게이트웨이 모드¶

RBLN 메트릭 익스포터 v0.3.0부터는 단일 exporter 인스턴스가 여러 원격 호스트의 메트릭을 수집하는 게이트웨이 모드를 제공합니다. 게이트웨이 모드는 Prometheus에서 제공하는 멀티 타겟 exporter 패턴을 따르며, 호스트마다 exporter를 배포하기 어려운 베어메탈/비-쿠버네티스 환경을 위한 기능입니다.

동작 방식¶

Prometheus가 /metrics?target=<host:port> 형태로 게이트웨이를 스크랩하면, 게이트웨이는 해당 타겟의 rbln-smd에 gRPC로 접속해 요청 시점의 전체 메트릭을 수집하고 Prometheus 형식으로 응답합니다. 게이트웨이는 요청 사이에 메트릭 상태를 저장하지 않고 타겟 목록도 갖지 않으며, 타겟 목록은 Prometheus 스크랩 설정에서만 관리됩니다. 타겟별 gRPC 연결은 캐시해 재사용하고, 끊어지면 자동으로 다시 연결합니다.

게이트웨이 실행¶

exporter는 두 가지 실행 모드 중 하나로 동작하며, 시작 시 --mode 플래그 또는 RBLN_METRICS_EXPORTER_MODE 환경 변수를 사용하여 선택합니다.

1

rbln-metrics-exporter --mode=gateway --port=9200

Prometheus 스크랩 설정¶

NPU 호스트 주소를 targets에 나열합니다. relabel_configs를 사용해 각 주소를 target 쿼리 파라미터로 전달하고, HTTP 요청은 게이트웨이로 보내도록 설정합니다.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

scrape_configs:
  - job_name: rbln-npu-gateway
    metrics_path: /metrics
    static_configs:
      - targets:
          - npu-host-1:50051   # 각 NPU 호스트의 rbln-smd gRPC 주소
          - npu-host-2:50051
    relabel_configs:
      # 1. 나열된 주소를 ?target= 쿼리 파라미터로 복사합니다.
      - source_labels: [__address__]
        target_label: __param_target
      # 2. 호스트별로 시리즈를 구분할 수 있도록 instance 레이블로 유지합니다.
      - source_labels: [__param_target]
        target_label: instance
      # 3. 실제 HTTP 요청은 NPU 호스트가 아닌 게이트웨이로 보냅니다.
      - target_label: __address__
        replacement: rbln-gateway:9200   # 게이트웨이 exporter 주소

이 설정으로 Prometheus는 호스트마다 http://rbln-gateway:9200/metrics?target=npu-host-1:50051을 스크랩하고, 모든 시리즈를 instance="npu-host-1:50051" 레이블과 함께 저장합니다.