Skip to content

Operate

Evidence

What the artifact contains, how it is generated, and how long it is retained.

Generation

An evidence record is generated for a resolved incident. Generation is asynchronous: evidence_status moves from pending to ready, or to failed with a reason in evidence_error. A record is written once and never silently regenerated - if you need it rebuilt, POST /v1/evidence/{report_id}/regenerate creates a new one and records that it was rebuilt.

What is in the record

  1. Incident record - the window, the dependency, severity, status, and the observation topology the measurements came from.
  2. Detection record - the rule identifier, its reason string, and the run that satisfied it.
  3. Incident window measurements - checks in window, successes, failures, blocked probes excluded, availability, longest failure run, latency, first and last observation.
  4. SLA impact calculation - target uptime, measured availability, degradation impact, measured downtime, and the arithmetic basis for each.
  5. Observed latency and failures - the chart, drawn from the rows in the appendix.
  6. Rolling 24-hour health - context, labelled as context, never as the incident window.
  7. Correlated dependency events - the other dependencies that failed nearby, by name.
  8. Deterministic attribution - classification, confidence score, methodology version.
  9. Documented observations - every observation in the window, individually, with timestamp, result, latency and status.
  10. Authenticity, retention and verification - the payload hash, the document checksum, the verification URL, the signing status.

Integrity

Evidence data hash
SHA-256 over the canonical payload - the incident’s facts as data, not as a rendered PDF.
Document checksum
SHA-256 over the rendered bytes. A PDF cannot contain the hash of itself, so the checksum lives on the record, not inside the document.
Signature
Ed25519 over the canonical payload bytes, when the deployment has a signing key configured. The public key is at /v1/verify/keys.

Retention and sharing

Records are retained for 365 days from issue. Sharing is by token: a recipient opens the artifact and its verification page without an account. The token is unguessable and carries capability, so treat a shared link as you would the document.

bash
reliastra evidence list
reliastra evidence get 4b2e… --out incident-2026-09-18.pdf

Problem with this page?

These guides live in the repository. An inaccuracy in the documentation is a bug, and the fastest fix is an issue with the sentence quoted. Open an issue.

Next

Verification →

How a third party checks an artifact without trusting RELIASTRA, and without an account.

Read the methodology, or run the thing.

Every rule in these guides has a page stating its thresholds and its limits. The other way to check it is to add a dependency and watch what the detector does.