Logging dan pemantauan untuk pemberitahuan Cloud Load Balancing

Halaman ini menunjukkan cara mengonfigurasi dan menggunakan Cloud Logging dan Cloud Monitoring dengan info Ekstensi Layanan untuk Cloud Load Balancing.

Logging

Bagian ini menjelaskan logging untuk info Load Balancer Aplikasi.

Mengaktifkan logging di layanan backend

Anda dapat mengaktifkan logging untuk info Load Balancer Aplikasi saat membuat layanan dengan mengaktifkan logging pada layanan backend yang menjadi target permintaan (dan bukan pada layanan backend yang terkait dengan ekstensi).

Untuk mengaktifkan logging bagi layanan backend target, gunakan perintah gcloud compute backend-services update.

gcloud compute backend-services update BACKEND_SERVICE \
    --enable-logging \
    --logging-sample-rate=RATE \
    --region=REGION \
    --logging-optional=LOGGING_OPTIONAL_MODE \
    --logging-optional-fields=OPTIONAL_FIELDS

Ganti kode berikut:

  • BACKEND_SERVICE: nama layanan backend
  • RATE: nilai dari 0.0 hingga 1.0, dengan 0.0 berarti tidak ada permintaan yang di-log dan 1.0 berarti 100% permintaan di-log. Nilai defaultnya adalah 1.0. Setelan ini hanya efektif jika digunakan dengan parameter enable-logging. Jika Anda menghilangkan enable-logging, logging akan dinonaktifkan.
  • REGION: region backend
  • LOGGING_OPTIONAL_MODE: mengaktifkan logging untuk kolom opsional dalam salah satu mode berikut:

    • INCLUDE_ALL_OPTIONAL menyertakan semua kolom opsional.
    • EXCLUDE_ALL_OPTIONAL (default) mengecualikan semua kolom opsional.
    • CUSTOM menyertakan daftar kustom kolom opsional.
  • OPTIONAL_FIELDS: daftar kolom opsional yang dipisahkan koma saat Anda memilih mode CUSTOM

Setelah Anda mengaktifkan logging di layanan backend, permintaan HTTP atau HTTPS akan dicatat ke dalam log menggunakan permintaan log Cloud Logging.

Untuk melihat log, di konsol Google Cloud , buka halaman Logs Explorer.

Untuk mengetahui informasi selengkapnya, lihat halaman "Memantau dan memecahkan masalah" dalam dokumentasi Load Balancer Aplikasi, seperti Logging dan pemantauan Load Balancer Aplikasi Internal.

Pesan log untuk layanan backend

Secara umum, entri log Load Balancer Aplikasi berisi informasi yang berguna untuk memantau dan men-debug traffic HTTP atau HTTPS Anda. Entri log berisi jenis informasi berikut:

  • Informasi yang ditampilkan di sebagian besar log Google Cloud , seperti tingkat keparahan, project ID, nomor project, dan stempel waktu seperti yang dijelaskan dalam log LogEntry.
  • Kolom log HttpRequest.

Log permintaan untuk load balancer HTTP dan HTTPS berisi objek service_extension_info dalam payload JSON entri log load balancer dengan informasi berikut:

Kolom Jenis Deskripsi
backend_target_name string Nama target backend ekstensi.
backend_target_type string Jenis target backend.
chain string Nama rantai ekstensi dalam resource ekstensi layanan yang cocok dengan permintaan.
extension string Nama ekstensi dalam rantai ekstensi.
failed_open boolean Jika konfigurasi ekstensi memiliki failOpen yang ditetapkan ke true, nilai true untuk metrik ini menunjukkan bahwa pemrosesan dilanjutkan saat waktu tunggu ekstensi habis atau gagal.

Hanya berlaku untuk Load Balancer Aplikasi eksternal regional, Load Balancer Aplikasi internal regional, dan Load Balancer Aplikasi internal lintas region.

grpc_status enum Status terbaru di streaming gRPC. Untuk informasi selengkapnya, lihat kode status gRPC.
per_processing_request_info array Daftar statistik ProcessingRequest untuk ekstensi ext_proc atau statistik CheckRequest untuk ekstensi ext_authz yang terjadi melalui aliran gRPC.
per_processing_request_info[].event_type enum Jenis peristiwa ProcessingRequest. Dapat berupa salah satu dari berikut ini: REQUEST_HEADERS, REQUEST_BODY, RESPONSE_HEADERS, atau RESPONSE_BODY.
per_processing_request_info[].latency durasi Durasi dari saat byte pertama pesan ProcessingRequest dikirim ke ekstensi hingga saat byte terakhir pesan ProcessingResponse diterima.
per_processing_request_info[].processing_effect enum Hasil pemrosesan untuk setiap peristiwa dalam permintaan pemrosesan.

Hanya berlaku untuk Load Balancer Aplikasi eksternal regional, Load Balancer Aplikasi internal regional, dan Load Balancer Aplikasi internal lintas region.

Dapat berupa salah satu dari nilai berikut ini:

  • NONE: menunjukkan bahwa konten tidak diubah.
  • NONE_FAILED_OPEN: menunjukkan bahwa tidak ada mutasi yang dilakukan karena ekstensi gagal terbuka.
  • CONTENT_MODIFIED: menunjukkan bahwa konten diubah oleh permintaan mutasi yang berhasil diterapkan.
  • IMMEDIATE_RESPONSE: menunjukkan bahwa respons langsung dikirim oleh ekstensi untuk menghentikan semua pemrosesan lebih lanjut.
  • MUTATION_REJECTED: menunjukkan bahwa ekstensi meminta setidaknya satu perubahan yang tidak diizinkan dan pemrosesan lebih lanjut dihentikan. Pesan error yang sesuai akan dicatat ke dalam log.
  • UNSPECIFIED: menunjukkan bahwa efek pemrosesan tidak diketahui.
