게이지 등록 및 모니터링 (스프링, 프로메테우스, 그라파나)

 

카운터 메트릭 등록 및 모니터링 (스프링, 프로메테우스, 그라파나) (tistory.com)

카운터 메트릭 등록 및 모니터링 (스프링, 프로메테우스, 그라파나)

 

Timer 메트릭 등록 및 모니터링 (스프링, 프로메테우스, 그라파나) (tistory.com)

Timer 메트릭 등록 및 모니터링 (스프링, 프로메테우스, 그라파나)

 

위에 두 글에서는 카운터 값에 대해서 직접 메트릭을 등록해서 그라파나 대시보드에 나타냈었다. 

이번에는 게이지를 등록해서 확인해볼 것이다. 🙆‍♀️

 

 

1️⃣ 메트릭 등록 5 - 게이지 

Gauge 게이지 

: 게이지는 임의로 오르내릴 수 있는 단일 숫자 값을 나타내는 메트릭으로 값의 현재 상태를 보는데 사용한다. 

-> 따라서 값이 증가하거나 감소할 수 있다. 

ex) 차량의 속도, CPU 사용량, 메모리 사용량 

 

👩‍💻 참고: 게이지와 카운터가 헷갈린다면 값이 감소할 수 있는가를 기준으로 생각해보면 된다. 

 

StockConfigV1

@Configuration
public class StockConfigV1
{
   
   @Bean
   public MyStockMetric myStockMetric(OrderService orderService, MeterRegistry meterRegistry)
   {
      return new MyStockMetric(orderService, meterRegistry);
   }
   
   @Slf4j
   static class MyStockMetric
   {
      private OrderService orderService;
      
      private MeterRegistry meterRegistry;
      
      public MyStockMetric(OrderService orderService, MeterRegistry meterRegistry)
      {
         this.orderService = orderService;
         this.meterRegistry = meterRegistry;
      }
      
      @PostConstruct
      public void init()
      {
         Gauge.builder("my.stock", orderService, service -> {
            log.info("stock gague call");
            return service.getStock().get();
         }).register(meterRegistry);
      }
   }
}

 my.stock이라는 게이지를 등록하는데, 이때 함수를 함께 전달한다. 이 함수는 외부에서 메트릭을 확인할 때 마다 호출되는 것으로 이 함수의 반환값이  게이지의 값이다. 

 

 

ActuatorApplication 

@Import({OrderConfigV4.class, StockConfigV1.class})
@SpringBootApplication(scanBasePackages = "hello.controller")
public class ActuatorApplication {

    public static void main(String[] args) {
        SpringApplication.run(ActuatorApplication.class, args);
    }

}

 

 

* 실행

애플리케이션을 실행하면 stock gauge call 로그가 주기적으로 남는 것을 확인할 수 있는데 

게이지를 확인하는 함수는 외부에서 메트릭을 확인할 때 호출된다. 

-> 지금 프로메테우스가 메트릭을 주기적으로 확인하기 때문에 계속 로그가 남는다. 

http://localhost:8080/actuator/prometheus

 

만약 프로메테우스 종료하면 더이상 로그가 출력되지 않는 것을 알 수 있다. 

 

http://localhost:8080/actuator/metrics/my.stock

게이지는 누적값이 필요없고 현재 값만 있으면 되기 때문에 현재값만 반환해준다.

 

 

* 그라파나 등록 

 

 

 

2️⃣ 게이지 간단 등록 

StockConfigV2

@Slf4j
@Configuration
public class StockConfigV2
{
   
   @Bean
   public MeterBinder stockSize(OrderService orderService)
   {
      return registry -> Gauge.builder("my.stock", orderService, service -> {
         log.info("stock gague call");
         return service.getStock().get();
      }).register(registry);
   }

}

 

 

ActuatorApplication 

@Import({OrderConfigV4.class, StockConfigV2.class})
@SpringBootApplication(scanBasePackages = "hello.controller")
public class ActuatorApplication {

    public static void main(String[] args) {
        SpringApplication.run(ActuatorApplication.class, args);
    }
    
    @Bean
    public InMemoryHttpExchangeRepository httpExchangeRepository()
    {
        return new InMemoryHttpExchangeRepository();
    }

}