diff --git a/instrumentation/spring/README.md b/instrumentation/spring/README.md
index f1bce57c9470..5567aa56222e 100644
--- a/instrumentation/spring/README.md
+++ b/instrumentation/spring/README.md
@@ -599,7 +599,11 @@ To create a sample trace enter `localhost:8080/message` in a browser. This trace
## Auto Instrumentation using Spring Starters
-In this tutorial we will create two SpringBoot applications (MainService and TimeService). We will use [opentelemetry-spring-starter](starters/spring-starter) to enable distributed tracing using OpenTelemetry and export spans using the default LoggingSpanExporter. We will also use the [opentelemetry-zipkin-exporter-starter](starters/zipkin-exporter-starter) to export traces to Zipkin.
+In this tutorial we will create two SpringBoot applications (MainService and TimeService). We will
+use [opentelemetry-spring-boot-starter](starters/spring-boot-starter) to enable distributed tracing using
+OpenTelemetry and export spans using the default LoggingSpanExporter. We will also use
+the [opentelemetry-zipkin-spring-boot-starter](starters/zipkin-spring-boot-starter) to export traces to
+Zipkin.
### OpenTelemetry Spring Starter Dependencies
@@ -612,14 +616,14 @@ Replace `OPENTELEMETRY_VERSION` with the latest stable [release](https://search.
```xml
io.opentelemetry.instrumentation
- opentelemetry-spring-starter
+ opentelemetry-spring-boot-starter
OPENTELEMETRY_VERSION
```
#### Gradle
```gradle
-implementation("io.opentelemetry.instrumentation:opentelemetry-spring-starter:OPENTELEMETRY_VERSION")
+implementation("io.opentelemetry.instrumentation:opentelemetry-spring-boot-starter:OPENTELEMETRY_VERSION")
```
### Create two Spring Projects
@@ -827,21 +831,14 @@ To configure OpenTelemetry tracing with the OTLP, Zipkin, or Jaeger span exporte
io.opentelemetry.instrumentation
- opentelemetry-zipkin-exporter-starter
+ opentelemetry-zipkin-spring-boot-starter
OPENTELEMETRY_VERSION
io.opentelemetry.instrumentation
- opentelemetry-jaeger-exporter-starter
- OPENTELEMETRY_VERSION
-
-
-
-
- io.opentelemetry.instrumentation
- opentelemetry-otlp-exporter-starter
+ opentelemetry-jaeger-spring-boot-starter
OPENTELEMETRY_VERSION
```
@@ -850,13 +847,10 @@ To configure OpenTelemetry tracing with the OTLP, Zipkin, or Jaeger span exporte
```gradle
//opentelemetry starter with zipkin configurations
-implementation("io.opentelemetry.instrumentation:opentelemetry-zipkin-exporter-starter:OPENTELEMETRY_VERSION")
+implementation("io.opentelemetry.instrumentation:opentelemetry-zipkin-spring-boot-starter:OPENTELEMETRY_VERSION")
//opentelemetry starter with jaeger configurations
-implementation("io.opentelemetry.instrumentation:opentelemetry-jaeger-exporter-starter:OPENTELEMETRY_VERSION")
-
-//opentelemetry starter with otlp configurations
-implementation("io.opentelemetry.instrumentation:opentelemetry-otlp-exporter-starter:OPENTELEMETRY_VERSION")
+implementation("io.opentelemetry.instrumentation:opentelemetry-jaeger-spring-boot-starter:OPENTELEMETRY_VERSION")
```
#### Exporter Configuration Properties
@@ -878,7 +872,7 @@ Add the following configurations to overwrite the default exporter values listed
### Sample Trace Zipkin
To generate a trace using the zipkin exporter follow the steps below:
- 1. Replace `opentelemetry-spring-starter` with `opentelemetry-zipkin-starter` in your pom or gradle build file
+ 1. Replace `opentelemetry-spring-boot-starter` with `opentelemetry-zipkin-spring-boot-starter` in your pom or gradle build file
2. Use the Zipkin [quick starter](https://zipkin.io/pages/quickstart) to download and run the zipkin executable jar
- Ensure the zipkin endpoint matches the default value listed in your application properties
3. Run `MainServiceApplication.java` and `TimeServiceApplication.java`
@@ -886,7 +880,7 @@ To generate a trace using the zipkin exporter follow the steps below:
5. Navigate to `http://localhost:9411` to see your trace
-Shown below is the sample trace generated by `MainService` and `TimeService` using the opentelemetry-zipkin-exporter-starter.
+Shown below is the sample trace generated by `MainService` and `TimeService` using the opentelemetry-zipkin-spring-boot-starter.
```json
[
diff --git a/instrumentation/spring/spring-boot-autoconfigure/README.md b/instrumentation/spring/spring-boot-autoconfigure/README.md
index e9efdd1bca6b..a0e8e720c093 100644
--- a/instrumentation/spring/spring-boot-autoconfigure/README.md
+++ b/instrumentation/spring/spring-boot-autoconfigure/README.md
@@ -1,13 +1,17 @@
# OpenTelemetry Spring Auto-Configuration
-Auto-configures OpenTelemetry instrumentation for [spring-web](../spring-web-3.1), [spring-webmvc](../spring-webmvc-3.1), and [spring-webflux](../spring-webflux-5.0). Leverages Spring Aspect Oriented Programming, dependency injection, and bean post-processing to trace spring applications. To include all features listed below use the [opentelemetry-spring-starter](../starters/spring-starter/README.md).
+Auto-configures OpenTelemetry instrumentation for [spring-web](../spring-web-3.1/library)
+, [spring-webmvc](../spring-webmvc-5.3/library), and [spring-webflux](../spring-webflux-5.0/library)
+. Leverages Spring Aspect Oriented Programming, dependency injection, and bean post-processing to
+trace spring applications. To include all features listed below use
+the [opentelemetry-spring-boot-starter](../starters/spring-boot-starter/README.md).
## Quickstart
### Add these dependencies to your project.
Replace `OPENTELEMETRY_VERSION` with the latest stable [release](https://search.maven.org/search?q=g:io.opentelemetry).
- - Minimum version: `0.17.0`
+ - Minimum version: `1.17.0`
For Maven add to your `pom.xml`:
@@ -17,7 +21,7 @@ For Maven add to your `pom.xml`:
io.opentelemetry.instrumentation
- opentelemetry-spring-boot-autoconfigure
+ opentelemetry-spring-boot
OPENTELEMETRY_VERSION
@@ -43,7 +47,7 @@ For Gradle add to your dependencies:
```groovy
//opentelemetry spring auto-configuration
-implementation("io.opentelemetry.instrumentation:opentelemetry-spring-boot-autoconfigure:OPENTELEMETRY_VERSION")
+implementation("io.opentelemetry.instrumentation:opentelemetry-spring-boot:OPENTELEMETRY_VERSION")
//opentelemetry
implementation("io.opentelemetry:opentelemetry-api:OPENTELEMETRY_VERSION")
//opentelemetry exporter
diff --git a/instrumentation/spring/spring-boot-autoconfigure/build.gradle.kts b/instrumentation/spring/spring-boot-autoconfigure/build.gradle.kts
index 66fa6ca011a1..187b910a0025 100644
--- a/instrumentation/spring/spring-boot-autoconfigure/build.gradle.kts
+++ b/instrumentation/spring/spring-boot-autoconfigure/build.gradle.kts
@@ -3,6 +3,8 @@ plugins {
id("otel.publish-conventions")
}
+// Name the Spring Boot modules in accordance with https://docs.spring.io/spring-boot/docs/current/reference/html/features.html#features.developing-auto-configuration.custom-starter
+base.archivesName.set("opentelemetry-spring-boot")
group = "io.opentelemetry.instrumentation"
val versions: Map by project
diff --git a/instrumentation/spring/starters/jaeger-exporter-starter/README.md b/instrumentation/spring/starters/jaeger-spring-boot-starter/README.md
similarity index 87%
rename from instrumentation/spring/starters/jaeger-exporter-starter/README.md
rename to instrumentation/spring/starters/jaeger-spring-boot-starter/README.md
index 4e1f6fb88f20..902346bb2ed3 100644
--- a/instrumentation/spring/starters/jaeger-exporter-starter/README.md
+++ b/instrumentation/spring/starters/jaeger-spring-boot-starter/README.md
@@ -17,7 +17,7 @@ Replace `OPENTELEMETRY_VERSION` with the latest stable [release](https://search.
io.opentelemetry.instrumentation
- opentelemetry-jaeger-exporter-starter
+ opentelemetry-jaeger-spring-boot-starter
OPENTELEMETRY_VERSION
@@ -27,7 +27,7 @@ Replace `OPENTELEMETRY_VERSION` with the latest stable [release](https://search.
#### Gradle
```groovy
-implementation("io.opentelemetry.instrumentation:opentelemetry-jaeger-exporter-starter:OPENTELEMETRY_VERSION")
+implementation("io.opentelemetry.instrumentation:opentelemetry-spring-boot-exporter-starter:OPENTELEMETRY_VERSION")
```
### Starter Guide
diff --git a/instrumentation/spring/starters/jaeger-exporter-starter/build.gradle.kts b/instrumentation/spring/starters/jaeger-spring-boot-starter/build.gradle.kts
similarity index 82%
rename from instrumentation/spring/starters/jaeger-exporter-starter/build.gradle.kts
rename to instrumentation/spring/starters/jaeger-spring-boot-starter/build.gradle.kts
index f426855737eb..33d857f09f73 100644
--- a/instrumentation/spring/starters/jaeger-exporter-starter/build.gradle.kts
+++ b/instrumentation/spring/starters/jaeger-spring-boot-starter/build.gradle.kts
@@ -9,6 +9,6 @@ val versions: Map by project
dependencies {
api("org.springframework.boot:spring-boot-starter:${versions["org.springframework.boot"]}")
- api(project(":instrumentation:spring:starters:spring-starter"))
+ api(project(":instrumentation:spring:starters:spring-boot-starter"))
api("io.opentelemetry:opentelemetry-exporter-jaeger")
}
diff --git a/instrumentation/spring/starters/spring-starter/README.md b/instrumentation/spring/starters/spring-boot-starter/README.md
similarity index 92%
rename from instrumentation/spring/starters/spring-starter/README.md
rename to instrumentation/spring/starters/spring-boot-starter/README.md
index dbd0978b431b..9d3879b55cb2 100644
--- a/instrumentation/spring/starters/spring-starter/README.md
+++ b/instrumentation/spring/starters/spring-boot-starter/README.md
@@ -20,7 +20,7 @@ Add the following dependencies to your `pom.xml` file:
io.opentelemetry.instrumentation
- opentelemetry-spring-starter
+ opentelemetry-spring-boot-starter
OPENTELEMETRY_VERSION
@@ -31,7 +31,7 @@ Add the following dependencies to your `pom.xml` file:
Add the following dependencies to your gradle.build file:
```groovy
-implementation("io.opentelemetry.instrumentation:opentelemetry-spring-starter:OPENTELEMETRY_VERSION")
+implementation("io.opentelemetry.instrumentation:opentelemetry-spring-boot-starter:OPENTELEMETRY_VERSION")
```
### Starter Guide
diff --git a/instrumentation/spring/starters/spring-starter/build.gradle.kts b/instrumentation/spring/starters/spring-boot-starter/build.gradle.kts
similarity index 100%
rename from instrumentation/spring/starters/spring-starter/build.gradle.kts
rename to instrumentation/spring/starters/spring-boot-starter/build.gradle.kts
diff --git a/instrumentation/spring/starters/zipkin-exporter-starter/README.md b/instrumentation/spring/starters/zipkin-spring-boot-starter/README.md
similarity index 93%
rename from instrumentation/spring/starters/zipkin-exporter-starter/README.md
rename to instrumentation/spring/starters/zipkin-spring-boot-starter/README.md
index 1e8ba2a314ff..a6847b475d72 100644
--- a/instrumentation/spring/starters/zipkin-exporter-starter/README.md
+++ b/instrumentation/spring/starters/zipkin-spring-boot-starter/README.md
@@ -19,7 +19,7 @@ Replace `OPENTELEMETRY_VERSION` with the latest stable [release](https://search.
io.opentelemetry.instrumentation
- opentelemetry-zipkin-exporter-starter
+ opentelemetry-zipkin-spring-boot-starter
OPENTELEMETRY_VERSION
@@ -29,7 +29,7 @@ Replace `OPENTELEMETRY_VERSION` with the latest stable [release](https://search.
#### Gradle
```groovy
-implementation("io.opentelemetry.instrumentation:opentelemetry-zipkin-exporter-starter:OPENTELEMETRY_VERSION")
+implementation("io.opentelemetry.instrumentation:opentelemetry-zipkin-spring-boot-starter:OPENTELEMETRY_VERSION")
```
### Starter Guide
diff --git a/instrumentation/spring/starters/zipkin-exporter-starter/build.gradle.kts b/instrumentation/spring/starters/zipkin-spring-boot-starter/build.gradle.kts
similarity index 82%
rename from instrumentation/spring/starters/zipkin-exporter-starter/build.gradle.kts
rename to instrumentation/spring/starters/zipkin-spring-boot-starter/build.gradle.kts
index 2ad37b33a550..2db304dc9a47 100644
--- a/instrumentation/spring/starters/zipkin-exporter-starter/build.gradle.kts
+++ b/instrumentation/spring/starters/zipkin-spring-boot-starter/build.gradle.kts
@@ -9,6 +9,6 @@ val versions: Map by project
dependencies {
api("org.springframework.boot:spring-boot-starter:${versions["org.springframework.boot"]}")
- api(project(":instrumentation:spring:starters:spring-starter"))
+ api(project(":instrumentation:spring:starters:spring-boot-starter"))
api("io.opentelemetry:opentelemetry-exporter-zipkin")
}
diff --git a/settings.gradle.kts b/settings.gradle.kts
index 3b5166fecd17..e18e2e14d006 100644
--- a/settings.gradle.kts
+++ b/settings.gradle.kts
@@ -445,9 +445,9 @@ include(":instrumentation:spring:spring-webflux-5.0:javaagent")
include(":instrumentation:spring:spring-webflux-5.0:library")
include(":instrumentation:spring:spring-ws-2.0:javaagent")
include(":instrumentation:spring:spring-boot-autoconfigure")
-include(":instrumentation:spring:starters:spring-starter")
-include(":instrumentation:spring:starters:jaeger-exporter-starter")
-include(":instrumentation:spring:starters:zipkin-exporter-starter")
+include(":instrumentation:spring:starters:spring-boot-starter")
+include(":instrumentation:spring:starters:jaeger-spring-boot-starter")
+include(":instrumentation:spring:starters:zipkin-spring-boot-starter")
include(":instrumentation:spymemcached-2.12:javaagent")
include(":instrumentation:struts-2.3:javaagent")
include(":instrumentation:tapestry-5.4:javaagent")