이 문서에서는 OpenTelemetry OTLP 프로토콜을 구현하는 원격 분석 (OTLP) API를 사용하여 trace 데이터를Google Cloud 프로젝트로 전송하는 것이 권장되는 이유를 설명합니다. 또한 애플리케이션을 계측하는 방법과 추적 데이터를 볼 수 있는 위치에 관한 안내도 제공합니다. OpenTelemetry SDK 중 하나를 사용하여 애플리케이션을 계측하거나 OpenTelemetry Collector를 사용하는 경우 Telemetry API를 사용할 수 있습니다.
Telemetry API를 권장하는 이유는 다음과 같습니다.
이 API는 오픈소스 OpenTelemetry 생태계와 호환되며 한도가 독점 Google Cloud API인 Cloud Trace API의 한도보다 더 관대한 경우가 많습니다.
trace 데이터는 일반적으로 OpenTelemetry OTLP 프로토콜에서 정의한 proto 파일과 일치하는 형식으로 저장됩니다. 일부 필드는 저장 전에 OpenTelemetry 전용 데이터 유형에서 JSON 데이터 유형으로 변환될 수 있습니다. 스토리지 형식에 대한 자세한 내용은 trace 데이터 스키마를 참고하세요.
계측은 Google Cloud별 내보내기 도구를 사용하지 않습니다.
애플리케이션 모니터링과 같은 일부 기능은 trace 데이터를 Telemetry API로 전송하는 경우에만 사용할 수 있는 정보를 사용합니다.
OpenTelemetry는 Google Cloud에서 지원하는 오픈소스 프로젝트로, Google Cloud엔지니어가 원격 분석의 수집 및 시각화를 지원합니다.
권장사항
Google Cloud 프로젝트에 trace 데이터를 전송하도록 애플리케이션을 계측할 때는 다음 중 하나를 수행하는 것이 좋습니다.
- OTLP를 수집기에 작성하는 내보내기 도구를 사용합니다. 그러면 수집기에서 trace 데이터를 Telemetry API로 전송합니다.
- 원격 분석을 Telemetry API에 전송하는 OpenTelemetry 라이브러리에서 지원되는 프로세스 내 OTLP 내보내기 도구를 사용합니다. 이 구성에는 수집기가 없습니다.
Telemetry API 사용 방법에 대한 자세한 내용은 Cloud Trace 내보내기 도구에서 OTLP 엔드포인트로 마이그레이션을 참고하세요.
인증
Google Cloud 프로젝트로 트레이스 데이터를 전송하는 데 필요한 사용자 인증 정보로 내보내기 도구를 구성해야 합니다. 예를 들어Google Cloud 애플리케이션 기본 사용자 인증 정보 (ADC)로 내보내기 도구를 구성하려면 애플리케이션에 언어별 Google 인증 라이브러리를 추가하세요. 자세한 내용과 샘플 코드는 인증 구성을 참고하세요.
Cloud Trace 및 데이터 상주
데이터 상주 또는 영향 수준 4 (IL4) 요구사항이 있기 때문에 Assured Workloads를 사용하는 경우 Telemetry API를 사용하여 추적 범위를 프로젝트로 전송하지 마세요.
수집된 데이터를 확인할 수 있는 위치
Trace 탐색기 및 로그 애널리틱스 페이지를 사용하여 trace 데이터를 볼 수 있습니다. 자세한 내용은 다음을 참고하세요.