Troubleshoot Elastic OpenTelemetry

Find solutions to common issues in Elastic OpenTelemetry components and SDKs.

Component troubleshooting

Elastic Agent troubleshooting: Troubleshoot issues with the Elastic Agent, including resource problems, configuration errors, and connectivity issues.
Elastic OTel SDKs troubleshooting: Troubleshoot issues with Elastic OTel SDKs for Android, .NET, iOS, Java, Node.js, PHP, and Python.

Common troubleshooting topics

These guides apply to both the Collector and SDKs:

Connectivity issues: Resolve connection problems between Elastic OpenTelemetry components and Elastic, including firewall, proxy, and network configuration issues.
No data visible in Kibana: Diagnose why telemetry data (logs, metrics, traces) doesn't appear in Kibana after setting up Elastic OpenTelemetry.
429 errors when using the mOTLP endpoint: Resolve HTTP 429 Too Many Requests errors when sending data through the Elastic Cloud Managed OTLP endpoint.
Contact support: Learn how to contact Elastic Support and what information to include to help resolve issues faster.

Supported architectures

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.

Additional resources

Troubleshoot ingestion tools: Overview of troubleshooting for all ingestion tools, including Elastic OpenTelemetry, Logstash, Fleet, and Beats.
Elastic Support Portal: Access support cases, subscriptions, and licenses.
Elastic community forums: Get answers from experts in the community, including Elastic team members.