Skip to main content
You can inspect your apps through the dashboard, CLI, or MCP.

​
Read Logs

beam logs returns the last 100 entries. Add --follow to stream new output:
Use --source system to debug image pulls, mounts, and container exits. A name selects the app’s active deployment. Use an ID if multiple versions are active. Target a specific resource with --deployment-id, --stub-id, --task-id, or --container-id; use --app-id for all versions.

​
Time Windows and Output

  • --since and --until accept relative durations (30m, 2h, 1d) or ISO timestamps. Timestamps without an offset use UTC; --until is exclusive.
  • --tail (also --lines or -n) accepts 0–1000. Use --tail 0 --follow to read only new output.
  • --json emits one JSON record per line. --format json returns a historical JSON response; --format jsonl streams records.
  • --until cannot be combined with --follow.

​
Dashboard Metrics

Open an app or container to view CPU, memory, GPU, and network metrics. Task details show execution times and exit status.

​
MCP Metrics and Logs

request_stats supports endpoints. Latency percentiles are histogram upper bounds; resource averages are per container. Use the REST API for custom dashboards or webhooks for event notifications.