OTLP Sum은 시간 창에서 보고된 측정의 합계를 나타냅니다. 예를 들어, Sum을 사용하여 데이터베이스에 대한 총 연결 수 또는 엔드포인트에 대한 총 요청 수를 추적할 수 있습니다. Sum에는 매핑에 영향을 미치는 두 가지 기능이 있습니다:

• 집계 일시성, 누적 또는 델타일 수 있습니다. 델타 메트릭은 시간 창에서 겹치지 않는 반면, 누적 메트릭은 고정된 시작 시점의 시간 창을 나타냅니다.
• 단조성. 단조 합계는 감소하지 않으며 기본 개수에 추가만 지원합니다.

기본 매핑은 다음과 같습니다:

1. 누적 단조 합계의 경우, 연속 포인트 사이의 델타가 계산되어 Datadog에 개수로 보고됩니다. 첫 번째 포인트는 저장되지만 생략됩니다. OTLP 페이로드의 값을 복구하려면 cumsum 산술 함수를 사용하세요.
2. 누적 비단조 합계는 Datadog 게이지로 내보내집니다.
3. 델타 합계는 Datadog 개수로 내보내집니다.

OTLP 게이지는 주어진 시간에 샘플링된 값을 나타냅니다. 지정된 시간 창의 마지막 값만 OTLP 메트릭에 포함됩니다.

OTLP 게이지는 집계 시맨틱을 제공하지 않기 때문에, Datadog 게이지에 매핑됩니다. 정수 및 부동 소수 게이지 데이터 포인트는 모두 Datadog 형식의 부동 소숫점 숫자로 매핑됩니다.

OTLP 히스토그램은 일련의 버킷 수와 함께 모집단 합계 또는 개수와 같은 특정 집계 메트릭을 저장하여, 지정된 시간 창에서 값 집합의 통계적 분포를 나타냅니다. 히스토그램에는 매핑에 영향을 미치는 한 가지 기능이 있습니다:

• 집계 일시성, 누적 또는 델타일 수 있습니다. 델타 메트릭은 시간 창에서 겹치지 않는 반면, 누적 메트릭은 고정된 시작 시점의 시간 창을 나타냅니다.

기본 매핑은 다음과 같습니다:

1. 델타 히스토그램은 Datadog 분포로 보고됩니다. 분포에 대해 자세히 알아보기에서 사용 가능한 집계에 대해 더 알아보세요. 카운트가 0인 히스토그램은 삭제됩니다.
2. 누적 히스토그램의 경우, 연속 포인트 사이의 델타가 계산되어 분포로 Datadog에 보고됩니다. 카운트가 0인 델타는 보고되지 않습니다. 개별 집계에서 cumsum 산술 함수를 사용하여 OTLP 페이로드의 값을 복구할 수 있습니다.

참고: OTLP의 히스토그램 메트릭은 분포 메트릭에 기본으로 매핑됩니다. OTLP가 이 데이터를 전송하는 방식 때문에 최대, 최소(기존 OTLP 데이터에서 사용 불가한 경우) 및 백분위수 집계는 정확한 계산값이 아닌 근사치입니다.

Datadog 에이전트 및 OpenTelemetry 컬렉터 Datadog 내보내기를 사용하면 histogram 하위 섹션에서 히스토그램 내보내기를 변경할 수 있습니다.

• mode가 counters로 설정된 경,우 다음 메트릭이 생성됩니다:

lower_bound와 upper_bound가 태그한 <METRIC_NAME>.bucket

지정된 하한 및 상한이 있는 버킷에 대한 시간 창의 버킷 수입니다.
Datadog 인앱 유형: COUNT

• send_aggregation_metrics 플래그가 활성화되어 있는 경우, 다음 메트릭이 생성됩니다:

<METRIC_NAME>.sum

시간 창의 시간 동안 제출된 값의 합계입니다.
Datadog 인앱 유형: COUNT

<METRIC_NAME>.count

시간 창의 시간 동안 제출된 값의 수입니다.
Datadog 인앱 유형: COUNT

<METRIC_NAME>.min

시간 창의 시간 동안 제출된 최소 값입니다. 델타 OTLP 히스토그램에만 사용할 수 있습니다. 사용 가능 버전: Datadog 내보내기 v0.75.0 및 Datadog 에이전트 v6.45.0 및 v7.45.0.
Datadog 인앱 유형: GAUGE

<METRIC_NAME>.max

시간 창의 시간 동안 제출된 값의 최대값입니다. 델타 OTLP 히스토그램에만 사용할 수 있습니다. 사용 가능 버전: Datadog 내보내기 v0.75.0 및 Datadog 에이전트 v6.45.0 및 v7.45.0.
Datadog 인앱 유형: GAUGE

참고: send_aggregation_metrics는 분포 모드를 사용하지 않는 경우에만 유용합니다. Datadog 내보내기 v0.75.0, Datadog 에이전트 v6.45.0, v7.45.0 이전 버전의 경우 send_count_sum_metrics를 사용합니다.

OTLP 요약은 일정 기간의 모집단 변위치 정보를 전달하는 레거시 유형입니다. OTLP 요약 유형은 OpenTelemetry SDK에서 생성되지 않지만 이전 버전과의 호환성을 위해 다른 구성 요소에서 생성될 수 있습니다.

<METRIC_NAME>.sum

애플리케이션이 메트릭 생성을 시작한 이후 값의 합계입니다.
Datadog 인앱 유형: COUNT

<METRIC_NAME>.count

모집단의 값 수.
Datadog 인앱 유형: COUNT

quantile가 태그한 <METRIC_NAME>.quantile

주어진 변위치의 값입니다.
Datadog 인앱 유형: GAUGE

기본적으로 누적 단조 합계 유형의 메트릭을 내보내는 단일 애플리케이션에서 OpenTelemetry Counter 계측을 사용한다고 가정합니다. 다음 표에는 Datadog 동작이 요약되어 있습니다:

기본적으로 누적 합계 유형의 메트릭을 내보내는 단일 애플리케이션에서 OpenTelemetry UpDownCounter 계측을 사용하고 있다고 가정합니다. 다음 표에는 Datadog 동작이 요약되어 있습니다:

단일 애플리케이션에서 OpenTelemetry 게이지 계측, temperature을 사용하고 있다고 가정합니다. 다음 표에는 Datadog 동작이 요약되어 있습니다:

두 웹 서버: webserver:web_1 및 webserver:web_2에서 OpenTelemetry 히스토그램 계측 request.response_time.histogram을 사용한다고 가정합니다. 지정된 수집 기간에 webserver:web_1는 [1,1,1,2,2,2,3,3] 값이 있는 메트릭을 보고하고, webserver:web_2는 [1,1,2] 값이 있는 동일한 메트릭을 보고한다고 가정합니다. 이 수집 기간 동안, 다음 다섯개의 집계는 두 웹 서버에서 수집된 모든 값의 글로벌 통계 분포를 나타냅니다.

추가 집계를 설정하는 방법을 이해하려면 분포에 대해 자세히 알아보세요.

또는, counters 모드를 사용하는 경우, send_aggregation_metrics 플래그가 활성화되고, 히스토그램 버킷 경계가 [-inf, 2, inf]로 설정되며, 다음 메트릭이 보고됩니다:

하나의 웹 서버에서 레거시 OTLP 요약 메트릭 request.response_time.summary를 제출한다고 가정합니다. 지정된 수집 기간에 웹 서버가 [1,1,1,2,2,2,3,3] 값이 있는 메트릭을 보고한다고 가정합니다. 최소, 최대 및 중앙 분위수가 활성화된 경우, 다음 메트릭이 보고됩니다: