호스트

메트릭 수집

호스트에서 실행 중인 에이전트에 대해 이 점검을 구성하려면

1. 에이전트의 설정 디렉터리 루트에 있는 conf.d/ 폴더에서 haproxy.d/conf.yaml 파일을 편집하여 HAProxy 메트릭 수집을 시작합니다. 사용 가능한 모든 설정 옵션은 haproxy.d/conf.yaml 샘플을 참조하세요.

   instances:
   
     ## @param use_openmetrics - boolean - optional - default: false
     ## Enable to preview the new version of the check which supports HAProxy version 2 or later
     ## or environments using the HAProxy exporter.
     ##
     ## OpenMetrics-related options take effect only when this is set to `true`. 
     ##
     ## Uses the latest OpenMetrics V2 implementation for more features and better performance.
     ## Note: To see the configuration options for the OpenMetrics V1 implementation (Agent v7.33 or earlier),
     ## https://github.com/DataDog/integrations-core/blob/7.33.x/haproxy/datadog_checks/haproxy/data/conf.yaml.example
     #
   - use_openmetrics: true  # Enables OpenMetrics V2
   
     ## @param openmetrics_endpoint - string - optional
     ## The URL exposing metrics in the OpenMetrics format.
     #
     openmetrics_endpoint: http://localhost:<PORT>/metrics
   

   레거시 구현에 대한 설정 옵션을 보려면 에이전트 v7.34 이전 버전에 대한 haproxy.d/conf.yaml 샘플 파일을 참조하세요.

2. 에이전트를 재시작하세요.

컨테이너화

컨테이너화된 환경의 경우 자동탐지 통합 템플릿에 아래 파라미터를 적용하는 방법이 안내되어 있습니다.

메트릭 수집

쿠버네티스(Kubernetes) 배포 예시

배포를 위해 .spec.template.metadata 아래에 포드 주석을 추가합니다.

apiVersion: apps/v1
kind: Deployment
metadata:
  name: haproxy
spec:
  template:
    metadata:
      labels:
        name: haproxy
      annotations:
        ad.datadoghq.com/haproxy.check_names: '["haproxy"]'
        ad.datadoghq.com/haproxy.init_configs: '[{}]'
        ad.datadoghq.com/haproxy.instances: |
          [
            {
              "openmetrics_endpoint": "http://%%host%%:<PORT>/metrics", "use_openmetrics": "true"
            }
          ]          
    spec:
      containers:
        - name: haproxy

호스트

호스트에서 실행 중인 에이전트에 대해 이 점검을 구성하려면,

메트릭에이전트의 설정 디렉토리 루트의 conf.d/ 폴더에 있는 haproxy.d/conf.yaml 파일을 편집하여 HAProxy 메트릭 및 로그 수집을 시작합니다. 사용 가능한 모든 설정 옵션은 haproxy.d/conf.yaml 샘플을 참조하세요.

메트릭 수집

1. haproxy.d/conf.yaml 파일에 설정 블록을 추가하여 HAProxy 메트릭 수집을 시작하세요.

   init_config:
   
   instances:
     ## @param url - string - required
     ## Haproxy URL to connect to gather metrics.
     ## Set the according <USERNAME> and <PASSWORD> or use directly a unix stats
     ## or admin socket: unix:///var/run/haproxy.sock
     #
     - url: http://localhost/admin?stats
   

2. 에이전트를 재시작하세요.

로그 수집

기본적으로 Haproxy는 UDP를 통해 포트 514로 로그를 전송합니다. 에이전트는 이 포트에서 로그를 수신할 수 있지만 1024 미만의 포트 번호에 바인딩하려면 더 높은 권한이 필요합니다. 아래 지침에 따라 설정하세요. 또는 다른 포트를 사용하고 3단계를 건너뛸 수 있습니다.

1. Datadog 에이전트에서 로그 수집은 기본적으로 사용하지 않도록 설정되어 있습니다. datadog.yaml 파일에서 로그 수집을 사용하도록 설정합니다.

   logs_enabled: true
   

2. haproxy.d/conf.yaml 파일에 설정 블록을 추가하여 Haproxy 로그 수집을 시작하세요.

   logs:
     - type: udp
       port: 514
       service: <SERVICE_NAME>
       source: haproxy
   

   service 파라미터 값을 변경하고 환경에 맞춰 설정을 변경합니다. 사용 가능한 모든 설정 옵션은 haproxy.d/conf.yaml 샘플을 참조하세요.

