개요

Datadog Agent는 DogStatsD를 사용하여 Druid로부터 메트릭을 수집합니다. DogStatsD는 Druid 쿼리, 수집 및 조정 데이터에 대한 메트릭을 수집합니다. 자세한 내용은 Druid 메트릭 문서를 참조하세요.

메트릭을 수집하는 것 외에 Agent는 Druid의 상태와 관련된 Service Check도 보냅니다.

설정

사전 요구 사항

이 통합이 제대로 작동하려면 Druid 0.16 이상이 필요합니다.

설치

Druid 통합이 제대로 작동하려면 아래 두 단계가 모두 필요합니다. 시작하기 전에 Datadog Agent를 설치해야 합니다.

1단계: 상태 메트릭 및 서비스 점검을 수집하도록 Druid 구성

Datadog Agent 패키지에 포함된 Druid 검사를 구성하여 상태 메트릭 및 서비스 점검을 수집합니다.

1. Druid 서비스 점검 수집을 시작하려면 Agent 구성 디렉터리 루트에 있는 conf.d/ 폴더에서 druid.d/conf.yaml 파일을 편집합니다. 사용 가능한 모든 구성 옵션은 샘플 druid.d/conf.yaml을 참조하세요.
2. Agent를 다시 시작합니다.

2단계: 확장 프로그램 statsd-emitter을 사용하여 메트릭 수집을 위해 Druid를 DogStatsD(Datadog Agent에 포함됨)에 연결합니다.

대부분의 Druid 메트릭을 수집하도록 확장 프로그램 statsd-emitter을 구성하는 단계입니다.

1. Druid 확장 프로그램 statsd-emitter을 설치합니다.

   $ java \
     -cp "lib/*" \
     -Ddruid.extensions.directory="./extensions" \
     -Ddruid.extensions.hadoopDependenciesDir="hadoop-dependencies" \
     org.apache.druid.cli.Main tools pull-deps \
     --no-default-hadoop \
     -c "org.apache.druid.extensions.contrib:statsd-emitter:0.15.0-incubating"
   

   이 단계에 대한 자세한 내용은 Druid 확장 프로그램 로드에 대한 공식 가이드에서 확인할 수 있습니다.

2. 다음 구성을 추가하여 Druid Java 속성을 업데이트합니다.

   # Add `statsd-emitter` to the extensions list to be loaded
   druid.extensions.loadList=[..., "statsd-emitter"]
   
   # By default druid emission period is 1 minute (PT1M).
   # We recommend using 15 seconds instead:
   druid.monitoring.emissionPeriod=PT15S
   
   # Use `statsd-emitter` extension as metric emitter
   druid.emitter=statsd
   
   # Configure `statsd-emitter` endpoint
   druid.emitter.statsd.hostname=127.0.0.1
   druid.emitter.statsd.port:8125
   
   # Configure `statsd-emitter` to use dogstatsd format. Must be set to true, otherwise tags are not reported correctly to Datadog.
   druid.emitter.statsd.dogstatsd=true
   druid.emitter.statsd.dogstatsdServiceAsTag=true
   

3. Druid를 다시 시작하여 DogStatsD를 통해 Druid 메트릭을 Agent로 전송합니다.

통합 서비스 점검

druid.d/conf.yaml 파일의 기본 구성을 사용하여 Druid 서비스 점검 수집을 활성화합니다. 사용 가능한 모든 구성 옵션은 샘플 druid.d/conf.yaml을 참조하세요.

로그 수집

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

1. 로그 수집은 Datadog Agent에서 기본적으로 비활성화되어 있습니다. datadog.yaml 파일에서 활성화하세요.

   logs_enabled: true
   

2. druid.d/conf.yaml의 하단에서 이 구성 블록의 주석 처리를 제거하고 편집합니다.

   logs:
     - type: file
       path: '<PATH_TO_DRUID_DIR>/var/sv/*.log'
       source: druid
       service: '<SERVICE_NAME>'
       log_processing_rules:
         - type: multi_line
           name: new_log_start_with_date
           pattern: \d{4}\-\d{2}\-\d{2}
   

   path 및 service 파라미터 값을 변경하고 환경에 맞게 설정합니다.

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

검증

Agent의 상태 하위 명령을 실행하고 Checks 섹션에서 druid를 찾으세요.

수집한 데이터

메트릭

이벤트

Druid 점검은 이벤트를 포함하지 않습니다.

서비스 점검

druid.service.can_connect
Returns CRITICAL if the check cannot connect to Druid service. Returns OK otherwise.
Statuses: ok, critical

druid.service.health
Returns CRITICAL if Druid service is not healthy. Returns OK otherwise.
Statuses: ok, critical

트러블슈팅

도움이 필요하세요? Datadog 지원팀에 문의하세요.