Skip to content

Documentation

Audit logs

What the audit logs record, how to search and export them, and how to send them to your security tools.

Where
Admin → Audit logs · Admin → Settings → Organization settings → SIEM export
Permission
VIEW_AUDIT_LOGS · MANAGE_SETTINGS (SIEM export)
Updated
October 2026

Overview

Admin → Audit logs has two views: Changes and Security events.

Changes records who changed which request, person, role or setting, with the values before and after.

Security events records sign-ins and failed sign-ins, MFA, lockouts, password changes, API key use, refused access and EvenTier staff access.

Rows for EvenTier staff hide the source IP address and browser details.

Both views export to CSV, and every export is itself recorded in the audit log.

Both views can stream to your security information and event management (SIEM) tool, such as Splunk or Datadog.

Step by step

  1. 01

    Review the audit log

    Open Admin → Audit logs and pick a view.

    • Changes: filter by action, person or resource, and open a row to see the values before and after
    • Security events: choose Failures to see only refused attempts
    • Export either view to CSV from the same page
  2. 02

    Stream the audit log to your SIEM

    Send every audit event to your SIEM. Either EvenTier sends each event to you, or your SIEM collects them on a schedule.

    • Send: add a webhook subscription, and each event is POSTed to your HTTPS address as {"event": {...}}
    • Each POST is signed in X-EvenTier-Signature as t=<unix time>,v1=<HMAC-SHA256>, the same scheme as webhooks
    • Collect: generate a pull-API token, with an expiry if your policy wants one, and point your SIEM at /api/audit/stream with Authorization: Bearer <token>
    • The stream is newline-delimited JSON (NDJSON): one event per line, with kind set to audit or security_audit
    • Start with ?since=<ISO time>, then pass each response's X-EvenTier-Next-Cursor back as ?cursor=
    Collect events with the pull APIbash
    # First poll
    curl -H "Authorization: Bearer <token>" \
      "https://<your host>/api/audit/stream?since=<ISO time>"
    
    # Next polls: pass back the X-EvenTier-Next-Cursor header
    curl -H "Authorization: Bearer <token>" \
      "https://<your host>/api/audit/stream?cursor=<cursor>"
  3. 03

    Give an auditor read-only access

    Give your auditor a read-only reviewer role instead of an admin seat.

    • Build it in Admin → Roles with VIEW_AUDIT_LOGS, VIEW_ALL_REQUESTS (or VIEW_TEAM_REQUESTS) and VIEW_ANALYTICS
    • Give it no write permissions
    • Reviewers can read the queue and every request, but get no reply box or request controls

Good to know

  • How long each log is kept depends on your plan in the cloud and on your settings when self-hosted. See Data retention.
  • Stream to your SIEM to keep a copy outside EvenTier for as long as you need.