OpenTelemetry 누적 합계 메트릭에 대한 전환 가이드

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

누적 메트릭을처리하는 방법을 더 잘 지원하기 위해 OTLP 메트릭 파이프라인이 업그레이드되고 있습니다. 이 업그레이드의 일환으로 단순 누적 합계에 대한 기본 측정항목 데이터 유형을 gauge 유형에서 cumulativeCount 유형으로 전환하고 있습니다. cumulativeCount 유형을 사용하면 보고된 데이터와 관련된 누적 및 델타 값을 모두 쿼리할 수 있습니다.

gaDateAndYear를 시작하면 다음 EoL(수명 종료) 타임라인에 따라 누적된 단순 지표를 수집합니다.

날짜 및 연도:
- cumulativeCount 측정항목 유형이 해제됨에 따라 누적 단순 합계 수집이 해제됩니다(비단조 누적 합계는 영향을 받지 않음 ). 이러한 측정항목을 gauge 측정항목 유형으로 수집한 이전 경험은 더 이상 사용되지 않습니다.
- 이 날짜 이전에 누적 단순 합계를 적극적으로 전송한 계정은 gauge 유형 수집을 계속 사용할 수 있습니다.
- 다른 모든 계정에는 cumulativeCount 측정항목 유형으로 수집된 누적 단순 합계가 있습니다.
gaDate에서 eolDate까지:
- 지원 중단된 gauge 유형 수집을 사용하는 계정은 cumulativeCount 유형 수집을 선택할 수 있습니다. 조기 옵트인은 영향을 받는 쿼리 및 경고가 EoL로 인해 중단되지 않도록 하는 가장 좋은 방법입니다.
eolDateAndYear: 모든 계정은 누적 단순 합계를 위해 cumulativeCount 유형 수집으로 마이그레이션됩니다.

gaDate 이전에 누적 단조 합계를 수집했다면 이 180일 기간 동안 쿼리를 업데이트하고 영향을 받는 측정항목을 활용합니다.

아래 섹션에서 다음 내용을 배울 수 있습니다.

영향을 받는지 확인하는 방법
EoL을 준비하는 방법
EoL 날짜 이전에 cumulativeCount 기능을 선택하는 방법

중요

단순하지 않은 누적 합계는 영향을 받지 않습니다 .

영향 확인

귀하의 계정이 gaDateAndYear 이전에 OTLP 누적 합계 메트릭을 New Relic으로 보낸 경우 eolDateAndYear의 EoL에 의해 영향을 받게 됩니다.

영향을 받았는지 확인하려면 관련 계정에 대해 다음 NRQL 쿼리를 실행하십시오.

FROM NrIntegrationError SELECT count(*)
WHERE newRelicFeature = 'cumulativeSumAsGaugeEoL'
SINCE 24 hours ago

지난 24시간 동안 이 EoL의 영향을 받은 메트릭을 보고한 경우 쿼리가 결과를 반환합니다.

추가 조사를 위해 이벤트 메시지를 보고 어떤 메트릭이 영향을 받는지 확인할 수 있습니다.

FROM NrIntegrationError SELECT uniques(metricName)
WHERE newRelicFeature = 'cumulativeSumAsGaugeEoL'
LIMIT MAX SINCE 24 hours ago

이러한 메트릭과 관련된 모든 모니터링 또는 경고는 EoL 날짜 이전에 검토하고 업데이트해야 합니다. 다음 섹션에는 영향을 받는 메트릭에 대한 제안 조치가 포함되어 있습니다.

영향을 받는 경우 수행할 작업

eolDate에서 OTLP 단순 누적 합계 측정항목의 보고가 gauge 사용에서 cumulativeCount 측정항목 유형으로 전환됩니다. 이러한 메트릭을 사용하는 경우 이에 대비해야 합니다. 예를 들어 전환이 발생할 때 중단이 발생하지 않도록 새 지표 유형으로 중복 경보 조건을 생성할 수 있습니다(아래에서 그 방법을 설명함).

OpenTelemetry 모범 사례는 gauge 및 cumulativeCount 측정항목 유형 간의 쿼리 차이점을 설명합니다. 즉, 누적 필드를 선택하여 델타 값(기본값) 또는 누적 값을 대상으로 지정할 수 있습니다.

누적 단조 합계 메트릭 metricName의 예제 쿼리를 살펴보겠습니다. EoL까지 다음과 같은 쿼리:

FROM Metric SELECT latest(<metricName>)

gauge 측정항목만 평가합니다. EoL이 발생하면 metricName 과 연결된 기본 메트릭 유형이 cumulativeCount로 변경됩니다. 경고에 따라 이 변경으로 인해 gauge 및 cumulativeCount 유형의 측정항목 값이 서로 다른 데이터 포인트 값을 나타내므로 잘못된 결과가 발생할 수 있습니다.

