프로메테우스 메트릭을 데이터독 메트릭에 매핑하기

개요

이 페이지는 Prometheus 또는 OpenMetrics 점검 메트릭이 기존 Datadog 메트릭 유형에 매핑되는 방식을 소개합니다.

Prometheus 및 OpenMetrics 메트릭 유형

  • counter: 단조롭게 증가하는 단일 카운터로 표시되는 누적 메트릭. 값은 증가하거나 0으로 재설정됩니다.
  • gauge: 임의로 증가하거나 감소할 수 있는 단일 숫자 값을 나타내는 메트릭.
  • histogram: 관찰 결과를 샘플링하고 구성 가능한 버킷에서 계산하며 관찰된 모든 값의 합계도 제공합니다.
  • summary: histogram과 유사하게 관찰값을 샘플링하고, 관찰된 모든 값의 합계를 제공하며 슬라이딩 시간 창에 걸쳐 구성 가능한 양을 계산합니다.

Prometheus/OpenMetrics 메트릭이 Datadog 메트릭에 매핑되는 방식

자세한 내용은 OpenMetrics 메트릭 유형Datadog 메트릭 유형을 참조하세요.

메트릭 종류OpenMetricsDatadog
countercountercount
gaugegaugegauge
histogram_count, _sum, _bucket_count, _sum 히스토그램의 _bucket값은 Datadog의 count 유형에 매핑되며, 각각 .count, .sum, .bucket이라는 접미사가 포함됩니다.
summary_count, _sum, _created_count_sum 값은 Datadog의 count 유형에 매핑되며 각각 .count, .sum이라는 접미사가 이름에 포함됩니다. 분위수 샘플은 .quantile 접미사가 포함된 gauge 유형의 메트릭에 매핑됩니다.

Histogram

Prometheus/OpenMetrics histogram의 경우 히스토그램의 _count, _sum, _bucket 값은 각각 Datadog의 count 유형에 매핑되며 이름에 .count, .sum, .bucket이라는 접미사가 이름에 포함됩니다.

histogram_buckets_as_distributions 파라미터가 true_bucket 샘플은 Datadog distribution으로 집계됩니다. Datadog 분포 메트릭DDSketch 알고리즘을 기반으로 하며 분위수와 같은 보다 고급 통계 집계를 허용합니다. 자세한 내용은 Datadog 엔지니어링 블로그 OpenMetrics 및 분포 메트릭에 대한 게시물을 참조하세요.

collect_counters_with_distributions를 사용하면 _count_sum의 값을 분포와 함께 count로 보낼 수 있습니다.

요약

Prometheus/OpenMetrics summary의 경우 _count_sum 값은 Datadog의 count 유형에 매핑되고 각각 이름에 .count.sum 접미사가 포함됩니다. 분위수 샘플은 .quantile 접미사가 있는 gauge 유형의 메트릭에 매핑됩니다.

Counter

기본적으로 Prometheus/OpenMetrics counter는 Datadog의 count에 매핑됩니다.

그러나 send_monotonic_counter 파라미터가 false인 경우, 이 메트릭은 gauge로 전송됩니다.

게이지

Prometheus/OpenMetrics gauge는 Datadog의 gauge에 매핑됩니다.

Histogram

Prometheus/OpenMetrics histogram의 경우 히스토그램의 _count_sum 값은 각각 Datadog의 gauge 유형에 매핑되고 이름에 .count.sum 접미사가 포함됩니다.

send_histograms_buckets 파라미터가 true인 경우 _bucket 샘플은 .bucket이라는 접미사와 함께 Datadog에 전송되며, 기본적으로 Datadog의 gauge에 매핑됩니다.

send_distribution_counts_as_monotonic 파라미터를 true로 설정하면 _count_bucket 메트릭이 대신 count 유형으로 전송됩니다. send_distribution_sums_as_monotonic을 설정하면 _sum 메트릭에 대해 동일하게 적용됩니다.

send_distribution_buckets 파라미터가 true_bucket 샘플은 Datadog distribution으로 집계됩니다. Datadog 분포 메트릭DDSketch 알고리즘을 기반으로 하며 분위수와 같은 보다 고급 통계 집계를 허용합니다. 자세한 내용은 Datadog 엔지니어링 블로그 OpenMetrics 및 분포 메트릭에 대한 게시물를 참조하세요.

요약

Prometheus/OpenMetrics summary의 경우 _count_sum 값은 기본적으로 Datadog의 gauge 유형에 매핑되고 각각 이름에 .count.sum 접미사가 포함됩니다. 분위수 샘플은 .quantile 접미사가 있는 gauge 유형의 메트릭에 매핑됩니다.

send_distribution_counts_as_monotonic 파라미터를 true로 설정하면 _count_sum 메트릭은 대신 count 유형으로 전송됩니다. send_distribution_sums_as_monotonic을 설정하면 _sum 메트릭에 대해 동일하게 적용됩니다.

모든 count 메트릭은 Agent에 의해 monotonic counts로 처리되며, 이는 Agent가 실제로 연속적인 원시 값 간의 차이를 전송한다는 것을 의미합니다. 자세한 내용은 메트릭 제출: 커스텀 Agent 점검에서 확인하세요.

참고 자료