如何在Spring Boot应用中添加自定义端点及监控指标

# 1. Spring Boot自定义端点的基础知识

Spring Boot自定义端点允许开发人员创建自己的端点，以公开应用程序的特定信息或执行特定操作。这些端点可以用于监视、故障排除或与外部系统集成。

自定义端点基于Spring MVC框架，因此可以使用熟悉的注解和配置选项来创建和管理它们。最常见的注解是`@Endpoint`，它用于标记端点类，并指定端点路径和HTTP方法。例如：

@Endpoint(id = "my-custom-endpoint")
public class MyCustomEndpoint {

    @GetMapping
    public String getEndpointInfo() {
        return "This is my custom endpoint.";
    }

}

# 2. Spring Boot自定义端点的实践

### 2.1 创建基本自定义端点

**创建自定义端点：**

1. 创建一个新的Spring Boot项目。
2. 在`src/main/java`目录下创建一个新的类，例如`MyEndpoint.java`。
3. 继承`Endpoint`类并实现`invoke`方法。

import org.springframework.boot.actuate.endpoint.annotation.Endpoint;
import org.springframework.boot.actuate.endpoint.annotation.ReadOperation;
import org.springframework.boot.actuate.endpoint.web.annotation.WebEndpoint;
import org.springframework.stereotype.Component;

@Component
@Endpoint(id = "my-endpoint")
@WebEndpoint(id = "my-endpoint")
public class MyEndpoint {

    @ReadOperation
    public String invoke() {
        return "Hello from custom endpoint!";
    }
}

**配置端点：**

1. 在`application.properties`文件中添加以下配置：

management.endpoints.web.exposure.include=my-endpoint

2. 重启Spring Boot应用程序。

### 2.2 扩展自定义端点功能

**添加参数：**

1. 在`invoke`方法中添加参数。
2. 使用`@RequestParam`注解进行参数绑定。

@ReadOperation
public String invoke(@RequestParam(required = false) String message) {
    if (message == null) {
        return "Hello from custom endpoint!";
    } else {
        return "Hello from custom endpoint! Message: " + message;
    }
}

**返回复杂对象：**

1. 在`invoke`方法中返回一个复杂对象。
2. 使用`@ResponseBody`注解将对象转换为JSON。

import org.springframework.web.bind.annotation.ResponseBody;

@ResponseBody
@ReadOperation
public Map<String, String> invoke() {
    Map<String, String> result = new HashMap<>();
    result.put("message", "Hello from custom endpoint!");
    return result;
}

### 2.3 使用Actuator管理自定义端点

**启用Actuator：**

1. 在`pom.xml`文件中添加以下依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>

2. 重启Spring Boot应用程序。

**管理端点：**

1. 访问`http://localhost:8080/actuator`。
2. 找到自定义端点，例如`http://localhost:8080/actuator/my-endpoint`。
3. 使用HTTP方法（例如GET、POST）与端点交互。

**使用Actuator端点信息：**

1. 访问`http://localhost:8080/actuator/info`。
2. 查看自定义端点