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