> ## Documentation Index
> Fetch the complete documentation index at: https://docs.reliantlabs.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Built-in observability: logs, traces, metrics, errors

> Forge apps record logs, traces and metrics at every boundary from the first commit; read them with forge commands locally and on Reliant hosting.

A forge app reports on itself from the first commit. Every inbound RPC, every call between your components, every database query, every outbound HTTP call and the browser records a log line, a trace span and a metric sample, all carrying the same trace ID. You write none of that instrumentation, and there is nothing to sign up for, no collector to run and no API key to paste into your code.

The point is what you can do with it. Because the signals are on disk and behind commands that print JSON and exit with meaningful codes, you and an agent working on your project can answer "what did the user's browser do", "did that deploy make things worse" and "what is in the database" without opening a dashboard. The sections below follow the signals from where they are produced to what you do with them.

> [card] [What every boundary records](https://docs.reliantlabs.io/hosting/observability/signals.md)
>
> The logs, traces and metrics on RPCs, component calls, the database, outbound HTTP and the browser, and how browser and API traces join.

> [card] [Where the telemetry goes](https://docs.reliantlabs.io/hosting/observability/where-it-goes.md)
>
> The local ClickStack, `.forge/logs/<env>/`, the browser console mirror, the hosted store, retention and opting out.

> [card] [Querying with forge obs](https://docs.reliantlabs.io/hosting/observability/forge-obs.md)
>
> `obs check` and its exit codes, `status`, `issue`, `trace` and `db query`, the same locally and hosted.

> [card] [Hosted dashboards, alerts and issues](https://docs.reliantlabs.io/hosting/observability/dashboards-and-alerts.md)
>
> Generated dashboards, the default alert rules, how errors are grouped, source maps and session replay.

> [card] [Health probes and graceful shutdown](https://docs.reliantlabs.io/forge/observability/health-and-shutdown.md)
>
> `/healthz` and `/readyz`, what a booting process reports, and how a rollout drains a replica.

> [card] [Why this helps an agent](https://docs.reliantlabs.io/hosting/observability/agents.md)
>
> Browser errors on disk, exit codes to branch on, recon commands, shipped skills, MCP and parallel agents.

## The shape of it

```mermaid theme={null}
flowchart LR
    A[Your app<br/>RPCs, components, DB, HTTP] --> S[(Telemetry store)]
    B[Browser<br/>errors, console, vitals] --> S
    S --> U[Apps UI<br/>dashboards, alerts, issues]
    S --> O[forge obs<br/>check, status, issue, trace]
    S --> L[.forge/logs<br/>local files, grep]
```

The app exports standard OpenTelemetry to whatever endpoint its environment provides, so the same build runs against the local ClickStack in development and your organization's store on hosting. Read the diagram from the left: two producers, one store, and three ways to read it. Locally the third arm, plain files you can `grep`, is the one agents reach for first.

## Related topics

[Environments & deploys](https://docs.reliantlabs.io/forge/environments-and-deploys.md) covers the releases that `forge obs check` judges. [Troubleshooting](https://docs.reliantlabs.io/forge/troubleshooting.md) covers what to check when a command fails. [Hosting on Reliant](https://docs.reliantlabs.io/hosting/overview.md) covers what hosting runs and bills. [Session timelines](https://docs.reliantlabs.io/hosting/observability/session-timelines.md) shows what a user did before a frontend error, and [Profiling](https://docs.reliantlabs.io/hosting/observability/profiling.md) covers CPU and heap profiles. [Release gates](https://docs.reliantlabs.io/forge/deploy/release-gates.md) explains how `forge obs check` gates a promotion.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.