opentelemetry-go icon indicating copy to clipboard operation
opentelemetry-go copied to clipboard

Add `semconv/v1.26.0`

Open MrAlias opened this issue 1 year ago • 2 comments

v1.26.0 semantic conventions release notes:

v1.26.0

🛑 Breaking changes 🛑

  • db: Rename db.statement to db.query.text and introduce db.query.parameter.<key> (#716)

  • db: Renames db.sql.table, db.cassandra.table, db.mongodb.collection, and db.cosmosdb.container attributes to db.collection.name (#870)

  • db: Rename db.operation to db.operation.name. (#884)

  • messaging: Rename messaging.operation to messaging.operation.type, add messaging.operation.name. (#890)

  • db: Deprecate the db.user attribute. (#885)

  • db: Rename db.name and db.redis.database_index to db.namespace, deprecate db.mssql.instance_name. (#885)

  • db: Remove db.instance.id. For Elasticsearch, replace with db.elasticsearch.node.name. (#972)

  • db: Clarify database span name format and fallback values. (#974, #704)

  • db: Rename db.client.connections.* metric namespace to db.client.connection.* and rename db.client.connection.usage to db.client.connection.count.
    (#201, #967)

  • db: Rename pool.name to db.client.connections.pool.name and state to db.client.connections.state. (#909)

  • system: Deprecate shared from system.memory.state values and make it a standalone metric (#522)

  • device.app.lifecycle: Reformat and update the device.app.lifecycle event description adds constraints for the possible values of the android.state and ios.state.
    (#794)
    Removes the ios.lifecycle.events and android.lifecycle.events attributes from the global registry and adds constraints for the possible values of the android.state and ios.state attributes.

  • messaging: Rename messaging.client_id to messaging.client.id (#935)

  • rpc: Renamemessage.* attributes under rpc to rpc.message.*. Deprecate old message.* attributes. (#854)

🚀 New components 🚀

  • gen-ai: Introducing semantic conventions for GenAI clients. (#327)

💡 Enhancements 💡

  • all: Markdown snippets are now generated by jinja templates in the templates directory. (#1000)

  • db, messaging, gen_ai: Clarify that db.system, messaging.system, gen_ai.system attributes capture the client perception and may differ from the actual product name. (#813, #1016)

  • messaging: Show all applicable attributes in individual messaging semantic conventions. (#869, #1018)

  • process: Add additional attributes to process attribute registry (#564)

  • messaging: Add a GCP Pub/Sub unary pull example and the new GCP messaging attributes: - messaging.gcp_pubsub.message.ack_deadline, - messaging.gcp_pubsub.message.ack_id, - messaging.gcp_pubsub.message.delivery_attempt (#527)

  • db: Add db.client.operation.duration metric (#512)

  • messaging: Adds `messaging.destination.partition.id`` to the messaging attributes (#814)

  • exception: Replace constraints with requirement levels on exceptions. (#862)

  • process: Replace constraints with requirement_level in process attributes. (#863)

  • db: Reorganize DB conventions to be shared across span and metric conventions. (#910)

  • all: Migrate Attribute Registry to be completely autogenerated. (#197)
    Migrate to using weaver for markdown generation (snippet + registry).
    The entirety of the registry now is generated using weaver with templates
    under the templates/ directory. Snippets still require a hardcoded
    command.

  • http: List all HTTP client and server attributes in the corresponding table, remove common attributes from yaml and markdown. (#928)

  • other: Document patterns and suggestions for semconv code generation. (#551, #953)

  • db: Show applicable common attributes in individual database semantic conventions. (#973)

  • db: Add error.type attribute to the database span and operation duration metric. (#975)

  • db: Parameterized query text does not need to be sanitized by default (#976)

  • http: List experimental HTTP attributes applicable to HTTP client and server spans. (#989)

  • db: Finalizes the migration requirement for instrumentations to follow when updating to stable database semconv. (#719)

  • http: New url.template attribute added to URL, HTTP client attributes are extended with optional low-cardinality url.template (#675)

  • db: Add note to db.collection.name, db.namespace, and db.operation.name about capturing those without attempting to do any case normalization.
    (#886)

  • events: Provides additional definitions of log events and their structure. (#755)

  • k8s: add container.status.last_terminated_reason resource attribute (#922)

🧰 Bug fixes 🧰

  • http: Add previously deprecated http attributes to registry (#1025)
    These attributes were deprecated in 1.13
  • net: Add previously deprecated net attributes to registry (#1029)
    These attributes were deprecated in 1.13

Follow up work

  • [ ] Update all dependencies on semconv to v1.26.0

MrAlias avatar May 21 '24 19:05 MrAlias

Codecov Report

All modified and coverable lines are covered by tests :white_check_mark:

Project coverage is 84.5%. Comparing base (5661ff0) to head (cb38de8).

Additional details and impacted files

Impacted file tree graph

@@           Coverage Diff           @@
##            main   #5394     +/-   ##
=======================================
- Coverage   84.5%   84.5%   -0.1%     
=======================================
  Files        268     268             
  Lines      17796   17796             
=======================================
- Hits       15052   15051      -1     
- Misses      2430    2431      +1     
  Partials     314     314             

see 1 file with indirect coverage changes

codecov[bot] avatar May 21 '24 19:05 codecov[bot]

Blocked by https://github.com/open-telemetry/semantic-conventions/issues/1031 or a workaround.

MrAlias avatar May 21 '24 20:05 MrAlias

Superseded by https://github.com/open-telemetry/opentelemetry-go/pull/5476

MrAlias avatar Jun 03 '24 21:06 MrAlias