Memilih pendekatan instrumentasi

Halaman ini berisi rekomendasi untuk melengkapi aplikasi Anda di berbagai Platform Google Cloud, seperti Google Kubernetes Engine (GKE) dan di Cloud Run. Jika aplikasi Anda belum diinstrumentasi, lalu gunakan rekomendasi ini sebagai panduan tentang cara melengkapi untuk mengirim data telemetri ke Google Cloud. Rekomendasi di halaman ini bukanlah satu-satunya solusi, dan pendekatan yang berbeda. Untuk panduan tambahan, hubungi Dukungan Google Cloud.

Ada rekomendasi untuk hal berikut:

Untuk informasi tentang contoh instrumentasi, lihat dokumen yang tercantum dalam Contoh kode.

GKE

Untuk informasi umum tentang GKE, lihat Ringkasan GKE.

Jenis Rekomendasi
Metrik

Sebaiknya gunakan Google Cloud Managed Service for Prometheus.

Untuk instrumentasi, lakukan salah satu hal berikut:

Trace

Lakukan tindakan berikut:

  1. Gunakan OpenTelemetry SDK dan pengekspor OTLP untuk bahasa Anda.
  2. Konfigurasi kolektor OpenTelemetry untuk mengirim rekaman aktivitas OTLP ke Google Cloud.
Log

Mengonfigurasi aplikasi Anda untuk menghasilkan output Log terstruktur JSON ke stdout dan stderr. Untuk daftar framework, lihat Framework logging yang direkomendasikan.

GKE mengumpulkan log yang ditulis ke stdout dan stderr secara otomatis. Untuk informasi selengkapnya, lihat Tentang log GKE.

Compute Engine

Untuk informasi umum tentang Compute Engine, lihat Instance virtual machine.

Jenis Rekomendasi
Metrik dan Trace

Lakukan tindakan berikut:

  1. Gunakan OpenTelemetry SDK dan pengekspor OTLP untuk bahasa Anda.
  2. Menggunakan Agen Operasional untuk mengumpulkan metrik dan trace. Sebagai contoh, lihat Kumpulkan Metrik dan trace OpenTelemetry Protocol (OTLP).

Atau, jika Anda hanya ingin mengonfigurasi pengumpulan untuk metrik format Prometheus, Anda dapat menggunakan Penerima Prometheus Agen Operasional untuk mengumpulkan metrik yang diinstrumentasikan menggunakan Library klien Prometheus atau OpenTelemetry SDK.

Log

Lakukan tindakan berikut:

  1. Konfigurasi aplikasi Anda untuk menghasilkan log terstruktur JSON ke sebuah file. Untuk daftar framework, lihat Framework logging yang direkomendasikan.
  2. Menginstal Agen Operasional dan mengonfigurasi penerima. Sebagai contoh, lihat Penerima logging.

Cloud Run

Untuk informasi umum tentang Cloud Run, lihat Apa itu Cloud Run.

Jenis Rekomendasi
Metrik dan Trace

Lakukan tindakan berikut:

  1. Gunakan OpenTelemetry SDK dan pengekspor OTLP untuk bahasa Anda.
  2. Konfigurasi file bantuan OpenTelemetry untuk mengumpulkan metrik dan trace. Untuk misalnya, lihat Tulis Metrik OTLP menggunakan file bantuan OpenTelemetry.
  3. Menyetel CPU agar selalu dialokasikan di Cloud Run. Karena Instrumentasi OpenTelemetry melakukan pemrosesan latar belakang, sebaiknya bahwa layanan Cloud Run berinstrumen menggunakan CPU yang selalu dialokasikan; untuk informasi selengkapnya, lihat Alokasi CPU (layanan).

Atau, jika Anda hanya ingin mengonfigurasi pengumpulan untuk metrik format Prometheus, Anda dapat menggunakan Prometheus file bantuan untuk Cloud Run guna mengumpulkan metrik yang diinstrumentasikan menggunakan Library klien Prometheus atau OpenTelemetry SDK.

Log

Mengonfigurasi aplikasi Anda untuk menghasilkan output Log terstruktur JSON ke stdout dan stderr. Untuk daftar framework, lihat Framework logging yang direkomendasikan.

Cloud Run mengumpulkan log yang ditulis ke stdout dan stderr secara otomatis. Untuk informasi selengkapnya, lihat Tulis log container.

Fungsi Cloud Run

Untuk informasi umum tentang fungsi Cloud Run, lihat Ringkasan fungsi Cloud Run.

Jenis Rekomendasi
Metrik Penulisan langsung metrik tidak didukung di fungsi Cloud Run. Kepada untuk menghasilkan metrik. Sebaiknya gunakan metrik berbasis log.
Trace Gunakan Pengekspor SDK dan Cloud Trace untuk bahasa.
Log

Mengonfigurasi aplikasi Anda untuk menghasilkan output Log terstruktur JSON ke stdout dan stderr. Untuk daftar framework, lihat Framework logging yang direkomendasikan.

Fungsi Cloud Run mengumpulkan log yang ditulis ke stdout dan stderr secara otomatis. Untuk informasi selengkapnya, lihat Melihat dan menulis log fungsi Cloud Run.

App Engine

Untuk informasi umum tentang App Engine, lihat Ringkasan App Engine.

Jenis Rekomendasi
Metrik Gunakan Pengekspor SDK dan Cloud Monitoring untuk bahasa.
Trace Gunakan Pengekspor SDK dan Cloud Trace untuk bahasa.
Log

Mengonfigurasi aplikasi Anda untuk menghasilkan output Log terstruktur JSON ke stdout dan stderr. Untuk daftar framework, lihat Framework logging yang direkomendasikan.

App Engine mengumpulkan log yang ditulis ke stdout dan stderr secara otomatis. Untuk informasi selengkapnya, lihat Menulis dan melihat log.

Framework logging yang direkomendasikan

Untuk mengumpulkan log, sebaiknya Anda menggunakan kerangka kerja yang dapat dikonfigurasi untuk menghasilkan output objek JSON serial ke stdout, stderr, atau ke . Agen pencatatan log, baik yang terintegrasi maupun terinstal, melakukan scraping file dan menulis log terstruktur untuk Cloud Logging. Untuk menulis data log, sebaiknya lakukan hal berikut:

Contoh kode

Untuk contoh kode yang menggambarkan cara menginstrumentasikan aplikasi Anda untuk mengirim telemetri ke Google Cloud, lihat data berikut:

Referensi ke OpenTelemetry

Bagian ini memberikan tautan ke OpenTelemetry SDK, dan pengekspor untuk OTLP, Cloud Trace, dan Cloud Monitoring.

Referensi umum:

Go

Java

JavaScript

Python