• EnglishEspañol日本語한국어Português
  • 로그인지금 시작하기

이 한글 문서는 사용자의 편의를 위해 기계 번역되었습니다.

영문본과 번역본이 일치하지 않는 경우 영문본이 우선합니다. 보다 자세한 내용은 이 페이지를 방문하시기 바랍니다.

문제 신고

OpenTelemetry 측정항목: 모범 사례

수출 const 연도 = 2023; 수출 const gaDate = '4월 4일'; 내보내기 const gaDateAndYear = gaDate + ', ' + 연도;

OpenTelemetry 메트릭은 New Relic 차원 메트릭과 크게 호환됩니다. OpenTelemetry 메트릭 v0.10을 지원합니다. 지원되는 모든 메트릭 유형에는 쿼리 시 메트릭 데이터를 패싯 또는 필터링하는 데 사용할 수 있는 차원에 직접 매핑되는 독립적인 관련 속성 집합(이름-값 쌍)이 포함됩니다. OpenTelemetry 메트릭은 이를 생성한 원래 엔터티를 식별하고 패싯 및 필터링을 위해 차원에 매핑하는 리소스 속성 집합과 함께 제공됩니다.

메트릭에 대한 OpenTelemetry 데이터 모델 은 합계, 게이지, 히스토그램 및 요약과 같은 다양한 메트릭 유형을 정의합니다.

합계 메트릭

OpenTelemetry 합계는 지정된 기간 동안의 모든 데이터 포인트의 합계인 스칼라 메트릭입니다. 합계에는 보고된 값이 이전 측정을 통합하는지(누적 시간성) 그렇지 않은지(델타 시간성)을 나타내는 시간성 개념이 있습니다.

또한 합계는 단조(상승만 또는 하락만) 또는 비단조(위 및 아래로 이동)일 수 있습니다.

델타 합계

델타 합은 단조인지 비단조인지에 따라 다르게 처리됩니다.

  • 단순 델타 합계는 카운트 메트릭 유형에 매핑됩니다.
  • 비단조 델타 합계는 지원되지 않습니다. 이러한 방식으로 측정된 것들은 사용된 것으로 합산될 가능성이 높기 때문에 의미 있는 데이터를 생성하지 않습니다. 자세한 내용은 이 커뮤니티 풀 요청게이지와 카운터에 대한 문서를 참조하십시오.

누적 합계

누적 합계는 단조인지 비단조인지에 따라 다르게 처리됩니다.

  • 단순하지 않은 누적 합계는 게이지 메트릭 유형에 매핑됩니다.
  • 단조 누적 합계는 cumulativeCount 지표 유형에 매핑됩니다.

합계 구성 예

집계 시간성을 구성하는 방법을 이해하려면 JavaPython OpenTelemetry SDK를 사용하는 다음 예제를 참조하세요.

게이지 측정항목

OpenTelemetry 게이지 메트릭 데이터 포인트는 지정된 시간에 샘플링된 값을 나타냅니다. 이러한 값은 New Relic 게이지 메트릭 유형으로 변환됩니다. OpenTelemetry 게이지에는 집계 시간성이 없지만 샘플링된 값은 쿼리 시간에 집계될 수 있습니다.

히스토그램 측정항목

OpenTelemetry 히스토그램 은 기록된 값의 모집단을 총 개수 및 합계와 함께 간결하게 나타냅니다. 선택적으로 히스토그램에는 명시적 경계와 해당 버킷의 모집단에 대한 개수 값이 있는 일련의 버킷이 포함될 수 있습니다.

모든 OpenTelemetry 히스토그램은 New Relic의 분포 메트릭 유형으로 변환되며 이는 확장된 지수 기반 2 히스토그램으로 뒷받침됩니다(자세한 설명은 NrSketch 참조).

델타 막대 그래프

지수 히스토그램의 경우 NrSketch로 직접 변환할 수 있습니다.

명시적 범위 히스토그램의 경우 OpenTelemetry 히스토그램 버킷의 개수가 선형 보간법을 사용하여 New Relic의 분포 메트릭 버킷에 할당됩니다. 또한 OpenTelemetry에는 New Relic에서 너비가 0인 버킷으로 나타내는 음수 및 양수 무한대 버킷이 있습니다. 음수 및 양수 무한대에 대한 표현이 없기 때문에 이렇게 합니다. 예를 들어 경계가 \[-∞, 10) 인 OpenTelemetry 버킷은 너비가 0인 \[10,10) New Relic 버킷으로 표시됩니다. 이 변환으로 인해 배포 엔드포인트에서 과장된 버킷 수를 볼 수 있습니다.

