Dokumen ini menjelaskan Telemetry (OTLP) API, yang menerapkan OpenTelemetry OTLP Protocol. API ini dirancang untuk digunakan dengan aplikasi yang diinstrumentasi menggunakan salah satu SDK OpenTelemetry.
Alasan Anda harus menggunakan Telemetry API
Telemetry API mendukung penyerapan data rekaman aktivitas yang dalam format OTLP. Saat Anda menggunakan Telemetry API, data Anda disimpan dalam format OTLP tanpa pernah dikonversi ke format eksklusif, dan batas untuk Telemetry API berlaku. Batas ini sering kali lebih longgar daripada batas untuk Cloud Trace API. Terakhir, instrumentasi Anda tidak bergantung pada eksportir khusus Google Cloud.
OpenTelemetry adalah project open source yang didukung Google Clouddengan Google Cloud engineer yang ditugaskan untuk memastikan dukungan untuk menyerap dan memvisualisasikan data trace Anda.
Kapan harus menggunakan Telemetry API
Saat melakukan instrumentasi aplikasi untuk mengirim data rekaman aktivitas ke project Google Cloud, sebaiknya lakukan salah satu hal berikut:
- Gunakan eksportir yang menulis OTLP ke kolektor, 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 kolektor dengan konfigurasi ini.
Untuk mengetahui informasi tentang cara menggunakan Telemetry API, lihat Bermigrasi dari eksportir Cloud Trace ke endpoint OTLP.
Tempat melihat data yang ditransfer
Data rekaman aktivitas yang diserap melalui Telemetry API dapat dilihat menggunakan halaman Trace Explorer. Untuk mengetahui informasi tentang cara melihat data trace, lihat Menemukan dan menjelajahi trace.
Data rekaman aktivitas yang ditransfer melalui Telemetry API tidak tersedia untuk halaman Trace Explorer lama. Untuk mengetahui informasi selengkapnya, lihat Trace Explorer Lama: Masalah umum.
Dukungan Kontrol Layanan VPC
Layanan Telemetry API, yang nama layanannya adalah telemetry.googleapis.com,
adalah 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 layanan cloudtrace.googleapis.com,
yang juga dapat menyerap data rekaman aktivitas.
Untuk informasi selengkapnya, lihat referensi berikut: