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
- 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
- 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-Signatureast=<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/streamwithAuthorization: Bearer <token> - The stream is newline-delimited JSON (NDJSON): one event per line, with
kindset toauditorsecurity_audit - Start with
?since=<ISO time>, then pass each response'sX-EvenTier-Next-Cursorback 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>" - Send: add a webhook subscription, and each event is POSTed to your HTTPS address as
- 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(orVIEW_TEAM_REQUESTS) andVIEW_ANALYTICS - Give it no write permissions
- Reviewers can read the queue and every request, but get no reply box or request controls
- Build it in Admin → Roles with
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.