The ax spans commands let you export span data from your Arize projects.
ax spans export
Export spans to a JSON file. Filter by trace ID, span ID, or session ID (mutually exclusive), and optionally combine with --filter for additional narrowing. Without any ID flag, all spans matching the time window are exported.
ax spans export <project> [--trace-id <id>] [--span-id <id>] [--session-id <id>] [--filter <expr>] [--days <n>] [--start-time <time>] [--end-time <time>] [--limit <n>] [--output-dir <path>] [--stdout] [--all]
| Option | Description |
|---|
project | Project name or ID (required, positional argument) |
--trace-id | Filter to spans belonging to a specific trace |
--span-id | Filter to a specific span |
--session-id | Filter to spans in a specific session |
--filter | Additional filter expression (e.g. "status_code = 'ERROR'", "latency_ms > 1000") |
--space | Space name or ID (required when using --all) |
--days | Lookback window in days (default: 30) |
--start-time | Override start of time window (ISO 8601) |
--end-time | Override end of time window (ISO 8601) |
--limit | Maximum number of spans to export (default: 100, ignored with --all) |
--output-dir | Directory to write the output file (default: current directory) |
--stdout | Print JSON to stdout instead of saving to a file |
--all | Use Arrow Flight for bulk export — streams all matching spans, ignores --limit |
--trace-id, --span-id, and --session-id are mutually exclusive. Only one may be provided per invocation.
# Export the last 30 days of spans for a project
ax spans export proj_abc123
# Export spans for a specific trace
ax spans export proj_abc123 --trace-id abc123def456
# Export error spans with a filter
ax spans export proj_abc123 --filter "status_code = 'ERROR'" --limit 200
# Export spans for a specific session
ax spans export my-project --session-id sess_xyz --space sp_abc123
# Bulk export via Arrow Flight (all spans, no limit)
ax spans export my-project --all --space sp_abc123
# Print to stdout for use in a pipeline
ax spans export proj_abc123 --stdout | jq '.[0]'
