이 문서에서는 OpenTelemetry OTLP 프로토콜을 구현하는 Telemetry (OTLP) API를 설명합니다. 이 API는 OpenTelemetry SDK 중 하나를 사용하여 계측된 애플리케이션과 함께 사용하도록 설계되었습니다.
Telemetry API를 사용해야 하는 이유
Telemetry API는 OTLP 형식의 트레이스 데이터 처리를 지원합니다. Telemetry API를 사용하면 데이터가 독점 형식으로 변환되지 않고 OTLP 형식으로 저장되며 Telemetry API의 제한사항이 적용됩니다. 이러한 한도는 Cloud Trace API의 한도보다 훨씬 더 관대합니다. 마지막으로 계측은 Google Cloud용 내보내기를 사용하지 않습니다.
OpenTelemetry는 trace 데이터 처리 및 시각화를 지원하기 위해 Google Cloud에서 지원하는 오픈소스 프로젝트로 Google Cloud엔지니어가 배치되어 있습니다.
Telemetry API를 사용해야 하는 경우
애플리케이션을 계측하여Google Cloud 프로젝트로 트레이스 데이터를 전송하는 경우 다음 중 하나를 실행하는 것이 좋습니다.
- OTLP를 수집기에 쓰고 트레이스 데이터를 Telemetry API로 전송하는 내보내기 도구를 사용합니다.
- 원격 분석을 Telemetry API로 전송하는 OpenTelemetry 라이브러리에서 지원하는 프로세스 내 OLTP 내보내기 도구를 사용합니다. 이 구성에는 수집기가 없습니다.
Telemetry API 사용 방법에 관한 자세한 내용은 Cloud Trace 내보내기 도구에서 OTLP 엔드포인트로 이전을 참고하세요.
처리된 데이터를 확인할 수 있는 위치
Telemetry API를 통해 처리된 trace 데이터는 Trace 탐색기 페이지를 사용하여 볼 수 있습니다. trace 데이터를 보는 방법에 관한 자세한 내용은 trace 찾기 및 탐색을 참고하세요.
Telemetry API를 통해 처리된 trace 데이터는 기존 Trace Explorer 페이지에서 사용할 수 없습니다. 자세한 내용은 기존 trace 탐색기: 알려진 문제를 참고하세요.
인증
내 프로젝트로 데이터를 전송할 수 있도록 내보내기 도구에 승인해야 합니다. Google Cloud 예를 들어 애플리케이션에 언어별 Google 인증 라이브러리를 추가하여 Google Cloud 애플리케이션 기본 사용자 인증 정보 (ADC)로 내보내기를 구성할 수 있습니다. 자세한 내용과 샘플 코드는 인증 구성을 참고하세요.
VPC 서비스 제어 지원
서비스 이름이 telemetry.googleapis.com인 Telemetry API 서비스는 VPC 서비스 제어 지원 서비스입니다. Telemetry API 서비스에 대해 만드는 모든 VPC 서비스 제어 제한사항은 해당 서비스에만 적용됩니다. 이러한 제한사항은 트레이스 데이터를 처리할 수도 있는 cloudtrace.googleapis.com 서비스와 같은 기타 서비스에는 적용되지 않습니다.
자세한 내용은 다음을 참조하세요.