aos obs

What this machine has been asked to do

6 commands. Run aos obs --help for the same list from the binary, or see every group.

What this machine has been asked to do. Every command records one span with the route, the source (cli or mcp), the exit code, the duration and the number of arguments, never their values. audit lists commands in order, stats and summary aggregate, tail shows the latest, export emits OTLP JSON. See observability.

Commands

aos obs audit

Every command this machine was asked to run, oldest first

aos obs audit [--since=<duration>] [--source=<cli|mcp>] [--failed] [--json]

flag	values	meaning
--since	<duration>	Optional
--source	cli, mcp	Optional
--failed		Optional
--json		Optional

aos obs audit --since=24h
aos obs audit --source=mcp     # only what agents asked for
aos obs audit --failed

aos obs export

Emit recorded spans as OTLP JSON, ready for a collector

aos obs export [--since=<duration>]

flag	values	meaning
--since	<duration>	Optional

aos obs export --since=1h > spans.json

aos obs path

Print where telemetry is written

aos obs path

aos obs path

aos obs stats

Summarise recorded work: calls, failures, and latency per route

aos obs stats [--since=<duration>] [--source=<cli|mcp>] [--json]

flag	values	meaning
--since	<duration>	Optional
--source	cli, mcp	Optional
--json		Optional

aos obs stats
aos obs stats --since=24h --source=mcp

aos obs summary

How much this machine is actually used, and by what

aos obs summary [--since=<duration>] [--json]

flag	values	meaning
--since	<duration>	Optional
--json		Optional

aos obs summary
aos obs summary --since=7d

aos obs tail

Print the most recent spans, newest last

aos obs tail [--limit=<n>] [--since=<duration>]

flag	values	meaning
--limit	<n>	Optional
--since	<duration>	Optional

aos obs tail --limit=20