Help: Ledger
Browse and filter the ledger
The Ledger page shows one account's events, newest first. Every member of the account can read it.
Open the ledger
- Select "Ledger" in the top bar.
- If you belong to more than one account, choose one in "Account". The page reloads for that account.
The chain status
The line under the heading says whether the account's chain of events is intact.
| The line says | What it means |
|---|---|
| Chain intact | Every event's hash and every link to the event before it were recomputed and match. |
| Chain broken at seq, followed by a number | The check failed at the event with that sequence number. Something in the stored history was altered. Keep your earlier exports and statements and contact the operator of your deployment. |
| Not yet verified | The ledger is too large to check while the page loads and the nightly check has not run for it yet. |
In brackets the line shows the number of events and when the check ran. A ledger of up to 2000 events is checked each time the page loads and reads "verified just now". A larger ledger shows the result of the nightly check, which runs at 3:00 UTC.
"Chain intact" means the record has not been altered since it was written. It does not mean the agents did what they reported. See What the ledger is.
The timeline
| Column | What it shows |
|---|---|
| Seq | The event's sequence number in this account's ledger. |
| When | The time of the event in UTC. |
| Event | The type of event, for example request.approved or agent.key_rotated. |
| Actor | Who caused it: agent, user or system, with the start of that actor's id. |
| Request | A link to the request the event belongs to, when there is one. |
| Hash | The start of the event's hash. Hold the pointer over it to see the whole hash. |
| Payload | Select "show" to read the details recorded with the event. "purged" means the details were deleted under the retention setting. |
The page shows 50 events at a time. Select "Older events" at the bottom of the table to load the next ones.
Filter the timeline
- Choose an "Event type", an "Agent", or both. Leave either at "all" to not filter on it.
- To limit the dates, set "From", "To", or both. Both days are included.
- Select "Filter".
The table shows only matching events, or "No events match." Select "Clear" to remove every filter.
- The "Event type" list holds only the types that occur in this account's ledger.
- The "Agent" filter shows events caused by that agent and events about its requests.
- Filtering changes what you see. It does not change the chain status, which always covers the whole ledger.
Also on this page
- "Export JSON" and "Export CSV": see Export and verify the ledger.
- "Retention": see Payload retention.
- "Monthly statements": see Monthly statements.
Previous: What the ledger is
Next: Export and verify the ledger
All help pages
Inbox
- Read a request
- Approve, deny or edit a request
- Held actions
- Expired requests and history
- Request statuses
Rules
- How rules work
- The default rules
- Write a rule in plain English
- Build a rule with the form
- Reorder, enable and disable rules
- Suggested rules
- Set a default policy for an agent
- Export your rules
Teams
Ledger
- What the ledger is
- Browse and filter the ledger
- Export and verify the ledger
- Payload retention
- Monthly statements
Billing
Account and security
- Change your password
- Two-factor authentication and recovery codes
- Rotate or revoke an agent key
- How your data is protected
- Closing an account