feat(exporters): add user-agent enrichment #4560

david-luna · 2025-06-18T12:18:16Z

Changes

Document that exporters may allow a user-agent option to append a product identifier to the exporter User Agent header. such option is only available via local var (not environment)

For non-trivial changes, follow the change proposal process.

Related issues #
Related OTEP(s) #
Links to the prototypes (when adding or changing features)
CHANGELOG.md file updated for non-trivial changes
spec-compliance-matrix.md updated if necessary

specification/protocol/exporter.md

carlosalberto · 2025-06-27T15:43:47Z

Maybe Collector folks should review this too @mx-psi ?

mx-psi · 2025-06-30T08:53:40Z

My understanding is that Collector components are not, as a general rule, bound by the spec. I guess we can add this to our coding guidelines in the Collector as well if it gets approved here to make sure it is followed

…telemetry-specification into enrich-user-agent-header

github-actions · 2025-07-08T03:35:06Z

This PR was marked stale due to lack of activity. It will be closed in 7 days.

trentm · 2025-07-10T14:25:41Z

not stale

david-luna · 2025-07-10T14:42:10Z

@open-telemetry/spec-sponsors sorry for the noise but I do not know exactly who to ping for this review

reyang

LGTM assuming a changelog entry will be added.

github-actions · 2025-07-18T03:42:29Z

This PR was marked stale due to lack of activity. It will be closed in 7 days.

david-luna · 2025-07-22T16:28:45Z

LGTM assuming a changelog entry will be added.

thanks @reyang for your review. Entry has been added in 3af4d2a

david-luna · 2025-07-24T17:21:35Z

Link checking is failing in a file unrelated to this PR https://github.com/open-telemetry/opentelemetry-specification/actions/runs/16450064559/job/46492635216?pr=4560

specification/protocol/exporter.md

Co-authored-by: Trent Mick <trentm@gmail.com>

Co-authored-by: Cijo Thomas <cithomas@microsoft.com>

CHANGELOG.md

Co-authored-by: Riccardo Magliocchetti <riccardo.magliocchetti@gmail.com>

specification/protocol/exporter.md

david-luna · 2025-08-28T14:01:08Z

I think this is good to merge now. @cijothomas do you have permission to merge this? If so, would you mind doing it?

cijothomas · 2025-08-28T15:25:49Z

I think this is good to merge now. @cijothomas do you have permission to merge this? If so, would you mind doing it?

I don't. Only spec-maintainers can merge. After getting enough approvals, they typically wait couple days before merging to see any new comments show up.

