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. To send data to your Operations for Applications account, specify the uri and api-token properties as follows:

     management.wavefront.api-token=$API_Token
 management.wavefront.uri=$wavefront_instance
  7. Restart the application and navigate to http://localhost:8080.
  8. 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.

Examine Inventory Data

To examine the data:

  1. Go to your server instance, click Dashboards > All Dashboards and enter Spring Boot Inventory.
  2. Select Contains: Spring Boot Inventory, and click the Spring Boot Inventory result in the table.

You are taken to the Wavefront Spring Boot Inventory dashboard where you can examine the data sent by your application. 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 can create smart alerts that dynamically filter noise and find true anomalies. For details, see Alerts.
tutorials