Docs

Export Formats and Crash Workflow

Understand pending reports, export sources, and compact formats.

Export Formats

CircleBox supports:

json
csv
json_gzip
csv_gzip
summary

Provenance Fields

Each report contains:

export_source: pending_crash or live_snapshot
capture_reason: uncaught_exception, manual_export, startup_pending_detection

These fields let you separate real crash-path artifacts from manual snapshots.

Crash Workflow

Runtime events fill ring buffer.
Crash path appends native_exception_prehook.
Pending report is persisted.
Next launch detects pending report.
App exports and optionally uploads pending report first.

CSV Notes

CSV includes metadata row and stable event columns:

seq
timestamp_unix_ms
uptime_ms
type
thread
severity
attrs_json

Size Reduction Guidance

Prefer summary for quick telemetry.
Use json_gzip for transport.
Keep full json only where deep forensics is needed.