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.

Validation Events

Use a validation event to prove Beacon can write a known-good endpoint event to the local runtime JSONL log before you rely on real agent activity.

Write a test event

Run beacon endpoint test-event with the default per-user endpoint paths:
beacon endpoint test-event
The command checks that the configured runtime log is writable, appends a synthetic Beacon endpoint event, and reports validation stages. beacon endpoint validate-pipeline is an alias for the same local validation path.
beacon endpoint validate-pipeline
Use JSON output when capturing evidence for support, scripts, or rollout checks:
beacon endpoint test-event --json

Validate a specific log path

If you are testing a non-default runtime log, pass the path explicitly:
beacon endpoint test-event --log-path /path/to/runtime.jsonl
For a system-mode deployment, use the system endpoint paths:
sudo beacon endpoint test-event --system

Test GitHub Copilot CLI telemetry

After beacon endpoint install has started the local collector, run a real Copilot CLI prompt with OTLP export enabled:
COPILOT_OTEL_ENABLED=true \
OTEL_EXPORTER_OTLP_ENDPOINT=http://127.0.0.1:4318 \
OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=true \
copilot -p "Tell me about this repo."
Use OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=true only when testing with full content retention and when prompt content capture is intended. Confirm the Copilot event with status or the local dashboard:
beacon endpoint status
beacon endpoint dashboard --open

Confirm the event

After writing the event, confirm it with status or the local dashboard:
beacon endpoint status
beacon endpoint dashboard --open
The status output should include a recent last Beacon event when the runtime log has been written successfully. The dashboard should show the validation event in Log Search.

beacon endpoint test-event

Review all flags and examples for synthetic validation events.

Dashboard testing

Confirm validation events through the local read-only dashboard.

Local logs

Inspect runtime JSONL paths and last-event freshness.

SIEM forwarding

Move from local validation to destination-specific forwarding checks.