sanity-logs
v0.1.0
Published
Analyze Sanity request-log exports locally with DuckDB and a browser dashboard.
Maintainers
Readme
sanity-logs
Analyze Sanity request-log exports locally. The CLI converts an NDJSON export to Parquet, starts the included dashboard on 127.0.0.1, and opens it in your browser.
npx sanity-logs export.ndjsonCompressed exports work directly too:
npx sanity-logs export.ndjson.gzNothing is uploaded. Conversion, serving, and analysis stay on your machine.
Requirements
- Node.js 22 or 24
- macOS, Linux, or Windows on arm64 or x64
- npm optional dependencies enabled so DuckDB can install its native binding
Options
-o, --output <path> Choose the Parquet output path
--convert-only Convert and exit without starting the dashboard
--no-open Start the dashboard without opening a browser
--port <number> Choose the loopback port
--help Show CLI help
--version Show the installed versionExamples
npx sanity-logs export.jsonl.gz --convert-only
npx sanity-logs export.ndjson -o ./logs.parquet
npx sanity-logs export.ndjson.gz --no-open --port 7411The project is independent and is not affiliated with or endorsed by Sanity.
Source and issue tracker: https://github.com/robotostudio/sanity-log-debug