per_processing_request_info[].processing_effect_details string Jika processing_effect adalah MUTATION_REJECTED, detail tentang alasan mutasi ditolak.

Hanya berlaku untuk Load Balancer Aplikasi eksternal regional, Load Balancer Aplikasi internal regional, dan Load Balancer Aplikasi internal lintas region.

resource string Nama resource ekstensi

Pemantauan

Bagian ini menjelaskan cara memantau info yang dikonfigurasi menggunakan Service Extensions untuk Cloud Load Balancing.

Melihat dasbor Monitoring

Load Balancer Aplikasi mengekspor data pemantauan ke Cloud Monitoring.

Gunakan metrik Monitoring untuk tujuan berikut:

  • Mengevaluasi konfigurasi, penggunaan, dan performa load balancer
  • Memecahkan masalah
  • Meningkatkan pemanfaatan resource dan pengalaman pengguna

Untuk melihat dasbor standar, ikuti langkah-langkah berikut:

  1. Di konsol Google Cloud , buka halaman Dashboards overview.

    Buka Dashboards overview

  2. Di bagian Categories, klik GCP.
    • Untuk melihat daftar dasbor untuk semua load balancer Anda, di daftar GCP Dashboards, klik dasbor bernama Google Cloud Load Balancers. Untuk melihat dasbor load balancer tertentu, temukan load balancer dalam daftar, lalu klik namanya.
    • Untuk melihat dasbor standar hanya untuk load balancer Anda, pilih dasbor yang sesuai.

Selain dasbor standar di Monitoring, Anda dapat membuat dasbor kustom, menyiapkan pemberitahuan, dan membuat kueri metrik melalui Cloud Monitoring API.

Untuk mengetahui informasi selengkapnya, lihat halaman "Memantau dan memecahkan masalah" dalam dokumentasi Load Balancer Aplikasi, seperti Logging dan pemantauan Load Balancer Aplikasi Internal.

Memantau metrik untuk info

Anda dapat memantau metrik berikut untuk layanan backend info.

Dalam Pratinjau, Anda dapat memantau metrik berikut untuk ekstensi di semua jenis Load Balancer Aplikasi. Metrik ini memiliki awalan networkservices.googleapis.com. Awalan dihilangkan dari entri dalam tabel berikut.

Tabel berikut menyediakan jenis metrik, nama tampilan, jenis, tipe, unit, dan deskripsi untuk setiap metrik.

Jenis metrik Nama tampilan
Jenis, Tipe, Unit
Deskripsi
extension/invocation_count Jumlah pemanggilan ekstensi
DELTA, INT64, 1
Jumlah pemanggilan yang dikirim ke ekstensi.
extension/invocation_latencies Latensi pemanggilan ekstensi
DELTA, DISTRIBUTION, ms
Distribusi yang dihitung dari latensi setiap pemanggilan ekstensi. Hanya berlaku untuk ekstensi info; tidak didukung untuk plugin.
extension/sent_chunks_count Jumlah potongan yang dikirim ekstensi
DELTA, INT64, 1
Hanya berlaku untuk peristiwa request_body dan response_body. Jumlah potongan data yang dikirim ke ekstensi.
extension/received_chunks_count Jumlah potongan yang diterima ekstensi
DELTA, INT64, 1
Hanya berlaku untuk peristiwa request_body dan response_body. Jumlah potongan yang diterima dari ekstensi.
extension/failed_open_count Pemanggilan ekstensi gagal dengan fail-open
DELTA, INT64, 1
Frekuensi kegagalan pemanggilan saat sistem dikonfigurasi untuk fail-open dan permintaan diizinkan untuk dilanjutkan.
extension/mutation_rejections_count Jumlah penolakan mutasi ekstensi
DELTA, INT64, 1
Jumlah pemanggilan yang meminta mutasi header, isi, atau trailer, tetapi ditolak. Penolakan dapat terjadi karena berbagai alasan, seperti saat mutasi tidak valid atau melebihi batas ukuran.
extension/sent_bytes_count Jumlah byte yang dikirim ekstensi
DELTA, INT64, By
Jumlah byte yang dikirim ke ekstensi.
extension/received_bytes_count Jumlah byte yang diterima ekstensi
DELTA, INT64, By
Jumlah byte yang diterima dari ekstensi.

Anda juga dapat memantau metrik berikut. Metrik ini memiliki awalan loadbalancing.googleapis.com/. Awalan dihilangkan dari entri dalam tabel.

Jenis metrik Nama tampilan
Jenis, Tipe, Unit
Deskripsi
https/backend_request_count,
https/external/regional/backend_request_count,
https/internal/backend_request_count
Jumlah permintaan backend
DELTA, INT64, 1
Frekuensi layanan backend info tambahan dipanggil dari Load Balancer Aplikasi.
https/backend_request_bytes_count,
https/external/regional/backend_request_bytes_count,
https/internal/backend_request_bytes_count
Backend request bytes
DELTA, INT64, By
Jumlah byte yang dikirim dari load balancer ke layanan backend info.
https/backend_response_bytes_count,
https/external/regional/backend_response_bytes_count,
https/internal/backend_response_bytes_count
Byte respons backend
DELTA, INT64, By
Jumlah byte yang diterima oleh load balancer dari backend ekstensi.
https/backend_latencies,
https/external/regional/backend_latencies,
https/internal/backend_latencies
Latensi backend
DELTA, DISTRIBUTION, ms
Distribusi yang dihitung dari jumlah latensi setiap pemanggilan ekstensi antara load balancer dan layanan backend info. Dibuat sampelnya setiap 60 detik.

Langkah berikutnya