Repository navigation
RFC 0060: Add gen_ai.tool.source.* and gen_ai.usage.cache_*.input_tokens - #2711
Merged
trisch-me merged 7 commits intoNov 5, 2026
Conversation
Contributor
🤖 GitHub commentsJust comment with:
|
Contributor
Author
|
Tracking issue: #2712 |
angelosoliveira
marked this pull request as ready for review
October 28, 2026 16:52
Per review, these fields have no OTel definition yet, so leave the mapping out instead of declaring relation: na, which is for fields that will never be in semconv.
taylor-swanson
left a comment
Contributor
There was a problem hiding this comment.
Overall seems reasonable to me. I'll let @trisch-me comment on anything OTel-related, if necessary.
trisch-me
reviewed
Nov 3, 2026
trisch-me
reviewed
Nov 3, 2026
trisch-me
reviewed
Nov 3, 2026
trisch-me
reviewed
Nov 3, 2026
trisch-me
reviewed
Nov 3, 2026
trisch-me
reviewed
Nov 3, 2026
trisch-me
left a comment
Contributor
There was a problem hiding this comment.
left some comments, needs to be addressed.
Define the tool.source.type values (including inline) and add examples to the field descriptions and a table, compare gen_ai.tool.type with gen_ai.tool.source.type, and remove the OTel 'related' relation from tool.source.address together with the server.* concern that justified it.
trisch-me
reviewed
Nov 5, 2026
trisch-me
approved these changes
Nov 5, 2026
5 tasks done
trisch-me
added a commit
that referenced
this pull request
Nov 12, 2026
…ut_tokens (#2713) * feat(otel): align ECS with OTel semconv 1.44.0 - Bump otel-semconv-version to v1.44.0 and update USAGE.md examples. - Support the `definition/2` model format in the OTel generator. - Load GenAI attributes from open-telemetry/semantic-conventions-genai, as they were deprecated in the main semconv repo. - Remove the OTel mapping of `gen_ai.token.type`, dropped upstream. - Add `match` mappings for `user_agent.os.name` and `user_agent.os.version`. - Add `equivalent` mappings for `process.start`, `process.end`, `process.exit_code`, `process.parent.pid` and `event.original`, and a `related` mapping for `process.name`. - Regenerate artifacts and docs. Relates to #2708 Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> * docs: use PR number in changelog entry Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> * docs: address Vale warnings in event.original description Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> * Implement RFC 0060: gen_ai.tool.source.* and gen_ai.usage.cache_*.input_tokens Apply field definitions from RFC 0060 to schemas/gen_ai.yml, regenerate all artifacts, and add changelog entry. Ref: #2711 Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> --------- Co-authored-by: Claude Sonnet 5.5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Proposal RFC to add five fields to the existing
gen_aifieldset (target maturity: beta):gen_ai.tool.source.name,gen_ai.tool.source.type,gen_ai.tool.source.address: where a tool came from (MCP server, gateway target, registry, request-defined). Needed to detect look-alike tools and changed tool definitions (OWASP ASI02).gen_ai.usage.cache_read.input_tokens,gen_ai.usage.cache_write.input_tokens: match the OTel GenAI attributes of the same name, and are already logged by Bedrock and the OpenAI Responses API.This is a documentation-only Proposal PR per rfcs/PROCESS.md: rationale, field YAML and example events. Schema application to
schemas/gen_ai.ymlfollows after acceptance.Changes
rfcs/text/0060-gen_ai-tool-source-and-cache-tokens.mdrfcs/text/0060/gen_ai.yamlWhy
gen_ai.tool.*identifies a tool by name only, so two tools with the same or similar name from different sources cannot be told apart, and a changed definition cannot be told from a re-advertised one. The cache token fields close a gap between ECS and OTel for data that providers already emit. Tracked in the GenAI detections epic: elastic/integrations#20737.Test plan
schemas/gen_ai.yml(or rely on post-merge automation when available)Related
gen_ai.conversation.id), Fix GenAI numbers datatype #2646 (GenAI numbers datatype)