0.12.0 - 2024-12-09

Release Notes

What's changed

• Issue #502 - Support stability definitions from OTEP 232 - (#504 by @jerbly).
  • Stability enum now has these variants: stable, development, deprecated, alpha, beta, release_candidate
  • unmaintained is not supported yet.
  • experimental is still accepted when parsing but aliased to development.
  • The minijinja test, experimental, now returns true for any variant other than stable.
  • EBNF and JSON schema updated to define the new enum without the experimental variant.
• Issue #301 - Warn against usage of allow_custom_values. (#514 by @jerbly).
• Fixed rego typos, attrigute and deprecaded (#517 by @jerbly).
• Create better HTML comment parser - Allow more semconv snippet headers (#512 by @jsuereth).
• Add javadoc

  tag after lists (#511 @trask).

• Javadoc

  tags should only precede paragraphs (#510 by @trask).

• More consistent newline behavior (#509 by @trask).
• Add test cases to cover a paragraph after a list (#508 by @trask).

Important note: Our CI/CD pipeline has been updated to use Rust cross-compilation, significantly speeding up the ARM
target (see [#506](#506, thanks to @bernot-dev). If you encounter any
issues on ARM, please let us know as soon as possible. Thank you!

Install weaver 0.12.0

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download weaver 0.12.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>

0.11.0 - 2024-12-05

Release Notes

What's changed

• Detect duplicate group ids, group names, and metric names. (#382 by lquerel).
• Add support for Maps map[] to the definition of an AnyValue. (#396 by @MSNev).
• Update semconv schema, syntax doc and validity check to correctly define stability as optional for attribute groups. (#467 by @jerbly).
• Fix issue #405 - Updated the EBNF and JSON schema to define the extends or attributes requirement mandatory for all group types except metric and event. Added a group validity check as a warning. (#494 by @jerbly).
• Allow adding a description when using opt_in requirement level (#392 by @joaopgrassi)
• Add warning that issues when using prefix on groups (#407 by @jsuereth)
• Update comment filter to remove trailing spaces (#453 by @jsuereth)
• Metrics and Events don't require attributes (#494 by @jerbly)
• Added an option to follow symbolic links when loading the registry in various parts of the codebase. (#468 by @Leo6Leo)
• Provide max line-length in comment filter. (#454 by @jsuereth)

Install weaver 0.11.0

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download weaver 0.11.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>

0.10.0 - 2024-09-23

Release Notes

What's changed

• Add support log based event definitions with a body of new AnyValue type. (#297 by @MSNev).
• Add escape_square_brackets into comment_formats markdown configuration. (#379 by @lquerel).
• Add enforce_trailing_dots into the comment_formats configuration. (#378 by @lquerel).
• Add support for indent_type in both the comment filter and the comment_formats configuration. (#377 by @lquerel).
• Add regex_replace filter to support replacing text using regex. (#380 by @lquerel).
• Bump opentelemetry_sdk from 0.24.1 to 0.25.0 (#369)
• Bump opentelemetry-stdout from 0.5.0 to 0.25.0 (#368)
• Bump anyhow from 1.0.88 to 1.0.89 (#370)
• Bump regorus from 0.2.4 to 0.2.5 (#375)
• Bump minijinja-contrib from 2.2.0 to 2.3.1 (#376). Some callouts:
  • Implemented the missing groupby filter. minijinja#570
  • The unique filter now is case insensitive by default like in Jinja2 and supports an optional flag to make it case sensitive. It also now lets one check individual attributes instead of values. minijinja#571
• Bump minijinja from 2.2.0 to 2.3.1 (#371)
• Bump globset from 0.4.14 to 0.4.15 (#366)

Install weaver 0.10.0

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download weaver 0.10.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>

0.9.2 - 2024-09-09

Release Notes

What's Changed

• Build X86 + ARM64 image (#346 by jsuereth). The parameter
  --platform=linux/x86_64 is no longer needed to run this image on MacOS.
• Update docker guide for home directory (#356 by jsuereth).
• Fix clippy issues. (#357 by jsuereth).
• Bump alpine from 3.20.2 to 3.20.3 (#360)
• Bump anyhow from 1.0.86 to 1.0.87 (#359)
• Bump serde from 1.0.209 to 1.0.210 (#358)
• Bump serde_json from 1.0.127 to 1.0.128 (#354)
• Bump clap from 4.5.16 to 4.5.17 (#351)
• Bump regorus from 0.2.3 to 0.2.4 (#350)
• Bump indexmap from 2.4.0 to 2.5.0 (#349)
• Bump minijinja-contrib from 2.1.2 to 2.2.0 (#347)
• Bump ratatui from 0.28.0 to 0.28.1 (#341)
• Bump flate2 from 1.0.32 to 1.0.33 (#342)
• Bump minijinja from 2.1.2 to 2.2.0 (#343)
• Bump serde from 1.0.208 to 1.0.209 (#344)
• Bump serde_json from 1.0.125 to 1.0.127 (#340)

Install weaver 0.9.2

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download weaver 0.9.2

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>

0.9.1 - 2024-08-22

Release Notes

Fixes

• Warnings detected in the baseline registry are now ignored and non-fatal errors will not
  interrupt any command before it completes
  (#337 by lquerel).

Install weaver 0.9.1

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download weaver 0.9.1

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>

0.9.0 - 2024-08-19

Release Notes

What's Changed

• (#309 by lquerel) Configurable Comment Filter to Support Multiple Programming Language Comment Formats.
  More details in Weaver Force Doc
  and Weaver Configuration Doc.
• (#300 by lquerel) Validation for the examples attribute field.
• (#322, #312,
  #319, #318,
  #312, #304
  by jsuereth) Many improvements have been made to the creation of the Weaver Docker image,
  which is now scoring an A on the Scout Docker image score.
  • Add Weaver docker image to dependabot tracking,
  • Add build attestations,
  • Stop using root user the docker image,
  • Use official docker action to build docker image,
  • Update docker to use release build.
• (#311 by MSNev) Fix unknown.com test reference issue.
• (#307 by lmolkova) Move semconv schema definition from build tools.
• (#305 by lquerel) Detect root attribute name duplicates during the resolution process.
• (#294 by lquerel) Add template-level parameters and file_name per template config.
• (#327) Bump regorus from 0.2.2 to 0.2.3.
• (#326, #317, #302) Bump clap from 4.5.13 to 4.5.16.
• (#325, #313) Bump serde from 1.0.205 to 1.0.208.
• (#324) Bump alpine from 3.18.3 to 3.20.2.
• (#323) Bump rust from 1.76.0-alpine3.18 to 1.78.0-alpine3.18.
• (#320, #315, #287) Bump serde_json from 1.0.122 to 1.0.125.
• (#316) Bump indexmap from 2.3.0 to 2.4.0.
• (#314, #308) Bump markdown from 1.0.0-alpha.18 to 1.0.0-alpha.20.
• (#310) Bump ratatui, textarea and crossterm version in lock-step.
• (#303, #299, #293) Bump tui-textarea from 0.5.2 to 0.6.1.
• (#298) Bump ratatui from 0.27.0 to 0.28.0.
• (#292) Bump flate2 from 1.0.30 to 1.0.31.
• (#290) Bump regex from 1.10.5 to 1.10.6.
• (#286) Bump crossterm from 0.27.0 to 0.28.1.

Install weaver 0.9.0

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download weaver 0.9.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

0.8.0 - 2024-08-01

Release Notes

What's Changed

• (#257 by lquerel) Infrastructure to support backward-compatibility testing and, more generally, policies applied to multi-version registries.

weaver registry check \
--registry https://github.com/open-telemetry/semantic-conventions.git[model] \
--baseline-registry https://github.com/open-telemetry/semantic-conventions/archive/refs/tags/v1.26.0.zip[model] \
--policy compatibility_check.rego

Supported syntax for registry paths:

• <local-path> -> e.g. $HOME/otel-registry
• <git-url> -> e.g. https://github.com/open-telemetry/semantic-conventions.git
• <git-url>[<sub-folder>] -> e.g. https://github.com/open-telemetry/semantic-conventions.git[model]
• <git-archive-url> -> e.g. https://github.com/open-telemetry/semantic-conventions/archive/refs/tags/v1.26.0.zip
• <git-archive-url>[<sub-folder>] -> e.g. https://github.com/open-telemetry/semantic-conventions/archive/refs/tags/v1.26.0.zip[model]
• Future extension: <git-url>@<tag|branch|commit>
• Future extension: <git-url>@<tag|branch|commit>[<sub-folder>]

• (#284 by MadVikingGod) The --policy flag now accepts directories.
• (#270 by @lquerel) Follow build tools’ case conversion rules. Numbers are no longer considered word splitters.
• (#276 by @jsuereth) Remove legacy way of writing templates for semconv.
• (#274 by @lquerel) Enhance error reporting for invalid JQ expressions.
• (#275 by @lquerel) The custom JQ filter semconv_grouped_metrics now sorts metrics by their metric_name (issue #268).
• (#256) Bump gix from 0.63.0 to 0.64.0.
• (#271) Bump jaq-parse from 1.0.2 to 1.0.3.
• (#272) Bump jaq-core from 1.5.0 to 1.5.1
• (#273) Bump toml from 0.8.16 to 0.8.17
• (#283) Bump minijinja from 2.1.0 to 2.1.1

Install weaver 0.8.0

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download weaver 0.8.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

0.7.0 - 2024-07-22

Release Notes

What's Changed

• Add support for new custom semconv JQ filters by @lquerel.
• Update Weaver Forge documentation and include a step-by-step guide for codegen authors by @lquerel.

The following new filters have been added to the Weaver Forge:

• semconv_group_attributes_by_root_namespace: Groups the attributes by their root namespace.
• semconv_attributes($options): Extracts and processes semantic convention attributes based on provided options. $options is an object that can contain:
  • exclude_stability: a list of stability statuses to exclude.
  • exclude_deprecated: a boolean to exclude deprecated metrics.
  • exclude_root_namespace: a list of root namespaces to exclude.
• semconv_attributes: Convenience function to extract all attributes without any filtering options.
• semconv_grouped_attributes($options): Groups the processed attributes by their root namespace based on provided options. $options is an object that can contain:
  • exclude_stability: a list of stability statuses to exclude.
  • exclude_deprecated: a boolean to exclude deprecated metrics.
  • exclude_root_namespace: a list of root namespaces to exclude.
• semconv_grouped_attributes: Convenience function to group all attributes by their root namespace without any filtering options.
• semconv_group_metrics_by_root_namespace: Groups the metrics by their root namespace.
• semconv_metrics($options): Extracts and processes semantic convention metrics based on provided options. $options is an object that can contain:
  • exclude_stability: a list of stability statuses to exclude.
  • exclude_deprecated: a boolean to exclude deprecated metrics.
  • exclude_root_namespace: a list of root namespaces to exclude.
• semconv_metrics: Convenience function to extract all metrics without any filtering options.
• semconv_grouped_metrics($options): Groups the processed metrics by their root namespace based on provided options. $options is an object that can contain:
  • exclude_stability: a list of stability statuses to exclude.
  • exclude_deprecated: a boolean to exclude deprecated metrics.
  • exclude_root_namespace: a list of root namespaces to exclude.
• semconv_grouped_metrics: Convenience function to group all metrics by their root namespace without any filtering options.

Install weaver 0.7.0

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download weaver 0.7.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

v0.6.0 - 2024-07-16

Release v0.6.0

We are excited to announce the release of version v0.6.0. This release includes several new features, enhancements, and updates. Below are the highlights:

New Features

• Support for Hierarchical Weaver Config: We have added support for hierarchical configuration in Weaver. This allows more flexible and powerful configuration management. For more details, please refer to the documentation on configuration file loading order and overriding rules.
• Support for MiniJinja py_compat Extensions: This release includes support for MiniJinja py_compat extensions, enhancing compatibility with Python syntax. For more information, see the documentation.

Enhancements

• Removed Unused Filters: We have removed unused filters such as function_name, struct_name, and others to streamline the codebase.

Dependency Updates

• Markdown: Updated from 1.0.0-alpha.17 to 1.0.0-alpha.18.
• itertools: Updated from 0.12.1 to 0.13.0.
• jaq-std: Updated from 1.5.0 to 1.5.1.
• ureq: Updated from 2.9.7 to 2.10.0.
• serde: Updated from 1.0.203 to 1.0.204.
• clap: Updated from 4.5.8 to 4.5.9.
• opentelemetry_sdk: Updated from 0.22.1 to 0.24.0.

Codegen Authors

For those using Weaver for generating code from semantic conventions, please refer to the following documentation to learn more about the latest updates and how to utilize Weaver effectively:

• Templates Organization, Integrated Jinja2 Engine, List of Supported Filters/Functions/Tests
• Weaver Configuration

Thank you for your continued support and contributions to the project. If you encounter any issues or have questions, please feel free to reach out or open an issue on GitHub.

Install weaver 0.6.0

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download weaver 0.6.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

0.5.0 - 2024-07-02

Release Notes

What's Changed

• Add optional variant to requirement_level. by @MadVikingGod in #199
• Add semconv_const filter to support semantic convention namespacing rules. by @lquerel in #200
• Add display_name field. by @joaopgrassi in #202
• Bump regex from 1.10.4 to 1.10.5 by @dependabot in #205
• Bump clap from 4.5.6 to 4.5.7 by @dependabot in #206
• New entry in developer guide to describe the process of adding new fields in the semantic convention registry by @lquerel in #209
• Add Embed option for single attributes by @trisch-me in #212
• Bump include_dir from 0.7.3 to 0.7.4 by @dependabot in #213
• Add support for post-resolution policies by @lquerel in #214
• split_id filter is singular by @bryannaegele in #217
• Add Jinja whitespace control by @joaopgrassi in #224

Install weaver 0.5.0

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download weaver 0.5.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