Read the agent dashboard

The agent serves a read-only debug dashboard on http://<host>:10101 by default. The dashboard polls the agent's in-process state every five seconds and never mutates anything.

Panels

Process

Identifies the agent: version string, Bun runtime version, process uptime, and resident-set memory. Use this to confirm the running image matches the version you expected after an upgrade.

Config

Lists the environment variables the agent considers relevant to operation, with values masked to first-4 + tail-4 characters. Variables outside the allowlist are not displayed regardless of their name. The masking applies even to values that are not themselves secrets, so screenshots of the dashboard never reveal a full token.

Queue

Reports the local SQLite queue's current depth, the age of the oldest pending push, the configured capacity, and the drain controller's current backoff in milliseconds. A growing queue combined with a non-zero backoff is the signature of cloud unreachability.

Cloud

Reports the configured CLOUD_SERVER_URL and the timestamps and results of the last heartbeat and the last metric push. Failed recent calls show their error reason here.

Prometheus

Reports the configured PROMETHEUS_SERVER_URL, the outcome of the last Prometheus probe (success, no_data, error, or null if the agent has not run a Prometheus probe yet), and the timestamp.

Definitions

One row per metric the cloud has assigned to this agent. Each row shows the metric id, source type, intervals, and the last reported status, value, timestamp, and reason. Use this to confirm a specific metric is being collected.

Active source types

The list of source types the agent has actually run since boot. Useful when verifying that a stubbed runtime (e.g. database) is not silently unused.

Toggling the dashboard

The dashboard is enabled by default. To disable it set ENABLE_DEBUG_DASHBOARD=false in the agent's environment. To change the bind address or port, set DEBUG_DASHBOARD_HOST and DEBUG_DASHBOARD_PORT.