Audit
Search and inspect security, identity, and network events.
Use Security → Audit to find and inspect individual events: administrative changes, posture decisions, access decisions, exit traffic and content filter verdicts. Authentication audit lives here too, even when you reach it from Authentication settings.

With the Audit tab active the table holds administrative events only; the histogram, window controls and Export act on the same filtered set.
Before you start#
- Viewing needs
audit:view(audit.readon the control plane). Owners and admins have it by default. Changing Logging Settings needsaudit:configure. - Traffic categories have short history. All, Access and Content Filter only offer 1h and 24h windows, and the page notes “Traffic history is limited to 24h”. The other categories offer up to 30d.
- Every query is capped at 31 days by the control plane. Retention is set per tenant (see below). Events older than retention are gone.
- Content Filter events are kept for 30 days regardless of the tenant retention setting.
Investigate an event#
- Open Security → Audit.
- Pick a category: All, Audit, Posture, SCIM, Exit, Access or Content Filter. Changing category resets the window to 24h.
- Pick a window: 1h, 24h, 7d or 30d. To look at an earlier period, set Window ending (UTC). This pauses live polling.
- Add filters with Filter. Choose a field, an operator (is, is not or contains) and a value, then click Apply. Type free text in the search box to match across event, actor, destination and metadata fields.
- Click an event name to open the Event details drawer. Polling pauses while it is open.
- Click Export and choose Export as CSV or Export as JSON to download the rows currently loaded.
You should see a status line such as “100 shown · 2,340 total · live every 15s”. Above the table, a histogram shows event volume across the window.

Applied filters appear as chips in the search box and the Filter menu lists the available fields; the histogram and status line reflect the filtered set.
Change logging settings#
- Click the Logging settings gear icon.
- Set Exit Node Logging: Off - No exit traffic logging, Metadata - IPs, ports, protocols only, or Full - Include hostnames when available.
- Set Retention Period (days) between 7 and 365.
- Click Save Settings.
You should see “Logging settings saved”.

Logging Settings holds the exit node logging level and the retention period; the note at the top explains which categories the retention applies to.
Reference#
Categories#
| Tab | Category value | What it holds |
|---|---|---|
| Audit | audit | Administrative actions, including authentication and configuration changes |
| Posture | posture | Device posture decisions |
| SCIM | scim | Audit rows whose event starts with scim |
| Exit | exit_traffic | Exit node connection logs |
| Access | access | Access decisions made by gateways |
| Content Filter | content_filter | Secure Web verdicts |
Two further categories, exit_policy and failover, have no tab. They appear under All.
Table columns#
Time, Event, Decision, Actor, Destination, Agent, Gateway, Category, Protocol.
Filter fields#
| Field | Values |
|---|---|
| Event | Free text, for example exit_connection |
| Event Class | DNS, Web, Malware |
| Decision | Allow, Deny, Compliant, Non-compliant |
| Protocol | TCP, UDP |
| Actor, Target User | A user |
| Agent, Gateway | A device or gateway |
| Dest IP, Dest Port | Free text |
Repeated filters are combined with AND. contains is case-insensitive. is not also matches rows where the field is empty. The control plane accepts at most 20 filters and a search of at most 256 bytes.
Event details#
The drawer shows the actor, affected user, device, gateway, destination, resource and threat where present, then Policy decision (matched by, policy, category, fail mode, reason), Recorded changes (before and after), and a collapsible Technical details section with raw references, IPs, ports, protocol, event class, DNS query type, SHA-256 and scan engine.

The Event details drawer opens on the right with the people and objects involved, the recorded reason, and Technical details collapsed below.
For a denied Content Filter event, users with content_filtering:update see Create tenant exception. Users with content_filtering:baseline_override also see Override security baseline.
Paging, polling and export#
- 100 rows per page. When the total exceeds 10,100 the page notes “First 10,100 results shown”. Narrow the category, window or filters.
- Live polling refreshes every 15 seconds. It pauses when you click pause, move past page 1, open the drawer, open settings, or change the window end.
- Export covers only the current loaded page. For a full-window export use Reports → Exports → Audit.
- CSV columns: Event ID, Tenant ID, Subject, Timestamp, Category, Event, Event Class, Threat, SHA-256, Scan Engine, Actor, Target User, Agent, Gateway, Resource, Decision, Destination IP, Destination Port, Protocol, Message, IP Address, User Agent, Metadata.
Retention#
A daily job deletes audit, posture, failover, access and exit traffic rows older than the tenant’s Retention Period. The control plane default is 30 days. Content Filter rows are purged on a fixed 30-day schedule. Retention is a policy setting, not a guarantee of durability. Keep required records in your approved external system.
Troubleshooting#
- “Audit unavailable: …” with Retry. The first load failed. Retry, then narrow the window.
- “Could not refresh. Showing the last successful results.” A poll failed; the table is stale. Retry.
- “Audit request timed out. Retry or narrow the window.” Reduce the window or add filters.
- “queries including access or content-filter traffic support at most 24 hours; choose an earlier end time for historical events”. Switch to Audit, Posture or SCIM, or set Window ending (UTC) with a 24h window.
- “Logging settings could not be loaded. Retry before making changes.” Do not save until the current values load.
- A link from Authentication settings opens Audit without a category. Pick Audit manually.
Related tasks#
- Analytics for aggregate block trends.
- Reports for full-window audit export.
- Secure Web to manage exceptions created from blocked events.
- Device posture for the policies behind posture decisions.
- SSO for authentication configuration.