누적 히스토그램

누적 히스토그램은 델타 히스토그램으로 변환됩니다. 번역 프로세스에 대한 자세한 내용은 누적 메트릭을참조하십시오.

요약 측정항목

OpenTelemetry 요약 메트릭 데이터 포인트는 Quantile 요약(예: P99 대기 시간)을 나타내는 데 사용됩니다. 이들은 New Relic 요약 메트릭 유형에 직접 매핑되지만 우리가 유지하는 유일한 분위수는 최소 및 최대에 대한 0.0 및 1.0 분위수입니다. 백분위수를 캡처하려는 경우 히스토그램 메트릭 을 선호합니다.

요약 메트릭 데이터 포인트에는 개수, 합계 및 분위수 값이 포함되며 최소값은 0.0이고 최대값은 1.0입니다. OpenTelemetry는 다른 형식과의 호환성을 위한 요약 메트릭을 제공합니다.

시작 시간

startTimeUnixNano 필드는 OpenTelemetry 사양 에 따라 선택 사항입니다. 델타 집계 시간성의 경우, 존재하는 경우 결과 New Relic 메트릭의 타임스탬프에 사용되며 durationtimeUnixNano - startTimeUnixNano 로 계산됩니다. duration 필드는 New Relic 메트릭에서 쿼리 가능한 endTimeStamp 속성을 계산하는 데 사용되지만 다른 의미론적 용도는 제공하지 않습니다.

startTimeUnixNano 이 제공되지 않으면 결과 New Relic 메트릭의 타임스탬프 필드에 timeUnixNano 이 사용되고 기간 필드는 0으로 설정됩니다.

누적 집계 시간성의 경우 startTimeUnixNano 시계열의 첫 번째 관찰을 나타내며 재설정을 감지하는 데 사용됩니다. timeUnixNano 은 누적 데이터 포인트의 타임스탬프로 해석됩니다. 그런 다음 누적 데이터 포인트는 델타 집계 시간성으로 변환됩니다.

속성의 배열 값

OpenTelemetry 메트릭 및 기타 신호에는 동종 기본 유형 배열로 구성된 속성이 포함될 수 있습니다. New Relic은 65개 미만의 요소를 포함하는 비중첩 동종 배열을 지원합니다.

본보기

OpenTelemetry는 추적과 같은 다른 신호를 메트릭 이벤트에 연결하고 컨텍스트를 제공할 수 있도록 하는 예시 값을 정의합니다. New Relic은 예제를 지원하지 않습니다.

측정항목을 쿼리하는 방법

New Relic에서 메트릭 NRQL 쿼리를 작성하려면 다음 팁을 고려하십시오.

cumulativeCounts로 저장된 쿼리 누적 합계

다음은 데이터를 쿼리하는 몇 가지 방법입니다.

게이지로 저장된 누적 합계 쿼리

New Relic gaDateAndYear 이전에 누적 합계를 보고한 고객의 누적 합계를 gauge 유형으로 변환했습니다.

누적 합계가 gauge 유형으로 저장된 경우 데이터를 쿼리하는 몇 가지 방법은 다음과 같습니다.

쿼리 게이지 측정항목

New Relic이 누적 합계를 게이지로 변환할 때 latest() 또는 derivative() NRQL 함수를 사용하여 쿼리할 수 있습니다. 선택하는 함수는 원시 값을 볼 것인지 아니면 변화율을 계산할 것인지에 따라 다릅니다.

쿼리 히스토그램 측정항목

OpenTelemetry 메트릭에서 변환된 New Relic 히스토그램은 다른 New Relic 히스토그램과 동일한 쿼리 의미 체계를 갖습니다. 즉, histogram() NRQL 함수를 사용하여 구성 가능한 버킷 수와 버킷 너비로 히스토그램을 나타낼 수 있습니다. 누적 히스토그램을 델타 히스토그램으로 변환하므로 델타 히스토그램이 쿼리되는 것과 같은 방식으로 쿼리됩니다. 엔드포인트 버킷에서 더 큰 버킷 수를 볼 수 있는 명시적 범위 히스토그램에 유의하십시오. 이는 음수 및 양수 무한 바인딩 OpenTelemetry 버킷을 너비가 0인 New Relic 버킷에 추가하기 때문입니다.

중요

TIMESERIES 키워드는 percentiles() 을(를) charing하지 않는 한 New Relic 히스토그램에 대해 지원되지 않습니다.

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.