Referensi REST Telemetry (OTLP) API

Halaman ini menjelaskan Telemetry (OTLP) API, yang mengimplementasikan OpenTelemetry OTLP Protocol. Untuk informasi tentang API ini, lihat Ringkasan Telemetry API.

Endpoint layanan

Endpoint layanan adalah URL dasar yang menentukan alamat jaringan layanan API. Satu layanan dapat memiliki beberapa endpoint layanan. Layanan ini mendukung endpoint layanan global.

Permintaan HTTP

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

Isi permintaan

Isi permintaan memuat instance ExportTraceServiceRequest. Untuk informasi tentang struktur ini, lihat trace_service.proto dan trace.proto.

Jika Anda menambahkan attributes ke Span, pastikan Anda mengikuti petunjuk OpenTelemetry. Untuk mengetahui informasi selengkapnya, lihat Konsep spesifikasi umum: Atribut.

Untuk informasi tentang cara mengirim permintaan dan protokol OTLP, lihat Detail Protokol.

Isi respons

Isi respons berisi instance ExportTraceServiceResponse. Untuk informasi tentang struktur ini, lihat trace_service.proto.

Respons dapat menunjukkan keberhasilan penuh, keberhasilan sebagian, atau kegagalan. Untuk mengetahui informasi selengkapnya, lihat Respons OTLP/gRPC.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Authentication Overview.