The Final Mental Model
Source: Observability Platform source notes, section 24, “The Final Mental Model”
The enterprise problem and today’s slice
Enterprise problem: A product-name mental model fails during redesigns and incidents because it says where signals usually live but not how system behavior becomes trustworthy evidence, a decision, and accountable action.
Whole-course context: The incoming phase ledger proves one complete investigation and alert path; this final day compresses every prior contract into a reusable chain that survives product substitutions and scale changes.
Today’s slice: We assign creation, protection, storage, correlation, condition recognition, notification, decision, and action responsibilities, then falsify the entire loop.
End-of-day evidence: Two contrasting incidents traverse the same invariant behavior-to-action chain with positive, denied, and recovery observations and independently owned boundaries.
Still unsolved: No architecture is permanently finished; new customer outcomes, threats, cost limits, and product versions must continuously re-enter the same review loop.
The smallest complete model
Observability is incomplete when it stops at a dashboard. The system must turn behavior into trustworthy evidence, evidence into an accountable decision, and action back into measured behavior.
Thesis: The durable model is behavior → evidence → verified action, regardless of which products implement the transitions. Why this matters: teams can replace tools or change scale without losing the ownership, security, failure, and recovery semantics that make incidents operable.
The boundary includes evidence creation, protection, storage, query, correlation, condition recognition, notification, authority, action, and follow-up measurement. It excludes any claim that this architecture is permanently finished; new outcomes and constraints re-enter the loop.
Expand the model one boundary at a time
First expand trustworthy evidence into creation, protected collection, and signal-shaped storage. Then expand verified action into correlation, condition recognition, notification, decision authority, bounded change, and follow-up evidence. Every added noun is still one transition in the behavior-to-effect loop.
Memorizing “Prometheus equals metrics” hides the customer-facing chain and breaks when architecture changes. Memorize responsibilities and evidence transitions instead.
| Responsibility | Durable question | Common implementation |
|---|---|---|
| Applications create evidence | What customer or system behavior occurred, with what domain meaning? | Application instrumentation, exporters, OpenTelemetry software development kits (SDKs) |
| Collectors protect, transform, and route | Was evidence authenticated, minimized, normalized, limited, buffered, and delivered to the right tenant? | OpenTelemetry Collector or Grafana Alloy |
| Specialized stores preserve queryable shapes | Can the relevant metric, log stream, trace, or profile be retrieved within retention and cost limits? | Prometheus or Mimir, Loki, Tempo, Pyroscope, object storage |
| Query and correlation assemble an investigation | Can an operator move among signals, deployment, owner, and runbook without losing scope? | Grafana and backend query APIs |
| Rules recognize conditions | Does measured evidence threaten a customer or system objective? | Prometheus-compatible rulers and alert rules |
| Notification control routes attention | Is the condition grouped, inhibited, silenced, and delivered to the accountable receiver? | Alertmanager or equivalent routing layer |
| Humans and automation act | Is there authority, a bounded change, rollback, and an expected effect? | Incident process, deployment and recovery controllers |
| Follow-up evidence closes the loop | Did the action improve the customer outcome without violating another boundary? | Synthetic probes, SLO queries, audit and action-run evidence |
The fundamental building block is not a product. It is a reliable path from system behavior to operational action and back to observed effect. Product substitutions are acceptable when they preserve the same owned interfaces, evidence quality, security, cost, and failure semantics.
The full chain becomes reusable when every boundary states its transformation, output, constraint, failure, and alternative.
| Boundary | Purpose, inputs, and transformation | Output or interface | Scaling constraint and failure mode | Alternatives, use when, and avoid when |
|---|---|---|---|---|
| Behavior → evidence | Convert domain and runtime events into named signals with canonical identity and context | Metrics, structured logs, spans, profiles, and schema references | Instrumentation overhead and semantic ownership; generic infrastructure cannot reconstruct missing checkout meaning | Use application instrumentation for domain facts and exporters for native system state; avoid collector-only semantics |
| Evidence → protected collection | Authenticate, minimize, normalize, batch, sample, limit, buffer, and route by tenant | Backend writes plus accepted, rejected, queued, and dropped counters | Ingest rate, buffer duration, and destination availability; overload causes loss or backpressure | Use direct delivery for simple paths and gateways for measured shared-policy or isolation needs; avoid global chokepoints |
| Collection → preservation | Store each signal in a queryable shape under retention and cost constraints | Metrics, log, trace, and profile query APIs backed by durable objects | Cardinality, bytes, spans, samples, compaction, and query fan-out; saturation hides or delays evidence | Use specialized stores when their semantics improve decisions; avoid forcing all signals into one shape |
| Preservation → investigation | Correlate bounded queries with deployment, owner, tenant, and runbook | Immutable evidence set and investigation links | Query latency and cross-signal identity; missing context creates disconnected views | Use Grafana or equivalent as a correlation surface; avoid treating it as the authoritative signal store |
| Investigation → decision and action | Recognize threatened outcomes, route attention, choose an authorized bounded change, and retain rollback | Rule state, Alertmanager notification, decision record, and action run | Human attention and authority; component noise or over-broad automation causes unsafe action | Use human approval for ambiguous high-impact changes and automation for bounded well-proven responses; avoid action without expected effect and rollback |
| Action → observed effect | Re-query customer and platform outcomes after the change | Recovery verdict, completeness, regression controls, and new evidence set | Measurement delay and confounders; success may be declared from activity rather than effect | Use the same pre/post probe and healthy controls; avoid closing incidents on deployment completion alone |
Run the model through one incident
The general rule is to traverse owned transitions from behavior to measured effect, preserving one healthy control and testing denial where authority changes. A simple example is a failed collector export: queue risk is evidence, a routed notification supports a reroute decision, and backlog drain proves the action worked.
In a recurring checkout incident, a sustained success-rate alert begins with application-owned domain evidence. The collector authenticates, redacts, and routes it; Prometheus or Mimir shows the outcome change; Tempo and Loki expose the causal request and event; Grafana correlates deployment and owner; a ruler and Alertmanager route one notification; and the incident commander authorizes a bounded rollback. Observed evidence includes schema, policy, backend, rule, notification, deployment, and action revisions plus tenant-scoped query results. The checkout recovery probe must improve, an unauthorized cross-tenant query must remain denied, and unrelated service health must stay stable.
Run the same model through the telemetry path itself: if export fails, platform-health evidence must identify threatened availability, support rerouting, and measure replay or bounded loss. Different incident, same invariant chain.
Failure modes, trade-offs, and decision rules
The most dangerous failure mode is a locally healthy component chain with a broken ownership or correlation handoff, so no actor can move from evidence to safe action. The principal trade-off is richer, faster automation and broad correlation versus evidence cost, access risk, cognitive load, and the blast radius of an incorrect action.
accept a product substitution, scale change, or automated response only when it preserves every owned interface, tenant and privacy boundary, failure observation, rollback path, and pre/post customer probe in the behavior-to-effect loop.
Teams often test each component separately while the correlation and action handoffs fail, so exercise the loop as one product journey.
- Seed two contrasting incidents: a customer checkout failure and a collector export failure.
- Pin application build, schema, collector policy, backend, rule, notification, and action revisions.
- For each incident, traverse behavior, evidence, collection, storage, correlation, decision, action, and observed effect.
- Attempt a cross-tenant query and an unauthorized action; require independent denials.
- Fail one component and prove the evidence names that boundary while a healthy control still works.
- Roll back the action or reroute collection and measure recovery against its objective.
- Falsify the architecture if any transition lacks an owner, immutable identifier, negative evidence, or follow-up observation.
Use automation when the trigger, authority, action radius, rollback, and expected measurement are bounded and repeatedly proven. Use a human decision when evidence is ambiguous or the consequence is irreversible. Avoid product replacement justified only by feature lists; the relevant comparison is whether the owned transition and its failure semantics improve.
Close the loop
The final model is itself a reusable operating protocol. Apply Observe → Interpret → Decide → Act → Measure whenever behavior, signals, backends, teams, or incident processes change.
Observe a checkout outcome breach and the health of the telemetry path carrying its evidence. Interpret the smallest transition that explains the facts while preserving authorized controls. Decide on one bounded, owned change with a rollback target. Act through the recorded authority. Measure the same checkout probe, evidence completeness, tenant denial, notification state, and unaffected-service control over the agreed window. If the expected outcome does not improve—or another boundary regresses—the action is falsified, rolled back, and the new evidence starts the next loop.
Key takeaways
Observability is a socio-technical control loop: software creates evidence, platforms preserve it, and accountable actors turn it into verified change.
- Product names are replaceable; owned transitions and customer outcomes are not.
- Applications create meaning, collectors enforce policy, and specialized stores retain queryable evidence.
- Grafana correlates, rules recognize, Alertmanager routes, and humans or automation act.
- The loop closes only when follow-up evidence verifies the effect and boundaries remain intact.
Checklist
Use this final review whenever a signal, backend, team, or incident process changes.
- [ ] Every behavior-to-action transition has one owner and protocol.
- [ ] Domain meaning originates in application instrumentation.
- [ ] Collection proves redaction, tenant routing, limits, buffering, and delivery.
- [ ] Investigations include correlation, decision authority, rollback, and observed effect.
- [ ] Customer and platform incidents both pass happy, denial, failure, and recovery probes.
Sources
The mental model names current implementations but relies on official primary documentation for their present responsibilities.