Skip to main content

Dashboard

The BatAudit dashboard is served by the Reader service at port 8082. It provides a complete view of your audit data across all projects.

Pages​

Events​

The main view. Lists all audit events with filters:

  • Service — filter by service_name
  • Method — GET, POST, PUT, DELETE
  • Status code — exact match
  • Identifier — user or client ID
  • Environment — production, staging, development
  • Date range — start and end date/time

Click any row to open the event detail modal, which shows the full event including request_body, response_body, query_params, IP, user agent, and all metadata. The response_body is hidden by default and revealed on click, since it may contain sensitive data.

Sessions​

Shows derived sessions — groups of events from the same identifier within a 30-minute inactivity gap. Useful for understanding user journeys.

If you send events with an explicit session_id field, you can also look up a specific session directly.

Anomalies​

Lists all system.alert events generated by the anomaly detection engine. Each alert includes the rule that triggered it and the relevant metrics.

See Anomaly Detection → for details on how alerts are generated.

Insights​

Rankings over your data — top endpoints by volume, most active users, routes with the highest error rate, and slowest routes. See Insights →.

Settings​

Settings open in their own view (the sidebar switches to a settings navigation with a Back link). They're grouped by section:

  • General — Healthcheck monitors. See Healthcheck →.
  • Team — Members (link users to projects) and Users (accounts & invites). Admin/Owner only.
  • Project — API Keys (generate/list/revoke), Wallboard (TV activation codes), and Notifications (Web Push & Webhooks). Admin/Owner only.
  • Danger — Retention / data tiering configuration. Owner only.

Multi-project & roles​

If you're an Owner, the header shows a project selector that includes "All Projects" — a consolidated view across every project. Admins and Viewers only see projects they belong to.

The header also has an environment filter (production / staging / dev / …) on data pages.

See Team & Users → for the full role breakdown and how to invite people.

Orphan events​

If you use the Browser SDK, BatAudit tracks requests that the browser sent but never received a backend response for (network errors, timeouts, connection resets).

The dashboard shows a banner on the Events page when orphan events exist in the last 24 hours.

Export​

From the Events page, click Export to download up to 100 000 events as CSV or JSON. The export respects all active filters.