• 로그인지금 시작하기

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

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

문제 신고

OpenTelemetry 측정항목: 모범 사례

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

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

합계 메트릭

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

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

델타 합계

New Relic에서 델타 메트릭은 단조인지 비단조인지에 따라 다르게 처리됩니다.

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

누적 합계

단조 및 비단조 누적 합계는 New Relic 게이지 메트릭 유형에 매핑됩니다.

합계 구성 예

집계 시간성을 구성하는 방법을 이해하려면 JavaGo OpenTelemetry SDK를 사용하여 이 예제를 참조하십시오.

게이지 측정항목

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

히스토그램 측정항목

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

주의

New Relic은 현재 누적 히스토그램을 지원하지 않습니다. 대신 누적 히스토그램을 델타 시간으로 변환하십시오.

델타 시간성을 사용하도록 SDK를 구성하기 전에 OTLP 메트릭 내보내기에 대한 사양을 참조하세요.

이 계정 쿼리를 사용하여 지원되지 않는 일시적으로 인해 측정항목이 삭제되는지 확인할 수 있습니다.

FROM NrIntegrationError SELECT * WHERE message = 'One or more OTLP metric data point(s) were dropped due to unsupported AggregationTemporality.'

OpenTelemetry 히스토그램은 축척된 지수 2 밑 히스토그램으로 뒷받침되는 New Relic의 분포 메트릭 유형으로 변환됩니다(더 자세한 설명은 NrSketch 참조).

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

요약 측정항목

OpenTelemetry 요약 메트릭 데이터 포인트는 분위수 요약을 나타내는 데 사용됩니다(예: 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으로 설정됩니다.

속성의 배열 값

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

본보기

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

측정항목을 쿼리하는 방법

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

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

누적 합계는 게이지로 변환되므로 다음은 데이터를 쿼리하는 몇 가지 방법입니다.

쿼리 게이지 측정항목

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

쿼리 히스토그램 측정항목

OpenTelemetry 메트릭에서 변환된 New Relic 히스토그램은 다른 New Relic 히스토그램과 동일한 쿼리 의미 체계를 갖습니다. 즉, histogram() NRQL 함수를 사용하여 구성 가능한 버킷 수와 버킷 너비로 히스토그램을 나타낼 수 있습니다. 엔드포인트 버킷에서 더 많은 버킷 수가 표시될 수 있습니다. 이는 음수 및 양수 무한대 OpenTelemetry 버킷을 너비가 0인 New Relic 버킷에 추가하기 때문입니다.

중요

TIMESERIES 키워드는 New Relic 히스토그램에 지원되지 않습니다.

Copyright © 2022 New Relic Inc.

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