24

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.

ResponsibilityDurable questionCommon implementation
Applications create evidenceWhat customer or system behavior occurred, with what domain meaning?Application instrumentation, exporters, OpenTelemetry software development kits (SDKs)
Collectors protect, transform, and routeWas evidence authenticated, minimized, normalized, limited, buffered, and delivered to the right tenant?OpenTelemetry Collector or Grafana Alloy
Specialized stores preserve queryable shapesCan 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 investigationCan an operator move among signals, deployment, owner, and runbook without losing scope?Grafana and backend query APIs
Rules recognize conditionsDoes measured evidence threaten a customer or system objective?Prometheus-compatible rulers and alert rules
Notification control routes attentionIs the condition grouped, inhibited, silenced, and delivered to the accountable receiver?Alertmanager or equivalent routing layer
Humans and automation actIs there authority, a bounded change, rollback, and an expected effect?Incident process, deployment and recovery controllers
Follow-up evidence closes the loopDid 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.

BoundaryPurpose, inputs, and transformationOutput or interfaceScaling constraint and failure modeAlternatives, use when, and avoid when
Behavior → evidenceConvert domain and runtime events into named signals with canonical identity and contextMetrics, structured logs, spans, profiles, and schema referencesInstrumentation overhead and semantic ownership; generic infrastructure cannot reconstruct missing checkout meaningUse application instrumentation for domain facts and exporters for native system state; avoid collector-only semantics
Evidence → protected collectionAuthenticate, minimize, normalize, batch, sample, limit, buffer, and route by tenantBackend writes plus accepted, rejected, queued, and dropped countersIngest rate, buffer duration, and destination availability; overload causes loss or backpressureUse direct delivery for simple paths and gateways for measured shared-policy or isolation needs; avoid global chokepoints
Collection → preservationStore each signal in a queryable shape under retention and cost constraintsMetrics, log, trace, and profile query APIs backed by durable objectsCardinality, bytes, spans, samples, compaction, and query fan-out; saturation hides or delays evidenceUse specialized stores when their semantics improve decisions; avoid forcing all signals into one shape
Preservation → investigationCorrelate bounded queries with deployment, owner, tenant, and runbookImmutable evidence set and investigation linksQuery latency and cross-signal identity; missing context creates disconnected viewsUse Grafana or equivalent as a correlation surface; avoid treating it as the authoritative signal store
Investigation → decision and actionRecognize threatened outcomes, route attention, choose an authorized bounded change, and retain rollbackRule state, Alertmanager notification, decision record, and action runHuman attention and authority; component noise or over-broad automation causes unsafe actionUse human approval for ambiguous high-impact changes and automation for bounded well-proven responses; avoid action without expected effect and rollback
Action → observed effectRe-query customer and platform outcomes after the changeRecovery verdict, completeness, regression controls, and new evidence setMeasurement delay and confounders; success may be declared from activity rather than effectUse 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.

  1. Seed two contrasting incidents: a customer checkout failure and a collector export failure.
  2. Pin application build, schema, collector policy, backend, rule, notification, and action revisions.
  3. For each incident, traverse behavior, evidence, collection, storage, correlation, decision, action, and observed effect.
  4. Attempt a cross-tenant query and an unauthorized action; require independent denials.
  5. Fail one component and prove the evidence names that boundary while a healthy control still works.
  6. Roll back the action or reroute collection and measure recovery against its objective.
  7. 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.