feat(semconv): update dependency open-telemetry/semantic-conventions to v1.41.1#2139
Open
renovate[bot] wants to merge 1 commit into
Open
feat(semconv): update dependency open-telemetry/semantic-conventions to v1.41.1#2139renovate[bot] wants to merge 1 commit into
renovate[bot] wants to merge 1 commit into
Conversation
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.
This PR contains the following updates:
1.37.0→1.41.1Warning
Some dependencies could not be looked up. Check the Dependency Dashboard for more information.
Release Notes
open-telemetry/semantic-conventions (open-telemetry/semantic-conventions)
v1.41.1Compare Source
What's Changed
k8s.container.cpu.limit_utilizationandk8s.container.cpu.request_utilizationmetrics from code generation (#3711)Full Changelog: open-telemetry/semantic-conventions@v1.41.0...v1.41.1
v1.41.0Compare Source
🛑 Breaking changes 🛑
gen-ai: Execute tool call requires the name of the tool used for span naming. (#3595)graphql: Changegraphql.documentattribute requirement level from Recommended to Opt-In due to sensitive data, cardinality, and size concerns (#2985)The
graphql.documentattribute contains user-inputted data that is often sensitive,potentially unbounded in length, and high-cardinality. Moving from Recommended to Opt-In
ensures operators make an informed decision before enabling this attribute.
Also updated the note to use SHOULD for stronger normative language regarding sanitization.
process: Move process.executable to its own entity. (#3535)process: Update requirement levels for process attributes to ensure consistent identification and description across platforms. (#864)process.pidandprocess.creation.timeto beRequired(Identity).Optional.rpc: Removeclient.addressandclient.portattributes from RPC server spans. (#3487, #3488)💡 Enhancements 💡
Go: Add opt-in go.memory.gc.pause.duration histogram metric. (#3353)cicd: Clarify thatcicd.pipeline.task.run.idmust be unique within a pipeline run. (#3566)This id may be used for correlating results of a task across several pipeline runs.
configuration: Defined declarative configuration for semantic convention version selection. (#3424)configuration: Clarify that theexperimentalflag should not be used to gate incomplete implementations of stable convention versions. (#3505)db: Includedb.system.namevalue changes in database migration guide. (#3557)db: Clarifydb.response.returned_rowswhen captured on spans. (#3480)db: Clarify database client span duration. (#3479)deployment: Stabilizedeployment.environment.nameattribute. (#3339)The
deployment.environment.nameattribute is promoted from development to stable.deployment: Add enum values fordeployment.environment.nameattribute. (#2910)The
deployment.environment.nameattribute now has well-known enum values: Production, Staging, Test, and Development.exception: Improve exception event definition: add guidance on how to set event name and severity.(#3311)
exceptions: Add guidance thaterror.typeandexception.typemay unwrap uninformative wrapper types. (#3588, #3623)faas: Define domain-specific exception event for FaaS invocations (#3451)This domain-specific exception event provides a structured way to record
exceptions that occur during FaaS function invocations:
faas.invocation.exceptionfor exceptions during function executiongen-ai: Enhance the definition ofgen_ai.tool.definitionsattribute. (#2721, #1835)The schema of
gen_ai.tool.definitionsattribute is now enhanced to:gen_ai.tool.definitionsattribute.gen-ai: Addgen_ai.usage.reasoning.output_tokensattribute for reasoning tokens (#3194)gen_ai.usage.reasoning.output_tokensfor tokens used for reasoninggen-ai: Definegen_ai.client.operation.exceptionevent for recording exceptions during Generative AI client operations (#3436)This domain-specific exception event provides a structured way to record
exceptions that occur during Generative AI client operations (API errors,
rate limiting, timeouts).
gen-ai: Add invoke workflow operation name support to the gen-ai semantic conventions. (#2912)gen-ai: Addgen_ai.client.operation.time_to_first_chunkandgen_ai.client.operation.time_per_output_chunkmetrics. (#3113)gen_ai.client.operation.time_to_first_chunkmetric to track time from client request to first chunk of response.gen_ai.client.operation.time_per_output_chunkmetric to track time per output chunk of response.gen-ai: Splitinvoke_agentinto separate client and internal spans, and split attributes from inference hierarchy. (#2632)The
invoke_agentclient span now extends a dedicatedattributes.gen_ai.invoke_agent.clientattribute group instead of
attributes.gen_ai.inference.client. This removesgen_ai.response.id,gen_ai.response.model, andgen_ai.response.finish_reasonsand adds
gen_ai.agent.version.A new
invoke_agentinternal span is added for in-process agents (e.g., LangChain, CrewAI),which does not include
server.address,server.port, or token usage attributes.gen-ai: Addedgen_ai.response.modelattribute to embeddings spans. (#3499)gen_ai: Add streaming attributes for GenAI inference spans (#3598)Adds
gen_ai.request.stream(boolean) andgen_ai.response.time_to_first_chunk(double)attributes for streaming inference operations.
go: Add the go.cpu.time opt-in metric, and add go.cpu.detailed_state and go.memory.detailed_type attributes to CPU and memory metrics respectively with wildcard values. (#3354)go: Add the opt-in go.memory.gc.cycles metric. (#3353)http: Clarify that intentional client-side cancellation of HTTP requests SHOULD NOT be treated as an error. (#3495)k8s: Add PersistentVolume and PersistentVolumeClaim entities with phase and storage metrics. (#3375)Entities:
k8s.persistentvolumek8s.persistentvolumeclaimMetrics:
k8s.persistentvolume.status.phase,k8s.persistentvolume.storage.capacityk8s.persistentvolumeclaim.status.phase,k8s.persistentvolumeclaim.storage.request,k8s.persistentvolumeclaim.storage.capacityk8s: Update CPU metrics for container CPU limit and request to handle resize. (#3558)Introduced new metrics for container CPU limit and request that account for
KEP 1287 allowing for in-place updates of container resources.
k8s: Promote a selection of k8s/container attributes to release_candidate (#3491, #3380)k8s: Split container memory limit/request into desired/current to handle in-place resize (#3558)Introduced new metrics for container memory limit and request that account for
KEP 1287 allowing for in-place updates of container resources.
k8s: Addk8s.node.system_container.*metrics to capture node-level system daemon metrics. (#3531)messaging: Define domain-specific exception events for messaging (#3435)These domain-specific exception events provide a structured way to record
exceptions that occur during messaging operations:
messaging.create.exceptionfor messaging create operationsmessaging.send.exceptionfor messaging send operationsmessaging.receive.exceptionfor messaging receive operationsmessaging.settle.exceptionfor messaging settle operationsmessaging.process.exceptionfor messaging process operationsotel: Stabilize theotel.event.nameattribute. (#2913)process: Added specific requirement levels to all attribute refs within process metrics. (#864)process: Update process.executable.build_id.htlhash description to be generic (#3563)system: Add Linux HugePages system memory metrics. (#3362)telemetry: Promotetelemetry.distro.nameandtelemetry.distro.versionattributes to 'stable'. (#3650)The
telemetry.distro.nameandtelemetry.distro.versionattributes and thetelemetry.distroentity are promoted from development to stable.v8js: Addv8js.resource.activegauge for tracking resources that keep the event loop active. (#3445)v1.40.0Compare Source
🛑 Breaking changes 🛑
db: Oracle'sdb.namespaceupdated to represent only the database’sunique identifier. Information previously bundled into
db.namespace—includingPDB name, instance name, and service name — has been moved to dedicated attributes:
oracle.db.pdb,oracle.db.instance.name, andoracle.db.service.Introduced a new
oracle.db.domainattribute to capture the database domain(DB_DOMAIN).
(#2147)
error, feature-flags: Deprecateerror.messagein favor of using domain-specific codes such asfeature_flag.error.message.(#3307, #3308)
rpc: Removenetwork.protocol.name,network.protocol.version, andnetwork.transportattributes from RPC spans and metrics.(#3349, #3350)
system: Renamesystem.memory.sharedtosystem.memory.linux.shared(#3260)The
system.memory.sharedmetric has been renamed tosystem.memory.linux.sharedto align with other Linux-specific memory metrics (system.memory.linux.availableandsystem.memory.linux.slab.usage). This metric reports shared memory used, primarily by tmpfs, and is only available on Linux systems.🚩 Deprecations 🚩
exceptions: Update exception recording guidelines to not use span events. (#3256)rpc: Deprecate experimentalrpc.server.request.size,rpc.server.response.size,rpc.client.request.size, andrpc.client.response.sizemetrics due to ambiguous definitions and inconsistent implementation.(#3267)
rpc: Deprecate therpc.messageevent and its attributes (#3266, #3283)Per-message events within RPC streaming calls are of limited utility in their current form. They are recorded as span events (also being deprecated). There is no direct replacement at this time.
💡 Enhancements 💡
cloud: Addoracle_cloud.realmvendor-specific attribute for Oracle Cloud Infrastructure (OCI) realm identifier. (#3121)An Oracle Cloud realm is a logical collection of cloud regions that are isolated from each other, used for compliance and data residency requirements.
db: Mark the Oracle Database client span as Release Candidate. (#2989)db: Modify area to oracledb from oracle (#3316)db: Clarifieddb.query.summarybehavior for batch operations. (#3287)db, rpc: Define domain-specific exception events for database and RPC (#3426)These domain-specific exception events provide a structured way to record
exceptions that occur during operations in each area:
db.client.operation.exceptionfor database client operationsrpc.client.call.exceptionandrpc.server.call.exceptionfor RPCdocs: Add how-to guide for defining spans (#3240)event: Allow event body to represent a display message. (#3343)exception: Indicate thatexception.messageattribute may contain sensitive information. (#2967, #3310)exceptions: IntroduceOTEL_SEMCONV_EXCEPTION_SIGNAL_OPT_INenvironment variable for transitioning exception recording from span events to logs. (#3363)gcp: Add GCP GCE Instance Group Manager attributes (#905)gen-ai: Add retrieval span support to the gen-ai semantic conventions. (#2907)gen-ai: Enhance how tool calls are captured to extend support for server side tools.(#2585)
gen-ai: Addgen_ai.agent.versionattribute to capture the version of an agent. (#3428)gen-ai: Add cache token attributes and provider-specific normalization guidance for GenAI usage metrics (#1959)gen_ai.usage.cache_read.input_tokensattribute for tokens served from provider cachegen_ai.usage.cache_creation.input_tokensattribute for tokens written to provider cachegen_ai.usage.input_tokensgen_ai: Addedsampling-relevantflag to relevant GenAI span attributes to indicate their importance for sampling decisions. (#2994)http: Defined declarative configuration for overriding known HTTP methods. (#3394)http: Define declarative configuration for sensitive query parameters. (#3403)http: Definehttp.client.request.exceptionandhttp.server.request.exceptionevents for recording exceptions during HTTP operations (#3414)These domain-specific exception events provide a structured way to record
exceptions that occur during HTTP client requests (network failures, timeouts)
and HTTP server request processing (application errors, internal failures).
jvm: Addjvm.file_descriptor.limitas an in-development metric to track the maximum number of open file descriptors as reported by the JVM. (#3430)k8s: Promote a selection of k8s and container attributes to beta (#3120)k8s: Add k8s.service entity with endpoint and load balancer ingress metrics (#3294)New metrics:
k8s.service.endpoint.count: Number of endpoints by condition, address type, and zonek8s.service.load_balancer.ingress.count: Number of load balancer ingress pointsNew attributes:
k8s.service.endpoint.condition,k8s.service.endpoint.address_type,k8s.service.endpoint.zonek8s.service.traffic_distribution,k8s.service.publish_not_ready_addressesNew entity:
entity.k8s.service: k8s service entity with identifying and descriptive attributesopenai: Addopenai.api.typeattribute to distinguish between different OpenAI API types for similar operations. (#3337)pprof: addpprof.scope.default_sample_typeandpprof.scope.sample_type_orderattributes to support lossless conversion of pprof profiles. (#3078)rpc: Mark core RPC (plus gRPC and Apache Dubbo) semantic conventions as release candidate. (#3446)rpc: Add Metrics sections to JSON-RPC, gRPC, and Connect RPC system-specific conventions (#3319, #3320)rpc: Changerpc.server.call.durationandrpc.client.call.durationmetrics from recommended to required (#3284)rpc: Add RPC migration guide documenting changes from v1.37.0 to latest version. (#3204)rpc: Clarify thatnetwork.peer.addressshould indicate the last contacted address in case of retries.(#3392, #3427)
rpc: Add semantic conventions for Apache Dubbo RPC system. (#3291)rpc: Clarify how to populateserver.addressandserver.portwhen using client-side load balancing or service discovery.(#3258, #3317)
service: Addservice.criticalityattribute to classify services based on operational importance (#2986)This attribute enables observability platforms to implement criticality-aware tracing, monitoring,
and sampling strategies. Supports four levels: critical, high, medium, and low.
service: Stabilizeservice.instance.idattribute. (#1519)The
service.instance.idattribute and entity are promoted from development to stable.service: Stabilizeservice.namespaceattribute. (#3254)The
service.namespaceattribute is promoted from development to stable.v1.39.0Compare Source
🛑 Breaking changes 🛑
rpc: Renamerpc.client|server.durationtorpc.client|server.call.duration, change RPC duration metrics from milliseconds to seconds, and clarify metric and span duration semantics for streaming. (#383, #2961)rpc: Renamerpc.grpc.request.metadataandrpc.connect_rpc.request.metadatatorpc.request.metadatarpc.grpc.response.metadataandrpc.connect_rpc.response.metadatatorpc.response.metadata(#2869, #3169)
rpc: Mergerpc.methodandrpc.serviceinto fully-qualifiedrpc.methodattribute. Clarify how to handle possible high cardinality ofrpc.methodin edge cases. Clarifyrpc.methodusage in span names. (#2863, #3196, #3223)rpc: Deprecaterpc.grpc.status_code,rpc.connect_rpc.error_codeandrpc.jsonrpc.error_codeattributes in favor of the more generalrpc.response.status_codeattribute.(#1504, #2920)
rpc: Align RPC conventions with naming guidelines. Renames:rpc.systemtorpc.system.name. The values are also updated to matchnaming guidelines:
connect_rpcis renamed toconnectrpc;apache_dubbois renamed todubbo;java_rmi,dotnet_wcf, andonc_rpcare not included in the new enum.rpc.jsonrpc.request_idtojsonrpc.request.id.rpc.jsonrpc.versiontojsonrpc.protocol.version.(#2703, #2921)
system, linux: Rename*.linux.memorymetrics and attributes to*.memory.linux(#1661)🚩 Deprecations 🚩
peer: Thepeer.serviceattribute has been deprecated in favor ofservice.peer.name. (#2945)The
peer.serviceattribute has been renamed toservice.peer.nameto align with theservice.{name|namespace}resource attributes.process: Introduceprocess.unix.file_descriptor.countandprocess.windows.handle.countmetrics.Deprecate
process.open_file_descriptor.count(#3188)
💡 Enhancements 💡
cloud: Addgcp.agent_engineas a value forcloud.platform(#2957)cloud: Add Oracle Cloud Infrastructure to SemConv Areas list (#3190)cloud: Add Hetzner Cloud to cloud.provider and cloud.platform (#2758)cloud: Add Linode (Akamai Cloud) to cloud.provider and linode_cloud_compute to cloud.platform (#2756)cloud: Add Vultr Cloud to cloud.provider and cloud.platform (#2757)k8s: Add missing entity associations to k8s and container metrics (#3213)k8s: Addsk8s.pod.ip,k8s.pod.hostnameandk8s.pod.start_timeattributes (#3171)k8s: Define missing roles for entity attributes (#3135)k8s: Promote a selection of k8s and container attributes to alpha (#3120)The selected attributes being promoted are used by the Collector Contrib components
that are targeting stability. See opentelemetry-collector-contrib/#44130
k8s: Define roles for k8s entities' attributes (#3017)mcp: Add MCP semantic conventions (#2043, #2083)otel: Addotel.event.nameattribute for use by non-OTLP exporters and logging libraries. (#2913)The
otel.event.nameattribute can be used by:EventNameEventNamefield by Collector or SDK componentspprof: add various pprof attributes to support lossless conversion from and to OTel profiles. (#3078)rpc: Use consistent set of attributes between RPC spans and metrics (#2922, #3197)rpc.response.status_codeon common metrics and spans.error.typenote consistent between metrics and spans.rpc.methodandrpc.serviceto attribute definition.rpc: Markrpc.system.name,rpc.method,rpc.service,server.address, andserver.portas sampling relevant attributes in RPC spans.(#3202)
service: Splits service into three entities: namespace, service and instance. (#2880)service:service.peer.nameandservice.peer.namespacehave been introduced as the replacement forpeer.serviceto describe remote services that use both a name and a namespace. (#2945)The
peer.serviceattribute could not fully represent theservice.{name|namespace}resource attributes;service.peer.nameandservice.peer.namespaceprovide a more complete representation.🧰 Bug fixes 🧰
rpc: Demoteserver.addressfrom required to conditionally required (when available) on RPC spans and metrics. Updateserver.portrequirement level accordingly. (#3236)v1.38.0Compare Source
🛑 Breaking changes 🛑
k8s: Renamek8s.node.allocatable.*metrics tok8s.node.*.allocatable(#2973)Renamed metrics:
k8s: Fix plural-named updowncounter k8s metrics (#2301)Renamed metrics:
process: Renames process.context_switch_type to process.context_switch.type (#1501)rpc: Attributes for rpc metric are now explicitly associated with metrics. (#2311)The breaking change is due to the removal of network.type from the metrics.
system: Markcpu.logical_numberattribute as opt-in forsystem.cpu.timeandsystem.cpu.utilizationmetrics (#2932)system, process: Renamesystem.process.statustoprocess.state(#1803)system, process: Replacesystem.paging.typeandprocess.paging.fault_typewithsystem.paging.fault.type(#1803)v8js: Rename metricv8js.heap.space.available_sizetov8js.memory.heap.space.available_size.Rename metric
v8js.heap.space.physical_sizetov8js.memory.heap.space.physical_size.(#2856)
🚩 Deprecations 🚩
rpc: Deprecate rpc..requests_per_rpc and rpc..responses_per_rpc metrics. (#2784)system: Fix deprecation of system.cpu.logical_number (#2700)💡 Enhancements 💡
app: Addapp.screen.nameattribute to capture application screen names. (#2743)cicd: Add guidance on per pipeline run metrics (#1184)cicd: Improve the description ofcicd.workerentities. (#1191)cicd: Add guidance on CI/CD logs (#1714)db: Add database context propagation viaV$SESSION.ACTIONfor SQL Server (#2610)gcp: Documentgcp.apphub_destination.*attributes (#2649)gen-ai: Add participant's name on generative AI chat message. (#2943)gen-ai: Add tool definitions and execution details for Single and Multi-Agent systemsAdd 'gen_ai.tool.definitions' attribute to 'invoke_agent' span
Add 'gen_ai.tool.definitions' attribute to 'attributes.gen_ai.inference.client' attribute group.
Add 'gen_ai.tool.call.arguments' and 'gen_ai.tool.call.result' attributes to 'execute_tool' span.
(#2444, #591)
gen-ai: IntroducingEvaluation Eventin GenAI Semantic Conventions to represent and capture evaluation results.(#2563)
gen-ai:invoke_agentspans now include span kind (CLIENT/INTERNAL) guidance and clarify whenserver.*attributes should be set. (#2837)gen-ai: Add reasoning content message parts for chat messages. (#1965)gen_ai: Addgen_ai.embeddings.dimension.countattribute to capture the dimension count of embeddings. (#2361)The
gen_ai.embeddings.dimension.countis added to thespan.gen_ai.embeddings.clientspanand
gen_ai.client.operation.durationmetric.gen_ai: Add multimodaluri,file, andblobparts to GenAI JSON Schemas (#1556)gen_ai, db, enduser, messaging: Fix deprecation reasons - use uncategorized when attribute type is changing. Fix missing/invalid deprecations on (deprecated)gen_ai.systemattribute.(#2688)
http: Adds in the HTTP QUERY method. (#2642)http: Clarify value forhttp.routeattribute may contain static and dynamic segments. (#2616)k8s: Add container CPU limit/request utilization metrics. (#1489)k8s: Add k8s.pod.status.phase and k8s.pod.status.reason metrics (#2075)k8s: Add memory metrics for k8s.node, k8s.pod and container resources (#2776)nfs: Addnfs.*metrics, along with supportingrpc.onc.*/rpc.nfs.*attributes. (#39978)openshift: Adds metrics for openshift's clusterquota (#2078)pprof: Introduce pprof attributes. (#2522)pprof: add attribute pprof.profile.comment. (#2861)process: Increases the amount of attributes which are used to describe the running process. (#2655)rpc: JSON-RPC now has its own span definition. (#2228)rpc: Adds innetwork.protocol.nameandnetwork.protocol.versionto all RPC spans and metrics. (#2719)rpc: Adds in explicit span definitions for Connect RPC. (#2720)rpc: Removenetwork.typeattribute from RPC spans and metrics (#2851)The
network.typeattribute is no longer included in RPC semantic conventions.It remains available in the attribute registry for opt-in usage when needed.
rpc: Adds in explicitly defined grpc spans. (#2720)rpc: Update the RPC stability warning and guidance for instrumentation authors (#2718)rpc: The rpc spans now contains theerror.typeattribute to report the type of error that occurred. (#2812)🧰 Bug fixes 🧰
dns: Simplifydns.question.namenote to remove incorrect custom encoding requirements (#2143)The note now simply states that the domain name should be captured as it appears in the DNS query
without any additional normalization, removing the previous incorrect custom encoding requirements.
nfs: nfs/metrics.yaml: nfs.server.net.count: add missing network.transport attribute. Implementation not merged, so not a breaking change. (#39978)system: Thesystem.network.droppedandsystem.network.packetsmetrics have been added as deprecated rather than being removed. (#2828)Configuration
📅 Schedule: (UTC)
🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about this update again.
This PR was generated by Mend Renovate. View the repository job log.