docs(java): Document OpenTelemetry BOM alignment#18647
Draft
adinauer wants to merge 1 commit into
Draft
Conversation
Add setup guidance for the Sentry OpenTelemetry BOM on agentless and OTLP pages, including Gradle and Maven usage for Spring dependency management. Add an OpenTelemetry troubleshooting page that points users from classpath mismatch symptoms to the BOM alignment docs. Co-Authored-By: Claude <noreply@anthropic.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
1 Skipped Deployment
|
lbloder
reviewed
Jul 7, 2026
| } | ||
| ``` | ||
|
|
||
| When using Maven, import Sentry's OpenTelemetry BOM before `spring-boot-dependencies`: |
Collaborator
There was a problem hiding this comment.
Should gradle and maven be tabs like for the java view or do we want to have them split due to the additional info outside of snippet?
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Document the new
io.sentry:sentry-opentelemetry-bomfor Java OpenTelemetry agentless and OTLP setups.Sentry's OpenTelemetry integrations rely on a compatible OpenTelemetry core, instrumentation, and incubator dependency set. Spring Boot dependency management, Maven BOM imports, or other build-level dependency management can downgrade part of that set and leave users with classpath errors. These docs show how to opt in to Sentry's OpenTelemetry BOM without adding that behavior to Java agent setup pages.
The new troubleshooting page gives users a place to start when they hit OpenTelemetry classpath errors and links back to the BOM setup guidance for the relevant integration.
This should land with the sentry-java change that publishes
sentry-opentelemetry-bom.