메트릭

메트릭 (Metrics)

출처: Metrics

본문

메트릭

Traefik Proxy의 메트릭(metrics)은 인프라 건강 상태를 전체적으로 보여줘요. 들어오는 트래픽 양 같은 핵심 지표를 모니터링할 수 있게 해 주고, 그래프·시각화는 장애 분석(incident triage) 때 원인을 이해하고 사전 예방 조치를 취하는 데 도움을 줍니다.

사용 가능한 메트릭 프로바이더 (Available Metrics Providers)

Traefik Proxy는 다음 메트릭 프로바이더를 지원해요:

• OpenTelemetry

• Prometheus

• Datadog

• InfluxDB 2.X

• StatsD

설정 (Configuration)

Traefik Proxy에서 메트릭을 활성화하려면 정적 설정 파일이나(Helm 차트를 쓴다면) helm 값에 메트릭 프로바이더를 설정해야 해요. 다음 예시는 메트릭을 컬렉터로 보내도록 OpenTelemetry 프로바이더를 구성하는 방법을 보여줘요.

구조화 (YAML)

metrics:
  otlp:
    http:
      endpoint: http://myotlpcollector:4318/v1/metrics

구조화 (TOML)

[metrics.otlp.http]
  endpoint = "http://myotlpcollector:4318/v1/metrics"

Helm 차트 값 (Helm Chart Values)

# values.yaml
metrics:
  # Disable Prometheus (enabled by default)
  prometheus: null
  # Enable providing OTel metrics
  otlp:
    enabled: true
    http:
      enabled: true
      endpoint: http://myotlpcollector:4318/v1/metrics

라우터별 메트릭 (Per-Router Metrics)

특정 라우터에 대해 메트릭 수집을 활성화하거나 비활성화할 수 있어요. 일부 라우트를 메트릭 데이터에서 제외할 때 유용하죠.

특정 라우터에서 메트릭을 비활성화하는 예시를 볼게요:

구조화 (YAML)

http:
  routers:
    my-router:
      rule: "Host(`example.com`)"
      service: my-service
      observability:
        metrics: false

구조화 (TOML)

[http.routers.my-router.observability]
  metrics = false

Kubernetes

# ingressroute.yaml
apiVersion: traefik.io/v1alpha1
kind: IngressRoute
metadata:
  name: my-router
spec:
  routes:
    - kind: Rule
      match: Host(`example.com`)
      services:
        - name: my-service
          port: 80
      observability:
        metrics: false

Labels (레이블)

labels:
  - "traefik.http.routers.my-router.observability.metrics=false"

Tags (태그)

{
  // ...
  "Tags": [
    "traefik.http.routers.my-router.observability.metrics=false"
  ]
}

라우터에 observability 옵션이 정의되어 있지 않으면, 엔트리포인트의 관찰성 설정이나 전역 설정의 동작을 상속받아요.

정보 (Info)

자세한 설정 옵션은 참조 문서를 참고하세요.

더 알아보기 (Learn more)

• Traefik 공식 문서