호스트

메트릭 수집

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

1. HAProxy 메트릭 수집을 시작하려면 Agent 구성 디렉터리 루트에서 conf.d/ 폴더에 있는 haproxy.d/conf.yaml 파일을 편집합니다. 사용 가능한 모든 구성 옵션은 샘플 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
   

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

2. Agent를 다시 시작합니다.

컨테이너화된 환경

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

메트릭 수집

쿠버네티스(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

호스트

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

HAProxy 메트릭 및 로그 수집을 시작하려면 Agent 설정 디렉터리 루트에 있는 conf.d/ 폴더에서 haproxy.d/conf.yaml 파일을 편집합니다. 모든 가용 설정 옵션을 보려면 샘플 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. Agent를 다시 시작합니다.

로그 수집

기본적으로 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
   

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

4. Agent를 다시 시작합니다.

도커(Docker)

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

메트릭 수집

애플리케이션 컨테이너에서 Autodiscovery 통합 템플릿을 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 Agent에서는 로그 수집 기능이 기본적으로 비활성화되어 있습니다. 활성화하려면 Docker 로그 수집을 참고하세요.

그런 다음 로그 통합을 Docker 레이블로 설정합니다.

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

Kubernetes

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

메트릭 수집

애플리케이션 컨테이너에서 Autodiscovery 통합 템플릿을 포드 어노테이션으로 설정합니다. 이 외에도 파일, 구성 맵 또는 키-값 저장소를 사용하여 템플릿을 구성할 수도 있습니다.

주석 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 Agent에서는 로그 수집 기능이 기본적으로 비활성화되어 있습니다. 활성화하려면 Kubernetes 로그 수집을 참고하세요.

그런 다음 로그 통합을 포드 어노테이션으로 설정합니다. 파일, 구성 맵 또는 키-값 저장소를 사용하여 구성할 수도 있습니다.

주석 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에서 실행 중인 에이전트에 이 점검을 구성하는 방법:

메트릭 수집

애플리케이션 컨테이너에서 Autodiscovery 통합 템플릿을 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 Datadog Agent에서는 로그 수집 기능이 기본적으로 비활성화되어 있습니다. 활성화하려면 ECS 로그 수집을 참고하세요.

그런 다음 로그 통합을 Docker 레이블로 설정합니다.

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