引导完成第一个 Spring Boot 项目

本指南将引导您完成您的第一个 Spring Boot 项目，其中包含 Wavefront 的 Tanzu Observability。

您将构建什么

您将创建一个简单的 Web 应用程序，并将其配置为将指标发送到免费增值集群。

你需要什么

• 约15分钟
• 最喜欢的文本编辑器或 IDE
• JDK 1.8或以后
• 格拉德尔 4+​或梅文 3.2+
• 您也可以将代码直接导入到 IDE 中：

• 弹簧工具套件 （STS）
• 智能理念
• VSCode

如何完成本指南

像大多数春天一样入门指南，您可以从头开始并完成每个步骤，也可以绕过您已经熟悉的基本设置步骤。无论哪种方式，您最终都会得到工作代码。

要从头开始，请继续从 Spring 初始化开始.

要跳过基础知识，请执行以下操作：

• 下载​并解压缩本指南的源存储库，或使用吉特:git clone https://github.com/spring-guides/gs-tanzu-observability.git
• 光盘成gs-tanzu-observability/initial
• 跳转到开箱即用的可观测性.

完成后，您可以根据 中的代码检查结果。​​gs-tanzu-observability/complete​​

从 Spring 初始化开始

您可以使用此预初始化项目，然后单击生成以下载 ZIP 文件。此项目配置为适合本教程中的示例。

如果要手动初始化项目，请按照以下步骤操作：

1. 导航到https://start.spring.io.此服务拉入应用程序所需的所有依赖项，并为您完成大部分设置。
2. 选择您喜欢的构建系统和语言。本指南假定您已选择 Java。
3. 单击添加依赖项，然后选择 Spring Web，然后选择 Wavefront。
4. 单击生成。下载 ZIP 文件，该文件是包含 Tanzu 可观测性的 Web 应用程序的存档。

开箱即用的可观测性

按照以下步骤启动项目，并通过 Wavefront 自动将多个自动配置的指标发送到 Tanzu 可观测性。

1. 在启动服务之前，请配置项目，以便可以识别应用程序和服务发送的指标。打开文件并添加以下内容：application.properties

wavefront.application.name=demo
wavefront.application.service=getting-started

1. 通过调用 的方法从 IDE 运行应用程序。您会看到以下内容：mainDemoApplication

INFO 16295 --- [           main] o.s.b.a.e.web.EndpointLinksResolver      : Exposing 2 endpoint(s) beneath base path '/actuator'
INFO 16295 --- [           main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat started on port(s): 8080 (http) with context path ''
INFO 16295 --- [           main] hello.DemoApplication         : Started DemoApplication in 1.207 seconds (JVM running for 1.727)

A Wavefront account has been provisioned successfully and the API token has been saved to disk.

To share this account, make sure the following is added to your configuration:

  management.metrics.export.wavefront.api-token=ee1f454b-abcd-efgh-1234-bb449f6a25ed
  management.metrics.export.wavefront.uri=https://wavefront.surf

Connect to your Wavefront dashboard using this one-time use link:
https://wavefront.surf/us/AtoKen

发生了什么事？

• 在没有任何额外信息的情况下，免费增值集群上的帐户会自动为您配置。
• 已为您创建了一个 API 令牌。
• 为了让您访问免费增值集群上的仪表板，在应用程序启动时记录了一个一次性使用链接。链接以 开头。将此链接复制到您喜欢的浏览器中，并探索开箱即用的 Spring 启动仪表板：https://wavefront.surf

创建简单控制器

接下来，您可以创建一个简单的控制器来查看如何自动检测 HTTP 流量。以下清单显示了如何执行此操作：

package hello;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class DemoController {

  @GetMapping("/")
  public String home() {
    return "Hello World";
  }

}

1. 重新启动应用程序并从浏览器多次触发。http://localhost:8080
2. 您会注意到仪表板上有一个额外的 HTTP 部分。此功能称为条件仪表板，允许您根据筛选器显示部分。
   
   
3. （可选）访问以触发客户端 404 错误。http://localhost:8080/does-not-exist

使用 /actuator/wavefront 访问仪表板

您可以使用执行器端点访问仪表板，而无需查看日志并在每次启动应用程序时获取链接。若要启用此功能，需要公开终结点。​​wavefront​​

1. 打开文件并添加以下内容：application.properties

management.endpoints.web.exposure.include=health,info,wavefront

1. 重新启动应用程序，然后导航到http://localhost:8080/actuator/wavefront以访问 Tanzu 可观测性通过波前仪表板。

总结

祝贺！您刚刚开发了一个 Web 应用程序，该应用程序通过 Wavefront 将指标发送到 Tanzu Observability。