Audit log and analytics
Audit log
Section titled “Audit log”Every login, failed attempt, change to a user and change of settings is written to the environment’s audit trail, with who did it, from where and when. Events about a user can also go to your webhooks; the admin.* events never do.
Read the audit log
Section titled “Read the audit log”| Query | Meaning |
|---|---|
event |
An event name or the start of one: user. gives every user event, admin. every change of settings. |
user_id |
The events a user did, and those done to them. |
before |
An occurred_at: the page after it. |
limit |
50 by default, at most 200. |
event is matched as a prefix, and %, _ and \ are removed from it first. A name with an underscore, such as app_user.joined or admin.client.secret_rotated, therefore matches nothing as written: ask for the part before the underscore (app or admin.client.secret) instead.
{ "events": [ { "id": "…", "occurred_at": "…", "event": "login.succeeded", "actor_user_id": "…", "subject_user_id": "…", "ip": "…", "user_agent": "…", "data": { "method": "email_code" } } ], "next_before": null, "retention_days": null}| Field | Meaning |
|---|---|
actor_user_id |
Who did it: the user themselves, or null when it was done from the dashboard or with an API key. |
subject_user_id |
Whom it was done to. |
data |
What the event says. A change of settings carries the developer’s id, and api_key_id when an API key made it. |
retention_days |
How many days the workspace’s plan keeps: 30 on Free, null on paid plans, which keep a year. |
Event names
Section titled “Event names”| Event | When |
|---|---|
user.created, user.updated, user.deleted |
An account was made, changed (name, picture, email address) or deleted. |
user.disabled, user.enabled |
A user was disabled or enabled again. |
app_user.joined |
A user entered an app for the first time. |
login.succeeded, login.failed |
A login completed, or an attempt was refused. |
session.started, session.raised |
A session ticket gave a browser a session of its own (session.raised: raised the one it had, before 2026-11-17). |
session.revoked |
A session ended: a logout, or it was ended from the dashboard, the API or the account settings. |
mfa.enrolled, mfa.removed, mfa.failed |
A second factor was added (or new recovery codes made), removed, or failed. |
identity.linked, identity.unlinked |
A way to log in was connected or removed. |
password.changed, password.reset, password.removed |
A password was set or changed, reset during a login, or removed. |
email.changed |
A new email address. |
role.assigned, role.removed |
A user was given a role, or lost one. |
refresh.reuse_detected, code.reuse_detected |
A refresh token or an authorization code was presented a second time, and the tokens that came from it were revoked. |
key.rotated |
The environment’s signing keys rotated. |
admin.* |
A change of settings, such as admin.client.created, admin.policy.updated, admin.login_methods.updated, admin.webhook.secret_rolled or admin.issuer.changed. Changes to workspaces, members, API keys and billing are not part of an environment’s audit log. |
Analytics
Section titled “Analytics”The Analytics page counts from what is already in the audit trail and the usage counts; nothing else is collected for it.
Read the analytics
Section titled “Read the analytics”range is 24h, 7d (default), 30d or 90d. The last two need a plan with analytics (Pro and Scale); without it they answer 402 plan_limit. Answers are kept for five minutes.
{ "range": "7d", "bucket": "day", "from": "…", "to": "…", "users": 42, "mau": 17, "totals": { "logins": 3, "failed": 1, "signups": 2, "active_users": 2 }, "previous": { "logins": 1, "failed": 0, "signups": 1, "active_users": 1 }, "series": [{ "t": "…", "logins": 1, "failed": 0, "signups": 1, "active": 1 }], "splits": { "methods": [{ "key": "email_code", "count": 3 }], "countries": [{ "key": "DE", "count": 3 }], "devices": [], "browsers": [], "systems": [], "apps": [{ "key": "…", "name": "Your App", "count": 3 }] }, "advanced": true, "retention_days": null, "ranges": [ { "id": "24h", "locked": false }, { "id": "7d", "locked": false }, { "id": "30d", "locked": false }, { "id": "90d", "locked": false } ]}| Field | Meaning |
|---|---|
bucket |
hour or day: one point of series each, with gaps filled. |
totals, previous |
The counts of this period and of the one before it. |
splits |
Logins by method, country, device, browser, system and app: up to 8 named slices each, and "" for the rest. null without a plan with analytics. |
ranges |
Which ranges the plan allows (locked: true for the others). |
| Status | code |
When |
|---|---|---|
| 400 | bad_request |
“range is 24h, 7d, 30d or 90d” |
| 402 | plan_limit |
30d or 90d without analytics in the plan. |
Read the live view
Section titled “Read the live view”The last five minutes in five-second steps, and who is here now, with nobody named. Needs a plan with analytics (402 otherwise).
{ "now": "…", "step_seconds": 5, "active_now": 2, "points": [{ "t": "…", "logins": 0, "failed": 0, "signups": 0 }], "recent": [ { "at": "…", "event": "login.succeeded", "app": "Your App", "method": "email_code", "country": "DE", "device": "mobile", "browser": "Safari", "system": "iOS" } ]}active_now counts the sessions used in the last six minutes (an app in use renews its token every five minutes with the default lifetimes). points has 60 entries and recent up to 12.