Logging dan pemantauan untuk pemberitahuan Cloud Load Balancing

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

Logging

Bagian ini menjelaskan logging untuk panggilan Load Balancer Aplikasi.

Mengaktifkan logging di layanan backend

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

Untuk mengaktifkan logging untuk 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 berlaku 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 menggunakan permintaan log Cloud Logging.

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

Untuk mengetahui informasi selengkapnya, lihat halaman "Pantau dan pecahkan 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 rangkaian ekstensi.
failed_open boolean Jika konfigurasi ekstensi telah ditetapkan failOpen ke true, nilai true untuk metrik ini menunjukkan bahwa pemrosesan berlanjut saat ekstensi mengalami waktu tunggu 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 aliran gRPC. Untuk mengetahui 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 streaming gRPC.
per_processing_request_info[].event_type enum Jenis peristiwa ProcessingRequest. Dapat berupa salah satu dari berikut: 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 nilai berikut:

  • NONE: menunjukkan bahwa konten tidak diubah.
  • NONE_FAILED_OPEN: menunjukkan bahwa tidak ada mutasi yang dilakukan karena ekstensi gagal dibuka.
  • 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 dicatat.
  • 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 Ringkasan dasbor.

    Buka ringkasan Dasbor

  2. Di bagian Categories, klik GCP.
    • Untuk melihat daftar dasbor untuk semua load balancer, di daftar Dasbor GCP, 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 "Pantau dan pecahkan 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 promo.

Dalam Pratinjau, Anda dapat memantau metrik berikut untuk ekstensi pada Load Balancer Aplikasi eksternal regional, Load Balancer Aplikasi internal regional, dan Load Balancer Aplikasi internal lintas region. Metrik ini memiliki awalan networkservices.googleapis.com. Awalan ini dihilangkan dari entri dalam tabel berikut.

Tabel berikut memberikan 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
DELTAINT641
Jumlah pemanggilan yang dikirim ke ekstensi.
extension/invocation_latencies Latensi pemanggilan ekstensi
DELTADISTRIBUTIONms
Distribusi yang dihitung dari latensi setiap pemanggilan ekstensi.
extension/sent_chunks_count Jumlah chunk yang dikirim ekstensi
DELTAINT641
Hanya berlaku untuk peristiwa request_body dan response_body. Jumlah potongan data yang dikirim ke ekstensi.
extension/received_chunks_count Jumlah bagian yang diterima ekstensi
DELTAINT641
Hanya berlaku untuk peristiwa request_body dan response_body. Jumlah potongan yang diterima dari ekstensi.
extension/failed_open_count Kegagalan pemanggilan ekstensi dengan fail-open
DELTAINT641
Jumlah kegagalan pemanggilan saat sistem dikonfigurasi untuk fail-open dan permintaan diizinkan untuk dilanjutkan.
extension/mutation_rejections_count Jumlah penolakan mutasi ekstensi
DELTAINT641
Jumlah pemanggilan yang meminta mutasi header, isi, atau trailer, tetapi ditolak. Penolakan dapat terjadi karena berbagai alasan, seperti saat mutasi tidak valid atau melampaui batas ukuran.
extension/sent_bytes_count Jumlah byte yang dikirim ekstensi
DELTAINT64By
Jumlah byte yang dikirim ke ekstensi.
extension/received_bytes_count Jumlah byte yang diterima ekstensi
DELTAINT64By
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
DELTAINT641
Jumlah panggilan layanan backend callout dari Load Balancer Aplikasi.
https/backend_request_bytes_count,
https/external/regional/backend_request_bytes_count,
https/internal/backend_request_bytes_count
Byte permintaan backend
DELTAINT64By
Jumlah byte yang dikirim dari load balancer ke layanan backend panggilan.
https/backend_response_bytes_count,
https/external/regional/backend_response_bytes_count,
https/internal/backend_response_bytes_count
Byte respons backend
DELTAINT64By
Jumlah byte yang diterima oleh load balancer dari backend ekstensi.
https/backend_latencies,
https/external/regional/backend_latencies,
https/internal/backend_latencies
Latensi backend
DELTADISTRIBUTIONms
Distribusi yang dihitung dari jumlah latensi setiap pemanggilan ekstensi antara load balancer dan layanan backend callout. Dibuat sampelnya setiap 60 detik.

Langkah berikutnya