Skip to content

Define configurable SDK component names - #5300

Open
cijothomas wants to merge 7 commits into
open-telemetry:mainfrom
cijothomas:cijothomas/component-name-self-observability
Open

cijothomas wants to merge 7 commits into
open-telemetry:mainfrom
cijothomas:cijothomas/component-name-self-observability

Conversation

@cijothomas

@cijothomas cijothomas commented Sep 4, 2026 •

Copy link
Copy Markdown
Member

Fixes #5298

Changes

Define optional names that uniquely identify SDK components within their containing SDK instance.

Component names may be used by configuration and management mechanisms. When a named component emits self-observability telemetry, it uses the application-provided value as otel.component.name. If no name is configured, it automatically assigns a name satisfying the otel.component.name semantic convention.

This preserves automatic naming for applications that do not configure a name while allowing future mechanisms to refer to individual component instances.

Related changes

Together, these changes define configurable SDK component names, their fallback naming convention, and declarative configuration support.

@opentelemetry-pr-dashboard

opentelemetry-pr-dashboard Bot commented Sep 4, 2026 •

Copy link
Copy Markdown

Pull request dashboard status

Waiting on the author · refreshed 2026-10-01 18:11 UTC

Respond to 2 review items (e.g. link a commit, explain why not, ask a follow-up):

  • Inline threads: 1, 2
Status above doesn't look right?
  • Just replied or pushed? Anything around or after the refresh time above may not be picked up yet — give it a few minutes.
  • Should this be with reviewers? Comment /dashboard route:reviewers to route it to them.
  • Anything wrong — including the routing? Report it with what you expected; it helps us improve the dashboard.

@cijothomas
cijothomas force-pushed the cijothomas/component-name-self-observability branch from 24b9a98 to 78a898c Compare September 12, 2026 17:13
@cijothomas
cijothomas marked this pull request as ready for review September 22, 2026 15:25
@cijothomas
cijothomas requested a review from a team as a code owner September 22, 2026 15:25
Comment on lines +15 to +17
SDK components MAY allow users to configure an optional name. Users SHOULD
choose a name that uniquely identifies the component within its containing SDK
instance.

@pellared pellared Oct 1, 2026 •

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Users SHOULD choose a name

We cannot ensure what users are going to do. We can do something like this instead

If such configuration exists, then it MUST be documented that users should choose...

outlines the mechanisms by which OpenTelemetry components can be configured. It
does not attempt to specify the details of what can be configured.

## SDK component names

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should we mark this section as in development?

Suggested change
## SDK component names
## SDK component names
**Status**: [Development](../document-status.md)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Allow applications to assign names to SDK components

6 participants