아래에서는 알림이 일반적으로 차트보다 더 중요하기 때문에 알림 조건업데이트에 중점을 둡니다. 사용자 지정 차트의 경우 다음 중 하나를 수행할 수 있습니다.

경고에 대해 설명한 것과 동일한 일반적인 접근 방식을 취합니다(업데이트된 쿼리로 새 차트를 만들고 EoL 후 이전 차트 삭제). 또는
EoL 이후까지 기다렸다가 차트 업데이트

권장 조치: 새 버전의 경보 생성

다음은 경고 조건에서 사용될 수 있는 쿼리의 몇 가지 예입니다. 원래 쿼리를 제공한 다음 쿼리의 gauge 버전 및 쿼리의 cumulativeCount 버전을 제공합니다. 기존 경고를 쿼리의 gauge 버전으로 바꾸고 cumulativeCount 버전을 사용하는 중복 경고 조건을 생성해야 합니다. 이렇게 하면 eolDate에 귀하의 계정을 cumulativeCount 로 전환할 때 이전 쿼리가 더 이상 작동하지 않을 때 해당 알림 조건을 사용할 수 있습니다.

누적 쿼리

기존 쿼리:

FROM Metric SELECT latest(<metricName>)

쿼리의 게이지 버전:

FROM Metric SELECT latest(<metricName>)
WHERE <metricName>[type] = 'gauge'

쿼리의 누적 카운트 버전:

FROM Metric SELECT latest(<metricName>[cumulative])
WHERE <metricName>[type] = 'cumulativeCount'

쿼리 변경 비율

기존 쿼리:

FROM Metric SELECT derivative(<metricName>, 1 minute)

쿼리의 게이지 버전:

FROM Metric SELECT derivative(<metricName>, 1 minute)
WHERE <metricName>[type] = 'gauge'

쿼리의 누적 카운트 버전:

FROM Metric SELECT rate(sum(<metricName>[cumulative]), 1 minute)
WHERE <metricName>[type] = 'cumulativeCount'

권장 조치: EoL 전에 cumulativeCount 미리 보기

영향을 받는 계정은 EoL까지 누적 합계가 gauge 유형으로 계속 저장됩니다. 그러나 선택적으로 EoL 전에 cumulativeCount 시도하여 쿼리 및 경고가 예상대로 작동하는지 확인할 수 있습니다. cumuativeCount 유형을 조기에 테스트하려면 New Relic에 보내는 OTLP 데이터에 다음 속성을 추가하십시오.

newrelic_metric_type=cumulativeCount

중요

데이터에 newrelic_metric_type=cumulativeCount 전송을 시작하면 Google에서 수신하는 모든 누적 단순 합계가 cumulativeCount 유형으로 변환됩니다. 즉, gauge 유형을 대상으로 설정하도록 설정된 기존 쿼리 또는 경고는 예기치 않은 결과를 받게 됩니다. cumulativeCount 환경을 테스트할 때 이 점을 염두에 두십시오. gauge 유형으로 돌아가려면 newrelic_metric_type 속성 설정을 중지하면 됩니다.

계측 라이브러리

코드 베이스 내에서 OTLP 계측 라이브러리를 사용하는 경우 애플리케이션에 적합한 언어 SDK를 참조해야 합니다. 개별 지표 데이터 포인트 또는 자원 속성 레벨에 속성 newrelic_metric_type=cumulativeCount 을(를) 추가하는 모든 방법으로 충분해야 합니다.

다음은 Java SDK의 보고 측정항목에 속성을 직접 추가하는 예입니다.

final var meter = openTelemetry.meterBuilder("manual-instrumentation-scope")
                .setInstrumentationVersion("1.0.0")
                .build();
final LongCounter counter = meter.counterBuilder("myCumulativeCounter")
                .build();
counter.add(1, Attributes.of(stringKey("newrelic_metric_type"), "cumulativeCount"));

수집기

OTLP 모니터링 소스가 OTLP 수집기에서 오는 경우 OpenTelemetry 특성 프로세서를 사용하여 내보내기에 전송하기 전에 특성을 추가할 수 있습니다. 예를 들어 다음 스니펫은 newrelic_metric_type=cumulativeCount 속성을 삽입합니다.

…
attributes:
  actions:
    - key: newrelic_metric_type
      action: insert
      value: cumulativeCount
…
service:
  pipelines:
    metrics:
      …
      processors: [...,attributes,...]
      …

결과 확인

측정항목 데이터에 newrelic_metric_type=cumulativeCount 설정한 후 다음 쿼리로 올바르게 수신하고 있는지 확인할 수 있습니다.

FROM Metric SELECT count(*) WHERE %[type] = 'cumulativeCount' TIMESERIES