Dokumen ini menjelaskan alasan kami merekomendasikan agar Anda mengirim data rekaman aktivitas ke projectGoogle Cloud menggunakan Telemetry (OTLP) API, yang menerapkan OpenTelemetry OTLP Protocol. Panduan ini juga memberikan petunjuk tentang cara menginstrumentasi aplikasi Anda dan tempat Anda dapat melihat data rekaman aktivitas. Anda dapat menggunakan Telemetry API saat menginstrumentasi aplikasi menggunakan salah satu SDK OpenTelemetry atau saat menggunakan OpenTelemetry Collector.
Kami merekomendasikan Telemetry API karena alasan berikut:
API ini memberikan kompatibilitas dengan ekosistem OpenTelemetry open source dan batasnya sering kali lebih besar daripada batas Cloud Trace API, yang merupakan API Google Cloud berpemilik
Data rekaman aktivitas Anda disimpan dalam format yang umumnya konsisten dengan file proto yang ditentukan oleh Protokol OTLP OpenTelemetry. Beberapa kolom mungkin dikonversi dari jenis data khusus OpenTelemetry ke jenis data JSON sebelum penyimpanan. Untuk mempelajari format penyimpanan lebih lanjut, lihat Skema untuk data rekaman aktivitas.
Pengukuran Anda tidak bergantung pada eksportir khusus Google Cloud.
Beberapa fitur, seperti Pemantauan Aplikasi, mengandalkan informasi yang hanya tersedia saat Anda mengirim data rekaman aktivitas ke Telemetry API.
OpenTelemetry adalah project open source yang didukung Google Cloud-dengan staf engineer yang memastikan dukungan untuk penyerapan dan visualisasi telemetri Anda. Google Cloud
Praktik terbaik
Saat menginstrumentasi aplikasi untuk mengirim data rekaman aktivitas ke Google Cloud project, sebaiknya lakukan salah satu hal berikut:
- Gunakan eksportir yang menulis OTLP ke Collector, yang kemudian mengirim data rekaman aktivitas Anda ke Telemetry API.
- Gunakan eksportir OTLP dalam proses yang didukung oleh library OpenTelemetry yang mengirim telemetri ke Telemetry API. Tidak ada pengumpul dengan konfigurasi ini.
Untuk mengetahui informasi tentang cara menggunakan Telemetry API, lihat Bermigrasi dari eksportir Cloud Trace ke endpoint OTLP.
Autentikasi
Anda harus mengonfigurasi pengekspor dengan kredensial yang diperlukan untuk mengirim data aktivitas ke project Google Cloud Anda. Misalnya, untuk mengonfigurasi eksportir dengan Google Cloud Kredensial Default Aplikasi (ADC), tambahkan Google Auth Library khusus bahasa ke aplikasi Anda. Untuk mengetahui informasi selengkapnya dan kode contoh, lihat Mengonfigurasi autentikasi.
Cloud Trace dan residensi data
Jika Anda menggunakan Assured Workloads karena Anda memiliki persyaratan residensi data atau Tingkat Dampak 4 (IL4), jangan gunakan Telemetry API untuk mengirim rentang aktivitas ke project Anda.
Tempat melihat data yang diserap
Anda dapat melihat data rekaman aktivitas menggunakan halaman Trace Explorer dan Log Analytics. Untuk mengetahui informasi, lihat referensi berikut: