Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add semantic convention attributes for capturing the application layer protocol #2602

Merged
merged 5 commits into from
Jun 11, 2022

Conversation

pyohannes
Copy link
Contributor

Fixes #2548

Changes

This PR proposed the two additional attributes net.app.protocol.name and net.app.protocol.version. These allow capturing the name and version of the application layer protocol used (in addition to the name of the transport protocol captured in net.transport). The naming is consistent with ECS, where network.protocol is used.

Those general attributes can be used to capture information about application layer protocols for which no dedicated semantic conventions exist (e. g. AMQT, or MQTT).

@Oberon00 proposed using a new net.app namespace for this.

@pyohannes pyohannes requested review from a team June 2, 2022 20:39
@Oberon00
Copy link
Member

Oberon00 commented Jun 3, 2022

For the namespace name, ideally it should also fit with option 1 or 2 in #2607.
I think net.app is adequate. The only thing that is maybe not ideal is that "app" might suggest something that should not be set by instrumentation to some readers?

semantic_conventions/trace/general.yaml Outdated Show resolved Hide resolved
Copy link
Member

@blumamir blumamir left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We discussed it in messaging SIG and it makes sense to me, as well as introduces clarity to messaging instrumentation scenarios (current messaging.protocol and messaging.protocol_version does not feel right).
I support this change

@pyohannes pyohannes force-pushed the trace-semconv-applayer-proto branch from cccc578 to b28c337 Compare June 10, 2022 18:06
@reyang reyang merged commit 3770f17 into open-telemetry:main Jun 11, 2022
beeme1mr pushed a commit to beeme1mr/opentelemetry-specification that referenced this pull request Aug 31, 2022
beeme1mr pushed a commit to beeme1mr/opentelemetry-specification that referenced this pull request Aug 31, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Add semantic convention attributes for capturing the application layer protocol
6 participants