This project provides a Spring Boot 3 starter for Wavefront. Add the starter to a project to send metrics, histograms, and traces to a Wavefront cluster. If you don't have a Wavefront account, the starter creates a freemium account for you and saves the API token in your home directory at ~/.wavefront_freemium.
Note: Spring Boot 2 users should refer to the README on the
masterbranch.
- Spring Boot 3.0 or above
- Java 17 or above
- Maven 3.5+ or Gradle 7.5+
See System Requirements in the Spring Boot documentation.
Note: This starter reuses the existing Wavefront support for Metrics and Tracing in Spring Boot and provides the Actuator (i.e.,
spring-boot-starter-actuator).
There are several ways to start:
The easiest way to get started is to:
- Create a new project on start.spring.io.
- Select Spring Boot
3.0.0or later and define the other parameters for your project. - Click "Add dependency" and select
Wavefrontfrom the dependency list. - To include tracing support, add the
Distributed Tracingdependency as well.
If you don't have a Wavefront account, the starter creates a freemium account for you and saves the API token in your home directory at ~/.wavefront_freemium.
If you already have a Spring Boot application, you can use start.spring.io to explore a new project from your browser. This allows you to see the setup for the Spring Boot generation your project is using.
Next, follow the steps under Maven or Gradle to add the Wavefront Spring Boot BOM.
Follow these steps:
-
Import the
wavefront-spring-boot-bomBill Of Materials (BOM):<dependencyManagement> <dependencies> <dependency> <groupId>com.wavefront</groupId> <artifactId>wavefront-spring-boot-bom</artifactId> <version>3.0.1</version> <type>pom</type> <scope>import</scope> </dependency> </dependencies> </dependencyManagement> -
Add the
wavefront-spring-boot-starterdependency to your project:<dependency> <groupId>com.wavefront</groupId> <artifactId>wavefront-spring-boot-starter</artifactId> </dependency>
Follow these steps:
-
Make sure your project uses the
io.spring.dependency-managementplugin and add the following to yourbuild.gradlefile:dependencyManagement { imports { mavenBom "com.wavefront:wavefront-spring-boot-bom:3.0.1" } } -
Add the
wavefront-spring-boot-starterdependency to your project:dependencies { ... implementation 'com.wavefront:wavefront-spring-boot-starter' }
Set the Application and Service Name in application.properties. In Wavefront, the Application
represents a logical grouping of individual Services. For example, a shopping application might be
comprised of the cart and payment services. If your Spring Boot app is the payment service:
management.wavefront.application.name=shopping
management.wavefront.application.service-name=payment
Each time you restart your application, it either creates a new freemium account, or it restores from ~/.wavefront_freemium.
At the end of the startup phase, the console displays a message with a login URL.
Use it to log in to the Wavefront service and access the data that has been collected so far.
Here is an example message when an existing account is restored from ~/.wavefront_freemium:
Your existing Wavefront account information has been restored from disk.
To share this account, make sure the following is added to your configuration:
management.wavefront.api-token=2c96d63a-abcd-efgh-ijhk-841611451e07
management.wavefront.uri=https://wavefront.surf
Connect to your Wavefront dashboard using this one-time use link:
https://wavefront.surf/us/example
If you'd like to send traces to Wavefront, you can do so using Micrometer Tracing. Follow these steps:
-
Choose a Micrometer Tracer for your usecase. For instructions, see Micrometer's Supported Tracer documentation. For example, to use the OpenTelemetry Tracer:
-
Maven: Add the following dependency to the
pom.xmlfile:<dependency> <groupId>io.micrometer</groupId> <artifactId>micrometer-tracing-bridge-otel</artifactId> </dependency> -
Gradle: Add the following dependency to the
build.gradlefile:dependencies { ... implementation 'io.micrometer:micrometer-tracing-bridge-otel' }
-
-
For demo purposes, configure distributed tracing sampling to 100% in
application.properties:management.tracing.sampling.probability=1.0
To build the latest state of this project, invoke the following command from the root directory:
$ ./mvnw clean installThe project has a sample that showcases the basic usage of the starter.
It starts a web app on localhost:8080.
Invoke the following command from the root directory:
$ ./mvnw spring-boot:run -pl wavefront-spring-boot-sample- The Wavefront documentation includes a tutorial and instructions for examining services and traces inside Wavefront.
- You can customize existing Spring Boot applications to send data to Wavefront.
- If you run into any issues, let us know by creating a GitHub issue.
- If you didn't find the information you are looking for in our Wavefront Documentation create a GitHub issue or PR in our docs repository.
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent