diff --git a/pages/doc/documentation_getting_started.md b/pages/doc/documentation_getting_started.md index a7f6d9d46..a8e2107f3 100644 --- a/pages/doc/documentation_getting_started.md +++ b/pages/doc/documentation_getting_started.md @@ -90,7 +90,7 @@ Our documentation includes reference documentation for API, query language, and screenshot of TOC of chart FAQ diff --git a/pages/doc/wavefront_spring_boot.md b/pages/doc/wavefront_spring_boot.md index c321026b0..fbbf8cfc2 100644 --- a/pages/doc/wavefront_spring_boot.md +++ b/pages/doc/wavefront_spring_boot.md @@ -21,12 +21,10 @@ If you use Wavefront for Spring Boot: ## Sending Data from Spring Boot Into Our Service -You can send data from your Spring Boot applications into our service using the Wavefront for Spring Boot Starter (all users) or the Wavefront Spring Boot integration (customers). +You can send data from your Spring Boot applications into our service using the Wavefront for Spring Boot Starter or the Wavefront Spring Boot integration. -* **Wavefront for Spring Boot Starter**
If you configure your application with the Wavefront for Spring Boot starter, you can send metrics, histograms, and traces/spans to our service. Once the data is in our service, you can view your data, find hotspots, and gather more data. - - All users can run the Spring Boot Starter with the default settings to view their data in the freemium instance. Certain limitations apply, for example, alerts are not available, but you don't have to sign up. - +* **Wavefront for Spring Boot Starter** +
If you configure your application with the Wavefront for Spring Boot starter, you can send metrics, histograms, and traces/spans to our service. Once the data is in our service, you can view your data, find hotspots, and gather more data. Customers can modify the default Wavefront Spring Boot Starter to send data to their cluster. * **Wavefront Spring Boot Integration**: Customers can access the Wavefront Spring Boot integration directly from their clusters. ## Dashboards @@ -58,8 +56,8 @@ This is the default dashboard you see when you run the Spring Boot initializer. Getting started is easy. Here are some things to know before you start: * **Ingestion Method**: Wavefront for Spring Boot sends data to our service via [direct ingestion](direct_ingestion.html) by default. You can [configure your application to send data via the Wavefront proxy](#proxy). -* **Target**: Wavefront for Spring Boot sends data to the freemium instance by default. You can [configure your application to send data to your Operations for Applications instance](#step-2-optional-specify-your-operations-for-applications-instance). -* **Account**: By default, the starter sends you to the Freemium instance, auto-negotiates an account, and saves the API token in the `~/.wavefront_freemium` file in your home directory. If you customize the starter to go to your Operations for Applications instance (see Step 2 below) you need to include an API token for that instance. +* **Target**: You can [configure your application to send data to your Operations for Applications instance](#step-2-optional-specify-your-operations-for-applications-instance). +* **Account**: To send data to your Operations for Applications instance (see Step 2 below) you need to include an API token for that instance. ### Prerequisites for Wavefront Spring Boot Starter @@ -308,9 +306,9 @@ dependencies { -### Step 2 (Optional): Specify Your Operations for Applications Instance +### Step 2: Specify Your Operations for Applications Instance -By default, the Wavefront Spring Boot Starter creates an account for you and sends data to the Freemium instance. If you already have an Operations for Applications account, you can send data there instead by specifying the `uri` and `api-token` properties, as follows: +To send data to your Operations for Applications account, specify the `uri` and `api-token` properties as follows: ``` management.metrics.export.wavefront.api-token=$API_Token @@ -326,7 +324,6 @@ management.metrics.export.wavefront.uri=$wavefront_instance To view your data, you first run your project from the command line, and then click the link that directs you to our service. Follow these steps: 1. Run your project. - {% include note.html content="If you're using the Freemium instance, an account is auto-negotiated or restored from `~/.wavefront_freemium` in your home directory each time the application starts. Otherwise, you're directed to the instance you specified. "%}
@@ -137,114 +131,6 @@ Initialize a new project using the Spring Initializer or add the required depend
-
-

Follow these steps if you don't have an Operations for Applications account and need to use the freemium account.

-
    -
  1. Add the Wavefront dependency. - -
    -
    -

    Open your application and add the following code to your pom.xml file.

    -
    -<dependency>
    -  <groupId>com.wavefront</groupId>
    -  <artifactId>wavefront-spring-boot-starter</artifactId>
    -  <scope>runtime</scope>
    -</dependency>
    -              
    -
    - -
    -

    Open your application and add the following code to your build.gradle file.

    -
    -dependencies {
    -  ...
    -  runtimeOnly 'com.wavefront:wavefront-spring-boot-starter'
    -}
    -             
    -
    -
    -
  2. - -
  3. - Import the Wavefront for Spring Boot Bill of Materials (BOM) to your project. - {{site.data.alerts.tip}} -

    The Wavefront for Spring Boot dependency needs to be compatible with the Spring Boot release version. Therefore, replace $releaseVersion with the correct dependency version. See System Requirements to get the correct dependency version.

    - {{site.data.alerts.end}} - -
    -
    -
    -
    -<dependencyManagement>
    -  <dependencies>
    -  .....
    -    <dependency>
    -      <groupId>com.wavefront</groupId>
    -      <artifactId>wavefront-spring-boot-bom</artifactId>
    -      <version>$releaseVersion</version>
    -      <type>pom</type>
    -      <scope>import</scope>
    -    </dependency>
    -  .....
    -  </dependencies>
    -</dependencyManagement>
    -              
    -
    - -
    -
    -dependencyManagement {
    -  imports {
    -    mavenBom "com.wavefront:wavefront-spring-boot-bom:$releaseVersion"
    -  }
    -}
    -            
    -
    -
    -
  4. - -
  5. - If you want to send trace data to our service using Micrometer Tracing, add the following dependencies. - -
    -
    -
    -<dependency>
    -  <groupId>io.micrometer</groupId>
    -  <artifactId>micrometer-tracing-bridge-brave</artifactId>
    -</dependency>
    -<dependency>
    -  <groupId>io.micrometer</groupId>
    -  <artifactId>micrometer-tracing-reporter-wavefront</artifactId>
    -  <scope>runtime</scope>
    -</dependency>
    -              
    -
    - -
    -
    -dependencies {
    -  ...
    -  implementation 'io.micrometer:micrometer-tracing-bridge-brave'
    -  runtimeOnly 'io.micrometer:micrometer-tracing-reporter-wavefront'
    -}
    -              
    -
    -
    -
  6. -
-
-

Follow these steps if you already have an Operations for Applications account.

    @@ -322,9 +208,9 @@ dependencies {
-### Step 2 (Optional): Specify Your Operations for Applications Instance +### Step 2: Specify Your Operations for Applications Instance -By default, the Wavefront Spring Boot Starter creates an account for you and sends data to the Freemium instance. If you already have an Operations for Applications account, you can send data there instead by specifying the `uri` and `api-token` properties as follows: +To send data to your Operations for Applications account, specify the `uri` and `api-token` properties as follows: ``` management.wavefront.api-token=$API_Token @@ -339,7 +225,6 @@ management.wavefront.uri=$wavefront_instance To view your data, you first run your project from the command line, and then click the link that directs you to our service. Follow these steps: 1. Run your project. - {% include note.html content="If you're using the Freemium instance, an account is auto-negotiated or restored from `~/.wavefront_freemium` in your home directory each time the application starts. Otherwise, you're directed to the instance you specified. "%}