0.13.0 - 2025-02-07

Release Notes

What's changed

• Breaking Change: Introduced a new weaver registry diff command to generate a diff report between two versions of
  the semantic convention registry. This PR introduces a breaking change in the semantic conventions schema. While the
  text-based deprecated field is still supported for compatibility reasons, future semantic conventions should use the
  new deprecated structured format. (#400 by @lquerel).

  • The deprecated field is now a structured field defining the precise reason for deprecation. The semantic
    conventions must be updated to adopt this new format.
  • The changes related to the deprecated field (i.e., string → struct) also have a potential impact on certain
    templates that reference the deprecated field as containing text. These templates will need to be updated to use
    the brief field, which provides a textual explanation of the reasons for the deprecation.

• Improvement of comment generation: removal of <p> tags that precede @ Javadoc tags.
  (#574 by @trask).

• For Issue #564 - Require attributes and event fields to have stability: Added warnings for missing stability
  on: Attributes, Enum members in attributes, Event AnyValues, Enum members in AnyValues. (#568 by @jerbly).

• For issue [#569](Add include_stability config into semconv_grouped_attributes): is_experimental returns true by default. (#570 by @jerbly).

• Added an OTLP receiver to Weaver to prepare for the weaver registry live-check command. (see #548 by @lquerel)

• Add is_array filter and test for AttributeType. (#540 by @arthurDiff).

• Refactored CLI registry commands to remove some duplication. Resolving the registry with policy checks is common for
  generate, resolve and check. (#536 by @jerbly).

  • Added missing after_resolution policy checks to generate and resolve through the common code.
  • Removed the deprecated --registry-git-sub-dir option.
  • Fixed bug in check if --skip-policies was specified then it would not fail for any validation errors.

• Semantic Conventions Issue #1513 - Make span_kind required in yaml and break down multi-kind span
  definitions - (#542 by @jerbly).

  • Updated the EBNF and JSON schema to define span_kind as mandatory for span group types. Added a group validity
    check as a warning.

• First iteration of the new command: registry emit. Emits a semantic convention registry as example spans to your
  OTLP receiver. This may be useful in testing/simulation scenarios. (#549 by @jerbly)

• For issue [#569](Add include_stability config into semconv_grouped_attributes): added stable_only boolean flag as a parameter for
  semconv_signal, semconv_grouped_attributes, and other semconv_* JQ semconv helpers. When stable_only is set to true,
  corresponding helper function returns stable conventions only. If the flag is not set or set to false, stability filtering does not apply.
  It's recommended to use stable_only flag instead of exclude_stability parameter.
  (#588 by @lmolkova)

Install weaver 0.13.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/open-telemetry/weaver/releases/download/v0.13.0/weaver-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -c "irm https://github.com/open-telemetry/weaver/releases/download/v0.13.0/weaver-installer.ps1 | iex"

Download weaver 0.13.0

File	Platform	Checksum
weaver-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
weaver-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
weaver-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
weaver-x86_64-pc-windows-msvc.msi	x64 Windows	checksum
weaver-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:

gh attestation verify <file-path of downloaded artifact> --repo open-telemetry/weaver

You can also download the attestation from GitHub and verify against that directly:

gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>