(https://github.com/open-telemetry/opentelemetry-specification/blob/main/CONTRIBUTING.md#how-to-get-your-pr-merged)

carlosalberto · 2025-08-29T01:33:14Z

Let's confirm with @dyladan who provided feedback recently ;)

carlosalberto · 2025-09-02T00:13:40Z

Ping @dyladan

JamieDanielson

This seems reasonable to me

### Entities - Specify entity information via an environment variable. ([#4594](#4594)) ### Common - OTLP Exporters may allow devs to prepend a product identifier in `User-Agent` header. ([#4560](#4560)) - ⚠️ **IMPORTANT**: Extending the set of standard attribute value types is no longer a breaking change. ([#4614](#4614)) ### OTEPs - Clarify in Composite Samplers OTEP the unreliable threshold case. ([#4569](#4569)) --------- Co-authored-by: Armin Ruech <7052238+arminru@users.noreply.github.com>

feat(exporters): add user-agent enrichment

4cd0572

david-luna mentioned this pull request Jun 18, 2025

[META 896] Set User-Agent in OTLP exporters elastic/elastic-otel-node#431

Closed

3 tasks

trentm approved these changes Jun 18, 2025

View reviewed changes

Merge branch 'main' into enrich-user-agent-header

85e8cd4

david-luna marked this pull request as ready for review June 23, 2025 14:16

david-luna requested review from a team June 23, 2025 14:16

carlosalberto reviewed Jun 27, 2025

View reviewed changes

specification/protocol/exporter.md Outdated Show resolved Hide resolved

david-luna and others added 4 commits June 30, 2025 20:40

Merge branch 'main' into enrich-user-agent-header

10e3445

chore: be more strict about env vars

d7d96d7

Merge branch 'main' into enrich-user-agent-header

95de585

Merge branch 'enrich-user-agent-header' of github.com:david-luna/open…

aeecfa9

…telemetry-specification into enrich-user-agent-header

david-luna requested a review from carlosalberto June 30, 2025 18:48

github-actions bot added the Stale label Jul 8, 2025

Merge branch 'main' into enrich-user-agent-header

9c7d84e

reyang approved these changes Jul 10, 2025

View reviewed changes

github-actions bot removed the Stale label Jul 11, 2025

github-actions bot added the Stale label Jul 18, 2025

david-luna and others added 2 commits July 22, 2025 18:26

chore: add changelog entry

3af4d2a

Merge branch 'main' into enrich-user-agent-header

2432595

github-actions bot removed the Stale label Jul 23, 2025

carlosalberto approved these changes Jul 23, 2025

View reviewed changes

cijothomas reviewed Aug 20, 2025

View reviewed changes

specification/protocol/exporter.md Show resolved Hide resolved

cijothomas reviewed Aug 20, 2025

View reviewed changes

specification/protocol/exporter.md Show resolved Hide resolved

trentm reviewed Aug 20, 2025

View reviewed changes

specification/protocol/exporter.md Outdated Show resolved Hide resolved

Update specification/protocol/exporter.md

ba49060

Co-authored-by: Trent Mick <trentm@gmail.com>

david-luna requested review from a team as code owners August 21, 2025 08:39

Update CHANGELOG.md

f9eaedb

Co-authored-by: Cijo Thomas <cithomas@microsoft.com>

xrmx reviewed Aug 21, 2025

View reviewed changes

CHANGELOG.md Outdated Show resolved Hide resolved

xrmx approved these changes Aug 21, 2025

View reviewed changes

xrmx mentioned this pull request Aug 21, 2025

Permit to override default OTLP HTTP exporter headers open-telemetry/opentelemetry-python#4634

Merged

11 tasks

Update CHANGELOG.md

9bc7dca

Co-authored-by: Riccardo Magliocchetti <riccardo.magliocchetti@gmail.com>

xrmx reviewed Aug 27, 2025

View reviewed changes

specification/protocol/exporter.md Show resolved Hide resolved

cijothomas approved these changes Aug 27, 2025

View reviewed changes

david-luna and others added 2 commits August 28, 2025 14:42

fix: fix lint issue

abb5c1b

Merge branch 'main' into enrich-user-agent-header

0b53685

cijothomas requested a review from dyladan August 28, 2025 15:27

pichlermarc approved these changes Sep 3, 2025

View reviewed changes

JamieDanielson approved these changes Sep 3, 2025

View reviewed changes

reyang added this pull request to the merge queue Sep 3, 2025

Merged via the queue into open-telemetry:main with commit 4b630d8 Sep 3, 2025
6 checks passed

david-luna deleted the enrich-user-agent-header branch September 3, 2025 15:10

carlosalberto mentioned this pull request Sep 9, 2025

Release 1.49.0 #4654

Merged

Kielek mentioned this pull request Sep 16, 2025

[feature request] OTLPExportert - User-Agent customisation open-telemetry/opentelemetry-dotnet#6496

Open

Copilot AI mentioned this pull request Sep 17, 2025

Add User-Agent customization support to OTLP Exporter via headers open-telemetry/opentelemetry-dotnet#6500

Closed

feat(exporters): add user-agent enrichment #4560

feat(exporters): add user-agent enrichment #4560

Conversation

david-luna commented Jun 18, 2025

Changes

Uh oh!

Uh oh!

carlosalberto commented Jun 27, 2025

Uh oh!

mx-psi commented Jun 30, 2025

Uh oh!

github-actions bot commented Jul 8, 2025

Uh oh!

trentm commented Jul 10, 2025

Uh oh!

david-luna commented Jul 10, 2025

Uh oh!

reyang left a comment

Choose a reason for hiding this comment

Uh oh!

github-actions bot commented Jul 18, 2025

Uh oh!

david-luna commented Jul 22, 2025

Uh oh!

david-luna commented Jul 24, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

david-luna commented Aug 28, 2025

Uh oh!

cijothomas commented Aug 28, 2025

Uh oh!

carlosalberto commented Aug 29, 2025

Uh oh!

carlosalberto commented Sep 2, 2025

Uh oh!

JamieDanielson left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

11 participants