OpenTelemetry 추적: 모범 사례

이러한 OpenTelemetry 추적 주제를 숙지하여 추적 및 범위가 New Relic에 표시되도록 하십시오.

중요

OpenTelemetry Protocol이 성숙해지고 더 많은 구성 요소가 stable 로 선언됨에 따라 2022년 9월 이전에 OTLP 끝점에서 지원하는 버전을 v0.10.0에서 최신 릴리스인 v0.16.0 이상으로 이동할 예정입니다.

커뮤니티가 보다 안정적인 OTLP 릴리스를 향해 이동함에 따라 중단을 최소화하기 위해 취할 수 있는 조치 및 v0.10.0 지원 EOL 일정에 대한 추가 커뮤니케이션이 곧 있을 예정입니다.

필수 입력 사항

스팬의 startTimeUnixNano 및 endTimeUnixNano 필드는 추적 데이터 용 OpenTelemetry 프로토콜에 따라 필요합니다. startTimeUnixNano 가 없으면 범위가 삭제되고 NrIntegrationError 이 생성됩니다. endTimeUnixNano 가 없으면 범위의 기간이 크고 음수입니다.

스팬 이벤트의 timeUnixNano 필드는 필수입니다. timeUnixNano 이 없으면 스팬 이벤트가 삭제되고 NrIntegrationError 가 생성됩니다.

스팬의 traceId 및 spanId 필드는 추적 데이터 용 OpenTelemetry 프로토콜에 따라 필요합니다. traceId 또는 spanId 이 없으면 범위가 삭제되고 NrIntegrationError 가 생성됩니다.

견본 추출

추적 데이터는 가장 성숙한 OpenTelemetry 데이터 유형입니다. 이 때문에 New Relic의 OpenTelemetry 사용자 경험은 주로 추적 데이터를 기반으로 하므로 샘플링 전략의 영향을 받습니다.

다음과 같은 여러 위치에서 샘플링을 구성할 수 있습니다.

서비스: 귀하의 언어에 대해 OpenTelemetry SDK를 사용하십시오.
수집기: OpenTelemetry 수집기의 자체 인스턴스를 실행하는 경우 꼬리 기반 샘플링( 아래 참조 )과 같은 보다 정교한 형태의 샘플링을 수행하도록 구성할 수 있습니다.

다양한 유형의 샘플링을 구성하는 방법에 대한 이 문서를 확인하십시오.

무한 추적은 New Relic의 꼬리 기반 샘플링 옵션입니다. 이를 OpenTelemetry 계측 서비스와 함께 사용할 수 있습니다. 무한 추적을 설정할 때 OTLP gRPC를 사용하여 추적 데이터를 New Relic 추적 관찰자로 내보내도록 애플리케이션(또는 수집기)을 구성해야 합니다.

추적 관찰자 설정 의 단계에 따라 YOUR_TRACE_OBSERVER_URL 값을 가져옵니다.
빠른 시작 가이드 의 단계를 완료하면 YOUR_TRACE_OBSERVER_URL 값을 사용하여 통합을 구성합니다. YOUR_TRACE_OBSERVER_URL 은 https://{trace-observer}:443/trace/v1 형식을 따릅니다. OTLP gRPC 엔드포인트를 설정할 때 /trace/v1 접미사를 제거하면 https://{trace-observer}:443 형식의 URL이 생성됩니다.
New Relic이 모든 추적을 분석하기를 원하기 때문에 추적과 관련된 모든 애플리케이션이 꼬리 기반 샘플링을 허용하는 샘플러로 OpenTelemetry SDK를 구성 했는지 확인하십시오. 기본 parentbased_always_on 및 always_on 샘플러가 좋은 선택입니다.
추적 관찰자 끝점에는 추적 데이터만 보낼 수 있습니다. 애플리케이션(또는 수집기)은 OpenTelemetry 메트릭 및 로그에 대한 내보내기 전략을 별도로 구성해야 합니다.

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

중요

필수 입력 사항

견본 추출

OpenTelemetry 내장 샘플러

OpenTelemetry 꼬리 기반 샘플러

Infinite Tracing을 통한 New Relic 꼬리 기반 샘플링