Open Telemetry Connector
This guide explains how to implement Descope's Open Telemetry connector. Open Telemetry is an observability framework for instrumenting, generating, collecting, and exporting telemetry data.
Descope enables you to automatically collect authentication logs and audit events and forward them to your Open Telemetry Collector instance for centralized analysis and monitoring.
Configure Open Telemetry Connector
Navigate to the Connectors page in the Descope Console and select OpenTelemetry to create a new Open Telemetry connector.
The following parameters are required:
- Connector Name: Provide a unique name for your connector. This helps distinguish it, especially when multiple connectors are derived from the same template.
- Connector Description: Briefly explain the purpose of this connector (optional).
- Collector Endpoint: The endpoint URL of your Open Telemetry Collector instance.
- Protocol: The protocol to use when sending data to your Open Telemetry Collector (e.g., HTTP, gRPC).
- Authentication Type: Choose the authentication method required by your Open Telemetry Collector (if any).
- Request Headers: Specify any additional headers required for authentication or configuration when sending data to your Open Telemetry Collector.
- Trust Any Certificate: Enable this option if your Open Telemetry Collector uses a self-signed certificate.
- Stream Audit Events: Select which events are sent to Open Telemetry. You can allow all audit events or filter them based on specific actions or tenants in the project.
- Stream Troubleshooting Events: Decide whether troubleshooting events are also sent to Open Telemetry.
Configuring Your Open Telemetry Collector
In your OpenTelemetry setup, ensure that the Collector is properly configured to receive logs and events from Descope.
Here is an example of an OpenTelemetry Collector client using the OTLP exporter in a Node.js environment:
Optionally, specify the appropriate endpoint and authentication details in your Open Telemetry configuration file or interface.
Viewing Audit Logs
Audit logs are now viewable in Open Telemetry. You can test the connector during configuration to ensure logs are being sent and collected properly.
This span represents the handling of an HTTP request to /v1/logs
inside an Express.js application. It was captured by OpenTelemetry’s Express instrumentation, tied to a larger trace, executed on a Node.js process, and finished successfully in ~3 milliseconds:
The logs can still be viewed in Descope under the Audit and Troubleshoot section of the Descope Console.