OpenTelemetry adalah project open source yang didukung Google Cloud-dengan staf engineer yang memastikan dukungan untuk penyerapan dan visualisasi telemetri Anda. Google Cloud
Untuk mempelajari API ini lebih lanjut, lihat dokumen referensi berikut:
Praktik terbaik
Saat menginstrumentasi aplikasi untuk mengirim data rekaman aktivitas ke projectGoogle Cloud , sebaiknya Anda menggunakan eksportir yang menulis data berformat OTLP ke Collector, yang kemudian mengirimkan data rekaman aktivitas Anda ke Telemetry API. Di pengumpul, tentukan hanya URL root:
exporters:
otlphttp:
encoding: proto
endpoint: https://telemetry.googleapis.com
OpenTelemetry mendeteksi jenis data dan otomatis menambahkan /v1/traces,
/v1/metrics, atau /v1/logs sebagaimana mestinya. Untuk mengetahui informasi selengkapnya, lihat
Permintaan OTLP/HTTP.
Untuk contoh yang mengekspor data metrik atau rekaman aktivitas ke Telemetry API, lihat dokumen berikut:
Jika tidak dapat menggunakan pengumpul, Anda dapat menggunakan library OpenTelemetry yang berisi eksportir OTLP dalam proses untuk mengirim telemetri ke Telemetry API. Untuk mempelajari cara mengekspor data rekaman aktivitas secara langsung, lihat Pengekspor Cloud Trace ke endpoint OTLP.
Autentikasi
Anda harus mengonfigurasi pengekspor dengan kredensial yang diperlukan untuk mengirim
data ke project Google Cloud . Misalnya, saat menggunakan pengumpul, biasanya Anda juga menggunakan ekstensi googleclientauth untuk mengautentikasi dengan kredensial Google.
Untuk contoh autentikasi saat menggunakan ekspor langsung data rekaman aktivitas, lihat Mengonfigurasi autentikasi. Contoh ini menggambarkan cara mengonfigurasi eksportir dengan Google Cloud Kredensial Default Aplikasi (ADC) dan menambahkan Google Auth Library khusus bahasa ke aplikasi Anda.
Dukungan Kontrol Layanan VPC
Layanan Telemetry API, yang nama layanannya adalah telemetry.googleapis.com, merupakan layanan yang didukung Kontrol Layanan VPC. Setiap batasan Kontrol Layanan VPC yang Anda buat untuk layanan Telemetry API hanya berlaku untuk layanan tersebut. Batasan tersebut tidak berlaku untuk layanan lain, termasuk layanan seperti cloudtrace.googleapis.com, yang juga dapat menyerap data rekaman aktivitas.
Untuk informasi selengkapnya, lihat referensi berikut:
Endpoint Service
Endpoint layanan adalah URL dasar yang menentukan alamat jaringan layanan API. Telemetry API mendukung endpoint global dan endpoint regional:
Endpoint global:
telemetry.googleapis.com. Untuk endpoint ini, setelah Google Cloud Observability berhasil menyelesaikan semua langkah validasi, endpoint akan mengirimkan data ke layanan backend untuk penyimpanan.Endpoint regional:
telemetry.REGION.rep.googleapis.com, dengan REGION adalah region yang didukung. Untuk endpoint ini, setelah Google Cloud Observability berhasil menyelesaikan semua langkah validasi, Google Cloud Observability akan mengirimkan data ke layanan backend. Layanan ini menyimpan atau menghapus data:- Data log dan rekaman aktivitas disimpan. Layanan backend secara otomatis memindahkan data antar-region jika diperlukan.
- Data metrik hanya disimpan jika label lokasi yang dilampirkan ke data cocok dengan region endpoint atau zona dalam region tersebut.
Untuk mengetahui daftar endpoint regional yang didukung, lihat halaman referensi API.
Penyerapan data rekaman aktivitas dapat memicu pembuatan bucket kemampuan pengamatan. Namun, penggunaan endpoint regional tidak memengaruhi tempat sistem membuat bucket kemampuan observasi. Sistem menentukan lokasi bucket pengamatan menggunakan setelan default, kebijakan organisasi, dan kumpulan lokasi bucket yang didukung.