3. setcap 명령을 사용하여 포트 514에 대한 액세스 권한을 부여합니다.

   sudo setcap CAP_NET_BIND_SERVICE=+ep /opt/datadog-agent/bin/agent/agent
   

   getcap 명령을 실행하여 설정이 올바른지 확인합니다.

   sudo getcap /opt/datadog-agent/bin/agent/agent
   

   예상 결과:

   /opt/datadog-agent/bin/agent/agent = cap_net_bind_service+ep
   

   참고: 에이전트를 업그레이드할 때마다 이 setcap 명령을 다시 실행합니다.

4. 에이전트를 재시작하세요.

도커(Docker)

컨테이너에서 실행 중인 에이전트에 이 점검을 구성하는 방법:

메트릭 수집

애플리케이션 컨테이너에 자동탐지 통합 템플릿을 Docker 레이블로 설정하세요.

LABEL "com.datadoghq.ad.check_names"='["haproxy"]'
LABEL "com.datadoghq.ad.init_configs"='[{}]'
LABEL "com.datadoghq.ad.instances"='[{"url": "https://%%host%%/admin?stats"}]''

로그 수집

기본적으로 로그 수집은 Datadog 에이전트에서 비활성화되어 있습니다. 활성화하려면 Docker 로그 수집을 참고하세요.

그런 다음 Docker 레이블로 로그 통합을 설정하세요.

LABEL "com.datadoghq.ad.logs"='[{"source":"haproxy","service":"<SERVICE_NAME>"}]'

쿠버네티스(Kubernetes)

쿠버네티스에서 실행 중인 에이전트에 이 점검을 구성하는 방법:

메트릭 수집

자동탐지 통합 템플릿을 애플리케이션 컨테이너의 포드 주석으로 설정합니다. 이외 템플릿은 또한 파일, configmap, key-value store로 설정할 수 있습니다.

주석 v1(Datadog 에이전트 v7.36 이전)

apiVersion: v1
kind: Pod
metadata:
  name: haproxy
  annotations:
    ad.datadoghq.com/haproxy.check_names: '["haproxy"]'
    ad.datadoghq.com/haproxy.init_configs: '[{}]'
    ad.datadoghq.com/haproxy.instances: |
      [
        {
          "url": "https://%%host%%/admin?stats"
        }
      ]      
spec:
  containers:
    - name: haproxy

주석 v2(Datadog 에이전트 v7.36 이상)

apiVersion: v1
kind: Pod
metadata:
  name: haproxy
  annotations:
    ad.datadoghq.com/haproxy.checks: |
      {
        "haproxy": {
          "init_config": {},
          "instances": [
            {
              "url": "https://%%host%%/admin?stats"
            }
          ]
        }
      }      
spec:
  containers:
    - name: haproxy

로그 수집

에이전트 버전 6.0 이상에서 사용 가능

Datadog 에이전트에서 기본적으로 로그 수집이 비활성화되어 있습니다. 활성화하려면 [쿠버네티스 로그 수집]을 확인하세요.

그런 다음 로그 통합을 포드 주석으로 설정합니다. 또한 파일, configmap, 또는 key-value store로 설정할 수 있습니다.

주석 v1/v2

apiVersion: v1
kind: Pod
metadata:
  name: haproxy
  annotations:
    ad.datadoghq.com/haproxy.logs: '[{"source":"haproxy","service":"<SERVICE_NAME>"}]'
spec:
  containers:
    - name: haproxy

ECS

ECS에서 실행 중인 에이전트에 이 점검을 구성하는 방법:

메트릭 수집

애플리케이션 컨테이너에 자동탐지 통합 템플릿을 Docker 레이블로 설정하세요.

{
  "containerDefinitions": [{
    "name": "haproxy",
    "image": "haproxy:latest",
    "dockerLabels": {
      "com.datadoghq.ad.check_names": "[\"haproxy\"]",
      "com.datadoghq.ad.init_configs": "[{}]",
      "com.datadoghq.ad.instances": "[{\"url\": \"https://%%host%%/admin?stats\"}]"
    }
  }]
}

로그 수집

에이전트 버전 6.0 이상에서 사용 가능

기본적으로 로그 수집은 Datadog 에이전트에서 비활성화되어 있습니다. 활성화하려면 ECS 로그 수집을 참조하세요.

그런 다음 Docker 레이블로 로그 통합을 설정하세요.

{
  "containerDefinitions": [{
    "name": "haproxy",
    "image": "haproxy:latest",
    "dockerLabels": {
      "com.datadoghq.ad.logs": "[{\"source\":\"haproxy\",\"service\":\"<SERVICE_NAME>\"}]"
    }
  }]
}