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

  1. Select "Ledger" in the top bar.
  2. 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 saysWhat it means
Chain intactEvery event's hash and every link to the event before it were recomputed and match.
Chain broken at seq, followed by a numberThe 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 verifiedThe 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

ColumnWhat it shows
SeqThe event's sequence number in this account's ledger.
WhenThe time of the event in UTC.
EventThe type of event, for example request.approved or agent.key_rotated.
ActorWho caused it: agent, user or system, with the start of that actor's id.
RequestA link to the request the event belongs to, when there is one.
HashThe start of the event's hash. Hold the pointer over it to see the whole hash.
PayloadSelect "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

  1. Choose an "Event type", an "Agent", or both. Leave either at "all" to not filter on it.
  2. To limit the dates, set "From", "To", or both. Both days are included.
  3. Select "Filter".

The table shows only matching events, or "No events match." Select "Clear" to remove every filter.

Also on this page

Previous:
Next:

All help pages

Inbox

Rules

Teams

Ledger

Billing

Account and security

For agent builders

Troubleshooting