Skip to main content

​
Command Overview

beacon ingest endpoint manages endpoint telemetry uploads to Asymptote Managed ingest.
Command syntax
beacon ingest endpoint [command]
Use this command group when endpoint ingest is configured and you need to inspect upload state or trigger an upload from the local runtime log.
Endpoint ingest requires dashboard credentials from beacon login and endpoint ingest configuration. Beacon endpoint collection remains local-only unless managed ingest is configured and endpoint upload commands are used.

​
Commands

status

Show endpoint telemetry upload status.

upload

Upload endpoint telemetry to managed ingest.

​
Flags

FlagDescription
--userUse per-user endpoint paths. Enabled by default
--systemUse system endpoint paths and launch daemon
--log-path <path>Runtime JSONL log path
--jsonPrint output as JSON

​
beacon ingest endpoint status

beacon ingest endpoint status prints endpoint telemetry upload status, including whether ingest is enabled, whether it is managed, whether the CLI is logged in, upload cursor position, accepted and rejected counts, and the last upload error when present.
Show endpoint ingest status
beacon ingest endpoint status
Check status for a system-mode endpoint:
Show system endpoint ingest status
sudo beacon ingest endpoint status --system
Print machine-readable endpoint ingest status:
Print JSON
beacon ingest endpoint status --json

​
beacon ingest endpoint upload

beacon ingest endpoint upload uploads endpoint telemetry from the runtime log to managed ingest.
Upload endpoint telemetry
beacon ingest endpoint upload
Upload from an explicit runtime log:
Upload from a runtime log
beacon ingest endpoint upload --log-path /var/log/beacon-agent/runtime.jsonl
When the upload completes, Beacon prints the updated ingest state. If managed ingest is enabled and the upload is rejected or fails, the command exits with an error and includes the latest ingest error in the status output.

beacon ingest

Review the managed ingest command group.

Endpoint config

Inspect and validate local endpoint configuration.