Help Center/Governance, RBAC & Security Desk/How to search and filter the Audit Logs ledger
Governance, RBAC & Security Desk•Last updated: 2026-10-20•3 min read

How to search and filter the Audit Logs ledger

The Audit Trail page reads i8_audit_ledger and lets you search by leaf hash, actor or target and filter by action.

Have questions or need step-by-step guidance on this topic?

Ask AI Copilot

Step-by-Step Procedure

1

Read the header counters

The heading is "Audit Trail — i8_audit_ledger". The small line "showing N of M matching · K in the ledger" tells you how many rows match and how many exist.

2

Search

Type in "Search by leaf hash, actor, or target ID..." and press Enter or click "Filter".

3

Filter by action

Open the "Action:" dropdown ("All actions (K)" plus each action with its count); picking one reloads immediately.

4

Read the empty states

"No events match the current filters; N events exist in the ledger." means your filters are too narrow; "The ledger holds no events at all" means nothing was ever appended.

Expected Operational Outcome

The table shows only matching audit events (default page size 50).

Troubleshooting & Failure Modes

Symptom: "Audit ledger unreadable"
Likely Cause: The ledger query failed (HTTP 503 or another error). The page refuses to show an empty list because that would claim a history it cannot check.
Resolution: Click "Refresh Audit Ledger"; if it persists contact the platform team.
Symptom: Auditor clearance required to access the audit ledger
Likely Cause: You are not an admin, moderator or auditor.
Resolution: Ask for the auditor role.

Was this guide helpful?

Help us refine our platform documentation