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.
Schema Normalization
Beacon normalizes OTLP attributes and hook payloads into the same endpoint contract. The collector exporter looks for common runtime fields, while hook telemetry builds those fields directly from hook payloads.Source mapping
| Source signal | Normalized field or action |
|---|---|
gen_ai.request.model | model |
gen_ai.tool.name | tool.name |
mcp.tool.name | mcp.tool |
process.command_line | command.command |
file.path | file.path |
conversation.id | session.id |
vcs.repository.url | repository |
git.branch | branch |
| Prompt-like events | prompt.submitted |
| Shell or exec events | command.executed |
| MCP events | mcp.tool_invoked |
| File, write, or edit events | file.modified |
| Approval events | approval.requested |
| Other tool activity | tool.invoked |
Category inference
When a runtime omitsevent.category, Beacon infers it from event.action:
| Action pattern | Inferred category |
|---|---|
prompt.* | prompt |
command.* | command |
file.* | file |
mcp.* | mcp |
approval.* or policy.* | approval |
metric.* | metric |
tool.* | tool |
Related
Endpoint event schema
Return to the schema overview.
Schema fields
Review entities, optional context, and shared top-level fields.
Telemetry pipeline
See where normalization fits in the local telemetry flow.