호스트

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

메트릭 수집

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

   init_config:
   
   instances:
     ## @param url - string - required
     ## Where your Consul HTTP server lives,
     ## point the URL at the leader to get metrics about your Consul cluster.
     ## Use HTTPS instead of HTTP if your Consul setup is configured to do so.
     #
     - url: http://localhost:8500
   

2. 에이전트를 재시작합니다.

OpenMetrics

(선택 사항) use_prometheus_endpoint 설정 옵션을 활성화하여 Consul Prometheus 엔드포인트에서 추가 메트릭 세트를 가져올 수 있습니다.

참고: 동일한 인스턴스에 대해 두 가지를 모두 활성화하지 말고 DogStatsD 또는 Prometheus 메서드를 사용하세요.

1. Prometheus 엔드포인트에 메트릭을 노출하도록 Consul을 설정합니다. 기본 Consul 설정 파일의 최상위 telemetry 키에 중첩된 prometheus_retention_time을 설정합니다.

   {
     ...
     "telemetry": {
       "prometheus_retention_time": "360h"
     },
     ...
   }
   

2. Prometheus 엔드포인트 사용을 시작하려면 Agent의 설정 디렉터리 루트에 있는 conf.d/ 폴더에서 consul.d/conf.yaml 파일을 편집합니다.

   instances:
       - url: <EXAMPLE>
         use_prometheus_endpoint: true
   

3. 에이전트를 재시작합니다.

DogStatsD

Prometheus 엔드포인트를 사용하는 대신 DogStatsD를 통해 동일한 추가 메트릭 세트를 Agent에 보내도록 Consul을 설정할 수 있습니다.

1. DogStatsD 메트릭을 보내도록 Consul을 설정하려면 Consul의 기본 설정 파일에서 최상위 telemetry 키 아래에 중첩된 dogstatsd_addr을 추가합니다.

   {
     ...
     "telemetry": {
       "dogstatsd_addr": "127.0.0.1:8125"
     },
     ...
   }
   

2. 메트릭에 태그가 올바르게 지정되었는지 확인하려면 다음 설정을 추가하여 Datadog Agent 기본 설정 파일 datadog.yaml을 업데이트합니다.

   # dogstatsd_mapper_cache_size: 1000  # default to 1000
   dogstatsd_mapper_profiles:
     - name: consul
       prefix: "consul."
       mappings:
         - match: 'consul\.http\.([a-zA-Z]+)\.(.*)'
           match_type: "regex"
           name: "consul.http.request"
           tags:
             method: "$1"
             path: "$2"
         - match: 'consul\.raft\.replication\.appendEntries\.logs\.([0-9a-f-]+)'
           match_type: "regex"
           name: "consul.raft.replication.appendEntries.logs"
           tags:
             peer_id: "$1"
         - match: 'consul\.raft\.replication\.appendEntries\.rpc\.([0-9a-f-]+)'
           match_type: "regex"
           name: "consul.raft.replication.appendEntries.rpc"
           tags:
             peer_id: "$1"
         - match: 'consul\.raft\.replication\.heartbeat\.([0-9a-f-]+)'
           match_type: "regex"
           name: "consul.raft.replication.heartbeat"
           tags:
             peer_id: "$1"
   

3. 에이전트를 재시작합니다.

로그 수집

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

1. 로그 수집은 Datadog Agent에서 기본적으로 비활성화되어 있습니다. datadog.yaml에서 다음을 사용하여 활성화합니다.

   logs_enabled: true
   

2. Consul 로그를 수집하려면 consul.yaml 파일에서 이 설정 블록을 편집합니다.

   logs:
     - type: file
       path: /var/log/consul_server.log
       source: consul
       service: myservice
   

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

3. 에이전트를 재시작합니다.

컨테이너화

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

메트릭 수집

로그 수집

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

Datadog 에이전트에서 로그 수집은 기본값으로 비활성화되어 있습니다. 이를 활성화하려면 쿠버네티스(Kubernetes) 로그 수집을 참조하세요.