Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.asymptotelabs.ai/llms.txt

Use this file to discover all available pages before exploring further.

beacon endpoint test-event

beacon endpoint test-event writes a synthetic validation event to the Beacon runtime JSONL log.
beacon endpoint test-event
Use a test event to validate local write permissions and downstream file-tail pipelines before relying on real agent activity. The command checks that the configured runtime log is writable, appends a known-good Beacon endpoint event, and reports the validation stages. beacon endpoint validate-pipeline is an alias. For destination-specific validation guidance, use the SIEM commands such as beacon endpoint wazuh validate, beacon endpoint datadog validate, beacon endpoint sumo validate, or beacon endpoint rapid7 validate.

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 validation stages as JSON

Examples

Write a validation event to the default per-user runtime log:
beacon endpoint test-event
Validate a custom runtime log:
beacon endpoint test-event --log-path /path/to/runtime.jsonl
Print validation stages as JSON:
beacon endpoint test-event --json
Use the pipeline-validation alias:
beacon endpoint validate-pipeline
Validate a system-mode runtime log:
sudo beacon endpoint test-event --system

Endpoint status

Inspect endpoint health and last-event state.

SIEM forwarding

Forward Beacon runtime JSONL to customer-managed destinations.