Ringkasan API

Halaman ini memberikan ringkasan singkat tentang Observability API dan Telemetry (OTLP) API.

Tentang Observability API

Observability API memungkinkan Anda melakukan hal berikut:

  • Mengonfigurasi setelan default untuk bucket kemampuan observasi untuk project, folder, dan organisasi. Setelan ini membantu Anda memenuhi persyaratan kepatuhan dan peraturan. Anda dapat mengonfigurasi hal berikut:

    • Lokasi penyimpanan default untuk bucket kemampuan observasi baru.
    • Untuk setiap lokasi, kunci Cloud Key Management Service default. Kunci tersebut digunakan untuk mengenkripsi bucket kemampuan observasi baru.

    Untuk mengetahui informasi selengkapnya, lihat Menetapkan default untuk bucket kemampuan observasi.

  • Mengonfigurasi cakupan kemampuan observasi untuk project Anda. Cakupan ini mengontrol resource mana yang ditelusuri oleh halaman Explorer untuk data log, metrik, dan rekaman aktivitas. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi cakupan kemampuan observasi.

  • Mencantumkan informasi tentang bucket kemampuan observasi di project Google Cloud Anda. Data rekaman aktivitas Anda disimpan dalam bucket kemampuan observasi. Untuk mengetahui informasi tentang model data, lihat Ringkasan penyimpanan.

  • Membuat link pada set data, yang memungkinkan BigQuery memiliki akses baca ke set data. Untuk mempelajari cara membuat set data tertaut, lihat Mengelola penyimpanan.

Dukungan Kontrol Layanan VPC

Layanan Observability API, yang nama layanannya adalah observability.googleapis.com, adalah layanan yang didukung Kontrol Layanan VPC. Untuk mengetahui informasi selengkapnya, lihat referensi berikut:

Endpoint Service

Endpoint layanan adalah URL dasar yang menentukan alamat jaringan layanan API. Observability API mendukung endpoint global dan endpoint regional:

  • Endpoint global: observability.googleapis.com.

    Anda dapat menggunakan endpoint layanan global untuk melakukan operasi apa pun yang didukung oleh Observability API. Selain itu, untuk endpoint ini, perintah daftar bucket kemampuan observasi memungkinkan Anda mengganti kolom lokasi dalam parameter jalur dengan karakter pengganti (-).

  • Endpoint regional: observability.REGION.rep.googleapis.com, dengan REGION adalah region yang didukung. Untuk mengetahui daftar endpoint, lihat Endpoint layanan regional.

    Anda hanya dapat menggunakan endpoint layanan regional jika lokasi yang diberikan dalam parameter jalur cocok dengan region endpoint. Perintah yang dikirim ke endpoint layanan ini akan gagal jika menyertakan karakter pengganti atau jika lokasi berbeda dengan region endpoint.

Referensi API

Tentang Telemetry API

Telemetry (OTLP) API adalah implementasi OpenTelemetry OTLP Protocol. Telemetry API menyediakan kompatibilitas dan dukungan untuk ekosistem OpenTelemetry open source:

  • Log: Telemetry API memungkinkan Anda memasukkan data log berformat OTLP ke project Anda. Untuk mengetahui informasi selengkapnya, lihat Ringkasan pemasukan OTLP.

  • Metrik: Telemetry API memungkinkan Anda memasukkan metrik berformat OTLP ke Cloud Monitoring menggunakan eksportir otlphttp dan OpenTelemetry Collector atau OpenTelemetry SDK. Untuk mengetahui informasi selengkapnya, lihat Ringkasan pemasukan OTLP.

  • Rekaman aktivitas: Telemetry API memungkinkan Anda mengirim data rekaman aktivitas berformat OTLP ke project Anda. Selain itu, batas rekaman aktivitas untuk Telemetry API sering kali lebih besar daripada batas untuk Cloud Trace API.

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 yang dapat memasukkan data log, metrik, atau rekaman aktivitas. Untuk mengetahui informasi selengkapnya tentang Kontrol Layanan VPC, 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, data akan dikirim 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, data akan dikirim ke layanan backend. Layanan ini akan 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.

Pemasukan data rekaman aktivitas dapat memicu pembuatan bucket kemampuan observasi. Namun, penggunaan endpoint regional tidak memengaruhi tempat sistem membuat bucket kemampuan observasi. Sistem menentukan lokasi bucket kemampuan observasi menggunakan setelan default, kebijakan organisasi, dan kumpulan lokasi bucket yang didukung.

Referensi API

Untuk mengetahui informasi selengkapnya tentang Telemetry API, lihat dokumen berikut: