Troubleshooting the Elastic OTel SDKs

Find solutions to common issues with Elastic OTel SDKs for various programming languages and platforms.

• Android SDK: Troubleshoot common problems affecting the Elastic Distribution of OpenTelemetry Android SDK.

• Browser SDK: Troubleshoot common problems affecting the Elastic OTel Browser SDK.

• .NET SDK: Troubleshoot common problems affecting the Elastic OTel .NET SDK.

• iOS SDK: Troubleshoot common problems affecting the Elastic Distribution of OpenTelemetry iOS agent.

• Java SDK: Troubleshoot common problems affecting the Elastic OTel Java agent, including connectivity, agent identification, and debugging.

• Node.js SDK: Troubleshoot issues using Elastic OTel Node.js SDK.

• PHP SDK: Troubleshoot issues using Elastic OTel PHP agent.

• Python SDK: Troubleshoot issues using Elastic OTel Python agent.

These guides apply to all Elastic OTel SDKs:

• Enable debug logging: Learn how to enable debug logging for Elastic OTel SDKs to troubleshoot application-level instrumentation issues.

• No application-level telemetry visible in Kibana: Diagnose lack of telemetry flow due to issues with Elastic OTel SDKs.

• Proxy settings for Elastic OTel SDKs: Configure proxy settings for Elastic OTel SDKs when your application runs behind a proxy.

• Missing or incomplete traces due to SDK sampling: Troubleshoot missing or incomplete traces caused by SDK-level sampling configuration.

• Troubleshoot trace context header propagation: Troubleshoot missing or broken distributed traces when combining OpenTelemetry instrumentation with Elastic APM agents.

Elastic OTel SDKs are tested and supported only with Elastic Agent Gateway or Managed OTel intake. Using Elastic OTel SDKs directly with APM Server's OTel intake is not supported.

• Elastic Agent troubleshooting: For end-to-end issues that may involve both the Collector and SDKs.

• Troubleshoot Elastic OpenTelemetry: Overview of all Elastic OpenTelemetry troubleshooting resources.