Skip to content
🧭
System district

Observability Layer

Open this district when you need the short boundary between OpenObserve telemetry, Watchtower interpretation, the expected-state model, and the next street that owns the answer.
Validated Β· Oct 6, 2026The proof still tracks Watchtower source-health warnings, troubleshooting partial-coverage cues, and the OpenObserve-first explanation-versus-operator boundary Atlas keeps explicit for readers. This capture-currency pass re-verified those claims against the live Watchtower source β€” the every-2-hours monitor cadence, the Observability data unavailable warning string, and the OpenObserve-first contract β€” and retired the landing's frozen July 10 framing: the July 10 refresh is now named as a point-in-time confirmation while the contract is taught as still-current. The monitor row's pointer still routes the cooldown-based alert path to the Workflows page, not on this district's streets.
Current snapshot
  • Primary live source: OpenObserve remains the first telemetry destination; Watchtower stays the reader-facing interpretation surface.
  • Route split: This district sorts the question first, then exits toward Watchtower, observability infrastructure, or troubleshooting.
  • Best use: Open this page when you need the current explanation-versus-live-evidence boundary before following a deeper observability street.
  • Source-health cue: If Watchtower says Observability data unavailable, treat it as an upstream OpenObserve load failure on that refresh, not a quiet event stream.
Reader orientation

Choose the observability question you arrived with first

The district page is the quick sorter. Pick the closest question and Atlas will point you to the shortest safe stop instead of teaching every layer at once.
Current observability contract

Keep these four observability layers separate

Atlas uses one district plus three street pages to teach observability cleanly. If you remember one rule: the district sorts the question, How to Read Watchtower interprets live signals, Infrastructure explains the telemetry path, and Troubleshooting handles failure diagnosis.
Current model
OpenObserve is the primary live telemetry source

Treat OpenObserve as the place where current observability evidence lands first. The district should no longer teach a SQLite-backed collector as the main live model.

Watchtower README: raw event stream from OpenObserve. Stream: saffron.

Current model
Watchtower is the operator surface

Use Watchtower for live interpretation, alert review, and dashboard-level status questions. It reads and summarizes evidence; it does not replace the upstream systems that generated it.

Stay on the Watchtower street page when the live panel meaning is the blocker, not the infrastructure.

Current model
The expected-state registry shapes health interpretation

The service registry tells Watchtower whether a service is expected to be local, hosted, or deprecated, which prevents false β€œDown” readings for hosted services like OpenObserve on Railway.

Open the infrastructure street when you need the hosting and registry details behind a badge or health band.

Current model
Monitor still emits the recurring health snapshot

The monitor loop remains the recurring health-check surface. Its monitoring.completed events still matter for alert cadence, service health history, and troubleshooting order.

Atlas documents the monitor run every 2 hours on the Watchtower guide and infrastructure streets; the full cooldown-based alert path is traced on the Workflows page in the Watchtower Alert Escalation workflow.

Representative route rules

Use the district as a sorter, then leave

These are the recurring path choices Atlas expects readers to make most often. They are route rules, not live health claims.
What is happening right now?
How to Read Watchtower

The live dashboard, event stream, health timeline, and status meanings all live there.

Open How to Read Watchtower
Why does this badge say hosted or unavailable?
Observability infrastructure

The answer usually depends on the expected-state registry and the current OpenObserve path.

Open Observability Infrastructure
Why is the panel empty or the data missing?
Observability troubleshooting

Missing data is a failure mode, not just an empty dashboard state.

Open Observability Troubleshooting
Which page should I trust for explanation versus live state?
Current observability contractHere

This district page is where Atlas keeps the boundary between explanation, evidence, and diagnosis explicit.

Street-level pages

These are the deeper exits once the current contract is clear and the district has done its sorting job.

How to Read Watchtower

Navigate the monitoring dashboard, event stream, health timeline, Bridge log, and cost tracker.

Open How to Read Watchtower
Observability Infrastructure

Collector footprint and deployment topology.

Open Observability Infrastructure
Observability Troubleshooting

Debugging observability and event flow issues.

Open Observability Troubleshooting

Continue from Observability

Troubleshooting

Leave the observability family when you already know the failure pattern and need the broader diagnostic ladder.

Open Troubleshooting
Network

Zoom out when the signal only makes sense in the wider map of agents, services, and boundaries.

Open Network
FAQ

Use the question-routing layer when the reader is still mixing up Atlas explanation with Watchtower live status.

Open FAQ