liveBook · Manning

Evidence

As explained in Bootstrapping Microservices, Second Edition: With Docker, Kubernetes, GitHub Actions, and Terraform

Information that helps identify the location and cause of a software defect.

Evidence is information that narrows the search for a software defect’s location and cause. Gather it after triage, before isolating and reproducing the problem. section 11.3.1

Collect signals that reveal what happened and where to investigate:

  • Logging and error reports expose failures and relevant symptoms. section 11.3.1
  • Traces for relevant request paths show how a problem travels through the system. section 11.3.1
  • User bug reports add observed behavior from affected customers. section 11.3.1
  • Stern, kubectl, the Kubernetes dashboard, and observability software provide operational information. section 11.3.1
  • Call stacks and implicated code versions, branches, or tags connect failures to implementation changes. section 11.3.1
Figure 11.11 Cutting away the problem space until we isolate the exact source of the bug

Use the problem-space reduction view to connect gathered evidence with isolating the defect’s exact source. section 11.3.1

How Bootstrapping Microservices, Second Edition: With Docker, Kubernetes, GitHub Actions, and Terraform covers it

How deep it goes
Defines evidence, lists operational sources, and stops short of prescribing a fixed collection procedure.
Examples
Uses logs, error reports, request traces, user reports, Kubernetes tooling, call stacks, and code version metadata.
What it assumes
Assumes an existing debugging workflow and familiarity with application and operational diagnostic signals.
What you can do after
Diagnose/debug with it by narrowing investigation toward the real defect location.
How it connects
Connects evidence with debugging, triage, observability, logging, tracing, call stacks, and problem isolation.

Also explained in

Compare how 4 books explain evidence →

Related concepts

This explainer was generated by Manning's knowledge graph from the text of Bootstrapping Microservices, Second Edition: With Docker, Kubernetes, GitHub Actions, and Terraform. The section links point to the parts of the book it draws on.