mayros observe
Inspect agent trace events, view aggregated statistics, and perform causal analysis on agent decisions. All data is stored in AIngle Cortex as RDF triples.
Subcommands
observe status
Show observability configuration and Cortex connection info. Displays whether tracing is enabled, capture settings (tool calls, LLM calls, delegations), flush interval, buffered event count, and Cortex health.
observe events
List recent trace events for an agent. Events include tool calls, LLM calls, decisions, delegations, and errors.
| Option | Description |
|---|---|
--agent <id> | Agent ID (default: current agent) |
--type <type> | Filter by event type (tool_call, llm_call, decision, delegation, error) |
--from <iso> | Start time (ISO 8601) |
--to <iso> | End time (ISO 8601) |
--format <fmt> | Output format: terminal (default), json, or markdown |
observe explain <eventId>
Explain why a specific event occurred by tracing its full causal chain. Walks backward through causally-linked events to show the sequence of decisions that led to the target event.
observe stats
Show aggregated observability statistics for an agent, including event counts by type and time range breakdowns.
| Option | Description |
|---|---|
--agent <id> | Agent ID (default: current agent) |
--from <iso> | Start time (ISO 8601) |
--to <iso> | End time (ISO 8601) |
--format <fmt> | Output format: terminal (default) or json |
Examples
bashmayros observe status mayros observe events mayros observe events --type tool_call --from 2025-01-01T00:00:00Z mayros observe events --agent reviewer --format json mayros observe explain evt-abc123 mayros observe stats mayros observe stats --from 2025-01-01 --to 2025-01-31 --format json
Related
- Trace — session-level trace commands
- Session Fork — fork and rewind sessions
- Cortex — AIngle Cortex backend
- Dashboard — team and agent dashboard