Defines standards for generating consistent, accessible telemetry across a variety of domains
Go to file
Liudmila Molkova 139842c9e0 BREAKING: remove messaging.destination.kind and messaging.source.kind values (#3214)
Fixes #3170, #3265, #3249

## Changes

~~We currently allow `topic` or `queue` on `messaging.destination.kind`.
While it's common in messaging world to have one or another, messaging
semantic conventions can be applied to AMPQ communication (which does
not have topic/queue terminology), [socket.io](https://socket.io/), and
potentially other less traditional messaging use-cases.~~

It's unclear how `messaging.destination.kind` and
`messaging.source.kind` could be used. The distinction between queue and
topic is significant for messaging and distributed systems, but not for
tracing.

In either case, tracing backends should expect to process traces from 0+
messaging and 0+ messaging consumers. In either case, message consumers
can be simultaneous or consequent and there could be many of them.

The only known case (Solace) where it could be useful is when messaging
system allows having queues and topic with the same name on the same
broker, and it could be used to distinguish one from another.

Based on messaging SIG discussion, the attributes are removed for the
time being until we understand if and how they are useful.

Depending on messaging system queues or topics behavior vary a lot and
in future it would makes more sense to represent actual behavior with
individual attributes such as:
- auto-settlement (at-most-once or at least once guarantees)
- settlement for individual messages or offsets
- broadcast or unicast
- etc
2023-03-21 10:51:55 -06:00
.vscode Rename Optional attribute requirement level to Opt-In (#3228) 2023-03-01 15:13:24 -08:00
internal/tools Rename Optional attribute requirement level to Opt-In (#3228) 2023-03-01 15:13:24 -08:00
schemas BREAKING rename `net.app.protocol.(name|version)` to `net.protocol.(name|version)` and replace `http.flavor` with `net.protocol.(name|version)` (#3272) 2023-03-10 10:15:15 -08:00
semantic_conventions BREAKING: remove messaging.destination.kind and messaging.source.kind values (#3214) 2023-03-21 10:51:55 -06:00
specification BREAKING: remove messaging.destination.kind and messaging.source.kind values (#3214) 2023-03-21 10:51:55 -06:00
.gitattributes Add .gitattributes & normalize line endings (#1230) 2020-11-26 13:15:29 +01:00
.gitignore Add Makefile target to auto-generate TOC via markdown-toc (#2020) 2021-10-15 15:04:22 +00:00
.markdown_link_check_config.json Use attribute_group for cross-signal HTTP attributes (#3183) 2023-02-13 16:00:14 -08:00
.markdownlint.yaml mdlint: Use named rules. (#1813) 2021-07-19 18:08:22 +02:00
.nvmrc [linters] Recommend latest LTS version of Node (#2401) 2022-03-03 19:52:45 -05:00
.yamllint Lint YAML files (mainly semantic conventions). (#1814) 2021-07-15 10:12:05 +02:00
LICENSE First commit 2019-05-01 16:05:13 -04:00
Makefile Rename Optional attribute requirement level to Opt-In (#3228) 2023-03-01 15:13:24 -08:00
docfx.json Update docfx sanity check (#2285) 2022-03-24 20:44:12 +01:00
package.json Make markdown-link-check work again (#3327) 2023-03-21 08:19:14 -06:00