Skip to content

Clarify what language agents should use for identity#310

Closed
breedx-splk wants to merge 2 commits intoopen-telemetry:mainfrom
breedx-splk:language_instrumentation_identity
Closed

Clarify what language agents should use for identity#310
breedx-splk wants to merge 2 commits intoopen-telemetry:mainfrom
breedx-splk:language_instrumentation_identity

Conversation

@breedx-splk
Copy link
Copy Markdown
Contributor

The original opamp spec was written with the Collector at top of mind.

There is increasing interest in using OpAMP to manage or re/configure certain aspects of language agents at runtime. This PR adds some clarification about how language instrumentation agents should handle identity and non-identity attributes in OpAMP...effectively just passing along the Resource and nothing more.

@aunshc
Copy link
Copy Markdown

aunshc commented Apr 7, 2026

Raised this topic at the SIG, the recommendation from the maintainers was to keep the spec generic and create a supplemental document for agent (eg. language instrumentation) specific aspects. @tigrannajaryan @andykellr we'd probably want to move the existing standalone section in context to the Collector out as well in that case?

Comment thread specification.md

###### Language Instrumentation Agents

Instrumentation agents use an OpenTelemetry SDK instance which includes a
Copy link
Copy Markdown

@RassK RassK Apr 7, 2026

Choose a reason for hiding this comment

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

why not also filter service.name, service.namespace, service.version, service.instance.id to identifying_attributes and everything else to nonidentifying_attributes ?

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Comment thread specification.md

For standalone running Agents (such as OpenTelemetry Collector) the following
attributes SHOULD be specified:
###### Standalone Agents
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.

@breedx-splk let's move this section and the new "Language Instrumentation Agents" section to a separate document. We can call it something like opentelemetry-guidelines.md and it will contain all considerations that are specific to Otel agents. The specification.md will contain generic protocol specification, which is 99% of the content right now (the only exception is this paragraph, so let's move it out).

@breedx-splk
Copy link
Copy Markdown
Contributor Author

💨

@breedx-splk breedx-splk closed this Apr 7, 2026
tigrannajaryan pushed a commit that referenced this pull request Apr 23, 2026
This follows #310.

It creates a new document instead of polluting the general high level OpAMP spec with tedious details about actual behavior.
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.

4 participants