OpenTelemetry 차원 지표 데이터 모델, 지표 인덱스 데이터 기록을 위한 API , 지표 데이터 집계 및 내보내기를 위한 SDK를 제공합니다.
이 페이지에서는 뉴렐릭이 OpenTelemetry 뉴렐릭 OTLP 엔드포인트를 통해 수신한 지표를 처리하는 방법을 설명합니다. 다음 페이지를 참조하세요.
- 엔드포인트 설정 요구 사항은 뉴렐릭 OTLP 엔드포인트를 참조하세요.
- OpenTelemetry를 사용하여 서비스를 구성하는 방법에 대한 자세한 내용은 OpenTelemetry APM 모니터링을 참조하세요.
지표 유형 매핑에 대한 종류
OpenTelemetry 지표 API 여러 가지 소비하다 종류를 정의합니다. OTLP를 통해 특정 지표 유형으로 집계되고 내보내지는 로그화된 기록 측정값입니다. 아래 표에서는 각 OpenTelemetry 가 집계하고 내보내는 방식에 대한 기본 동작을 설명합니다. 뉴렐릭에서 각 지표 유형이 처리되는 방식에 대한 자세한 내용은 OTLP 지표 매핑을 참조하세요.
종류 | 사용 예 | 기본 집계 | 내보낸 지표 유형 |
|---|---|---|---|
처리된 바이트 |
| ||
총 프로세스 CPU 시간 관찰 |
| ||
대기열의 항목 |
| ||
현재 메모리 사용량 관찰 |
| ||
http 요청 기간 |
| ||
CPU 팬 속도에 대한 이벤트 변경 | |||
현재 실내 온도를 관찰하세요 |
올바른 리소스화 유형 선택에 대한 자세한 내용은 OpenTelemetry 지표 보충 지침을 참조하세요.
[1] 히스토그램 분량은 지수적으로 집계될 수도 있습니다. 자세한 내용은 OTLP 히스토그램 지표를 참조하세요.
OTLP 측정 매핑
뉴렐릭은 OTLP 지수를 Metric 데이터 유형 에 매핑합니다. 아래 표는 Indicator proto 메시지 의 필드가 해석되는 방식을 설명합니다. 와 SDK에서 다양한 지표 유형이 어떻게 생성되는지에 대한 자세한 내용은 지표 유형을 참조하세요. OpenTelemetry API
OTLP 지표 프로토 필드 | 뉴렐릭 |
|---|---|
| 각 핵심 가치는 |
|
|
|
|
| 각 핵심 가치는 |
|
|
|
|
|
|
|
|
|
|
| 각 핵심 가치는 |
| 뉴렐릭 |
| 뉴렐릭 |
| 뉴렐릭 |
| 뉴렐릭 |
| 뉴렐릭 |
[1]: 리소스 속성, 범위 속성, 메트릭 포인트 속성 및 최상위 메트릭 필드에 충돌이 있는 경우 선례 순서(가장 높은 것에서 가장 낮은 것까지)는 최상위 Metric.* 필드 > Metric.*.data_points.attributes > ScopeMetrics.InstrumentationScope.attributes 입니다. > ResourceMetrics.Resource.attributes.
뉴웰릭 OTLP 엔드포인트 지원 속성 유형에 대한 자세한 내용은 OTLP 속성 유형을 참조하세요.
OTLP 합계 지표
OTLP 합계 지표는 시간에 따른 측정값의 합계를 나타냅니다. 합계에는 값이 단조롭게 증가하는지(즉, 올라갈 수만 있음) 또는 그렇지 않은지(즉, 올라가거나 내려갈 수 있음) 여부를 나타내는 aggregation_temporality 필드와 is_monotonic 필드가 포함됩니다. 다음 표에서는 뉴렐릭이 다양한 합계 종류를 처리하는 방법을 설명합니다.
|
| 행동 |
|---|---|---|
|
| 뉴렐릭 |
|
| 뉴렐릭 |
|
| 뉴렐릭 |
|
| 데이터가 의미가 없으므로 지원되지 않습니다. 자세한 내용은 이 토론을 참조하세요. |
OTLP 히스토그램 지표
OTLP 히스토그램 메트릭 및 지수 히스토그램 메트릭은 측정값의 분포를 설명하는 합계, 개수, 최소값, 최대값 및 버킷과 같은 정보로 측정값 모집단을 요약합니다. 다양한 히스토그램(명시적 버킷 히스토그램이라고도 함)에는 명시적인 경계가 있는 버킷이 있습니다. 지수 다양성에는 지수 공식으로 설명되는 경계가 있는 버킷이 있습니다. 두 종류 모두 집계 시간성 필드를 포함합니다.
히스토그램의 두 종류 모두 뉴렐릭 distribution 으로 변환되며, 이는 내부 베이스 2 지수 히스토그램 표현으로 뒷받침됩니다. 이 표현은 OpenTelemetry 지수 히스토그램 형식을 밀접하게 반영합니다. 이러한 이유로 뉴웰릭은 지수 히스토그램을 선호합니다( 지수 미스토그램 집계를 참조하여 지수 미스토그램을 선호하도록 OTLP를 구성하는 방법에 대한 자세한 내용을 참조하세요). OpenTelemetry의 명시적 버킷 히스토그램 다양성은 선형 보간법을 사용하여 지수 표현으로 변환됩니다. 자세한 설명은 NrSketch를 참조하세요.
음수 및 양수 무한대의 경계가 있는 버킷은 뉴렐릭에서 너비가 0인 버킷으로 표시됩니다. 예를 들어 경계가 [-∞, 10) 인 OpenTelemetry 버킷은 뉴렐릭에서 [10, 10)로 표시됩니다. 결과적으로 배포가 끝날 때 버킷 수가 과장된 것을 볼 수 있습니다.
OTLP 요약 지표
OTLP 요약 지표는 합계와 개수를 포함하여 측정값의 모집단을 요약한다는 점에서 히스토그램과 유사합니다. 그러나 히스토그램에 측정값의 분포를 설명하는 버킷이 포함된 반면, 요약에는 분위수가 포함됩니다. 이러한 분위수는 공간적 또는 시간적 재집계를 겪을 수 없기 때문에 제한적인 용도가 있습니다. OpenTelemetry 에 포함된 비공개 지원에 대한 요약, OpenTelemetry API 및 SDK는 요약을 생성하지 않습니다.
요약은 뉴엘릭 summary 으로 번역됩니다. 뉴렐릭 요약 유형은 분위수를 지원하지 않습니다.
중요
요약은 수집되어 summary 으로 변환되지만 제대로 지원되지 않습니다. 뉴렐릭은 요약이 마지막 측정 이후의 델타를 나타낸다고 가정하지만 실제로는 누적 지표입니다( 집계 시간성 참조). 요약은 누적 메트릭 시스템인 Prometheus에서 가장 일반적으로 생성됩니다. 따라서 뉴렐릭은 현재 가장 일반적인 사용 사례를 지원하지 않습니다. 따라서 요약 메트릭에 대해 예상치 못한 동작이 발생하고 수집 실패도 포함됩니다.
집계 시간성
집계 시간성에 대한 OpenTelemetry 개념은 특정 지표 데이터 포인트가 누적 측정 세트(일반적으로 시작 이후)를 집계하는지 아니면 마지막 내보내기 이후 측정의 델타 세트를 집계하는지 정의합니다. OTLP 합계 지표 및 히스토그램 지표 에는 해당 포인트의 의미를 설명하는 aggregation_temporality 필드가 있습니다.
누적 및 델타 시간성 지수를 모두 허용하지만 뉴 크롤릭은 일반적으로 델타 지수 시스템이므로 사용자가 델타 시간성을 선호하도록 OTLP 내보내기 프로그램을 구성하는 것이 좋습니다.
시간성이 누적되는 경우 지수는 델타 표현으로 변환됩니다( cumulativeCount 에 대해 누적 값이 유지됨). 상태 저장 변환을 사용하는 것은 동일한 계열의 두 연속 누적 누적 지점에서 델타를 컴퓨트하는 상태 저장 프로세스입니다. Metric.*.data_points.start_time_unix_nano 은 시리즈 재설정을 감지하는 데 사용됩니다.
예시 지원
OpenTelemetry 지표 예시는 현재 뉴렐릭에서 지원되지 않습니다.