infrayantra/pg_analyzer repository overview

⁠BadgerScope (pg_analyzer)

A self-contained web GUI for analyzing PostgreSQL server logs with pgBadger⁠, the full-featured PostgreSQL log analyzer. Upload log files or point the container at a mounted log directory, and get a complete HTML performance report without touching the command line.

⁠Features

• Web GUI built with FastAPI: upload logs or select from a mounted directory, no CLI needed
• Supports all pgBadger log formats: stderr, csvlog, jsonlog, syslog, syslog2, logplex, rds, redshift
• Background job processing with live status polling
• Report history with a built-in viewer and delete option
• Incremental mode for building rolling multi-day reports
• Health check endpoint for container orchestration

⁠Quick start

docker run -d --name pg_analyzer -p 8080:8080 \
  -v /path/to/postgresql/logs:/data/logs:ro \
  -v pg_analyzer_reports:/data/reports \
  -v pg_analyzer_uploads:/data/uploads \
  infrayantra/pg_analyzer:latest

Then open http://localhost:8080⁠ in a browser.

⁠Volumes

⁠Environment variables

⁠Port

• 8080: web GUI

⁠Health check

• GET /healthz returns {"status": "ok"}

⁠Notes

This image runs without authentication by default. PostgreSQL logs can contain query text and connection details, so restrict network access (VPN, reverse proxy, firewall) if deploying beyond a trusted local environment.