Skip to content

Conversation

@kaylareopelle
Copy link
Contributor

@kaylareopelle kaylareopelle commented Oct 30, 2025

Semantic conventions update for version 1.37.0

Also includes an adjustment to the attributes jinja template to account for multi-line comments in response to open-telemetry/semantic-conventions#3019


Outdated

This was pretty smooth overall. The only problem was with the Gen AI examples. They needed to be manually commented out. After the opening [ the rest of the example wasn't commented out. This problem also exists in the latest release, 1.38.0.

It might be related to a fix in the actual semconv repo. Things look pretty good from the weaver perspective to me, but maybe you have an idea, @robbkidd?

Where the sample values are in the weaver template:

# @example Sample Values
{%- if attribute.examples is sequence %}
{%- for example in attribute.examples %}
# {{ example }}
{%- endfor %}
{%- else %}
# {{ attribute.examples }}
{%- endif %}

@kaylareopelle
Copy link
Contributor Author

Opened an issue for the weaver problem: open-telemetry/semantic-conventions#3019

Also, update the jinja template for attributes to handle multi-
line code comments.
# client.example.com
# 10.1.2.80
# /tmp/my.sock
# # client.example.com
Copy link
Contributor

Choose a reason for hiding this comment

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

where are these extra octothorps # coming from? The jinja template?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Good catch, I'm not sure. I can take a look next week.

{%- if attribute.examples is sequence %}
{%- for example in attribute.examples %}
# {{ example }}
# {{ example | comment }}
Copy link
Contributor

@arielvalentin arielvalentin Nov 5, 2025

Choose a reason for hiding this comment

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

Is that because the example or comment may already have an octothorp in it?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I was directed to use this for multi line strings.

However, looking at the comment, I may have got something wrong:

open-telemetry/semantic-conventions#3019 (comment)

Perhaps just using the filter without the prefixed # would solve the issue.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

(assuming the "that" you're referring to is the addition of "| comment" )

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.

2 participants