release notes switch to docs-builder yaml

.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?

docs/changelog.yml

@@ -0,0 +1,43 @@
+# 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: "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
+  repo: elastic-otel-java
+  owner: elastic

docs/changelog/README.md

@@ -0,0 +1 @@
+This folder contains changelog entries that are pending release, is empty when no new release is pending.

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

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

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

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

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

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

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

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