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

OpenTelemetry를 사용한 앱 또는 서비스 설정

OpenTelemetry는 자체 앱 또는 서비스에서 텔레메트리 데이터를 수집한 다음 해당 데이터를 뉴렐릭으로 내보내는 데 사용할 수 있는 툴킷입니다. OpenTelemetry에 익숙하고 앱 또는 서비스를 설정할 준비가 되었다면 아래 정보를 확인하십시오.

데모 앱에서 OpenTelemetry를 사용해 보거나 다른 설정 옵션을 보려면 OpenTelemetry를 시작하는 방법을 참조하십시오.

다음 5단계는 OpenTelemetry로 자체 앱 또는 서비스를 구성하는 데 도움이 됩니다.

OpenTelemetry로 앱 또는 서비스 계측

앱이나 서비스를 계측하는 데 도움이 되도록 OpenTelemetry는 언어별 제품 및 SDK를 제공합니다. 많은 언어가 보편적인 라이브러리 및 프레임워크에 대해 즉시 사용 가능한 계측을 제공합니다. 또한 각 언어는 코드를 수동으로 계측하여 텔레메트리를 수집하는 데 도움이 되는 API를 제공합니다.

해당 언어의 리포지토리로 이동하여 지침에 따라 코드를 계측합니다. 완료되면 이곳으로 돌아와 3단계: 텔레메트리 데이터를 뉴렐릭으로 내보내기 위한 설정 검토를 완료합니다.

텔레메트리 데이터를 뉴렐릭으로 내보내기 위한 설정 검토

텔레메트리 데이터 내보내기는 OpenTelemetry Protocol(OTLP)을 사용합니다. 이는 OpenTelemetry 프로젝트용으로 설계된 범용 텔레메트리 데이터 전달 프로토콜입니다. 이 프로토콜은 텔레메트리 데이터를 인코딩하고 전송하는 방법을 설명하므로 데이터 전송을 위한 적절한 선택입니다. 각 언어 SDK는 OTLP를 통해 데이터를 내보내도록 구성할 수 있는 OTLP 내보내기를 제공합니다.

텔레메트리 데이터를 내보내려면 먼저 인제스트 라이선스 키와 적절한 OTLP 엔드포인트가 있어야 합니다. 다음 단계에서 두 정보가 모두 필요하므로 이 정보를 텍스트 파일에 붙여넣는 것이 좋습니다. OTLP를 통해 뉴렐릭으로 데이터를 내보내는 방법에는 두 가지가 있습니다.

  • 앱에서 직접 내보내기:

    앱과 서비스에서 OTLP 내보내기는 뉴렐릭 OTLP 수신기로 직접 내보낼 수 있습니다.

  • OpenTelemetry 수집기에서 내보내기:

    수집기를 뉴렐릭 OTLP 수신기를 수신, 처리 및 내보내는 게이트웨이로 설정할 수 있습니다. 또는 수집기를 애플리케이션과 함께 실행되거나 동일한 호스트에서 실행되는 에이전트로 설정할 수 있습니다.

    앱에서 직접 내보내든 수집기에서 내보내든 다음을 수행해야 합니다.

  1. 헤더(api-key)를 추가하도록 OTLP 내보내기를 구성할 준비를 합니다. 값은 데이터를 보내려는 뉴렐릭 계정의 라이선스 키입니다.

  2. 통합에 기반해, 엑스포터가 뉴렐릭으로 데이터를 보내는 엔드포인트를 구성할 준비를 합니다. 엔드포인트는 지역별로 다르므로 뉴렐릭 조직이 기반을 두고 있는 엔드포인트를 사용해야 합니다. 예를 들어 EU 데이터 센터 지역을 사용하는 경우 EU 엔드포인트를 사용합니다. 아래 표를 가이드로 사용하고, 포트엔드포인트에 대한 아래의 추가 고려 사항을 참조하십시오.

    통합

    gRPC

    HTTP

    엔드포인트

    지원되는 포트

    API 헤더 이름

    API 헤더 값

    TLS 암호화 필수

    US OTLP

    https://otlp.nr-data.net

    443, 4317, 4318

    api-key

    라이선스 키

    EU OTLP

    https://otlp.eu01.nr-data.net

    443, 4317, 4318

    api-key

    라이선스 키

    US FedRAMP OTLP
    (자세한 내용은 FedRAMP 규정 준수 참조)

    https://gov-otlp.nr-data.net

    443, 4317, 4318

    api-key

    라이선스 키

    Infinite Tracing
    (세부적인 엔드포인트 정보는 모범 사례를 참조)

    https://{trace-observer}

    443

    api-key

    라이선스 키

내보내기 설정 단계 완료

내보내기를 위한 뉴렐릭 관련 설정에 익숙해졌으면 데이터를 내보내려는 방법에 대한 지침을 따릅니다.

뉴렐릭 UI에서 데이터 보기

앱 또는 서비스를 계측하고 데이터를 뉴렐릭으로 내보내도록 구성한 후에는 트레이스, 메트릭로그에 대한 뉴렐릭 UI를 살펴보시기 바랍니다.

OpenTelemetry용 UI는 APM UI와 일부 유사하므로, 이에 익숙한 경우 바로 UI로 이동할 수 있습니다. OpenTelemetry UI 옵션을 이해하는 데 도움이 필요하거나 데이터가 UI에 표시되는지 확인하는 방법이 필요한 경우 뉴렐릭에서 OpenTelemetry 데이터 보기를 참조하십시오.

이 문서가 설치하는데 도움이 되셨나요?

지원되지 않는 사양

뉴렐릭은 현재 opentelemetry-specification v1.8.0을 지원하며, 몇 가지 예외 사항이 있습니다.

  • 뉴렐릭의 성공적인 응답에는 응답 본문이 없고 데이터 유형을 기반으로 하는 Protobuf 인코딩 응답이 있습니다. 뉴렐릭은 또한 인증 후 디코딩 및 유효성 검사 전에 성공적으로 응답을 합니다.
  • OTLP 클라이언트는 Status 객체를 사용하지 않기 때문에, 뉴렐릭의 실패 응답에는 Status.message 또는 Status.details이 포함되지 않습니다.

다음 단계는?

초기 설정을 완료한 후 엔드투엔드 구현 가이드와 기타 모범 사례 가이드를 확인하십시오. OpenTelemetry 사용을 최적화하는 데 도움이 됩니다.

Copyright © 2024 New Relic Inc.

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