Skip to content

The only tool you need to know what is happening and how to fix it.

add: more docs for multi project access

narrow-adventure4cd39242cba9
diff --git a/README.md b/README.md
index 73c6709b..ce6c4e61 100644
--- a/README.md
+++ b/README.md
@@ -52,6 +52,7 @@ Traceway is an **OpenTelemetry-native** observability platform. It combines **lo
- **Session Replay**: Watch what the user did right before the error. Available for web (any JS framework) and Flutter.
- **AI Observability**: LLM cost, tokens, latency, and full conversations across providers (OpenRouter and any OTel-compatible AI gateway). Calls group into conversations via `gen_ai.conversation.id`, tool calls are parsed from completions and rendered in the chat view, and multi-language content flagging catches conversations containing terms you care about. Per-customer analytics (conversation length, cost per conversation) key on `user.id`: set it to a stable customer identifier such as your account or tenant id, the same value across all of that user's conversations, never a session id.
- **On-Call & Paging**: Rotation schedules with layers and overrides, escalation policies, and pages that escalate until someone acknowledges. Delivered via email, Slack, Pushover, Telegram, or SMS, with one-click acknowledge links that need no login.
+- **Fleet Overview**: One organization-wide page above every project: each reporting instance with live CPU, memory, disk and network, plus issues, monitors and open pages across all projects. Kubernetes nodes group by cluster, and a single `kubectl apply` instruments a whole cluster.
Plus: background-task (job) monitoring, configurable alerts (Slack / GitHub / email / webhook / Pushover / Telegram), multi-tenant orgs with role-based access, and a per-endpoint slow-threshold override.
@@ -291,6 +292,8 @@ Full documentation at **[docs.tracewayapp.com](https://docs.tracewayapp.com)**:
- [**Self-Hosting**](https://docs.tracewayapp.com/server): Docker Compose and production deployment
- [**Concepts**](https://docs.tracewayapp.com/learn): How tracing, exception fingerprinting, metrics, and alerts work
- [**Embedded Mode**](https://docs.tracewayapp.com/learn/embedded-mode): Run Traceway inside your Go app
+- [**Kubernetes**](https://docs.tracewayapp.com/learn/kubernetes): Instrument a whole cluster with the manifests in [`examples/kubernetes`](./examples/kubernetes)
+- [**Organization Overview**](https://docs.tracewayapp.com/learn/organization-overview): Fleet health and cross-project triage on one page
## Community
diff --git a/docs/pages/learn/monitors.mdx b/docs/pages/learn/monitors.mdx
index 944036a0..ad367f03 100644
--- a/docs/pages/learn/monitors.mdx
+++ b/docs/pages/learn/monitors.mdx
@@ -2,7 +2,7 @@
Monitors answer the question your telemetry cannot: is the service actually reachable from the outside? Traces and logs only exist while requests arrive. A monitor keeps probing on a schedule, so you find out your site is down before a user tells you.
-They live under **Monitors** in the sidebar, with tabs for the monitors themselves, **Status Pages**, and **Post-Mortems**. The badge counts the monitors currently down on the current project.
+They live under **Monitors** in the sidebar, with tabs for the monitors themselves, **Status Pages**, and **Post-Mortems**. The badge counts the monitors currently down on the current project. Every monitor across all of the organization's projects, with uptime, latency, and incident history, is on the [Organization Overview](/learn/organization-overview#monitors).
## Check types
diff --git a/docs/pages/learn/on-call.mdx b/docs/pages/learn/on-call.mdx
index 2b437ced..75cf8a75 100644
--- a/docs/pages/learn/on-call.mdx
+++ b/docs/pages/learn/on-call.mdx
@@ -4,6 +4,8 @@ On-Call turns an alert into a person's phone ringing. Alerts on their own post t
Traceway ships the full paging stack: teams, rotating schedules, escalation policies, per-responder contact methods, and a no-login acknowledge link. It lives under **On-Call** in the sidebar, and the badge there counts the pages still open on the current project.
+That badge and that queue are per project. For pages across every project in the organization at once, use the [Organization Overview](/learn/organization-overview).
+
<img src="/on-call/oncall-pages.png" alt="The On-Call page showing the incident queue" style={{ maxWidth: '100%', height: 'auto', marginTop: '16px', borderRadius: '8px', border: '1px solid #e5e7eb' }} />
## How the pieces fit together