Configure Wavefront for Spring Boot with a sample application.

In this tutorial, you use Wavefront for Spring Boot that uses Spring Boot 2 with the Spring petclinic sample application. This tutorial sets dependencies explicitly. In most cases, it makes sense to use the Spring Initializr instead to explore supported combinations.

Prerequisites

  • Spring Boot 2.3.0 or above.
  • Java 8 or above.
  • Maven 3.3+ or Gradle 6.3 or later.
    See System Requirements in the Spring Boot documentation.
  • Clone the sample petclinic application.
    git clone https://github.com/spring-projects/spring-petclinic.git
    
  • Build the project and start it.
    cd spring-petclinic
    ./mvnw spring-boot:run
    

Send Data to Our Service

  1. Open the sample petclinic application using an IDE and add the following code to the pom.xml file:
     <dependency>
       <groupId>com.wavefront</groupId>
       <artifactId>wavefront-spring-boot-starter</artifactId>
     </dependency>
    
  2. Import the Wavefront for Spring Boot Bill of Materials (BOM) to your project. Add the following code to the pom.xml file (replace VERSION with the current version):
     <dependencyManagement>
     <dependencies>
       <dependency>
         <groupId>com.wavefront</groupId>
         <artifactId>wavefront-spring-boot-bom</artifactId>
         <version>VERSION</version>
         <type>pom</type>
         <scope>import</scope>
       </dependency>
     </dependencies>
     </dependencyManagement>
    
  3. Add the following dependency to send trace data to our service using Spring Cloud Sleuth.
    1. Open your application and add the following code to your pom.xml file.
       <dependency>
         <groupId>org.springframework.cloud</groupId>
         <artifactId>spring-cloud-starter-sleuth</artifactId>
       </dependency>
      
    2. Import the Spring Cloud Bill of Materials (BOM) to your project. Add the following code under .
       <dependencyManagement>
         <dependencies>
           .....
           <dependency>
             <groupId>org.springframework.cloud</groupId>
             <artifactId>spring-cloud-dependencies</artifactId>
             <version>{ADD_VERSION}</version>
             <type>pom</type>
             <scope>import</scope>
           </dependency>
           .....
         </dependencies>
       </dependencyManagement>
      
  4. Add the P6Spy dependency to intercept and log SQL queries. You can intercept most Connection, Statement and ResultSet methods invocations using the P6Spy dependency.
     <dependency>
       <groupId>p6spy</groupId>
       <artifactId>p6spy</artifactId>
       <version>{ADD_VERSION}</version>
       <scope>runtime</scope>
     </dependency>
    
  5. Add the following configurations to the application.properties file so that your application is named spring-demo, and the service is named spring-petclinic.
     wavefront.application.name=spring-demo
     wavefront.application.service=spring-petclinic
     spring.sleuth.jdbc.p6spy.enable-logging=true
    
  6. Restart the application and navigate to http://localhost:8080.
  7. Add data from the petclinic user interface. For example:
    1. Add an Owner and a Pet via the User Interface.
    2. Click ERROR to trigger errors.
  8. Click the one-time use link to access the Wavefront for Spring Boot Service Dashboard and view data.

    Example:

     To share this account, make sure the following is added to your configuration:
    
      management.metrics.export.wavefront.api-token=44444-34this-45is-123a-sampletoken
      management.metrics.export.wavefront.uri=https://wavefront.surf
    
     Connect to your Wavefront dashboard using this one-time use link:
     https://wavefront.surf/us/example
    

Examine Inventory Data

When you click the link in the Wavefront Spring Boot starter, you are taken to the Spring Boot Inventory dashboard. This dashboard provides real-time visibility into your Spring Boot application landscape. The dashboard has several sections that include the following charts:

  • Status of hosts, applications, and services.
  • Request rate
  • Inventory details
  • Hosts. Use the drop-down menus to group the hosts.

If one or more applications are enabled for tracing, click the link in the Tracing section to be directed to the Tracing dashboard.

Spring Boot inventory screenshot

Examine RED Metrics and Traces

When you click the link in the Spring Boot Inventory dashboard, you are taken to the Spring Boot Traces Browser where you can:

  • View the trace data of the spring-petclinic service.
    • Once in the Traces Browser, you see the traces from the application and the trace related to the error you created.
    • If you configured your application to send trace data using OpenTracing, you can see span logs for the errors you triggered. Span logs for the petclinic application
  • View details specific to an application service, such as the Request, Error, and Duration (RED) metrics by clicking service dashboard on the Traces Browser. See Explore the Default Service Dashboard for details.

    Wavefront for Spring Boot Service dashboard

Next Steps

  • See the Wavefront for Spring Boot FAQs.
  • You cannot save changes that you make to the preconfigured Spring Boot Inventory and Wavefront for Spring Boot Service Dashboards. If you want custom dashboards, you must clone and edit the dashboard. For details, see Create and Customize Dashboards.
  • Customers or free trial users can create smart alerts that dynamically filter noise and find true anomalies. For details, see Alerts.
  • Try out the petclinic application with the Micrometer. See Wavefront for Spring Boot: Getting Started for details.