From 7098bf2d2f40d97e672cef49a1f7890297a91b7d Mon Sep 17 00:00:00 2001 From: Sylvain Juge <763082+SylvainJuge@users.noreply.github.com> Date: Wed, 25 Mar 2026 10:10:07 +0100 Subject: [PATCH 01/17] add readme to avoid re-creating changelog folder when empty --- changelog/README.md | 1 + 1 file changed, 1 insertion(+) create mode 100644 changelog/README.md diff --git a/changelog/README.md b/changelog/README.md new file mode 100644 index 00000000..c435be32 --- /dev/null +++ b/changelog/README.md @@ -0,0 +1 @@ +This folder contains changelog entries (one file per pull-request) that are pending release. From a461dc3ff30d033c5985f5b091bd59c2dbe837ed Mon Sep 17 00:00:00 2001 From: Sylvain Juge <763082+SylvainJuge@users.noreply.github.com> Date: Thu, 26 Mar 2026 09:53:42 +0100 Subject: [PATCH 02/17] start with an simple config --- docs/changelog.yml | 40 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 40 insertions(+) create mode 100644 docs/changelog.yml diff --git a/docs/changelog.yml b/docs/changelog.yml new file mode 100644 index 00000000..ba2691bf --- /dev/null +++ b/docs/changelog.yml @@ -0,0 +1,40 @@ +# use PR ID as changelog filename +filename: pr + +products: + default: + - product: edot-java + lifecycle: ga + +# extract context from PR (title, description, linked issues, ...) +extract: + # there are no 'release notes' section in PR descriptions, so we can skip it + release_notes: false + # extract linked issues from PR descriptions + issues: true + +# mapping from PR labels to changelog type +pivot: + types: + breaking-change: "breaking-change" + bug-fix: "bug" + deprecation: "deprecation" + feature: "feature" + enhancement: "enhancement" + docs: "docs, documentation" + # those types should be used after the release is published, they allow to amend existing bundles + # TODO: investigate what is the expected workflow for those and how to amend existing bundles + known-issue: + regression: + security: + +rules: + create: + exclude: "release_notes:skip" + +bundle: + directory: docs/changelog + output_directory: docs/releases + resolve: true + repo: elastic-otel-java + owner: elastic From c92c7efeca9857169a98774501b6f05e237228f1 Mon Sep 17 00:00:00 2001 From: Sylvain Juge <763082+SylvainJuge@users.noreply.github.com> Date: Thu, 26 Mar 2026 10:19:51 +0100 Subject: [PATCH 03/17] ci: label upstream updates as 'enhancement' --- .ci/updatecli.d/bump-upstream-agent-version.yml | 2 ++ 1 file changed, 2 insertions(+) diff --git a/.ci/updatecli.d/bump-upstream-agent-version.yml b/.ci/updatecli.d/bump-upstream-agent-version.yml index 010176eb..deaf8ff0 100644 --- a/.ci/updatecli.d/bump-upstream-agent-version.yml +++ b/.ci/updatecli.d/bump-upstream-agent-version.yml @@ -66,5 +66,7 @@ actions: automerge: false labels: - dependencies + # use 'enhancement' changelog automation + - enhancement description: | @elastic/apm-agent-java, can you please check and merge this PR? From bea8499f9edc8c8b0273a4707deabc5cb9cd9c47 Mon Sep 17 00:00:00 2001 From: Sylvain Juge <763082+SylvainJuge@users.noreply.github.com> Date: Thu, 26 Mar 2026 10:41:01 +0100 Subject: [PATCH 04/17] add readme for changelog folder --- docs/changelog/README.md | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/changelog/README.md diff --git a/docs/changelog/README.md b/docs/changelog/README.md new file mode 100644 index 00000000..0f182e0f --- /dev/null +++ b/docs/changelog/README.md @@ -0,0 +1 @@ +This folder contains changelog entries that are pending release, is empty when no new release is pending. From d1b834fbb9bdc79adc544fc7fef2cab2cad35737 Mon Sep 17 00:00:00 2001 From: Sylvain Juge <763082+SylvainJuge@users.noreply.github.com> Date: Thu, 26 Mar 2026 15:17:39 +0100 Subject: [PATCH 05/17] finish generating changelog for older versions --- docs/changelog.yml | 3 ++ wip-changelog.sh | 112 +++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 115 insertions(+) create mode 100755 wip-changelog.sh diff --git a/docs/changelog.yml b/docs/changelog.yml index ba2691bf..6a30a857 100644 --- a/docs/changelog.yml +++ b/docs/changelog.yml @@ -33,6 +33,9 @@ rules: exclude: "release_notes:skip" bundle: + # TODO: evaluate if there any benefits to using nested folders here, for example + # docs/changelog for changelog entries + # docs/changelog/bundles for bundles directory: docs/changelog output_directory: docs/releases resolve: true diff --git a/wip-changelog.sh b/wip-changelog.sh new file mode 100755 index 00000000..577aa229 --- /dev/null +++ b/wip-changelog.sh @@ -0,0 +1,112 @@ +#!/bin/bash -x + +set -euo pipefail + +add_pr(){ + version="${2}" + pr="${1}" + + # TODO: do we have to add complete PR URLs here or could we just use the numeric ID ? + # having the complete URL in the generated changelog entry is however convenient for humans to open the link + docs-builder changelog add --prs https://github.com/elastic/elastic-otel-java/pull/${pr} --products "edot-java ${version} ga" + + # remove comments and empty lines from generated changelog to reduce noise + # TODO: might be better to move doc to the bottom or allow to not include comments + sed -i 's/#.*//g' "./docs/changelog/${pr}.yaml" + sed -i '/^[[:space:]]*$/d' "./docs/changelog/${pr}.yaml" + + # TODO: to filter duplicate upstream dependency updates, we could maybe just remove any changelog entry + # for such update, the challenge might be to define a reliable heuristic, relying on PR title seems quite brittle. +} + +create_bundle(){ + version="${1}" + docs-builder changelog bundle \ + --input-products "edot-java ${version} ga" \ + --output "./docs/releases/${version}.yaml" + + # TODO: document changelog remove + docs-builder changelog remove \ + --products "edot-java ${version} ga" +} + +# remove all changelog entries and generated bundles +rm -f ./docs/changelog/*.yaml +rm -f ./docs/releases/*.yaml + +# generate changelog and bundles for each release, the PRs have been labelled +add_pr 973 1.10.0 +add_pr 1001 1.10.0 +add_pr 1017 1.10.0 +create_bundle 1.10.0 + +add_pr 911 1.9.0 +add_pr 932 1.9.0 +add_pr 958 1.9.0 +create_bundle 1.9.0 + +add_pr 898 1.8.0 +add_pr 899 1.8.0 +create_bundle 1.8.0 + +add_pr 838 1.7.0 +add_pr 835 1.7.0 +add_pr 848 1.7.0 +add_pr 844 1.7.0 +create_bundle 1.7.0 + +add_pr 803 1.6.0 +add_pr 763 1.6.0 +add_pr 789 1.6.0 +add_pr 818 1.6.0 +create_bundle 1.6.0 + +add_pr 726 1.5.0 +add_pr 641 1.5.0 +add_pr 712 1.5.0 +add_pr 729 1.5.0 +# add changelog entry not related to a PR +# TODO: how should we handle adding a 'tech preview' feature in a GA product ? +docs-builder changelog add \ + --products "edot-java 1.5.0 ga" \ + --type enhancement \ + --title 'tech preview release of central configuration support for dynamically changing instrumentation and sending, using OpAMP protocol' +create_bundle 1.5.0 + +add_pr 610 1.4.1 +create_bundle 1.4.1 + +add_pr 583 1.4.0 +add_pr 593 1.4.0 +add_pr 607 1.4.0 +add_pr 596 1.4.0 +add_pr 580 1.4.0 +add_pr 603 1.4.0 +create_bundle 1.4.0 + +add_pr 531 1.3.0 +add_pr 564 1.3.0 +add_pr 539 1.3.0 +add_pr 561 1.3.0 +create_bundle 1.3.0 + +add_pr 514 1.2.1 +create_bundle 1.2.1 + +add_pr 422 1.2.0 +add_pr 471 1.2.0 +add_pr 474 1.2.0 +add_pr 497 1.2.0 +add_pr 500 1.2.0 +create_bundle 1.2.0 + +add_pr 423 1.1.0 +add_pr 455 1.1.0 +create_bundle 1.1.0 + +# add changelog entry not related to a PR +docs-builder changelog add \ + --products "edot-java 1.0.0 ga" \ + --type enhancement \ + --title 'first GA release' +create_bundle 1.0.0 From 9f1107a035163ecad710584d50ce1a46ba294a61 Mon Sep 17 00:00:00 2001 From: Sylvain Juge <763082+SylvainJuge@users.noreply.github.com> Date: Thu, 26 Mar 2026 15:18:07 +0100 Subject: [PATCH 06/17] add release note bundles --- docs/releases/1.0.0.yaml | 16 ++++++++ docs/releases/1.1.0.yaml | 29 +++++++++++++++ docs/releases/1.10.0.yaml | 40 ++++++++++++++++++++ docs/releases/1.2.0.yaml | 62 +++++++++++++++++++++++++++++++ docs/releases/1.2.1.yaml | 18 +++++++++ docs/releases/1.3.0.yaml | 53 +++++++++++++++++++++++++++ docs/releases/1.4.0.yaml | 77 +++++++++++++++++++++++++++++++++++++++ docs/releases/1.4.1.yaml | 18 +++++++++ docs/releases/1.5.0.yaml | 62 +++++++++++++++++++++++++++++++ docs/releases/1.6.0.yaml | 53 +++++++++++++++++++++++++++ docs/releases/1.7.0.yaml | 57 +++++++++++++++++++++++++++++ docs/releases/1.8.0.yaml | 29 +++++++++++++++ docs/releases/1.9.0.yaml | 40 ++++++++++++++++++++ 13 files changed, 554 insertions(+) create mode 100644 docs/releases/1.0.0.yaml create mode 100644 docs/releases/1.1.0.yaml create mode 100644 docs/releases/1.10.0.yaml create mode 100644 docs/releases/1.2.0.yaml create mode 100644 docs/releases/1.2.1.yaml create mode 100644 docs/releases/1.3.0.yaml create mode 100644 docs/releases/1.4.0.yaml create mode 100644 docs/releases/1.4.1.yaml create mode 100644 docs/releases/1.5.0.yaml create mode 100644 docs/releases/1.6.0.yaml create mode 100644 docs/releases/1.7.0.yaml create mode 100644 docs/releases/1.8.0.yaml create mode 100644 docs/releases/1.9.0.yaml diff --git a/docs/releases/1.0.0.yaml b/docs/releases/1.0.0.yaml new file mode 100644 index 00000000..9b637053 --- /dev/null +++ b/docs/releases/1.0.0.yaml @@ -0,0 +1,16 @@ +products: +- product: edot-java + target: 1.0.0 + lifecycle: ga + repo: elastic-otel-java + owner: elastic +entries: +- file: + name: 1774534599-first-ga-release.yaml + checksum: 302ab54915fc331db323023dea3d8d2ed3fb3917 + type: enhancement + title: first GA release + products: + - product: edot-java + target: 1.0.0 + lifecycle: ga diff --git a/docs/releases/1.1.0.yaml b/docs/releases/1.1.0.yaml new file mode 100644 index 00000000..62f0ca8e --- /dev/null +++ b/docs/releases/1.1.0.yaml @@ -0,0 +1,29 @@ +products: +- product: edot-java + target: 1.1.0 + lifecycle: ga + repo: elastic-otel-java + owner: elastic +entries: +- file: + name: 455.yaml + checksum: 2290d77fc788da87d4744a41ad3379b28da4878a + type: enhancement + title: update upstream 2.10.0 + products: + - product: edot-java + target: 1.1.0 + lifecycle: ga + prs: + - https://github.com/elastic/elastic-otel-java/pull/455 +- file: + name: 423.yaml + checksum: 44a63f0af2dc9f29e1622632a3988440d917c26d + type: bug-fix + title: Fix missing transitive dependencies when using universal profiling integration + products: + - product: edot-java + target: 1.1.0 + lifecycle: ga + prs: + - https://github.com/elastic/elastic-otel-java/pull/423 diff --git a/docs/releases/1.10.0.yaml b/docs/releases/1.10.0.yaml new file mode 100644 index 00000000..482879be --- /dev/null +++ b/docs/releases/1.10.0.yaml @@ -0,0 +1,40 @@ +products: +- product: edot-java + target: 1.10.0 + lifecycle: ga + repo: elastic-otel-java + owner: elastic +entries: +- file: + name: 1001.yaml + checksum: b87a336d3c9700cfbcdf0cd607e822a3620f0f1d + type: enhancement + title: Update upstream OpenTelemetry agent dependencies to 2.26.0 + products: + - product: edot-java + target: 1.10.0 + lifecycle: ga + prs: + - https://github.com/elastic/elastic-otel-java/pull/1001 +- file: + name: 973.yaml + checksum: 0b4e293ae737f0f91282a6b55eb2a0a6f5633eff + type: enhancement + title: Update upstream OpenTelemetry agent dependencies to 2.25.0 + products: + - product: edot-java + target: 1.10.0 + lifecycle: ga + prs: + - https://github.com/elastic/elastic-otel-java/pull/973 +- file: + name: 1017.yaml + checksum: 39f94151ac7b2705cebdf773af1042d15ea9ba69 + type: enhancement + title: Update upstream OpenTelemetry agent dependencies to 2.26.1 + products: + - product: edot-java + target: 1.10.0 + lifecycle: ga + prs: + - https://github.com/elastic/elastic-otel-java/pull/1017 diff --git a/docs/releases/1.2.0.yaml b/docs/releases/1.2.0.yaml new file mode 100644 index 00000000..cc2dab66 --- /dev/null +++ b/docs/releases/1.2.0.yaml @@ -0,0 +1,62 @@ +products: +- product: edot-java + target: 1.2.0 + lifecycle: ga + repo: elastic-otel-java + owner: elastic +entries: +- file: + name: 497.yaml + checksum: 7ec3f1f83a31aebbad616c96694b89cafea4e055 + type: enhancement + title: Add experimental instrumentation for OpenAI client + products: + - product: edot-java + target: 1.2.0 + lifecycle: ga + prs: + - https://github.com/elastic/elastic-otel-java/pull/497 +- file: + name: 474.yaml + checksum: f3b5a550c15ce52d4a94a5da693e52d0799c7cc7 + type: enhancement + title: add stop-sending option + products: + - product: edot-java + target: 1.2.0 + lifecycle: ga + prs: + - https://github.com/elastic/elastic-otel-java/pull/474 +- file: + name: 471.yaml + checksum: 43806e6676262bb76db14a92e96e460dbd95e582 + type: enhancement + title: add disable all instrumentations option + products: + - product: edot-java + target: 1.2.0 + lifecycle: ga + prs: + - https://github.com/elastic/elastic-otel-java/pull/471 +- file: + name: 500.yaml + checksum: 0c2eaa377c437fcd9061a099929e84f17dba6a04 + type: enhancement + title: Update upstream OpenTelemetry agent dependencies to 2.12.0 + products: + - product: edot-java + target: 1.2.0 + lifecycle: ga + prs: + - https://github.com/elastic/elastic-otel-java/pull/500 +- file: + name: 422.yaml + checksum: 1b877bfbbffdb6e248d3552095e0742625e0a298 + type: enhancement + title: add dynamically disabled instrumentation capability + products: + - product: edot-java + target: 1.2.0 + lifecycle: ga + prs: + - https://github.com/elastic/elastic-otel-java/pull/422 diff --git a/docs/releases/1.2.1.yaml b/docs/releases/1.2.1.yaml new file mode 100644 index 00000000..8752e3ae --- /dev/null +++ b/docs/releases/1.2.1.yaml @@ -0,0 +1,18 @@ +products: +- product: edot-java + target: 1.2.1 + lifecycle: ga + repo: elastic-otel-java + owner: elastic +entries: +- file: + name: 514.yaml + checksum: 9dbf362c31b7b7f6d55764db81aaca4331dff165 + type: enhancement + title: Add support for OpenAI client 0.13.0 + products: + - product: edot-java + target: 1.2.1 + lifecycle: ga + prs: + - https://github.com/elastic/elastic-otel-java/pull/514 diff --git a/docs/releases/1.3.0.yaml b/docs/releases/1.3.0.yaml new file mode 100644 index 00000000..095d521b --- /dev/null +++ b/docs/releases/1.3.0.yaml @@ -0,0 +1,53 @@ +products: +- product: edot-java + target: 1.3.0 + lifecycle: ga + repo: elastic-otel-java + owner: elastic +entries: +- file: + name: 564.yaml + checksum: e0f4d9006a31e593295ecb760e9fb4c80e287362 + type: enhancement + title: Add support for OpenAI client 0.22 to 0.31 + products: + - product: edot-java + target: 1.3.0 + lifecycle: ga + prs: + - https://github.com/elastic/elastic-otel-java/pull/564 +- file: + name: 561.yaml + checksum: 6072ecdb1b2e6b0f49f119a3910f528fbd9456d0 + type: enhancement + title: fix upstream otel update for 2.13.3 + products: + - product: edot-java + target: 1.3.0 + lifecycle: ga + prs: + - https://github.com/elastic/elastic-otel-java/pull/561 +- file: + name: 539.yaml + checksum: 0cfeb37c6ea43935b857a8cdb21e89ff0fa56f25 + type: enhancement + title: Fix support for OpenAI developer messages + products: + - product: edot-java + target: 1.3.0 + lifecycle: ga + prs: + - https://github.com/elastic/elastic-otel-java/pull/539 + issues: + - https://github.com/elastic/elastic-otel-java/issues/532 +- file: + name: 531.yaml + checksum: 3d53748428ff2e94dc0b3afc3d3d6b801c4b1a1d + type: enhancement + title: Fix instrumentation support for OpenAI client 0.14+ + products: + - product: edot-java + target: 1.3.0 + lifecycle: ga + prs: + - https://github.com/elastic/elastic-otel-java/pull/531 diff --git a/docs/releases/1.4.0.yaml b/docs/releases/1.4.0.yaml new file mode 100644 index 00000000..1a18e1f2 --- /dev/null +++ b/docs/releases/1.4.0.yaml @@ -0,0 +1,77 @@ +products: +- product: edot-java + target: 1.4.0 + lifecycle: ga + repo: elastic-otel-java + owner: elastic +entries: +- file: + name: 583.yaml + checksum: 3791a3e9b5ac7184acc152cd52ffcf76eb8e7795 + type: enhancement + title: Change default metric temporality to delta + products: + - product: edot-java + target: 1.4.0 + lifecycle: ga + prs: + - https://github.com/elastic/elastic-otel-java/pull/583 + issues: + - https://github.com/elastic/elastic-otel-java/issues/446 +- file: + name: 607.yaml + checksum: af888f56344f4717c13dbb1e84d181ee59d0bef5 + type: enhancement + title: Add support for openAI client 1.1+, drop support for older versions + products: + - product: edot-java + target: 1.4.0 + lifecycle: ga + prs: + - https://github.com/elastic/elastic-otel-java/pull/607 +- file: + name: 593.yaml + checksum: 9a9ee121a7fbfbb4dfa75ec2262b0c10ed3220c1 + type: enhancement + title: Override user agent header for otlp exporters + products: + - product: edot-java + target: 1.4.0 + lifecycle: ga + prs: + - https://github.com/elastic/elastic-otel-java/pull/593 + issues: + - https://github.com/elastic/elastic-otel-java/issues/448 +- file: + name: 603.yaml + checksum: 33aa7c1cef9a3dee247d51714c89f07406fa06f7 + type: enhancement + title: Update upstream OpenTelemetry agent dependencies to 2.15.0 + products: + - product: edot-java + target: 1.4.0 + lifecycle: ga + prs: + - https://github.com/elastic/elastic-otel-java/pull/603 +- file: + name: 580.yaml + checksum: bc87fb1e3086b936ebea6ba2815ed485260c2f8c + type: enhancement + title: Update upstream OpenTelemetry agent dependencies to 2.14.0 + products: + - product: edot-java + target: 1.4.0 + lifecycle: ga + prs: + - https://github.com/elastic/elastic-otel-java/pull/580 +- file: + name: 596.yaml + checksum: 602477f37ba4b76a1d0e8942fdc4eb5d6ad054b1 + type: enhancement + title: enable azure provider by default when available + products: + - product: edot-java + target: 1.4.0 + lifecycle: ga + prs: + - https://github.com/elastic/elastic-otel-java/pull/596 diff --git a/docs/releases/1.4.1.yaml b/docs/releases/1.4.1.yaml new file mode 100644 index 00000000..7e101668 --- /dev/null +++ b/docs/releases/1.4.1.yaml @@ -0,0 +1,18 @@ +products: +- product: edot-java + target: 1.4.1 + lifecycle: ga + repo: elastic-otel-java + owner: elastic +entries: +- file: + name: 610.yaml + checksum: 18a256e988d018719a559aac7326948f9e9f6ed2 + type: bug-fix + title: Workaround for temporality configuration not being possible + products: + - product: edot-java + target: 1.4.1 + lifecycle: ga + prs: + - https://github.com/elastic/elastic-otel-java/pull/610 diff --git a/docs/releases/1.5.0.yaml b/docs/releases/1.5.0.yaml new file mode 100644 index 00000000..5567744a --- /dev/null +++ b/docs/releases/1.5.0.yaml @@ -0,0 +1,62 @@ +products: +- product: edot-java + target: 1.5.0 + lifecycle: ga + repo: elastic-otel-java + owner: elastic +entries: +- file: + name: 712.yaml + checksum: fb8054886914f2e350f7b4ac5d7cf466501f816e + type: enhancement + title: Update upstream OpenTelemetry agent dependencies to 2.17.0 + products: + - product: edot-java + target: 1.5.0 + lifecycle: ga + prs: + - https://github.com/elastic/elastic-otel-java/pull/712 +- file: + name: 1774534585-tech-preview-release-of-central-configuration-supp.yaml + checksum: 9658915b21905328900f102bb4630330a402e495 + type: enhancement + title: tech preview release of central configuration support for dynamically changing instrumentation and sending, using OpAMP protocol + products: + - product: edot-java + target: 1.5.0 + lifecycle: ga +- file: + name: 641.yaml + checksum: 6c7f2f6ba601046ad56cb78baefddee3c6cd572b + type: enhancement + title: Update upstream OpenTelemetry agent dependencies to 2.16.0 + products: + - product: edot-java + target: 1.5.0 + lifecycle: ga + prs: + - https://github.com/elastic/elastic-otel-java/pull/641 +- file: + name: 726.yaml + checksum: c0d8f24359c11428bdbf800ba102f33adb7b42ae + type: enhancement + title: add option to bypass certificate validation + products: + - product: edot-java + target: 1.5.0 + lifecycle: ga + prs: + - https://github.com/elastic/elastic-otel-java/pull/726 + issues: + - https://github.com/elastic/elastic-otel-java/issues/493 +- file: + name: 729.yaml + checksum: bae190e7ba0b4cd03a31d42a7f83e5a4a90cfcc3 + type: enhancement + title: Update upstream OpenTelemetry agent dependencies to 2.17.1 + products: + - product: edot-java + target: 1.5.0 + lifecycle: ga + prs: + - https://github.com/elastic/elastic-otel-java/pull/729 diff --git a/docs/releases/1.6.0.yaml b/docs/releases/1.6.0.yaml new file mode 100644 index 00000000..e8bff731 --- /dev/null +++ b/docs/releases/1.6.0.yaml @@ -0,0 +1,53 @@ +products: +- product: edot-java + target: 1.6.0 + lifecycle: ga + repo: elastic-otel-java + owner: elastic +entries: +- file: + name: 803.yaml + checksum: 5a4268ebe44333701ec9d0f4f840fc0a50f5b182 + type: enhancement + title: Update upstream OpenTelemetry agent dependencies to 2.20.1 + products: + - product: edot-java + target: 1.6.0 + lifecycle: ga + prs: + - https://github.com/elastic/elastic-otel-java/pull/803 +- file: + name: 818.yaml + checksum: a358d474350bcdb51e86fcdca0b687806e3820a3 + type: enhancement + title: Add 9.2 supported dynamic config options + products: + - product: edot-java + target: 1.6.0 + lifecycle: ga + prs: + - https://github.com/elastic/elastic-otel-java/pull/818 +- file: + name: 789.yaml + checksum: cae5da96cc54fc21a23265e0ebbba2cdf5ad8bb7 + type: enhancement + title: Opamp migration + products: + - product: edot-java + target: 1.6.0 + lifecycle: ga + prs: + - https://github.com/elastic/elastic-otel-java/pull/789 + issues: + - https://github.com/elastic/elastic-otel-java/issues/788 +- file: + name: 763.yaml + checksum: 948f1b512463fe42ca6dbc68561752de2ad43c70 + type: breaking-change + title: switch to 2.18.1, and switch openai to upstream + products: + - product: edot-java + target: 1.6.0 + lifecycle: ga + prs: + - https://github.com/elastic/elastic-otel-java/pull/763 diff --git a/docs/releases/1.7.0.yaml b/docs/releases/1.7.0.yaml new file mode 100644 index 00000000..b86fda5d --- /dev/null +++ b/docs/releases/1.7.0.yaml @@ -0,0 +1,57 @@ +products: +- product: edot-java + target: 1.7.0 + lifecycle: ga + repo: elastic-otel-java + owner: elastic +entries: +- file: + name: 835.yaml + checksum: a8b3a5b5e2136ceb9d0fd67e0018227ad3b93134 + type: enhancement + title: add config logging on agent startup + products: + - product: edot-java + target: 1.7.0 + lifecycle: ga + prs: + - https://github.com/elastic/elastic-otel-java/pull/835 + issues: + - https://github.com/elastic/elastic-otel-java/issues/730 +- file: + name: 848.yaml + checksum: 65b0561962cf07cff3b1f1f0168cb13bfef4b923 + type: enhancement + title: add support for elastic.otel.opamp.headers config + products: + - product: edot-java + target: 1.7.0 + lifecycle: ga + prs: + - https://github.com/elastic/elastic-otel-java/pull/848 + issues: + - https://github.com/elastic/elastic-otel-java/issues/833 +- file: + name: 844.yaml + checksum: db263b3a162de735a6e33a2d6886a2c57480bc56 + type: enhancement + title: Update upstream OpenTelemetry agent dependencies to 2.21.0 + products: + - product: edot-java + target: 1.7.0 + lifecycle: ga + prs: + - https://github.com/elastic/elastic-otel-java/pull/844 +- file: + name: 838.yaml + checksum: 2d67dce53e0a537f26a5b4c4d7679ec856958a5d + type: enhancement + title: add infer-spans dynamoic central config handling + products: + - product: edot-java + target: 1.7.0 + lifecycle: ga + prs: + - https://github.com/elastic/elastic-otel-java/pull/838 + issues: + - https://github.com/elastic/elastic-otel-java/issues/301 diff --git a/docs/releases/1.8.0.yaml b/docs/releases/1.8.0.yaml new file mode 100644 index 00000000..2489f166 --- /dev/null +++ b/docs/releases/1.8.0.yaml @@ -0,0 +1,29 @@ +products: +- product: edot-java + target: 1.8.0 + lifecycle: ga + repo: elastic-otel-java + owner: elastic +entries: +- file: + name: 899.yaml + checksum: 8917a0bb587d53bc958b71f1a6e52546176e64f9 + type: enhancement + title: enable indy by default + products: + - product: edot-java + target: 1.8.0 + lifecycle: ga + prs: + - https://github.com/elastic/elastic-otel-java/pull/899 +- file: + name: 898.yaml + checksum: 0ebb827244c0ca0b1d2a67248cb544fbfba68ed6 + type: enhancement + title: Update upstream OpenTelemetry agent dependencies to 2.22.0 + products: + - product: edot-java + target: 1.8.0 + lifecycle: ga + prs: + - https://github.com/elastic/elastic-otel-java/pull/898 diff --git a/docs/releases/1.9.0.yaml b/docs/releases/1.9.0.yaml new file mode 100644 index 00000000..8b681c4a --- /dev/null +++ b/docs/releases/1.9.0.yaml @@ -0,0 +1,40 @@ +products: +- product: edot-java + target: 1.9.0 + lifecycle: ga + repo: elastic-otel-java + owner: elastic +entries: +- file: + name: 932.yaml + checksum: 65379a859a8bc866929ee2d3e9b335f40a854a8f + type: enhancement + title: Update upstream OpenTelemetry agent dependencies to 2.24.0 + products: + - product: edot-java + target: 1.9.0 + lifecycle: ga + prs: + - https://github.com/elastic/elastic-otel-java/pull/932 +- file: + name: 911.yaml + checksum: 2c5fffca3b66b755872bfd683df3ea83a62cbfd8 + type: enhancement + title: Update upstream OpenTelemetry agent dependencies to 2.23.0 + products: + - product: edot-java + target: 1.9.0 + lifecycle: ga + prs: + - https://github.com/elastic/elastic-otel-java/pull/911 +- file: + name: 958.yaml + checksum: 8945e17491236ea6d8fabda01b15c4bdb4ebd1ed + type: breaking-change + title: document universal profiling as opt-in + products: + - product: edot-java + target: 1.9.0 + lifecycle: ga + prs: + - https://github.com/elastic/elastic-otel-java/pull/958 From 343c1db66ea1707cd09a3e30fb7750386b79e3d6 Mon Sep 17 00:00:00 2001 From: Sylvain Juge <763082+SylvainJuge@users.noreply.github.com> Date: Thu, 26 Mar 2026 15:32:50 +0100 Subject: [PATCH 07/17] ignore with 'chore' label --- changelog/README.md | 1 - docs/changelog.yml | 2 +- 2 files changed, 1 insertion(+), 2 deletions(-) delete mode 100644 changelog/README.md diff --git a/changelog/README.md b/changelog/README.md deleted file mode 100644 index c435be32..00000000 --- a/changelog/README.md +++ /dev/null @@ -1 +0,0 @@ -This folder contains changelog entries (one file per pull-request) that are pending release. diff --git a/docs/changelog.yml b/docs/changelog.yml index 6a30a857..86a8af9c 100644 --- a/docs/changelog.yml +++ b/docs/changelog.yml @@ -30,7 +30,7 @@ pivot: rules: create: - exclude: "release_notes:skip" + exclude: "chore" bundle: # TODO: evaluate if there any benefits to using nested folders here, for example From 4376be4f9beb29b5b4a8f43c40deb5e23982bae6 Mon Sep 17 00:00:00 2001 From: lcawl Date: Fri, 27 Mar 2026 19:28:24 -0700 Subject: [PATCH 08/17] Add profiles to changelog.yml --- docs/changelog.yml | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/docs/changelog.yml b/docs/changelog.yml index 86a8af9c..65cc8af8 100644 --- a/docs/changelog.yml +++ b/docs/changelog.yml @@ -41,3 +41,24 @@ bundle: resolve: true repo: elastic-otel-java owner: elastic + + # Named bundle profiles for different release scenarios. + # Profiles can be used with both 'changelog bundle' and 'changelog remove': + # docs-builder changelog bundle elasticsearch-release 9.2.0 + # docs-builder changelog remove elasticsearch-release 9.2.0 + # When used with 'changelog remove', only the 'products' field is applied. + # The 'output', 'output_products', 'repo', 'owner', and 'hide_features' fields are + # bundle-specific and are ignored for removal. + profiles: + # Example: Edot-java release profile (filter by changelog fields) + edot-java-release: + # Filter: which input changelogs to include ({version} and {lifecycle} are substituted at runtime) + products: "edot-java {version} {lifecycle}" + # Output filename ({version} is substituted at runtime) + output: "{version}.yaml" + # Optional: override the products array written to the bundle output. + # output_products: "edot-java {version}" + # # Feature IDs to hide when bundling with this profile (accepts string or list) + # hide_features: + # - feature-flag-1 + # - feature-flag-2 \ No newline at end of file From fa325c561e3c40990bbe7f642d3007285b126edb Mon Sep 17 00:00:00 2001 From: lcawl Date: Fri, 27 Mar 2026 19:49:32 -0700 Subject: [PATCH 09/17] Add changelog directives --- docs/release-notes/breaking-changes.md | 7 ++++++- docs/release-notes/deprecations.md | 8 ++++++-- docs/release-notes/index.md | 8 ++++++-- docs/release-notes/known-issues.md | 6 +++++- 4 files changed, 23 insertions(+), 6 deletions(-) diff --git a/docs/release-notes/breaking-changes.md b/docs/release-notes/breaking-changes.md index e5895db9..01559b76 100644 --- a/docs/release-notes/breaking-changes.md +++ b/docs/release-notes/breaking-changes.md @@ -28,6 +28,11 @@ Breaking changes can impact your applications, potentially disrupting normal ope % :::: % TEMPLATE END +:::{changelog} /releases/ +:type: breaking-change +::: + + diff --git a/docs/release-notes/deprecations.md b/docs/release-notes/deprecations.md index 308b3509..cc73bc5b 100644 --- a/docs/release-notes/deprecations.md +++ b/docs/release-notes/deprecations.md @@ -16,7 +16,7 @@ products: Over time, certain Elastic functionality becomes outdated and is replaced or removed. To help with the transition, Elastic deprecates functionality for a period before removal, giving you time to update your applications. Review the deprecated functionality for Elastic Distribution of OpenTelemetry Java. While deprecations have no immediate impact, we strongly encourage you update your implementation after you upgrade. To learn how to upgrade, check out [Upgrade](docs-content://deploy-manage/upgrade.md). - + + +:::{changelog} /releases/ +:type: deprecation +::: \ No newline at end of file diff --git a/docs/release-notes/index.md b/docs/release-notes/index.md index c80db739..e139d040 100644 --- a/docs/release-notes/index.md +++ b/docs/release-notes/index.md @@ -17,7 +17,11 @@ Review the changes, fixes, and more in each version of Elastic Distribution of O To check for security updates, go to [Security announcements for the Elastic stack](https://discuss.elastic.co/c/announcements/security-announcements/31). -% Release notes include only features, enhancements, and fixes. Add breaking changes, deprecations, and known issues to the applicable release notes sections. +:::{changelog} /releases/ +:type: all +::: + + diff --git a/docs/release-notes/known-issues.md b/docs/release-notes/known-issues.md index 8830d3c7..86c27cf7 100644 --- a/docs/release-notes/known-issues.md +++ b/docs/release-notes/known-issues.md @@ -13,4 +13,8 @@ products: # Elastic Distribution of OpenTelemetry Java known issues -No known issues. + + +:::{changelog} /releases/ +:type: known-issue +::: From 92d72046d549c9dad5534b9948ab6611ad304cc4 Mon Sep 17 00:00:00 2001 From: Sylvain Juge <763082+SylvainJuge@users.noreply.github.com> Date: Tue, 31 Mar 2026 11:08:18 +0200 Subject: [PATCH 10/17] use --consise --- wip-changelog.sh | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-) diff --git a/wip-changelog.sh b/wip-changelog.sh index 577aa229..1e806ddb 100755 --- a/wip-changelog.sh +++ b/wip-changelog.sh @@ -8,12 +8,10 @@ add_pr(){ # TODO: do we have to add complete PR URLs here or could we just use the numeric ID ? # having the complete URL in the generated changelog entry is however convenient for humans to open the link - docs-builder changelog add --prs https://github.com/elastic/elastic-otel-java/pull/${pr} --products "edot-java ${version} ga" - - # remove comments and empty lines from generated changelog to reduce noise - # TODO: might be better to move doc to the bottom or allow to not include comments - sed -i 's/#.*//g' "./docs/changelog/${pr}.yaml" - sed -i '/^[[:space:]]*$/d' "./docs/changelog/${pr}.yaml" + docs-builder changelog add \ + --concise \ + --prs https://github.com/elastic/elastic-otel-java/pull/${pr} \ + --products "edot-java ${version} ga" # TODO: to filter duplicate upstream dependency updates, we could maybe just remove any changelog entry # for such update, the challenge might be to define a reliable heuristic, relying on PR title seems quite brittle. From 09613263a8dd2eb8af36bf5baaff95190d2bc545 Mon Sep 17 00:00:00 2001 From: Sylvain Juge <763082+SylvainJuge@users.noreply.github.com> Date: Wed, 1 Apr 2026 09:38:09 +0200 Subject: [PATCH 11/17] deduplicate upstream updates --- docs/changelog.yml | 3 --- docs/releases/1.1.0.yaml | 4 ++-- docs/releases/1.10.0.yaml | 27 +++------------------------ docs/releases/1.2.0.yaml | 23 ++++++++++++----------- docs/releases/1.2.1.yaml | 2 +- docs/releases/1.3.0.yaml | 8 ++++---- docs/releases/1.4.0.yaml | 34 ++++++++++++---------------------- docs/releases/1.4.1.yaml | 2 +- docs/releases/1.5.0.yaml | 33 ++++++--------------------------- docs/releases/1.6.0.yaml | 29 +++++++++++++++-------------- docs/releases/1.7.0.yaml | 25 +++++++++++++------------ docs/releases/1.8.0.yaml | 7 ++++--- docs/releases/1.9.0.yaml | 30 ++++++++++-------------------- 13 files changed, 83 insertions(+), 144 deletions(-) diff --git a/docs/changelog.yml b/docs/changelog.yml index 65cc8af8..b93398e3 100644 --- a/docs/changelog.yml +++ b/docs/changelog.yml @@ -33,9 +33,6 @@ rules: exclude: "chore" bundle: - # TODO: evaluate if there any benefits to using nested folders here, for example - # docs/changelog for changelog entries - # docs/changelog/bundles for bundles directory: docs/changelog output_directory: docs/releases resolve: true diff --git a/docs/releases/1.1.0.yaml b/docs/releases/1.1.0.yaml index 62f0ca8e..b2caf7d1 100644 --- a/docs/releases/1.1.0.yaml +++ b/docs/releases/1.1.0.yaml @@ -7,7 +7,7 @@ entries: - file: name: 455.yaml - checksum: 2290d77fc788da87d4744a41ad3379b28da4878a + checksum: 2ed25ec4208bd4f01090072823c3c03735deb43f type: enhancement title: update upstream 2.10.0 products: @@ -18,7 +18,7 @@ entries: - https://github.com/elastic/elastic-otel-java/pull/455 - file: name: 423.yaml - checksum: 44a63f0af2dc9f29e1622632a3988440d917c26d + checksum: 568cf15908db42bab8cbd9f7f0f8f0bfe773c9d6 type: bug-fix title: Fix missing transitive dependencies when using universal profiling integration products: diff --git a/docs/releases/1.10.0.yaml b/docs/releases/1.10.0.yaml index 482879be..75509558 100644 --- a/docs/releases/1.10.0.yaml +++ b/docs/releases/1.10.0.yaml @@ -6,35 +6,14 @@ owner: elastic entries: - file: - name: 1001.yaml - checksum: b87a336d3c9700cfbcdf0cd607e822a3620f0f1d - type: enhancement - title: Update upstream OpenTelemetry agent dependencies to 2.26.0 - products: - - product: edot-java - target: 1.10.0 - lifecycle: ga - prs: - - https://github.com/elastic/elastic-otel-java/pull/1001 -- file: - name: 973.yaml - checksum: 0b4e293ae737f0f91282a6b55eb2a0a6f5633eff - type: enhancement - title: Update upstream OpenTelemetry agent dependencies to 2.25.0 - products: - - product: edot-java - target: 1.10.0 - lifecycle: ga - prs: - - https://github.com/elastic/elastic-otel-java/pull/973 -- file: - name: 1017.yaml - checksum: 39f94151ac7b2705cebdf773af1042d15ea9ba69 + name: upstream-update.yaml + checksum: d71dbd28df5b9fad9ad8ab6a703070092ac76172 type: enhancement title: Update upstream OpenTelemetry agent dependencies to 2.26.1 products: - product: edot-java target: 1.10.0 lifecycle: ga + description: '- javaagent:[2.26.1](https://github.com/open-telemetry/opentelemetry-java-instrumentation/releases/tag/v2.26.1) sdk:[1.60.1](https://github.com/open-telemetry/opentelemetry-java/releases/tag/v1.60.1) semconv:[1.40.0](https://github.com/open-telemetry/semantic-conventions-java/releases/tag/v1.40.0) contrib:[1.54.0](https://github.com/open-telemetry/opentelemetry-java-contrib/releases/tag/v1.54.0)' prs: - https://github.com/elastic/elastic-otel-java/pull/1017 diff --git a/docs/releases/1.2.0.yaml b/docs/releases/1.2.0.yaml index cc2dab66..7c996aea 100644 --- a/docs/releases/1.2.0.yaml +++ b/docs/releases/1.2.0.yaml @@ -7,7 +7,7 @@ entries: - file: name: 497.yaml - checksum: 7ec3f1f83a31aebbad616c96694b89cafea4e055 + checksum: e3dbd57033df12ab7d302a2245bb5077481060e7 type: enhancement title: Add experimental instrumentation for OpenAI client products: @@ -18,7 +18,7 @@ entries: - https://github.com/elastic/elastic-otel-java/pull/497 - file: name: 474.yaml - checksum: f3b5a550c15ce52d4a94a5da693e52d0799c7cc7 + checksum: 135abef4bc8216eaea11bc736b663eb4735f0119 type: enhancement title: add stop-sending option products: @@ -29,7 +29,7 @@ entries: - https://github.com/elastic/elastic-otel-java/pull/474 - file: name: 471.yaml - checksum: 43806e6676262bb76db14a92e96e460dbd95e582 + checksum: ec607a2eaa35edc69d079f5382f8537a88fa8366 type: enhancement title: add disable all instrumentations option products: @@ -39,24 +39,25 @@ entries: prs: - https://github.com/elastic/elastic-otel-java/pull/471 - file: - name: 500.yaml - checksum: 0c2eaa377c437fcd9061a099929e84f17dba6a04 + name: 422.yaml + checksum: d981e4a6d649d31a15d89687bcd95bc9babff8f3 type: enhancement - title: Update upstream OpenTelemetry agent dependencies to 2.12.0 + title: add dynamically disabled instrumentation capability products: - product: edot-java target: 1.2.0 lifecycle: ga prs: - - https://github.com/elastic/elastic-otel-java/pull/500 + - https://github.com/elastic/elastic-otel-java/pull/422 - file: - name: 422.yaml - checksum: 1b877bfbbffdb6e248d3552095e0742625e0a298 + name: upstream-update.yaml + checksum: 0f454f651c96799004071cfbe6e10715f178a4d5 type: enhancement - title: add dynamically disabled instrumentation capability + title: Update upstream OpenTelemetry agent dependencies to 2.12.0 products: - product: edot-java target: 1.2.0 lifecycle: ga + description: '- javaagent:[2.12.0](https://github.com/open-telemetry/opentelemetry-java-instrumentation/releases/tag/v2.12.0) sdk:[1.46.0](https://github.com/open-telemetry/opentelemetry-java/releases/tag/v1.46.0) semconv:[1.29.0](https://github.com/open-telemetry/semantic-conventions-java/releases/tag/v1.29.0) contrib:[1.42.0](https://github.com/open-telemetry/opentelemetry-java-contrib/releases/tag/v1.42.0)' prs: - - https://github.com/elastic/elastic-otel-java/pull/422 + - https://github.com/elastic/elastic-otel-java/pull/500 diff --git a/docs/releases/1.2.1.yaml b/docs/releases/1.2.1.yaml index 8752e3ae..8cd026fe 100644 --- a/docs/releases/1.2.1.yaml +++ b/docs/releases/1.2.1.yaml @@ -7,7 +7,7 @@ entries: - file: name: 514.yaml - checksum: 9dbf362c31b7b7f6d55764db81aaca4331dff165 + checksum: bacac3ea32027b613bdede584106bbc476052826 type: enhancement title: Add support for OpenAI client 0.13.0 products: diff --git a/docs/releases/1.3.0.yaml b/docs/releases/1.3.0.yaml index 095d521b..e7f19922 100644 --- a/docs/releases/1.3.0.yaml +++ b/docs/releases/1.3.0.yaml @@ -7,7 +7,7 @@ entries: - file: name: 564.yaml - checksum: e0f4d9006a31e593295ecb760e9fb4c80e287362 + checksum: d227a4491edbe1fbb82c718d9d7b9caeefde4c66 type: enhancement title: Add support for OpenAI client 0.22 to 0.31 products: @@ -18,7 +18,7 @@ entries: - https://github.com/elastic/elastic-otel-java/pull/564 - file: name: 561.yaml - checksum: 6072ecdb1b2e6b0f49f119a3910f528fbd9456d0 + checksum: ef38522ab77256d90f874ffa57e1b2a6d8eab869 type: enhancement title: fix upstream otel update for 2.13.3 products: @@ -29,7 +29,7 @@ entries: - https://github.com/elastic/elastic-otel-java/pull/561 - file: name: 539.yaml - checksum: 0cfeb37c6ea43935b857a8cdb21e89ff0fa56f25 + checksum: 948354d7c40f7acffed3ac21bd72e2f6591a7c62 type: enhancement title: Fix support for OpenAI developer messages products: @@ -42,7 +42,7 @@ entries: - https://github.com/elastic/elastic-otel-java/issues/532 - file: name: 531.yaml - checksum: 3d53748428ff2e94dc0b3afc3d3d6b801c4b1a1d + checksum: 5534514eb260aa6ccfea87e8fd078e035462dfe3 type: enhancement title: Fix instrumentation support for OpenAI client 0.14+ products: diff --git a/docs/releases/1.4.0.yaml b/docs/releases/1.4.0.yaml index 1a18e1f2..29dbb514 100644 --- a/docs/releases/1.4.0.yaml +++ b/docs/releases/1.4.0.yaml @@ -7,7 +7,7 @@ entries: - file: name: 583.yaml - checksum: 3791a3e9b5ac7184acc152cd52ffcf76eb8e7795 + checksum: 020bf6ab1dfc9fa1c5335ac62017ca4e943002a0 type: enhancement title: Change default metric temporality to delta products: @@ -20,7 +20,7 @@ entries: - https://github.com/elastic/elastic-otel-java/issues/446 - file: name: 607.yaml - checksum: af888f56344f4717c13dbb1e84d181ee59d0bef5 + checksum: 661657aa8b13d5fd34f9f50739b7a02c544e0dd0 type: enhancement title: Add support for openAI client 1.1+, drop support for older versions products: @@ -31,7 +31,7 @@ entries: - https://github.com/elastic/elastic-otel-java/pull/607 - file: name: 593.yaml - checksum: 9a9ee121a7fbfbb4dfa75ec2262b0c10ed3220c1 + checksum: f187d99aad78afa7200e57099ee3f68864062a9d type: enhancement title: Override user agent header for otlp exporters products: @@ -43,35 +43,25 @@ entries: issues: - https://github.com/elastic/elastic-otel-java/issues/448 - file: - name: 603.yaml - checksum: 33aa7c1cef9a3dee247d51714c89f07406fa06f7 - type: enhancement - title: Update upstream OpenTelemetry agent dependencies to 2.15.0 - products: - - product: edot-java - target: 1.4.0 - lifecycle: ga - prs: - - https://github.com/elastic/elastic-otel-java/pull/603 -- file: - name: 580.yaml - checksum: bc87fb1e3086b936ebea6ba2815ed485260c2f8c + name: 596.yaml + checksum: 9872b81d2689ff00a365b7fba66f3b5bfc9b4bc5 type: enhancement - title: Update upstream OpenTelemetry agent dependencies to 2.14.0 + title: enable azure provider by default when available products: - product: edot-java target: 1.4.0 lifecycle: ga prs: - - https://github.com/elastic/elastic-otel-java/pull/580 + - https://github.com/elastic/elastic-otel-java/pull/596 - file: - name: 596.yaml - checksum: 602477f37ba4b76a1d0e8942fdc4eb5d6ad054b1 + name: upstream-update.yaml + checksum: 2a1a157849699e9ae5cf8c90a0bd24b932664b36 type: enhancement - title: enable azure provider by default when available + title: Update upstream OpenTelemetry agent dependencies to 2.15.0 products: - product: edot-java target: 1.4.0 lifecycle: ga + description: '- javaagent:[2.15.0](https://github.com/open-telemetry/opentelemetry-java-instrumentation/releases/tag/v2.15.0) sdk:[1.49.0](https://github.com/open-telemetry/opentelemetry-java/releases/tag/v1.49.0) semconv:[1.32.0](https://github.com/open-telemetry/semantic-conventions-java/releases/tag/v1.32.0) contrib:[1.45.0](https://github.com/open-telemetry/opentelemetry-java-contrib/releases/tag/v1.45.0)' prs: - - https://github.com/elastic/elastic-otel-java/pull/596 + - https://github.com/elastic/elastic-otel-java/pull/603 diff --git a/docs/releases/1.4.1.yaml b/docs/releases/1.4.1.yaml index 7e101668..fc10a5de 100644 --- a/docs/releases/1.4.1.yaml +++ b/docs/releases/1.4.1.yaml @@ -7,7 +7,7 @@ entries: - file: name: 610.yaml - checksum: 18a256e988d018719a559aac7326948f9e9f6ed2 + checksum: 35032a5e911047a819859e1304c3e5447267111a type: bug-fix title: Workaround for temporality configuration not being possible products: diff --git a/docs/releases/1.5.0.yaml b/docs/releases/1.5.0.yaml index 5567744a..402c711b 100644 --- a/docs/releases/1.5.0.yaml +++ b/docs/releases/1.5.0.yaml @@ -6,39 +6,17 @@ owner: elastic entries: - file: - name: 712.yaml - checksum: fb8054886914f2e350f7b4ac5d7cf466501f816e - type: enhancement - title: Update upstream OpenTelemetry agent dependencies to 2.17.0 - products: - - product: edot-java - target: 1.5.0 - lifecycle: ga - prs: - - https://github.com/elastic/elastic-otel-java/pull/712 -- file: - name: 1774534585-tech-preview-release-of-central-configuration-supp.yaml - checksum: 9658915b21905328900f102bb4630330a402e495 + name: 1774965825-tech-preview-release-of-central-configuration-supp.yaml + checksum: 51f9d0593a1636e9ff8c6839163e602728b21a68 type: enhancement title: tech preview release of central configuration support for dynamically changing instrumentation and sending, using OpAMP protocol products: - product: edot-java target: 1.5.0 lifecycle: ga -- file: - name: 641.yaml - checksum: 6c7f2f6ba601046ad56cb78baefddee3c6cd572b - type: enhancement - title: Update upstream OpenTelemetry agent dependencies to 2.16.0 - products: - - product: edot-java - target: 1.5.0 - lifecycle: ga - prs: - - https://github.com/elastic/elastic-otel-java/pull/641 - file: name: 726.yaml - checksum: c0d8f24359c11428bdbf800ba102f33adb7b42ae + checksum: 79e5d8d4d78f2a1c030441ed0c306d6c7758fbc8 type: enhancement title: add option to bypass certificate validation products: @@ -50,13 +28,14 @@ entries: issues: - https://github.com/elastic/elastic-otel-java/issues/493 - file: - name: 729.yaml - checksum: bae190e7ba0b4cd03a31d42a7f83e5a4a90cfcc3 + name: upstream-update.yaml + checksum: 968912fb957278ddfb905633ee647c8b445de325 type: enhancement title: Update upstream OpenTelemetry agent dependencies to 2.17.1 products: - product: edot-java target: 1.5.0 lifecycle: ga + description: '- javaagent:[2.17.1](https://github.com/open-telemetry/opentelemetry-java-instrumentation/releases/tag/v2.17.1) sdk:[1.51.0](https://github.com/open-telemetry/opentelemetry-java/releases/tag/v1.51.0) semconv:[1.34.0](https://github.com/open-telemetry/semantic-conventions-java/releases/tag/v1.34.0) contrib:[1.46.0](https://github.com/open-telemetry/opentelemetry-java-contrib/releases/tag/v1.46.0)' prs: - https://github.com/elastic/elastic-otel-java/pull/729 diff --git a/docs/releases/1.6.0.yaml b/docs/releases/1.6.0.yaml index e8bff731..8d317904 100644 --- a/docs/releases/1.6.0.yaml +++ b/docs/releases/1.6.0.yaml @@ -5,20 +5,9 @@ repo: elastic-otel-java owner: elastic entries: -- file: - name: 803.yaml - checksum: 5a4268ebe44333701ec9d0f4f840fc0a50f5b182 - type: enhancement - title: Update upstream OpenTelemetry agent dependencies to 2.20.1 - products: - - product: edot-java - target: 1.6.0 - lifecycle: ga - prs: - - https://github.com/elastic/elastic-otel-java/pull/803 - file: name: 818.yaml - checksum: a358d474350bcdb51e86fcdca0b687806e3820a3 + checksum: 44e62e674176c6f0bb83671b3c418293165d9c3a type: enhancement title: Add 9.2 supported dynamic config options products: @@ -29,7 +18,7 @@ entries: - https://github.com/elastic/elastic-otel-java/pull/818 - file: name: 789.yaml - checksum: cae5da96cc54fc21a23265e0ebbba2cdf5ad8bb7 + checksum: 17eecc0c9b0dc3bb78d5e32cfd657241b375f27a type: enhancement title: Opamp migration products: @@ -42,7 +31,7 @@ entries: - https://github.com/elastic/elastic-otel-java/issues/788 - file: name: 763.yaml - checksum: 948f1b512463fe42ca6dbc68561752de2ad43c70 + checksum: 70db96dff34ee6593fd1e06d008fcc9b93517d7d type: breaking-change title: switch to 2.18.1, and switch openai to upstream products: @@ -51,3 +40,15 @@ entries: lifecycle: ga prs: - https://github.com/elastic/elastic-otel-java/pull/763 +- file: + name: upstream-update.yaml + checksum: 7295b0ff57a171423e470117cc0c2ae551bb3d7e + type: enhancement + title: Update upstream OpenTelemetry agent dependencies to 2.20.1 + products: + - product: edot-java + target: 1.6.0 + lifecycle: ga + description: '- javaagent:[2.20.1](https://github.com/open-telemetry/opentelemetry-java-instrumentation/releases/tag/v2.20.1) sdk:[1.54.1](https://github.com/open-telemetry/opentelemetry-java/releases/tag/v1.54.1) semconv:[1.37.0](https://github.com/open-telemetry/semantic-conventions-java/releases/tag/v1.37.0) contrib:[1.49.0](https://github.com/open-telemetry/opentelemetry-java-contrib/releases/tag/v1.49.0)' + prs: + - https://github.com/elastic/elastic-otel-java/pull/803 diff --git a/docs/releases/1.7.0.yaml b/docs/releases/1.7.0.yaml index b86fda5d..57c85d94 100644 --- a/docs/releases/1.7.0.yaml +++ b/docs/releases/1.7.0.yaml @@ -7,7 +7,7 @@ entries: - file: name: 835.yaml - checksum: a8b3a5b5e2136ceb9d0fd67e0018227ad3b93134 + checksum: 9ca6e1b073a836bd86ed790e81728edae016e31a type: enhancement title: add config logging on agent startup products: @@ -20,7 +20,7 @@ entries: - https://github.com/elastic/elastic-otel-java/issues/730 - file: name: 848.yaml - checksum: 65b0561962cf07cff3b1f1f0168cb13bfef4b923 + checksum: cf6ff7b1c61314be16a5a2ec4aed17debb34e948 type: enhancement title: add support for elastic.otel.opamp.headers config products: @@ -32,26 +32,27 @@ entries: issues: - https://github.com/elastic/elastic-otel-java/issues/833 - file: - name: 844.yaml - checksum: db263b3a162de735a6e33a2d6886a2c57480bc56 + name: 838.yaml + checksum: 2fad0633ea3675be0eab05d95d5997c2f0ae66bd type: enhancement - title: Update upstream OpenTelemetry agent dependencies to 2.21.0 + title: add infer-spans dynamoic central config handling products: - product: edot-java target: 1.7.0 lifecycle: ga prs: - - https://github.com/elastic/elastic-otel-java/pull/844 + - https://github.com/elastic/elastic-otel-java/pull/838 + issues: + - https://github.com/elastic/elastic-otel-java/issues/301 - file: - name: 838.yaml - checksum: 2d67dce53e0a537f26a5b4c4d7679ec856958a5d + name: upstream-update.yaml + checksum: cd4aa640a00a6a8198aa04dae895e3ef3eb704ca type: enhancement - title: add infer-spans dynamoic central config handling + title: Update upstream OpenTelemetry agent dependencies to 2.21.0 products: - product: edot-java target: 1.7.0 lifecycle: ga + description: '- javaagent:[2.21.0](https://github.com/open-telemetry/opentelemetry-java-instrumentation/releases/tag/v2.21.0) sdk:[1.55.0](https://github.com/open-telemetry/opentelemetry-java/releases/tag/v1.55.0) semconv:[1.37.0](https://github.com/open-telemetry/semantic-conventions-java/releases/tag/v1.37.0) contrib:[1.50.0](https://github.com/open-telemetry/opentelemetry-java-contrib/releases/tag/v1.50.0)' prs: - - https://github.com/elastic/elastic-otel-java/pull/838 - issues: - - https://github.com/elastic/elastic-otel-java/issues/301 + - https://github.com/elastic/elastic-otel-java/pull/844 diff --git a/docs/releases/1.8.0.yaml b/docs/releases/1.8.0.yaml index 2489f166..b0c3a76a 100644 --- a/docs/releases/1.8.0.yaml +++ b/docs/releases/1.8.0.yaml @@ -7,7 +7,7 @@ entries: - file: name: 899.yaml - checksum: 8917a0bb587d53bc958b71f1a6e52546176e64f9 + checksum: 204926d07482045a0fe29911ccf8dcd04292e4aa type: enhancement title: enable indy by default products: @@ -17,13 +17,14 @@ entries: prs: - https://github.com/elastic/elastic-otel-java/pull/899 - file: - name: 898.yaml - checksum: 0ebb827244c0ca0b1d2a67248cb544fbfba68ed6 + name: upstream-update.yaml + checksum: 9e4f694dac2f676476d08f484451cff2e32221ea type: enhancement title: Update upstream OpenTelemetry agent dependencies to 2.22.0 products: - product: edot-java target: 1.8.0 lifecycle: ga + description: '- javaagent:[2.22.0](https://github.com/open-telemetry/opentelemetry-java-instrumentation/releases/tag/v2.22.0) sdk:[1.56.0](https://github.com/open-telemetry/opentelemetry-java/releases/tag/v1.56.0) semconv:[1.37.0](https://github.com/open-telemetry/semantic-conventions-java/releases/tag/v1.37.0) contrib:[1.52.0](https://github.com/open-telemetry/opentelemetry-java-contrib/releases/tag/v1.52.0)' prs: - https://github.com/elastic/elastic-otel-java/pull/898 diff --git a/docs/releases/1.9.0.yaml b/docs/releases/1.9.0.yaml index 8b681c4a..d2b77613 100644 --- a/docs/releases/1.9.0.yaml +++ b/docs/releases/1.9.0.yaml @@ -6,35 +6,25 @@ owner: elastic entries: - file: - name: 932.yaml - checksum: 65379a859a8bc866929ee2d3e9b335f40a854a8f - type: enhancement - title: Update upstream OpenTelemetry agent dependencies to 2.24.0 + name: 958.yaml + checksum: f78080964c0271b24ad8e66b0cf57b9344a92b9c + type: breaking-change + title: document universal profiling as opt-in products: - product: edot-java target: 1.9.0 lifecycle: ga prs: - - https://github.com/elastic/elastic-otel-java/pull/932 + - https://github.com/elastic/elastic-otel-java/pull/958 - file: - name: 911.yaml - checksum: 2c5fffca3b66b755872bfd683df3ea83a62cbfd8 + name: upstream-update.yaml + checksum: a466bbd5a70c27da4781396df8cd695e8f5f5ec3 type: enhancement - title: Update upstream OpenTelemetry agent dependencies to 2.23.0 - products: - - product: edot-java - target: 1.9.0 - lifecycle: ga - prs: - - https://github.com/elastic/elastic-otel-java/pull/911 -- file: - name: 958.yaml - checksum: 8945e17491236ea6d8fabda01b15c4bdb4ebd1ed - type: breaking-change - title: document universal profiling as opt-in + title: Update upstream OpenTelemetry agent dependencies to 2.24.0 products: - product: edot-java target: 1.9.0 lifecycle: ga + description: '- javaagent:[2.24.0](https://github.com/open-telemetry/opentelemetry-java-instrumentation/releases/tag/v2.24.0) sdk:[1.58.0](https://github.com/open-telemetry/opentelemetry-java/releases/tag/v1.58.0) semconv:[1.37.0](https://github.com/open-telemetry/semantic-conventions-java/releases/tag/v1.37.0) contrib:[1.52.0](https://github.com/open-telemetry/opentelemetry-java-contrib/releases/tag/v1.52.0)' prs: - - https://github.com/elastic/elastic-otel-java/pull/958 + - https://github.com/elastic/elastic-otel-java/pull/932 From 3180bdb41dbec3039025412b9126d67a075dd993 Mon Sep 17 00:00:00 2001 From: Sylvain Juge <763082+SylvainJuge@users.noreply.github.com> Date: Wed, 1 Apr 2026 10:10:39 +0200 Subject: [PATCH 12/17] add script to generate upstream update changelog --- .ci/update-upstream-changelog.sh | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100755 .ci/update-upstream-changelog.sh diff --git a/.ci/update-upstream-changelog.sh b/.ci/update-upstream-changelog.sh new file mode 100755 index 00000000..65c457cc --- /dev/null +++ b/.ci/update-upstream-changelog.sh @@ -0,0 +1,29 @@ +#!/bin/env bash +# This script generates changelog entry for upstream dependencies update PR using docs-builder +# +# If there is more than one upstream update, the latest will overwrite the prior one, hence making +# sure that there is one per release. +# +# Usage: .ci/update-upstream-changelog.sh [pr_number] +# Where pr_number is the PR number of an upstream dependencies update PR. +# If pr_number is not provided, it will default to the current PR using github CLI. +pr=${1:-} + +pr_url="$(gh pr view ${pr} --json url --jq .url)" +pr_id="${pr_url##*/}" +pr_title="$(gh pr view ${pr} --json title --jq .title)" + +folder="$(dirname "${0}")" +temp_dir="$(mktemp -d)" +docs-builder changelog add \ + --concise \ + --title "${pr_title}"\ + --type enhancement \ + --prs "${pr_url}" \ + --products "edot-java NEXT ga" \ + --output "${temp_dir}" \ + --description "- $("${folder}/../gradlew" -q changelogUpstreamDependenciesOneLiner)" + +# will overwrite any prior update, if there is any +mv "${temp_dir}/${pr_id}.yaml" "${folder}/../docs/changelog/upstream-update.yaml" +rm -rf "${temp_dir}" From c9d695c14d693208ff304a3c3d088dc6734f6e1b Mon Sep 17 00:00:00 2001 From: Sylvain Juge <763082+SylvainJuge@users.noreply.github.com> Date: Fri, 3 Apr 2026 17:09:27 +0200 Subject: [PATCH 13/17] remove unused script --- .ci/update-upstream-changelog.sh | 29 ----------------------------- 1 file changed, 29 deletions(-) delete mode 100755 .ci/update-upstream-changelog.sh diff --git a/.ci/update-upstream-changelog.sh b/.ci/update-upstream-changelog.sh deleted file mode 100755 index 65c457cc..00000000 --- a/.ci/update-upstream-changelog.sh +++ /dev/null @@ -1,29 +0,0 @@ -#!/bin/env bash -# This script generates changelog entry for upstream dependencies update PR using docs-builder -# -# If there is more than one upstream update, the latest will overwrite the prior one, hence making -# sure that there is one per release. -# -# Usage: .ci/update-upstream-changelog.sh [pr_number] -# Where pr_number is the PR number of an upstream dependencies update PR. -# If pr_number is not provided, it will default to the current PR using github CLI. -pr=${1:-} - -pr_url="$(gh pr view ${pr} --json url --jq .url)" -pr_id="${pr_url##*/}" -pr_title="$(gh pr view ${pr} --json title --jq .title)" - -folder="$(dirname "${0}")" -temp_dir="$(mktemp -d)" -docs-builder changelog add \ - --concise \ - --title "${pr_title}"\ - --type enhancement \ - --prs "${pr_url}" \ - --products "edot-java NEXT ga" \ - --output "${temp_dir}" \ - --description "- $("${folder}/../gradlew" -q changelogUpstreamDependenciesOneLiner)" - -# will overwrite any prior update, if there is any -mv "${temp_dir}/${pr_id}.yaml" "${folder}/../docs/changelog/upstream-update.yaml" -rm -rf "${temp_dir}" From ac4b86be578d89773a5d8f0e09214f7267672cc2 Mon Sep 17 00:00:00 2001 From: Sylvain Juge <763082+SylvainJuge@users.noreply.github.com> Date: Fri, 3 Apr 2026 17:10:03 +0200 Subject: [PATCH 14/17] remove wip script --- wip-changelog.sh | 110 ----------------------------------------------- 1 file changed, 110 deletions(-) delete mode 100755 wip-changelog.sh diff --git a/wip-changelog.sh b/wip-changelog.sh deleted file mode 100755 index 1e806ddb..00000000 --- a/wip-changelog.sh +++ /dev/null @@ -1,110 +0,0 @@ -#!/bin/bash -x - -set -euo pipefail - -add_pr(){ - version="${2}" - pr="${1}" - - # TODO: do we have to add complete PR URLs here or could we just use the numeric ID ? - # having the complete URL in the generated changelog entry is however convenient for humans to open the link - docs-builder changelog add \ - --concise \ - --prs https://github.com/elastic/elastic-otel-java/pull/${pr} \ - --products "edot-java ${version} ga" - - # TODO: to filter duplicate upstream dependency updates, we could maybe just remove any changelog entry - # for such update, the challenge might be to define a reliable heuristic, relying on PR title seems quite brittle. -} - -create_bundle(){ - version="${1}" - docs-builder changelog bundle \ - --input-products "edot-java ${version} ga" \ - --output "./docs/releases/${version}.yaml" - - # TODO: document changelog remove - docs-builder changelog remove \ - --products "edot-java ${version} ga" -} - -# remove all changelog entries and generated bundles -rm -f ./docs/changelog/*.yaml -rm -f ./docs/releases/*.yaml - -# generate changelog and bundles for each release, the PRs have been labelled -add_pr 973 1.10.0 -add_pr 1001 1.10.0 -add_pr 1017 1.10.0 -create_bundle 1.10.0 - -add_pr 911 1.9.0 -add_pr 932 1.9.0 -add_pr 958 1.9.0 -create_bundle 1.9.0 - -add_pr 898 1.8.0 -add_pr 899 1.8.0 -create_bundle 1.8.0 - -add_pr 838 1.7.0 -add_pr 835 1.7.0 -add_pr 848 1.7.0 -add_pr 844 1.7.0 -create_bundle 1.7.0 - -add_pr 803 1.6.0 -add_pr 763 1.6.0 -add_pr 789 1.6.0 -add_pr 818 1.6.0 -create_bundle 1.6.0 - -add_pr 726 1.5.0 -add_pr 641 1.5.0 -add_pr 712 1.5.0 -add_pr 729 1.5.0 -# add changelog entry not related to a PR -# TODO: how should we handle adding a 'tech preview' feature in a GA product ? -docs-builder changelog add \ - --products "edot-java 1.5.0 ga" \ - --type enhancement \ - --title 'tech preview release of central configuration support for dynamically changing instrumentation and sending, using OpAMP protocol' -create_bundle 1.5.0 - -add_pr 610 1.4.1 -create_bundle 1.4.1 - -add_pr 583 1.4.0 -add_pr 593 1.4.0 -add_pr 607 1.4.0 -add_pr 596 1.4.0 -add_pr 580 1.4.0 -add_pr 603 1.4.0 -create_bundle 1.4.0 - -add_pr 531 1.3.0 -add_pr 564 1.3.0 -add_pr 539 1.3.0 -add_pr 561 1.3.0 -create_bundle 1.3.0 - -add_pr 514 1.2.1 -create_bundle 1.2.1 - -add_pr 422 1.2.0 -add_pr 471 1.2.0 -add_pr 474 1.2.0 -add_pr 497 1.2.0 -add_pr 500 1.2.0 -create_bundle 1.2.0 - -add_pr 423 1.1.0 -add_pr 455 1.1.0 -create_bundle 1.1.0 - -# add changelog entry not related to a PR -docs-builder changelog add \ - --products "edot-java 1.0.0 ga" \ - --type enhancement \ - --title 'first GA release' -create_bundle 1.0.0 From cb68eb5e8ce812e846727411cea02089111db72d Mon Sep 17 00:00:00 2001 From: Sylvain Juge <763082+SylvainJuge@users.noreply.github.com> Date: Fri, 3 Apr 2026 17:10:42 +0200 Subject: [PATCH 15/17] remove unused markdown file --- docs/changelog/README.md | 1 - 1 file changed, 1 deletion(-) delete mode 100644 docs/changelog/README.md diff --git a/docs/changelog/README.md b/docs/changelog/README.md deleted file mode 100644 index 0f182e0f..00000000 --- a/docs/changelog/README.md +++ /dev/null @@ -1 +0,0 @@ -This folder contains changelog entries that are pending release, is empty when no new release is pending. From a42ee00c57af15d8fe244daa080208bc8ee268e6 Mon Sep 17 00:00:00 2001 From: Sylvain Juge <763082+SylvainJuge@users.noreply.github.com> Date: Fri, 3 Apr 2026 17:12:57 +0200 Subject: [PATCH 16/17] use placeholder for release notes --- docs/release-notes/breaking-changes.md | 33 ----- docs/release-notes/deprecations.md | 17 +-- docs/release-notes/index.md | 172 ------------------------- docs/release-notes/known-issues.md | 2 - 4 files changed, 1 insertion(+), 223 deletions(-) diff --git a/docs/release-notes/breaking-changes.md b/docs/release-notes/breaking-changes.md index 01559b76..b696fe2d 100644 --- a/docs/release-notes/breaking-changes.md +++ b/docs/release-notes/breaking-changes.md @@ -15,39 +15,6 @@ products: Breaking changes can impact your applications, potentially disrupting normal operations and their monitoring. Before you upgrade, carefully review the Elastic Distribution of OpenTelemetry Java breaking changes and take the necessary steps to mitigate any issues. -% ## Next version [edot-java-X.X.X-breaking-changes] - -% Use the following template to add entries to this document. - -% TEMPLATE START -% ::::{dropdown} Title of breaking change -% Description of the breaking change. -% **Impact**
Impact of the breaking change. -% **Action**
Steps for mitigating impact. -% View [PR #](PR link). -% :::: -% TEMPLATE END - :::{changelog} /releases/ :type: breaking-change ::: - - diff --git a/docs/release-notes/deprecations.md b/docs/release-notes/deprecations.md index cc73bc5b..00724da7 100644 --- a/docs/release-notes/deprecations.md +++ b/docs/release-notes/deprecations.md @@ -16,22 +16,7 @@ products: Over time, certain Elastic functionality becomes outdated and is replaced or removed. To help with the transition, Elastic deprecates functionality for a period before removal, giving you time to update your applications. Review the deprecated functionality for Elastic Distribution of OpenTelemetry Java. While deprecations have no immediate impact, we strongly encourage you update your implementation after you upgrade. To learn how to upgrade, check out [Upgrade](docs-content://deploy-manage/upgrade.md). - :::{changelog} /releases/ :type: deprecation -::: \ No newline at end of file +::: diff --git a/docs/release-notes/index.md b/docs/release-notes/index.md index 5445cca6..fbb77832 100644 --- a/docs/release-notes/index.md +++ b/docs/release-notes/index.md @@ -20,175 +20,3 @@ To check for security updates, go to [Security announcements for the Elastic sta :::{changelog} /releases/ :type: all ::: - - diff --git a/docs/release-notes/known-issues.md b/docs/release-notes/known-issues.md index 86c27cf7..a4ad7e33 100644 --- a/docs/release-notes/known-issues.md +++ b/docs/release-notes/known-issues.md @@ -13,8 +13,6 @@ products: # Elastic Distribution of OpenTelemetry Java known issues - - :::{changelog} /releases/ :type: known-issue ::: From 2d4053533c07ca0c27800f78b0485b82c3d1ebd0 Mon Sep 17 00:00:00 2001 From: Sylvain Juge <763082+SylvainJuge@users.noreply.github.com> Date: Thu, 9 Apr 2026 17:16:59 +0200 Subject: [PATCH 17/17] add missing security issue fix for 1.10.0 --- docs/releases/1.10.0.amend-1.yaml | 11 +++++++++++ 1 file changed, 11 insertions(+) create mode 100644 docs/releases/1.10.0.amend-1.yaml diff --git a/docs/releases/1.10.0.amend-1.yaml b/docs/releases/1.10.0.amend-1.yaml new file mode 100644 index 00000000..e8328bff --- /dev/null +++ b/docs/releases/1.10.0.amend-1.yaml @@ -0,0 +1,11 @@ +entries: +- file: + name: 1017.yaml + checksum: 97e10106382f21b7a8ea86be2013362e1b9bcaba + type: security + title: The 1.10.0 release contains fixes for potential security vulnerabilities + products: + - product: edot-java + description: Refer to our [security advisory](https://discuss.elastic.co/t/elastic-otel-java-1-10-0-security-update-esa-2026-22-ghsa-xw7x-h9fj-p2c7/385700) for more details. + prs: + - https://github.com/elastic/elastic-otel-java/pull/1017