--- schema_version: "1" id: d786a1c77d9177dcb77c5b70a30bb72b041f8be68c7a15d6163ee4fd3f3af167 title: Exporting Telemetry Data to Third-Party Monitoring Systems collection: mulesoft version: current locale: en-us portal_url: https://docs.salesforce.com/mulesoft/current/en-us/monitoring/telemetry-exporter.md canonical_url: https://docs.mulesoft.com/monitoring/telemetry-exporter source_site: docs.mulesoft.com content_type: documentation content_hash: 04cd73c1e00103805d96607a2877081f824c97e070b60d618091f6737402c7ea description: Use the MuleSoft Anypoint Monitoring Telemetry Exporter to send Mule app trace data and audit logs to third-party observability platforms like Azure Monitor, Splunk, and OpenTelemetry-compliant tools. latest: true --- --- product: Monitoring description: Use the MuleSoft Anypoint Monitoring Telemetry Exporter to send Mule app trace data and audit logs to third-party observability platforms like Azure Monitor, Splunk, and OpenTelemetry-compliant tools. keywords: MuleSoft, Anypoint Monitoring, Telemetry Exporter, OpenTelemetry, OTEL, Splunk, Azure Monitor, third-party observability, trace export, audit logs --- # Exporting Telemetry Data to Third-Party Monitoring Systems > For the full documentation index, see: https://docs.mulesoft.com/llms.txt [![](/mulesoft/current/en-us/_/img/icons/info.svg)](/monitoring/#billing) Use the Anypoint Monitoring Telemetry Exporter to send Mule app trace data and [audit logs](https://docs.mulesoft.com/access-management/audit-logging) to third-party observability platforms like Azure Monitor, Splunk HEC, and OpenTelemetry-compliant tools. To use the Telemetry Exporter, you must: - Create a connection by providing a third-party observability platform credential that authorizes Anypoint Platform to share data with the observability platform. See also, [Supported Third-Party Monitoring Products](#third-party-support). - Create a configuration that specifies the type of data Anypoint Platform exports and which business group and environment allows content to be exported to the connections that you configure. You can also edit and delete connections and configurations. > [!NOTE] Telemetry Exporter checks for changes to connections and configurations on an hourly > basis. When you create or modify a connection or configuration, there might be a delay in applying > your new settings. When exported, audit logs have a unique ID in the `mulesoft.audit.id` attribute. In usual operations, each log is delivered only once, but under certain circumstances, some logs are delivered more than once. Duplicate log entries always share the unique `mulesoft.audit.id` attribute, so this attribute can be used to safely block or remove duplicate logs from the target system. ## Supported Third-Party Monitoring Products The Telemetry Exporter enables you to create connections to most third-party observability and analytics platforms that: - Have OpenTelemetry-supported endpoints. For example, the endpoint URL for New Relic is `[https://otlp.nr-data.net:4318](https://otlp.nr-data.net:4318)`. Your team must set up endpoints for the monitoring platform you use. - Allow you to create an instrumentation key or access token. Azure Monitor and Splunk HEC are also compatible. ## Before You Begin Before you configure the Telemetry Exporter, ensure that you have: - Permissions that you require for your uses of Telemetry Exporter (see [Managing Permissions for Anypoint Monitoring](https://docs.mulesoft.com/monitoring/am-permissions)) - **Telemetry Exporter Administrator** permission for creating and modifying connections - **Telemetry Exporter Configurations Manager** permission for creating and modifying configurations - Access information for your third-party observability platform - The ability to create an instrumentation key or access token for your third-party observability platform. - Enabled trace data collection for your Mule apps: - For CloudHub 2.0 deployments, see [shared](https://docs.mulesoft.com/cloudhub-2/ch2-deploy-shared-space#enable-trace-data-collection) and [private spaces](https://docs.mulesoft.com/cloudhub-2/ch2-deploy-private-space#enable-trace-data-collection). - For Runtime Fabric deployments, see [Runtime Fabric](https://docs.mulesoft.com/runtime-fabric/latest/use-anypoint-monitoring#enable-trace-data). - An endpoint for telemetry data that is accessible from across the internet (CIDR `0.0.0.0/0`) if your observability provider or your organization’s endpoint requires an IP allowlist or firewall rule Consult your organization’s security guidelines when configuring open access rules for this endpoint. Telemetry Exporter generates its Internet Protocol (IP) address dynamically, which prevents allowlisting specific IPs, URLs, domains. ## Access Telemetry Exporter 1. Log in to Anypoint Platform using an account that has the Telemetry Exporter Administrator or Telemetry Exporter Configurations Manager permission. 2. Navigate to Anypoint Monitoring: Click **Monitoring** from the Anypoint Platform home page or from the **Runtimes** menu in the header. 3. Click **Telemetry Exporter**. To use create, view, edit, and delete connections and configurations for telemetry data exports, see [Manage a Connection](#manage-connections) and [Manage Configurations](#manage-configurations). ## Manage a Connection Anypoint Platform needs permission to send data to third-party observability platforms. Create a connection with a third-party platform, such as New Relic or Splunk, to authorize data transfers. You can configure up to 10 connections. Telemetry Exporter checks for changes to connections and configurations on an hourly basis. When you create or modify a connection or configuration, there might be a delay in applying your new settings. ### Create a Connection 1. Log in to Anypoint Platform using an account that has the Telemetry Exporter Administrator permission. 2. Navigate to Anypoint Monitoring: Click **Monitoring** from the Anypoint Platform home page or from the **Runtimes** menu in the header. 3. Click **Telemetry Exporter**. 4. Click the **Connections** tab. 5. Click **New Connection**. 6. On the **Connection Details** page, enter the following information: - **Connection Name**: Name for your connection, using only alphanumeric characters and hyphens. - **Destination Type**: Third-party observability platform to which you want to transfer data. - **Endpoint URL**: Endpoint that enables external connections to your third-party observability platform (see [Supported Third-Party Monitoring Products](#third-party-support)). Some platforms, such as DataDog and Splunk Observability Cloud, require an OpenTelemetry collector endpoint that is enabled to translate the OpenTelemetry standard to DataDog formats. 7. Click **Next**. 8. On the **Authentication** page, enter the information needed to authenticate your connection to the observability platform. Some platforms require only access tokens, while others also require a header key. 9. Click **Test Connection** to ensure that Anypoint Platform can connect to your third-party observability platform. 10. Click **Save Connection**. The new connection appears in the **Connections** tab on the **Telemetry Exporter** page. ### Edit a Connection 1. Log in to Anypoint Platform using an account that has the Telemetry Exporter Administrator permission. 2. Navigate to Anypoint Monitoring: Click **Monitoring** from the Anypoint Platform home page or from the **Runtimes** menu in the header. 3. Click **Telemetry Exporter**. 4. Click the **Connections** tab. 5. Next to the connection you want to edit, click **…​** and select **Edit Connection**. 6. On the **Connection Details** page, edit each field you want to change and click **Next**. 7. On the **Authentication** page, edit each field you want to change and click **Test Connection**. 8. If the connection is successful, click **Save Connection**. ### Delete a Connection 1. Log in to Anypoint Platform using an account that has the Telemetry Exporter Administrator permission. 2. Navigate to Anypoint Monitoring: Click **Monitoring** from the Anypoint Platform home page or from the **Runtimes** menu in the header. 3. Click **Telemetry Exporter**. 4. Next to the connection you want to delete, click **…​** and select **Delete Connection**. 5. A warning appears: - If the connection is not in use, the warning asks whether to delete the connection. Click **Delete Connection**. - If the connection is in use, the warning states that you must delete or redirect connections for any configurations that use the connection. Click **Dismiss**, and then [edit your configurations](#edit-configuration) to use other existing connections before deleting the current connection. ## Manage Configurations After you create a connection to your third-party observability platform, you must create a configuration to specify the scope of the data to send to the platform. When you create a new configuration, specify a data type, business group, environment type (traces only), and destination. You can export traces and audit logs from all of your business groups or a specific business group. Telemetry Exporter checks for changes to connections and configurations on an hourly basis. When you create or modify a connection or configuration, there might be a delay in applying your new settings. ### Create a Configuration 1. Log in to Anypoint Platform using an account that has the Telemetry Exporter Configurations Manager permission. 2. Navigate to Anypoint Monitoring: Click **Monitoring** from the Anypoint Platform home page or from the **Runtimes** menu in the header. 3. Click **Telemetry Exporter**. 4. Click **New Configuration**. 5. On the **General Information** page, enter the following information: - **Configuration Name**: Name for your configuration that uses only alphanumeric characters. - **Connection**: Existing connection that you configured. - **Data Type**: Audit logs or trace data 6. Click **Next**. 7. In the **Select Business Group** section, select one of the following: - **All business groups**: Audit logs are sourced from all business groups in the organization. - **Select a business group**: Data of the type you specified is sourced only from the selected business group. 8. Click **Next**. 9. If you selected trace data as the data type, select the environment type: - Production - Sandbox - Design 10. Click **Save Configuration**. ### Edit Configurations When you edit configurations, you can change the configuration name and connection. If you want to modify the data type business group or environment type, you must create a new configuration. 1. Log in to Anypoint Platform using an account that has the Telemetry Exporter Configurations Manager permission. 2. Navigate to Anypoint Monitoring: Click **Monitoring** from the Anypoint Platform home page or from the **Runtimes** menu in the header. 3. Click **Telemetry Exporter**. 4. Next to the configuration you want to edit, click **…​** and select **Edit Configuration**. 5. On the **General Information** page, edit each field you want to change and click **Next**. 6. On the **Business Group & Environment Type** page, **Next**. 7. Click **Save Configuration**. ### Delete Configurations 1. Log in to Anypoint Platform using an account that has the Telemetry Exporter Configurations Manager permission. 2. Navigate to Anypoint Monitoring: Click **Monitoring** from the Anypoint Platform home page or from the **Runtimes** menu in the header. 3. Click **Telemetry Exporter**. 4. Next to the configuration you want to delete, click **…​** and select **Delete Connection**. A warning appears that confirms whether you want to delete the configuration. 5. Click **Delete Configuration**. ## Errors If you receive this error, ensure that your endpoint supports OpenTelemetry: Error : validating connection request. Please check your request and try again See [Supported Third-Party Monitoring Products](#third-party-support). ## Known Issues For known issues, limitations, and data differences for Telemetry Exporter, see [Telemetry Exporter Known Issues (FAQ)](https://docs.mulesoft.com/monitoring/am-faq#telemetry-exporter-known-issues).