Spring Boot Actuator, uygulamalarınızı izlemek ve yönetmek için prodüksiyon seviyesinde hazır özellikler sunar. Bu rehber, Actuator'ın yeteneklerini, nasıl etkinleştirileceğini ve endpointlerin nasıl güvenlik altına alınacağını incelemektedir.
Spring Boot Actuator, uygulamalarınızı izlemek ve yönetmek için prodüksiyon seviyesinde hazır özellikler sunar. Bu rehber, Actuator'ın yeteneklerini, nasıl etkinleştirileceğini ve endpointlerin nasıl güvenlik altına alınacağını incelemektedir.
Spring Boot Actuator geliştiricilere şunları sağlar:
📋 Aşağıdaki şartların karşılandığından emin olun:
Actuator'ı etkinleştirmek için, projenize aşağıdaki bağımlılıkları ekleyin:
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-actuator</artifactId> </dependency>
implementation 'org.springframework.boot:spring-boot-starter-actuator'
Varsayılan olarak, Actuator uygulama bilgilerinin sağlanması için çeşitli endpointler yayınlar. Bu endpointleri application.properties veya application.yml dosyasında etkinleştirebilirsiniz.
Bu yapılandırmayı başlangıç noktası olarak alın, sonra ortamınıza göre değerleri uyarlayın.
management.endpoints.web.exposure.include=health,info,metrics management.endpoint.health.show-details=always
İşte sık kullanılan Actuator endpointleri:
/actuator/health: Uygulama sağlık durumu sağlar./actuator/info: Uygulama metadatasını gösterir./actuator/metrics: Uygulama performans metriklerini sunar.Bu endpointlere bir tarayıcı veya cURL gibi API araçları kullanarak erişebilirsiniz.
Örnek:
curl -X GET http://localhost:8080/actuator/health
Actuator endpointlerini ihtiyaçlarınıza göre özelleştirin. Örneğin, /actuator/info endpointi için ek metadata tanımlayabilirsiniz:
info.app.name=Benim Uygulamam info.app.version=1.0.0 info.app.description=Spring Boot Actuator Örneği
Prodüksiyon ortamlarında, Actuator endpointlerinin güvenli hale getirilmesi önemlidir. Spring Security kullanarak erişimi sınırlayabilirsiniz.
Uygulamayı aşağıdaki komutla çalıştırın:
./mvnw spring-boot:run
Actuator endpointlerine erişim sağlamak için:
http://localhost:8080/actuator/health
Actuator endpointlerini cURL veya tarayıcı kullanarak test edebilirsiniz:
curl -X GET http://localhost:8080/actuator/health
curl -X GET http://localhost:8080/actuator/info
Artık Spring Boot Actuator için üretim odaklı bir Spring Boot temeliniz var. Sonraki adımda ayarları kendi domainine uyarlayıp test ve gözlemlenebilirlik katmanını ekleyerek gerçek trafik altında doğrulayın.
package com.example.demo.config; import org.springframework.context.annotation.Configuration; import org.springframework.security.config.annotation.web.builders.HttpSecurity; import org.springframework.security.web.SecurityFilterChain; @Configuration public class SecurityConfig { public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception { http .authorizeHttpRequests() .requestMatchers("/actuator/**").hasRole("ADMIN") .anyRequest().authenticated() .and() .httpBasic(); return http.build(); } }
package com.example.demo.config 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 class SecurityConfig { @Bean fun securityFilterChain(http: HttpSecurity): SecurityFilterChain { http .authorizeHttpRequests() .requestMatchers("/actuator/**").hasRole("ADMIN") .anyRequest().authenticated() .and() .httpBasic() return http.build() } }