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

# Dashboard panels

> Read-only state surface served on the agent's debug HTTP port.

The agent exposes a read-only HTTP dashboard on port `10101`,
bound to `127.0.0.1` unless `DEBUG_DASHBOARD_HOST` and
`DEBUG_DASHBOARD_TOKEN` are both set (see
[Read the agent dashboard](https://docs.use.observer/agent/guides/read-the-dashboard.md)). Every
panel reads from the agent's in-process state. Nothing on the page
mutates anything.

The page renders the JSON served at `/api/state` on the same port.
`/healthz` answers `ok` and never needs the token. The sections
below list the top-level keys of `/api/state`.

## Panel reference

### `process`

| Field | Meaning |
| - | - |
| `agent_started_at` | ISO timestamp of process start. |
| `uptime_seconds` | Wall-clock seconds since `agent_started_at`. |
| `memory_rss_mb` | Resident set size of the agent process. |
| `version` | Build-time version string. |
| `bun_version` | Bun runtime version reported by `Bun.version`. |
| `pid` | Process id of the agent. |
| `hostname` | Hostname of the machine or container the agent runs on. |

### `counters`

Totals since the agent started.

| Field | Meaning |
| - | - |
| `evaluations` | Probe evaluations started, across all metrics. |
| `pushes` | Readings the cloud accepted. |
| `errors` | Errors the agent logged. |
| `dropped` | Queued readings evicted because the queue reached `BUFFER_MAX_ROWS`. |

### `config`

A map of environment variable names to masked values. Values
shorter than 20 characters show as `****`; longer values keep their
first 4 and last 2 characters. `DEBUG_DASHBOARD_TOKEN` is listed
with its value replaced by `•hidden•`. Names not in the dashboard's
allowlist are not displayed regardless of value.

### `queue`

| Field | Meaning |
| - | - |
| `depth` | Pushes currently waiting to be drained. |
| `oldest_age_seconds` | Age of the oldest pending push. |
| `capacity` | Configured `BUFFER_MAX_ROWS`. |
| `drain_backoff_ms` | Current exponential backoff used by the drain controller. Zero means the next drain attempt is immediate. |

### `cloud`

| Field | Meaning |
| - | - |
| `cloud_server_url` | Configured `CLOUD_SERVER_URL`. |
| `last_heartbeat_at` | ISO timestamp of the last heartbeat attempt. |
| `last_heartbeat_ok` | Boolean result of the last heartbeat. |
| `last_heartbeat_error` | Error string when `last_heartbeat_ok` is false. |
| `last_post_at` | Last metric-push attempt timestamp. |
| `last_post_ok` | Boolean result of the last push. |
| `last_post_error` | Error string when `last_post_ok` is false. |

### `prometheus`

| Field | Meaning |
| - | - |
| `server_url` | Configured `PROMETHEUS_SERVER_URL`. |
| `last_probe_outcome` | One of `success`, `no_data`, `error`, or `null` if no Prometheus probe has run yet. |
| `last_probe_at` | ISO timestamp of the last Prometheus probe. |

### `definitions`

One row per metric the cloud has assigned to this agent.

| Field | Meaning |
| - | - |
| `id` | Metric definition id. |
| `source_type` | One of the [probe types](https://docs.use.observer/agent/reference/probe-types.md). |
| `interval_minutes` | Configured collection interval. |
| `push_interval_minutes` | Configured forced-push interval (status pushes also fire on every status change). |
| `last_status` | Most recent status reported. |
| `last_value` | Most recent reported value. |
| `last_at` | ISO timestamp of the last push. |
| `last_reason` | Reason code on the last `no_data` (or null when the last push was healthy). |
| `healthy_operation` | Healthy threshold operator (`over`, `under`, or `equal`), or null when unset. |
| `healthy_value` | Healthy threshold value, or null when unset. |
| `unhealthy_operation` | Unhealthy threshold operator, or null when unset. |
| `unhealthy_value` | Unhealthy threshold value, or null when unset. |

### `active_source_types`

Distinct list of source types across the metric definitions
currently assigned to the agent. The list is rebuilt on every
definitions fetch.

### `recent_logs`

The 20 most recent log lines from the agent, each with
`timestamp`, `level`, and `message`.

### `heartbeat_relay`

Shown when the agent reports relay state. Only `enabled` is present
while the [heartbeat relay](https://docs.use.observer/agent/guides/heartbeat-relay.md) is off.
Counters are totals since the agent started.

| Field | Meaning |
| - | - |
| `enabled` | Whether `HEARTBEAT_RELAY_ENABLED` is `true`. |
| `listening` | Address and port the relay is bound to, or null when it is not listening. |
| `queue_depth` | Pings waiting to be forwarded to the cloud. |
| `forward_backoff_ms` | Current backoff before the next forward attempt. Zero means the next attempt is immediate. |
| `queued` | Pings accepted and queued. |
| `rejected_rate_limited` | Pings rejected by the relay's rate limit. |
| `rejected_invalid` | Pings rejected as malformed. |
| `enqueue_failures` | Pings that could not be written to the relay queue. |


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