Datadog 에이전트와 Datadog-개방형메트릭 또는 Datadog-프로메테우스 통합을 사용하여 호스트에서 실행 중인 애플리케이션에서 노출된 프로메테우스 및 개방형 메트릭 메트릭을 수집합니다.

개요

버전 6.5.0부터 프로메테우스 엔드포인트를 스크래핑할 수 있는 개방형 메트릭 및 프로메테우스 점검이 에이전트에 포함되어 있습니다. Datadog은 더 효율적이고 프로메테우스 텍스트 형식을 완벽하게 지원하는 개방형 메트릭 점검을 사용할 것을 권장합니다. 커스텀 점검 작성 등 OpenMetricsCheck 인터페이스의 고급 사용법은 개발자 도구 섹션을 참조하세요. 또한, 메트릭 엔드포인트가 텍스트 형식을 지원하지 않는 경우에만 프로메테우스 점검을 사용하세요.

이 페이지에서는 이러한 검사의 기본 사용법을 설명하며, 이를 통해 Datadog 내에 노출된 모든 프로메테우스 메트릭을 가져올 수 있습니다.

설정

설치

해당 운영체제에 맞는 Datadog Agent를 설치하세요. 개방형메트릭 및 프로메테우스 점검은 Datadog 에이전트 패키지에 포함되어 있으므로 컨테이너나 호스트에 달리 설치할 필요가 없습니다.

설정

노출된 메트릭 수집 방법:

1. 에이전트 설정 디렉터리의 루트에 있는 conf.d/ 폴더의 openmetrics.d/conf.yaml 파일을 편집합니다. 사용 가능한 모든 설정 옵션은 샘플 openmetrics.d/conf.yaml을 참조하세요. 통합을 활성화하는 데 필요한 최소 필수 설정은 다음과 같습니다.

   init_config:
   
   instances:
       - openmetrics_endpoint: 'localhost:<PORT>/<ENDPOINT>'
         namespace: '<NAMESPACE>'
         metrics:
             - '<METRIC_TO_FETCH>': '<DATADOG_METRIC_NAME>'
   

   다음 자리 표시자 설정 값을 사용합니다.

   자리 표시자	설명
   <PORT>	프로메테우스 엔드포인트에 액세스하기 위한 연결 포트입니다.
   <ENDPOINT>	프로메테우스 형식으로, 컨테이너에서 제공되는 메트릭 URL입니다.
   <NAMESPACE>	Datadog에서 확인 시 각 메트릭의 접두어로 사용되는 네임스페이스를 설정합니다.
   <METRIC_TO_FETCH>	프로메테우스 엔드포인트에서 가져온 프로메테우스 메트릭 키입니다.
   <DATADOG_METRIC_NAME>	설정된 경우 Datadog에서 <METRIC_TO_FETCH> 메트릭 키를 <DATADOG_METRIC_NAME>으로 변환하는 선택적 파라미터입니다. 이 옵션을 사용하지 않기로 선택한 경우 key:value 쌍이 아닌 문자열 목록을 전달하세요.

2. 에이전트를 다시 시작하여 메트릭 수집을 시작하세요.

사용 가능한 파라미터

아래에서 instances에 사용할 수 있는 파라미터 전체 목록을 학인하세요.

참고: send_distribution_buckets 및 send_distribution_counts_as_monotonic를 제외한 모든 파라미터는 개방형메트릭 점검과 프로메테우스 점검 모두에서 지원됩니다.

시작하기

단순 메트릭 수집

프로메테우스로 인해 노출된 메트릭 수집을 시작하려면 이러한 단계를 따릅니다.

1. 프로메테우스 시작하기 문서에 따라 자체 모니터링하는 프로메테우스 로컬 버전을 시작하세요.

2. 플랫폼에 맞는 Datadog 에이전트를 설치합니다.

3. 에이전트 설정 디렉토리의 루트에 있는 conf.d/ 폴더에 있는 openmetrics.d/conf.yaml 파일을 다음 내용으로 편집합니다:

   init_config:
   
   instances:
       - openmetrics_endpoint: http://localhost:9090/metrics
         namespace: 'documentation_example'
         metrics:
             - promhttp_metric_handler_requests_total: prometheus.handler.requests.total
   

4. 에이전트를 다시 시작합니다.

5. 메트릭 요약 페이지로 이동하여 수집된 메트릭(prometheus_target_interval_length_seconds*)을 확인합니다.

사용자 지정에서 공식 통합까지

기본적으로 일반 Prometheus 검사에서 검색된 모든 메트릭은 커스텀 메트릭으로 간주됩니다. 기성 소프트웨어에 대한 공식 통합이 필요할 경우 주저하지 마시고 참여해 주세요!

공식 통합 서비스에는 전용 디렉토리가 있습니다. 일반 검사에는 기본 설정 및 메트릭 메타데이터를 하드코딩하기 위한 기본 인스턴스 메커니즘이 있습니다. 예를 들어, kube-proxy 통합을 참조하세요.

참고 자료

추가 유용한 문서, 링크 및 기사:

로그 수집설명서 프로세스 수집설명서 트레이스 수집설명서 자체적인 커스텀 프로메테우스(Prometheus) 점검 작성설명서