open-telemetry / open-telemetry/opentelemetry-java-instrumentation

Audit experimental-span-attributes configuration before 3.0

Open
#20,125 0 comments 0 reactions 1 assignee View on GitHub

@trask is already working on this.

Since Sep 12, 2026.

enhancement needs triage
Dominant language
Java
Stars
2.6k
Forks
1.2k
Avg merge
2d 18h
Merged PRs (30d)
228

Description

Is your feature request related to a problem? Please describe.

Thirty module-specific experimental-span-attributes properties remain. The name implies span-only behavior even though Instrumenter attributes can also reach metric operation listeners, and the agent knowledge articles do not explain when to use this pattern versus emit-experimental-telemetry.

Describe the solution you'd like

Before 3.0, audit these properties and migrate multi-signal umbrella switches to emit-experimental-telemetry with compatibility aliases where appropriate. Update the agent knowledge articles with the naming decision and keep semantic-convention selection separate.

Describe alternatives you've considered

Only document the existing names. This avoids migration work but preserves misleading configuration names.

Additional context

#19822 highlighted the ambiguity while reusing RabbitMQ's existing experimental attribute setting.

Tip

React with 👍 to help prioritize this issue. Please use comments to provide useful context, avoiding +1 or me too, to help us triage it. Learn more here.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.