[release/v2.31.x] Prepare release 2.31.0 (#19731)

Co-authored-by: otelbot <197425009+otelbot@users.noreply.github.com>

Author: otelbot[bot]

CHANGELOG.md

@@ -1,6 +1,13 @@
 # Changelog
 
-## Unreleased
+## Version 2.31.0 (2026-08-20)
+
+This release targets the OpenTelemetry SDK 1.65.0.
+
+Note that many artifacts have the `-alpha` suffix attached to their version
+number, reflecting that they will continue to have breaking changes. Please see
+[VERSIONING.md](https://github.com/open-telemetry/opentelemetry-java-instrumentation/blob/main/VERSIONING.md#opentelemetry-java-instrumentation-versioning)
+for more details.
 
 ### ⚠️ Breaking changes to non-stable APIs
 

README.md

@@ -33,7 +33,7 @@ If you are looking for documentation on using those.
 ## Getting Started
 
 Download
-the [latest version](https://github.com/open-telemetry/opentelemetry-java-instrumentation/releases/latest/download/opentelemetry-javaagent.jar).
+the [latest version](https://github.com/open-telemetry/opentelemetry-java-instrumentation/releases/download/v2.31.0/opentelemetry-javaagent.jar).
 
 This package includes the instrumentation agent as well as
 instrumentations for all supported libraries and all available data exporters.

docs/apidiffs/current_vs_latest/opentelemetry-instrumentation-annotations.txt

@@ -1,2 +1,2 @@
-Comparing source compatibility of opentelemetry-instrumentation-annotations-2.31.0-SNAPSHOT.jar against opentelemetry-instrumentation-annotations-2.30.0.jar
+Comparing source compatibility of opentelemetry-instrumentation-annotations-2.31.0.jar against opentelemetry-instrumentation-annotations-2.30.0.jar
 No changes.

docs/apidiffs/current_vs_latest/opentelemetry-instrumentation-api.txt

@@ -1,4 +1,4 @@
-Comparing source compatibility of opentelemetry-instrumentation-api-2.31.0-SNAPSHOT.jar against opentelemetry-instrumentation-api-2.30.0.jar
+Comparing source compatibility of opentelemetry-instrumentation-api-2.31.0.jar against opentelemetry-instrumentation-api-2.30.0.jar
 +++  NEW CLASS: PUBLIC(+) FINAL(+) io.opentelemetry.instrumentation.api.config.IncludeExclude  (not serializable)
 	+++  CLASS FILE FORMAT VERSION: 52.0 <- n.a.
 	+++  NEW SUPERCLASS: java.lang.Object

docs/apidiffs/current_vs_latest/opentelemetry-spring-boot-autoconfigure.txt

@@ -1,2 +1,2 @@
-Comparing source compatibility of opentelemetry-spring-boot-autoconfigure-2.31.0-SNAPSHOT.jar against opentelemetry-spring-boot-autoconfigure-2.30.0.jar
+Comparing source compatibility of opentelemetry-spring-boot-autoconfigure-2.31.0.jar against opentelemetry-spring-boot-autoconfigure-2.30.0.jar
 No changes.

docs/apidiffs/current_vs_latest/opentelemetry-spring-boot-starter.txt

@@ -1,2 +1,2 @@
-Comparing source compatibility of opentelemetry-spring-boot-starter-2.31.0-SNAPSHOT.jar against opentelemetry-spring-boot-starter-2.30.0.jar
+Comparing source compatibility of opentelemetry-spring-boot-starter-2.31.0.jar against opentelemetry-spring-boot-starter-2.30.0.jar
 No changes.

examples/distro/buildSrc/src/main/kotlin/Versions.kt

@@ -2,7 +2,7 @@
 const val opentelemetrySdkVersion = "1.65.0"
 
 // these lines are managed by .github/scripts/update-version.sh
-const val opentelemetryJavaagentVersion = "2.31.0-SNAPSHOT"
-const val opentelemetryJavaagentAlphaVersion = "2.31.0-alpha-SNAPSHOT"
+const val opentelemetryJavaagentVersion = "2.31.0"
+const val opentelemetryJavaagentAlphaVersion = "2.31.0-alpha"
 
 const val autoserviceVersion = "1.1.1"

examples/distro/settings.gradle.kts

@@ -8,8 +8,8 @@ pluginManagement {
   }
   plugins {
     id("com.gradleup.shadow") version "9.6.1"
-    id("io.opentelemetry.instrumentation.muzzle-generation") version "2.31.0-alpha-SNAPSHOT"
-    id("io.opentelemetry.instrumentation.muzzle-check") version "2.31.0-alpha-SNAPSHOT"
+    id("io.opentelemetry.instrumentation.muzzle-generation") version "2.31.0-alpha"
+    id("io.opentelemetry.instrumentation.muzzle-check") version "2.31.0-alpha"
   }
 }
 

examples/extension/build.gradle.kts

@@ -15,8 +15,8 @@ plugins {
   id("com.gradleup.shadow") version "9.6.1"
   id("com.diffplug.spotless") version "8.10.0"
 
-  id("io.opentelemetry.instrumentation.muzzle-generation") version "2.31.0-alpha-SNAPSHOT"
-  id("io.opentelemetry.instrumentation.muzzle-check") version "2.31.0-alpha-SNAPSHOT"
+  id("io.opentelemetry.instrumentation.muzzle-generation") version "2.31.0-alpha"
+  id("io.opentelemetry.instrumentation.muzzle-check") version "2.31.0-alpha"
 }
 
 group = "io.opentelemetry.example"
@@ -27,8 +27,8 @@ val versions = mapOf(
   "opentelemetrySdk" to "1.65.0",
 
   // these lines are managed by .github/scripts/update-version.sh
-  "opentelemetryJavaagent" to "2.31.0-SNAPSHOT",
-  "opentelemetryJavaagentAlpha" to "2.31.0-alpha-SNAPSHOT"
+  "opentelemetryJavaagent" to "2.31.0",
+  "opentelemetryJavaagentAlpha" to "2.31.0-alpha"
 )
 
 val deps = mapOf(

version.gradle.kts

@@ -1,5 +1,5 @@
-val stableVersion = "2.31.0-SNAPSHOT"
-val alphaVersion = "2.31.0-alpha-SNAPSHOT"
+val stableVersion = "2.31.0"
+val alphaVersion = "2.31.0-alpha"
 
 val apidiffBaselineVersion = "2.30.0"