giuseppe-trisciuoglio/spring-boot-actuator

spring-boot-actuator 是做什麼的？

提供配置 Spring Boot Actuator 的模式，用於生產級監控、健康檢查、安全管理端點以及跨 JVM 服務的 Micrometer 指標。適用於為 Spring Boot 應用設置監控、健康檢查或指標時使用。

概述

此技能幫助你快速配置 Spring Boot Actuator，以便在生產環境中監控應用程式健康狀態、公開管理端點並收集 Micrometer 指標。

主要功能

• 健康檢查：配置 Actuator 健康端點以支援 Kubernetes 就緒探針與存活探針。
• 安全端點：保護敏感的管理端點（如 /actuator/env、/actuator/beans）僅限授權訪問。
• 指標匯出：整合 Micrometer 以將指標匯出至 Prometheus、Graphite 或 Datadog 等監控系統。
• 端點自訂：啟用或停用特定 Actuator 端點，並設定自訂基礎路徑。

使用方式

在 application.yml 或 application.properties 中加入以下配置範例：

management:
  endpoints:
    web:
      exposure:
        include: health,info,metrics,prometheus
      base-path: /manage
  endpoint:
    health:
      show-details: always
      probes:
        enabled: true
  metrics:
    export:
      prometheus:
        enabled: true

安全配置範例

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
import org.springframework.security.web.SecurityFilterChain;

@Configuration
public class ActuatorSecurityConfig {

    @Bean
    public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
        http.authorizeHttpRequests(authz -> authz
            .requestMatchers("/manage/health").permitAll()
            .requestMatchers("/manage/**").hasRole("ADMIN")
            .anyRequest().authenticated()
        );
        return http.build();
    }
}

支援的平台

• Claude Code
• Cursor
• Codex

相關依賴

• spring-boot-starter-actuator
• micrometer-registry-prometheus（如需要 Prometheus 導出）
• spring-boot-starter-security（如需安全保護）