beacon endpoint status

Show local Beacon endpoint agent status

beacon endpoint status

beacon endpoint status reports the current local endpoint configuration, collector status, launchd service state, discovered harnesses, diagnostics, destination status, and the last observed Beacon event.

beacon endpoint status

Examples

Show endpoint status with the default per-user paths:

beacon endpoint status

Print machine-readable status:

beacon endpoint status --json

Check a custom runtime log path:

beacon endpoint status --log-path /path/to/runtime.jsonl

Check system-mode status for a root-managed deployment:

sudo beacon endpoint status --system

Output

Status includes:

• Beacon CLI version
• Config path and runtime log path
• Runtime-log source warnings if a system collector may be writing OTLP events to a different log
• Collector health and configured OTLP ports
• launchd service status
• Discovered AI runtime harnesses
• Endpoint diagnostics
• Destination configuration in JSON output, including Splunk HEC endpoint, index, source, and sourcetype when configured
• Last Beacon event in the runtime log, when present

When Splunk HEC is configured, --json includes a destinations.splunk_hec object with configured: true and the non-secret destination settings. The HEC token is not printed.

Flags

Flag	Description
--user	Use per-user endpoint paths. Enabled by default
--system	Use system endpoint paths and launch daemon
--log-path <path>	Runtime JSONL log path
--json	Print status as JSON

Related

beacon endpoint install

Install local endpoint telemetry configuration.

beacon endpoint discover

Discover supported local AI agent runtimes.