Edit

Share via

Troubleshoot OpenTelemetry issues in Spring Boot native image applications

  • Article

This article discusses how to troubleshoot OpenTelemetry issues in Spring Boot native image applications.

Step 1: Verify the OpenTelemetry version

You might notice the following message during the application startup:

WARN  c.a.m.a.s.OpenTelemetryVersionCheckRunner - The OpenTelemetry version is not compatible with the spring-cloud-azure-starter-monitor dependency.
The OpenTelemetry version should be <version>

In this case, you have to import the OpenTelemetry Bills of Materials by following the OpenTelemetry documentation in the Spring Boot starter.

Step 2: Enable self-diagnostics

If something doesn't work as expected, you can enable self-diagnostics at the DEBUG level to get some insights. To do so, set the self-diagnostics level to ERROR, WARN, INFO, DEBUG, or TRACE by using the APPLICATIONINSIGHTS_SELF_DIAGNOSTICS_LEVEL environment variable.

To enable self-diagnostics at the DEBUG level when running a docker container, run the following command:

docker run -e APPLICATIONINSIGHTS_SELF_DIAGNOSTICS_LEVEL=DEBUG <image-name>

Note

Replace <image-name> with the docker image name accordingly.

Third-party information disclaimer

The third-party products that this article discusses are manufactured by companies that are independent of Microsoft. Microsoft makes no warranty, implied or otherwise, about the performance or reliability of these products.

Contact us for help

If you have questions or need help, create a support request, or ask Azure community support. You can also submit product feedback to Azure feedback community.