Menggunakan Telemetry API

Anda dapat mengonfigurasi Agen Operasional untuk menggunakan Telemetry (OTLP) API guna mengirim log, metrik, dan rekaman aktivitas ke project Google Cloud Anda. Telemetry API, telemetry.googleapis.com, adalah penerapan OpenTelemetry Protocol open source. Saat Anda mengonfigurasi Agen Operasi untuk menggunakan API ini, Agen Operasi akan mengirim telemetri menggunakan Telemetry API dan bukan Cloud Monitoring API, Logging API, atau Trace API eksklusif.

Jika Anda menggunakan Telemetry API di Agen Operasional dan memiliki diagram atau kebijakan pemberitahuan yang memantau penggunaan API, Anda harus memperbarui artefak ini untuk memantau endpoint telemetry.googleapis.com, bukan endpoint monitoring.googleapis.com, logging.googleapis.com, atau endpoint cloudtrace.googleapis.com.

Sebelum memulai

Untuk menggunakan Telemetry API, lakukan hal berikut:

  1. Aktifkan Telemetry API di project Google Cloud Anda, jika belum diaktifkan. Anda dapat mengaktifkan API dengan menjalankan perintah berikut:

    gcloud services enable telemetry.googleapis.com

  2. Sesuaikan kuota Telemetry API, jika nilai default tidak mencukupi. Telemetry API memiliki kuota yang terpisah dari kuota Cloud Monitoring API dan Cloud Logging API. Untuk mengetahui informasi tentang kuota dan batas Telemetry API, lihat bagian berikut:

    Anda mungkin perlu menyesuaikan kuota ini untuk mengakomodasi volume data telemetri yang Anda serap.

  3. Jika Anda mengumpulkan trace, berikan peran Cloud Telemetry Traces Writer (roles/telemetry.tracesWriter) ke akun layanan yang digunakan oleh Agen Operasional. Peran ini memberikan izin yang diperlukan untuk menulis rekaman aktivitas.

Mengonfigurasi Agen Operasional untuk menggunakan Telemetry API

Agen Operasional menyediakan opsi konfigurasi untuk beralih antara pengiriman telemetri menggunakan API eksklusif—default—dan menggunakan Telemetry API. Untuk mengumpulkan telemetri menggunakan Agen Operasional dan Telemetry API, Anda harus melakukan hal berikut, seperti yang dijelaskan di bagian berikut:

  1. Instal Agen Operasional versi yang mendukung Telemetry API.
  2. Perbarui file config.yaml Agen Operasional untuk menyetel opsi konfigurasi.
  3. Mulai ulang Agen Operasi untuk menerapkan perubahan.

Gunakan Agen Operasional versi 2.71.0 atau yang lebih baru

Untuk menggunakan Telemetry API dengan Agen Operasional, Anda harus menginstal Agen Operasional versi 2.71.0 atau yang lebih baru. Untuk mengetahui informasi tentang cara menginstal Agen Operasional, lihat Menginstal Agen Operasional di masing-masing VM.

Menetapkan opsi konfigurasi

Beri Agen Operasional akses ke Telemetry API dengan menyetel opsi konfigurasi otlp_exporter ke true di file config.yaml agen:

global:
   otlp_exporter: true

Mulai ulang Agen Operasional

Linux

  1. Untuk memulai ulang agen, jalankan perintah berikut di instance Anda: 
    sudo systemctl restart google-cloud-ops-agent
  2. Untuk mengonfirmasi bahwa agen telah dimulai ulang, jalankan perintah berikut dan pastikan komponen "Metrics Agent" dan "Logging Agent" telah dimulai: 
    sudo systemctl status "google-cloud-ops-agent*"

Windows

  1. Hubungkan ke instance Anda menggunakan RDP atau alat serupa dan login ke Windows.
  2. Buka terminal PowerShell dengan hak istimewa administrator dengan mengklik kanan ikon PowerShell dan memilih Run as Administrator
  3. Untuk memulai ulang agen, jalankan perintah PowerShell berikut: 
    Restart-Service google-cloud-ops-agent -Force
  4. Untuk mengonfirmasi bahwa agen telah dimulai ulang, jalankan perintah berikut dan pastikan komponen "Metrics Agent" dan "Logging Agent" telah dimulai: 
    Get-Service google-cloud-ops-agent*

Mengonfigurasi Agen Operasional agar tidak menggunakan Telemetry API

Untuk menghentikan Agen Operasional mengumpulkan telemetri menggunakan Telemetry API dan melanjutkan pengumpulan telemetri menggunakan Cloud Monitoring API, Logging API, dan Trace API, lakukan hal berikut:

  1. Hapus opsi otlp_exporter dari file config.yaml. Atau, Anda dapat menyetel opsi ke false.

  2. Mulai ulang Agen Operasi untuk menerapkan perubahan.

Langkah berikutnya