Traceyard

A fast, read-only SQLite log explorer for correlated request and application logs.

Important

Traceyard is designed exclusively for SQLite log files generated by ELT-Global's internal API servers. The logging framework that produces these files is not yet open source, although we plan to publish it in the near future. Until then, this project is unlikely to be relevant or usable for anyone outside ELT-Global.

Run

pnpm install
pnpm dev

Open http://localhost:5173.

For a production-style local run:

pnpm build
pnpm start

Open http://localhost:8787.

Traceyard automatically opens the first .db file in the project root. Use Open snapshot in the application to drag in or select any other .db file. Imported snapshots are kept in the local .traceyard/databases library so they can be reopened quickly.

The expected tables are request_logs and app_logs; their request_id columns are used to build the correlated trace timeline. Every file is schema-validated before it becomes active, and SQLite is always opened in read-only/query-only mode.

Features

• Request overview with traffic, response health, route volume, and slowest requests
• Indexed, server-side filtering for request and application logs
• Request/app-event correlation by request_id
• Agent-ready Markdown exports for complete request context or chronological timelines
• Status, method, latency, level, context, and full-text-like substring filters
• Cursor-based pagination for large extracted snapshots
• Drag-and-drop database opening with schema validation and local snapshot switching
• Keyboard shortcuts: Cmd/Ctrl + K for navigation and / to focus table search