Trace Export & Import

Exporting a trace

Click Export Trace during or after a session. moqtap saves a .moqtrace file containing every event from the session.

The .moqtrace format is JSON-lines (one event per line), gzip-compressed:

{"ts":1711036800000,"dir":"tx","type":"CLIENT_SETUP","fields":{...}}
{"ts":1711036800050,"dir":"rx","type":"SERVER_SETUP","fields":{...}}
{"ts":1711036800100,"dir":"tx","type":"SUBSCRIBE","request_id":0,"fields":{...}}

Each event includes:

• Timestamp (microseconds)
• Direction
• Parsed message fields
• Raw bytes (for re-parsing)
• Parse warnings (if any)

Importing a trace

Open a .moqtrace file via File > Open Trace. moqtap loads the entire timeline and switches to log analysis mode:

• Full timeline scrubbing (forward/backward)
• Search and filter across all events
• No live interaction (read-only)
• Latency displayed relative to first event

Sharing traces

.moqtrace files are self-contained — share them via email, Slack, or attach them to GitHub issues for bug reports.