Errors and Troubleshooting/Audit

Audit Trail Streaming

Descope allows you to stream audit logs to third-party services like AWS S3 and Datadog using connectors. This enables enhanced storage scalability, improved data resilience, and access to advanced analytics tools.

Audit Streaming with Connectors

Set up connectors to stream your audit trail to third-party services. To view available options, search for audit on the Connectors page in the Descope console.

AWS S3 Example

Configure the Connector

Configure the AWS S3 Connector according to the instructions in the AWS S3 Connector Doc.

Filtering Audit Stream

Within the connector configuration, you can filter audit streams based on Tenants and/or Actions.

This is useful for sending tenant-specific streams to different endpoints or controlling which actions are streamed.

An example of a filtering the audit stream within Descope

Viewing Audit Objects in Amazon S3

After configuring the connector, Descope Audit trails are stored in S3 as JSON objects. These objects are organized by project ID and date. You can open any object to view its details.

An example of directory structure when streaming Descope audit logs to Amazon S3

An example of the date formatted directory structure when streaming Descope audit logs to Amazon S3

Managing Streaming Errors

Error Notifications

When an audit streaming error occurs, Descope displays a toast notification in the console to alert you of the issue. This notification provides quick access to investigate and resolve the problem.

Notification of a streaming error within Descope

Dismissing Error Notifications

If you're not ready to address a streaming error immediately, you can dismiss the toast notification:

  1. When the streaming error notification appears in the console, locate the dismiss button (typically an "X" or close icon)
  2. Click the dismiss button to close the notification
  3. The notification will be removed from view, allowing you to continue working
  4. You can still access the Connectors page later to review and resolve any streaming issues

This allows you to manage your workflow without being interrupted by error notifications while still maintaining the ability to address connector issues when convenient.

Was this helpful?

On this page