Skip to main content

The Clerk Dashboard provides Application Logs for activity within an instance and Admin Logs, an audit log of administrative changes across your workspace.

LogUse it to investigateExample events
Application LogsAuthentication and user activity within an instanceSign-ins, sign-ups, sessions, user updates, and Organization changes
Admin LogsConfiguration and administrative changes made from the Clerk Dashboard, Backend API, or Platform APIInstance settings, domains, secrets, Roles, Permissions, and integrations

Viewing and filtering logs

Both log pages display a reverse-chronological feed of events. The available filters differ by log type.

You can filter Application Logs by:

  • Event type: Filter by event type (e.g., user.created, sign_in.completed). Supports trailing wildcards (e.g., sign_in.*).
  • Actor: Filter by the user or API key that triggered the event.
  • Subject: Filter by the resource ID being acted upon (e.g., a user ID or Organization ID).
  • IP address: Filter by the IP address the event originated from.
  • Trace ID: Filter by distributed trace ID for correlating events across systems.
  • Device: Filter by device ID.
  • Date range: Set a time window to scope the results.

For a complete list of event types, see Supported events.

You can filter Admin Logs by:

  • Event type: Filter by event type (e.g., oauth_application.updated, domain.created). Supports trailing wildcards (e.g., oauth_application.*).
  • Instance: Filter by the instance the action targeted.
  • Application: Filter by the application the action targeted.
  • Actor: Filter by the actor that triggered the event — a Dashboard user, an instance , or a Platform API access token.
  • IP address: Filter by the IP address the action originated from.
  • Time range: Set a time window to scope the results.

For a complete list of event types, see Supported events.

Log detail view

Select any log entry to view its full details, including:

  • Event metadata: Common fields such as event type, timestamp, actor, and subject. Application Logs also include the event source.
  • Payload: The full event data as a JSON object, containing the state of the resource at the time of the event.

Plans and retention

Availability and log retention depend on your plan. Application Logs are available on all plans, while Admin Logs are available on the Business and Enterprise plans only.

PlanApplication LogsAdmin Logs
Hobby1 dayNot available
Pro7 daysNot available
Business30 days30 days
EnterpriseCustomCustom

Retention periods apply to production and development instances.

Important

Admin Logs record events starting August 24, 2026. Actions taken before this date are not available, regardless of your plan's retention period.

Feedback

What did you think of this content?

Last updated on