Actuator监控模块实战：5分钟实现应用健康检查与性能监控

最新推荐文章于 2025-12-08 10:13:15 发布

原创最新推荐文章于 2025-12-08 10:13:15 发布 · 908 阅读

16 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

标签

#springboot

Web 专栏收录该内容

583 篇文章

订阅专栏

该文章已生成可运行项目，

🎓博主介绍：Java、Python、js全栈开发 “多面手”，精通多种编程语言和技术，痴迷于人工智能领域。秉持着对技术的热爱与执着，持续探索创新，愿在此分享交流和学习，与大家共进步。
📖全栈开发环境搭建运行攻略：多语言一站式指南(环境搭建+运行+调试+发布+保姆级详解)
👉感兴趣的可以先收藏起来，希望帮助更多的人

Actuator监控模块实战：5分钟实现应用健康检查与性能监控

一、引言

在当今的软件开发领域，保证应用程序的高可用性和良好性能是至关重要的。而对应用进行实时的健康检查和性能监控则是实现这一目标的关键手段。Spring Boot Actuator 作为 Spring Boot 提供的强大监控模块，能够帮助开发者快速搭建应用的监控体系，让我们在短时间内实现对应用的全面监控。本文将带领大家进行 Actuator 监控模块的实战，只需 5 分钟，就能实现应用的健康检查与性能监控。

二、Actuator 简介

2.1 什么是 Actuator

Spring Boot Actuator 是 Spring Boot 提供的一个强大的生产级特性，它可以帮助我们监控和管理 Spring Boot 应用。Actuator 提供了一系列的端点（Endpoints），这些端点可以通过 HTTP 或者 JMX 来访问，用于获取应用的各种信息，如健康状态、配置信息、性能指标等。

2.2 主要功能

健康检查：通过 /actuator/health 端点可以快速了解应用的健康状态，包括数据库连接、缓存状态等。
性能监控：提供了如内存使用情况、线程池状态、HTTP 请求统计等性能指标，方便我们对应用的性能进行分析。
配置信息管理：可以查看应用的配置属性，如环境变量、配置文件信息等。

三、实战环境搭建

3.1 项目创建

首先，我们使用 Spring Initializr 来创建一个新的 Spring Boot 项目。访问 Spring Initializr，按照以下步骤进行配置：

Project：选择 Maven Project。
Language：选择 Java。
Spring Boot：选择合适的版本，这里以 3.0.0 为例。
Group 和 Artifact：填写项目的包名和名称。
Dependencies：添加 Spring Web 和 Spring Boot Actuator 依赖。

点击 Generate 按钮下载项目压缩包，解压后导入到 IDE 中。

3.2 项目配置

在 application.properties 或 application.yml 中添加以下配置：

# 开启所有 Actuator 端点
management.endpoints.web.exposure.include=*

如果使用 application.yml，配置如下：

management:
  endpoints:
    web:
      exposure:
        include: '*'

四、实现健康检查

4.1 默认健康检查端点

Spring Boot Actuator 提供了默认的健康检查端点 /actuator/health。启动应用后，访问 http://localhost:8080/actuator/health，可以看到类似以下的响应：

{
    "status": "UP"
}

status 为 UP 表示应用健康状态正常。

4.2 自定义健康检查

除了默认的健康检查，我们还可以自定义健康检查逻辑。创建一个自定义的健康指示器类：

import org.springframework.boot.actuate.health.Health;
import org.springframework.boot.actuate.health.HealthIndicator;
import org.springframework.stereotype.Component;

@Component
public class CustomHealthIndicator implements HealthIndicator {

    @Override
    public Health health() {
        // 模拟自定义健康检查逻辑
        boolean isHealthy = checkCustomCondition();
        if (isHealthy) {
            return Health.up().build();
        } else {
            return Health.down().withDetail("error", "Custom condition failed").build();
        }
    }

    private boolean checkCustomCondition() {
        // 这里可以添加具体的健康检查逻辑
        return true;
    }
}

再次访问 /actuator/health，可以看到自定义健康检查的结果已经包含在响应中。

五、实现性能监控

5.1 性能指标端点

Actuator 提供了多个性能指标端点，如 /actuator/metrics 可以查看应用的各种性能指标。访问 http://localhost:8080/actuator/metrics，可以看到类似以下的响应：

{
    "names": [
        "jvm.buffer.memory.used",
        "jvm.classes.loaded",
        "jvm.gc.memory.promoted",
        ...
    ]
}

这些指标名称代表了不同的性能指标，如 JVM 内存使用情况、类加载数量等。

5.2 查看具体指标

要查看某个具体指标的详细信息，可以在 /actuator/metrics 后面加上指标名称，如 /actuator/metrics/jvm.memory.used：

{
    "name": "jvm.memory.used",
    "description": "The amount of used memory",
    "baseUnit": "bytes",
    "measurements": [
        {
            "statistic": "VALUE",
            "value": 123456789
        }
    ],
    "availableTags": [
        {
            "tag": "area",
            "values": [
                "heap",
                "nonheap"
            ]
        },
        {
            "tag": "id",
            "values": [
                "Metaspace",
                "PS Eden Space",
                ...
            ]
        }
    ]
}