Dokumen ini menjelaskan Telemetry (OTLP) API, yang menerapkan OpenTelemetry OTLP Protocol. API ini dirancang untuk digunakan dengan aplikasi yang diinstrumentasikan 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 diberdayakan untuk memastikan dukungan untuk menyerap dan memvisualisasikan data rekaman aktivitas 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 diserap melalui halaman Trace Explorer lama Telemetry API. 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: