뉴렐릭의 OpenTelemetry 지표

OpenTelemetry 차원 지표 데이터 모델, 지표 인덱스 데이터 기록을 위한 API , 지표 데이터 집계 및 내보내기를 위한 SDK를 제공합니다.

이 페이지에서는 뉴렐릭이 OpenTelemetry 뉴렐릭 OTLP 엔드포인트 를 통해 수신한 지표를 처리하는 방법을 설명합니다. OpenTelemetry 지표를 뉴렐릭과 통합하려면 이 엔드포인트로 내보낼 지표 소스를 구성해야 합니다. 엔드포인트 설정 요구 사항을 검토하세요. OpenTelemetry 지표를 사용하여 서비스를 구성하는 방법에 대한 자세한 내용은 OpenTelemetry APM 모델링을 참조하세요.

지표 유형 매핑에 대한 종류

OpenTelemetry 지표 API 여러 가지 소비하다 종류를 정의합니다. OTLP를 통해 특정 지표 유형으로 집계되고 내보내지는 로그화된 기록 측정값입니다. 아래 표에서는 각 OpenTelemetry 가 집계하고 내보내는 방식에 대한 기본 동작을 설명합니다. 뉴렐릭에서 각 지표 유형이 처리되는 방식에 대한 자세한 내용은 OTLP 지표 매핑을 참조하세요.

종류	사용 예	기본 집계	내보낸 지표 유형
`Counter`	처리된 바이트	합집합	`Sum` 지표, `is_monotonic=true`
비동기 카운터	총 프로세스 CPU 시간 관찰	합집합	`Sum` 지표, `is_monotonic=true`
`UpDownCounter`	대기열의 항목	합집합	`Sum` 지표, `is_monotonic=false`
비동기 UpDown카운터	현재 메모리 사용량 관찰	합집합	`Sum` 지표, `is_monotonic=false`
`Histogram`	http 요청 기간	명시적 버킷 히스토그램	`Histogram` 지표 [1]
`Gauge`	CPU 팬 속도에 대한 이벤트 변경	마지막 값	`Gauge` 미터법
비동기 게이지	현재 실내 온도를 관찰하세요	마지막 값	`Gauge` 미터법

올바른 리소스화 유형 선택에 대한 자세한 내용은 OpenTelemetry 지표 보충 지침을 참조하세요.

[1] 히스토그램 분량은 지수적으로 집계될 수도 있습니다. 자세한 내용은 OTLP 히스토그램 지표를 참조하세요.

OTLP 측정 매핑

뉴렐릭은 OTLP 지표를 Metric 데이터 유형 에 매핑합니다. 아래 표에서는 지표 proto 메시지 의 필드가 해석되는 방식을 설명합니다. /SDK에서 다양한 지표 유형을 생성하는 방법에 대한 자세한 내용은 지표 유형에 대한 리치를 참조 하세요.OpenTelemetry API

OTLP 지표 프로토 필드	뉴렐릭 `Metric` 필드
`ResourceMetrics.Resource.attributes`	각 핵심 가치는 `Metric`[1]의 속성입니다.
`ScopeMetrics.InstrumentationScope.name`	`otel.library.name`
`ScopeMetrics.InstrumentationScope.version`	`otel.library.version`
`ScopeMetrics.InstrumentationScope.attributes`	각 핵심 가치는 `Metric`[1]의 속성입니다.
`Metric.name`	`metricName`
`Metric.description`	`description`
`Metric.unit`	`unit`
`Metric.*.data_points.start_time_unix_nano`	`timestamp`
`Metric.*.data_points.time_unix_nano`	`endTimestamp`
`Metric.*.data_points.attributes`	각 핵심 가치는 `Metric`[1]의 속성입니다.
`Metric.gauge.data_points`	뉴렐릭 `gauge`에 대한 지도
`Metric.sum.data_points`	뉴렐릭 `count`, `cumulativeCount` 또는 `gauge`에 매핑됩니다. OTLP 합계 지표보기
`Metric.histogram.data_points`	뉴렐릭 `distribution`에 대한 지도 OTLP 히스토그램 지표보기
`Metric.exponential_histogram.data_points`	뉴렐릭 `distribution`에 대한 지도 OTLP 히스토그램 지표보기
`Metric.summary.data_points`	뉴렐릭 `summary`에 대한 지도 OTLP 요약 지표보기

[1]: 리소스 속성, 범위 속성, 메트릭 포인트 속성 및 최상위 메트릭 필드에 충돌이 있는 경우 선례 순서(가장 높은 것에서 가장 낮은 것까지)는 최상위 Metric.* 필드 > Metric.*.data_points.attributes > ScopeMetrics.InstrumentationScope.attributes 입니다. > ResourceMetrics.Resource.attributes.

OTLP 합계 지표

OTLP 합계 지표는 시간에 따른 측정값의 합계를 나타냅니다. 합계에는 값이 단조롭게 증가하는지(즉, 올라갈 수만 있음) 또는 그렇지 않은지(즉, 올라가거나 내려갈 수 있음) 여부를 나타내는 aggregation_temporality 필드와 is_monotonic 필드가 포함됩니다. 다음 표에서는 뉴렐릭이 다양한 합계 종류를 처리하는 방법을 설명합니다.

`is_monotonic`	`aggregation_temporality`	행동
`true`	`cumulative`	뉴렐릭 `cumulativeCount`에 대한 지도
`true`	`delta`	뉴렐릭 `count`에 대한 지도
`false`	`cumulative`	뉴렐릭 `gauge`에 대한 지도
`false`	`delta`	데이터가 의미가 없으므로 지원되지 않습니다. 자세한 내용은 이 토론을 참조하세요.

OTLP 히스토그램 지표

OTLP 히스토그램 메트릭 및 지수 히스토그램 메트릭은 측정값의 분포를 설명하는 합계, 개수, 최소값, 최대값 및 버킷과 같은 정보로 측정값 모집단을 요약합니다. 다양한 히스토그램(명시적 버킷 히스토그램이라고도 함)에는 명시적인 경계가 있는 버킷이 있습니다. 지수 다양성에는 지수 공식으로 설명되는 경계가 있는 버킷이 있습니다. 두 종류 모두 집계 시간성 필드를 포함합니다.

히스토그램의 두 종류 모두 뉴렐릭 distribution 으로 변환되며, 이는 내부 베이스 2 지수 히스토그램 표현으로 뒷받침됩니다. 이 표현은 OpenTelemetry 지수 히스토그램 형식을 밀접하게 반영합니다. 이러한 이유로 뉴웰릭은 지수 히스토그램을 선호합니다( 지수 미스토그램 집계를 참조하여 지수 미스토그램을 선호하도록 OTLP를 구성하는 방법에 대한 자세한 내용을 참조하세요). OpenTelemetry의 명시적 버킷 히스토그램 다양성은 선형 보간법을 사용하여 지수 표현으로 변환됩니다. 자세한 설명은 NrSketch를 참조하세요.

음수 및 양수 무한대의 경계가 있는 버킷은 뉴렐릭에서 너비가 0인 버킷으로 표시됩니다. 예를 들어 경계가 [-∞, 10) 인 OpenTelemetry 버킷은 뉴렐릭에서 [10, 10)로 표시됩니다. 결과적으로 배포가 끝날 때 버킷 수가 과장된 것을 볼 수 있습니다.

OTLP 요약 지표

OTLP 요약 메트릭은 합계 및 개수를 포함하여 측정값 모집단을 요약한다는 점에서 히스토그램과 유사합니다. 그러나 히스토그램에 측정값 분포를 설명하는 버킷이 포함되어 있는 경우 요약에는 분위수가 포함됩니다. 이러한 분위수는 공간적 또는 시간적 재집계를 겪을 수 없기 때문에 사용이 제한됩니다. 구형 지원을 위한 OpenTelemetry 와 OpenTelemetry API 및 SDK에 포함된 요약은 요약을 생성하지 않습니다.

요약은 뉴렐릭 summary 으로 번역됩니다.

집계 시간성

집계 시간성에 대한 OpenTelemetry 개념은 특정 지표 데이터 포인트가 누적 측정 세트(일반적으로 시작 이후)를 집계하는지 아니면 마지막 내보내기 이후 측정의 델타 세트를 집계하는지 정의합니다. OTLP 합계 지표 및 히스토그램 지표 에는 해당 포인트의 의미를 설명하는 aggregation_temporality 필드가 있습니다.

누적 및 델타 시간성 지수를 모두 허용하지만 뉴 크롤릭은 일반적으로 델타 지수 시스템이므로 사용자가 델타 시간성을 선호하도록 OTLP 내보내기 프로그램을 구성하는 것이 좋습니다.

시간성이 누적되는 경우 지수는 델타 표현으로 변환됩니다( cumulativeCount 에 대해 누적 값이 유지됨). 상태 저장 변환을 사용하는 것은 동일한 계열의 두 연속 누적 누적 지점에서 델타를 컴퓨트하는 상태 저장 프로세스입니다. Metric.*.data_points.start_time_unix_nano 은 시리즈 재설정을 감지하는 데 사용됩니다.

예시 지원

OpenTelemetry 지표 예시는 현재 뉴렐릭에서 지원되지 않습니다.

사용자의 편의를 위해 제공되는 기계 번역입니다.