System Log

The Okta System Log records system events that are related to your organization in order to provide an audit trail that can be used to understand platform activity and to diagnose problems.

The System Log API provides near real-time, read-only access to your organization's System Log and is the programmatic counterpart of the System Log UI.

The terms "event" and "log event" are often used interchangeably. In the context of this API, an "event" is an occurrence of interest within the system, and a "log" or "log event" is the recorded fact.

The System Log API supports these primary use cases:

• Event data export into a security information and event management system (SIEM)
• System monitoring
• Development debugging
• Event introspection and audit

Note: Some of the curl code examples on this page include SSWS API token authentication. However, Okta recommends using scoped OAuth 2.0 and OIDC access tokens to authenticate with Okta management APIs. OAuth 2.0 and OIDC access tokens provide fine-grain control over the bearer's actions on specific endpoints. See Okta API authentication methods.

For further details and examples, see System Log query.