Skip to content

Mark sampling-relevant attributes on RPC spans#3203

Merged
lmolkova merged 2 commits intoopen-telemetry:mainfrom
lmolkova:rpc-sampling
Dec 15, 2025
Merged

Mark sampling-relevant attributes on RPC spans#3203
lmolkova merged 2 commits intoopen-telemetry:mainfrom
lmolkova:rpc-sampling

Conversation

@lmolkova
Copy link
Copy Markdown
Member

Fixes #3202

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR marks sampling-relevant attributes on RPC spans to indicate which attributes should be provided at span creation time for making sampling decisions. The changes address issue #3202 by adding sampling_relevant: true flags in the YAML model for key RPC attributes.

Key changes:

  • Marks rpc.system.name, rpc.method, rpc.service, server.address, and server.port as sampling-relevant in the RPC YAML model
  • Updates documentation to include guidance that these attributes "can be important for making sampling decisions and SHOULD be provided at span creation time"
  • Applies changes consistently across generic RPC, gRPC, Connect RPC, and JSON-RPC span types

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated no comments.

Show a summary per file
File Description
model/rpc/spans.yaml Adds sampling_relevant flags to RPC attributes in the YAML model for various span types
docs/rpc/rpc-spans.md Adds documentation sections listing sampling-relevant attributes for generic RPC client and server spans
docs/rpc/json-rpc.md Adds documentation sections listing sampling-relevant attributes for JSON-RPC client and server spans
docs/rpc/grpc.md Adds documentation sections listing sampling-relevant attributes for gRPC client and server spans
docs/rpc/connect-rpc.md Adds documentation sections listing sampling-relevant attributes for Connect RPC client and server spans
.chloggen/rpc-sampling.yaml Adds changelog entry documenting the enhancement

@lmolkova lmolkova moved this from Untriaged to Awaiting codeowners approval in Semantic Conventions Triage Dec 11, 2025
@lmolkova lmolkova moved this from Awaiting codeowners approval to Needs More Approval in Semantic Conventions Triage Dec 15, 2025
@lmolkova lmolkova added this pull request to the merge queue Dec 15, 2025
Merged via the queue into open-telemetry:main with commit 99f369d Dec 15, 2025
24 checks passed
@lmolkova lmolkova deleted the rpc-sampling branch December 15, 2025 22:10
Cirilla-zmh pushed a commit to Cirilla-zmh/semantic-conventions that referenced this pull request Feb 3, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:rpc enhancement New feature or request

Development

Successfully merging this pull request may close these issues.

RPC: review sampling-relevant attributes

4 participants