OpenTelemetry는 서비스에 대해 다양한 방식으로 구현할 수 있는 유연한 툴킷입니다. 호스트에 대한 원격 분석을 수집하려는 경우 수집기 지침 으로 건너뛰십시오.
팁
샘플을 먼저 연습하고 싶다면 다음 옵션 중 하나를 사용하여 자체 개발 환경에서 샘플 서비스를 실행하십시오.
- OpenTelemetry 마스터 클래스 : OpenTelemetry에 대해 알아보고 .NET 또는 Python에 대한 실습 자습서 시도
- New Relic OpenTelemetry 예제 : .NET, Go, Java 또는 Python의 샘플 프로그램으로 계측 시도
다음 5단계는 OpenTelemetry를 사용하여 자체 서비스를 계측하는 데 도움이 됩니다.
1단계: 전제 조건
먼저 첫 번째 것들:
- 아직 등록하지 않았다면 무료 New Relic 계정 에 등록하십시오.
- 데이터를 보고하려는 New Relic 계정의 라이선스 키 를 가져옵니다.
2단계: OpenTelemetry로 서비스 계측
이 지침은 서비스 계측에 중점을 둡니다. 호스트 계측에 대해 알아보려면 수집기 지침 으로 이동하십시오.
서비스를 계측하는 데 도움이 되도록 OpenTelemetry는 언어별 제품 및 SDK를 제공합니다. 많은 언어가 공통 라이브러리 및 프레임워크에 대한 즉시 사용 가능한 계측을 제공합니다. 각 언어는 서비스를 수동으로 추가로 계측하기 위한 API도 제공합니다.
해당 언어의 저장소로 이동하고 지침에 따라 서비스를 계측합니다. 완료되면 여기로 돌아와 3단계: 원격 측정 데이터를 New Relic으로 내보내기 위한 구성 검토 를 완료합니다.
3단계: 원격 측정 데이터를 New Relic으로 내보내기 위한 구성 검토
원격 측정 데이터 내보내기를 설정하기 전에 먼저 New Relic에 대한 이 설정 섹션을 검토하고 북마크해야 합니다. 나중에 내보내기 단계를 설명하는 다른 페이지로 이동할 때 이 정보가 필요합니다.
내보내기는 OpenTelemetry 프로젝트용으로 설계된 범용 원격 측정 데이터 전달 프로토콜인 OpenTelemetry Protocol 또는 줄여서 OTLP에 의존합니다. 이 프로토콜은 원격 측정 데이터를 인코딩하고 전송하는 방법을 설명하므로 데이터 전송을 위한 자연스러운 선택이 됩니다. 각 언어 SDK는 OTLP를 통해 데이터를 내보내도록 구성할 수 있는 OTLP 내보내기를 제공합니다.
OTLP를 통해 New Relic으로 데이터를 내보내는 방법에는 두 가지가 있습니다.
앱에서 직접:
서비스의 OTLP 내보내기는 New Relic OTLP 수신기로 직접 내보낼 수 있습니다.
OpenTelemetry 수집기에서 내보내기:
수집기를 New Relic OTLP 수신기를 수신, 처리 및 내보내는 게이트웨이로 설정할 수 있습니다. 또는 수집기를 애플리케이션과 함께 실행되거나 동일한 호스트에서 실행되는 에이전트로 설정할 수 있습니다.
앱에서 직접 내보내든 수집기에서 내보내든 다음을 수행해야 합니다.
- 헤더(
api-key)를 추가하도록 OTLP 내보내기를 구성할 준비를 하십시오. 값은 데이터를 보내려는 New Relic 계정의 라이선스 키입니다. - 통합을 기반으로 내보내기가 New Relic으로 데이터를 보내는 끝점을 구성할 준비를 하십시오. 엔드포인트는 지역별로 다르므로 계정 기반 위치에 따라 엔드포인트를 사용하세요. 예를 들어, 계정이 유럽에 있는 경우 EU 엔드포인트를 사용하십시오. 아래 표를 지침으로 사용하고 다음에 나오는 포트 및 엔드포인트 에 대한 추가 고려 사항을 확인하십시오.
완성 | gRPC | HTTP | 끝점 | 지원되는 포트 | API 헤더 이름 | API 헤더 값 | TLS 암호화 필요 |
|---|---|---|---|---|---|---|---|
미국 OTLP | ✅ | ✅ |
|
|
| 라이센스 키 | ✅ |
EU OTLP | ✅ | ✅ |
|
|
| 라이센스 키 | ✅ |
미국 FedRAMP OTLP | ✅ | ✅ |
|
|
| 라이센스 키 | ✅ |
무한 추적 | ✅ | ❌ |
|
|
| 라이센스 키 | ✅ |
중요
Node.js에서 opentelemetry-collector-exporter-grpc 라이브러리에는 TLS를 활성화하기 위한 추가 옵션이 필요합니다.
4단계: 내보내기 구성 단계 완료
이제 내보내기를 위한 New Relic 관련 구성에 익숙해졌으므로 데이터를 내보내려는 방법에 대한 지침을 따르십시오.
앱에서 New Relic으로 직접 내보내기
귀하의 언어에 대한 아래 링크를 클릭하고 구성 단계를 완료하십시오. 완료되면 여기로 돌아와 5단계를 완료하세요. New Relic UI에서 데이터 보기 .
수집기에서 New Relic으로 내보내기
다양한 방법과 목적으로 수집기를 설정할 수 있습니다. 설정을 시작하기 전에 수집기에 대한 일반 정보가 필요한 경우 소개 를 참조하세요.
다음 중 하나를 선택하여 내보낼 수집기를 설정하는 예를 확인하십시오.
5단계: New Relic UI에서 데이터 보기
서비스를 계측하고 해당 데이터를 New Relic으로 내보내도록 구성한 후에는 추적 , 지표 및 로그 에 대한 New Relic UI를 확인하세요.
OpenTelemetry용 UI는 APM 에이전트 UI와 몇 가지 유사하므로 이에 대해 잘 알고 있으면 UI로 바로 이동할 수 있습니다. OpenTelemetry UI 옵션을 이해하는 데 도움이 필요하거나 데이터가 UI에 표시되는지 확인하는 방법이 필요한 경우 New Relic에서 OpenTelemetry 데이터 보기를 참조하세요 .
지원되지 않는 사양
New Relic은 현재 몇 가지 예외를 제외하고 opentelemetry-specification v1.8.0 을 지원합니다.
- New Relic의 성공적인 응답에는 데이터 유형을 기반으로 하는 Protobuf 인코딩 응답 대신 응답 본문이 없습니다. New Relic은 또한 인증 후 디코딩 및 유효성 검사 전에 성공으로 응답합니다.
- OTLP 클라이언트는
Status객체를 사용하지 않기 때문에 New Relic의 실패 응답 에는Status.message또는Status.details이 포함되지 않습니다.
다음은 뭐지?
초기 설정을 수행한 후 모범 사례 가이드에서 OpenTelemetry 및 New Relic 사용을 개선하기 위한 팁을 확인하십시오.