REST 원격 분석 (OTLP) API 참조

이 페이지에서는 OpenTelemetry OTLP 프로토콜을 구현하는 원격 분석 (OTLP) API를 설명합니다. 이 API에 관한 자세한 내용은 Telemetry API 개요를 참고하세요.

서비스 엔드포인트

서비스 엔드포인트는 API 서비스의 네트워크 주소를 지정하는 기준 URL입니다. 하나의 서비스는 여러 서비스 엔드포인트를 포함할 수 있습니다. 이 서비스는 전역 서비스 엔드포인트를 지원합니다.

HTTP 요청

POST https://telemetry.googleapis.com/v1/traces

요청 본문

요청 본문에 ExportTraceServiceRequest의 인스턴스가 포함됩니다. 이 구조에 관한 자세한 내용은 trace_service.prototrace.proto를 참고하세요.

Spanattributes를 추가하는 경우 OpenTelemetry의 안내를 따르세요. 자세한 내용은 일반 사양 개념: 속성을 참고하세요.

요청 전송 및 OTLP 프로토콜에 관한 자세한 내용은 프로토콜 세부정보를 참고하세요.

응답 본문

응답 본문에는 ExportTraceServiceResponse 인스턴스가 포함됩니다. 이 구조에 관한 자세한 내용은 trace_service.proto를 참고하세요.

응답은 전체 성공, 부분 성공 또는 실패를 나타낼 수 있습니다. 자세한 내용은 OTLP/gRPC 응답을 참고하세요.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/trace.append
  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참고하세요.