Repository navigation
v1.41.0
π 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)
Thegraphql.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)- Move process.executable to its own entity
- Identifying attribute:
- process.executable.build_id.htlhash
- We need to update its description in another PR.
- process.executable.build_id.htlhash
- Descriptive attributes:
- process.executable.build_id.go
- process.executable.build_id.gnu
- process.executable.path
- process.executable.name
-
process: Update requirement levels for process attributes to ensure consistent identification and description across platforms. (#864)- Changed
process.pidandprocess.creation.timeto beRequired(Identity). - Changed process descriptive attributes to be
Optional.
- Changed
-
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)
Thedeployment.environment.nameattribute is promoted from development to stable. -
deployment: Add enum values fordeployment.environment.nameattribute. (#2910)
Thedeployment.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 execution
-
gen-ai: Enhance the definition ofgen_ai.tool.definitionsattribute. (#2721, #1835)
The schema ofgen_ai.tool.definitionsattribute is now enhanced to:- Add JSON schema of
gen_ai.tool.definitionsattribute. - Document the behavior of capturing tool definitions.
- Capture the tool definitions in a simplified format if the content capturing is disabled.
- Add JSON schema of
-
gen-ai: Addgen_ai.usage.reasoning.output_tokensattribute for reasoning tokens (#3194)- Add
gen_ai.usage.reasoning.output_tokensfor tokens used for reasoning
- Add
-
gen-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)- Add
gen_ai.client.operation.time_to_first_chunkmetric to track time from client request to first chunk of response. - Add
gen_ai.client.operation.time_per_output_chunkmetric to track time per output chunk of response.
- Add
-
gen-ai: Splitinvoke_agentinto separate client and internal spans, and split attributes from inference hierarchy. (#2632)
Theinvoke_agentclient span now extends a dedicatedattributes.gen_ai.invoke_agent.client
attribute group instead ofattributes.gen_ai.inference.client. This removes
gen_ai.response.id,gen_ai.response.model, andgen_ai.response.finish_reasons
and addsgen_ai.agent.version.
A newinvoke_agentinternal span is added for in-process agents (e.g., LangChain, CrewAI),
which does not includeserver.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)
Addsgen_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.persistentvolumeclaim
Metrics:k8s.persistentvolume.status.phase,k8s.persistentvolume.storage.capacityk8s.persistentvolumeclaim.status.phase,k8s.persistentvolumeclaim.storage.request,
k8s.persistentvolumeclaim.storage.capacity
-
k8s: 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 operations
-
otel: 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)
Thetelemetry.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)
New Contributors
- @castlenthesky made their first contribution in #3377
- @wrisa made their first contribution in #3249
- @nagkumar91 made their first contribution in #3538
- @ShaanveerS made their first contribution in #3516
- @keith-decker made their first contribution in #3595
- @PlateauGao made their first contribution in #3556
- @shuningc made their first contribution in #3607
- @jmmcorreia made their first contribution in #3559
- @abernix made their first contribution in #3118
- @lahabana made their first contribution in #3543
- @cijothomas made their first contribution in #3637
- @sfozz made their first contribution in #3445
- @SAY-5 made their first contribution in #3642
Full Changelog: v1.40.0...v1.41.0