Logging dan pemantauan untuk pemberitahuan Cloud Load Balancing

Halaman ini menunjukkan cara mengonfigurasi dan menggunakan Cloud Logging dan Cloud Monitoring dengan callout Service Extensions untuk Cloud Load Balancing.

Logging

Bagian ini menjelaskan logging untuk callout Load Balancer Aplikasi.

Mengaktifkan logging di layanan backend

Anda dapat mengaktifkan logging untuk callout Load Balancer Aplikasi saat membuat layanan dengan mengaktifkan logging di layanan backend yang merupakan 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 command.

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, di mana 0.0 berarti tidak ada permintaan yang dicatat dan 1.0 berarti 100% permintaan dicatat. Nilai defaultnya adalah 1.0. Setelan ini hanya berlaku jika digunakan dengan parameter enable-logging. Jika Anda menghapus 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 Cloud Logging permintaan log.

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

Untuk mengetahui informasi selengkapnya, lihat halaman "Memantau dan memecahkan masalah" di 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 Google Cloud log, seperti tingkat keparahan, ID project, nomor project, dan stempel waktu seperti yang dijelaskan dalam LogEntry.
  • 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 ekstensi mengalami error waktu tunggu 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 aliran 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 sejak byte pertama pesan ProcessingRequest dikirim ke ekstensi hingga 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 akan 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 dititolak.

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 callout 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 Google Cloud konsol, buka halaman Ringkasan dasbor.

    Buka Ringkasan dasbor

  2. Di bagian Kategori, 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 dan 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" di dokumentasi Load Balancer Aplikasi, seperti Logging dan pemantauan Load Balancer Aplikasi internal.

Metrik pemantauan untuk callout

Anda dapat memantau metrik berikut untuk layanan backend callout.

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 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
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.
extension/sent_chunks_count Jumlah chunk yang dikirim ekstensi
DELTA, INT64, 1
Hanya berlaku untuk peristiwa request_body dan response_body. Jumlah chunk data yang dikirim ke ekstensi.
extension/received_chunks_count Jumlah chunk yang diterima ekstensi
DELTA, INT64, 1
Hanya berlaku untuk peristiwa request_body dan response_body. Jumlah chunk yang diterima dari ekstensi.
extension/failed_open_count Jumlah pemanggilan ekstensi yang gagal dengan fail-open
DELTA, INT64, 1
Jumlah pemanggilan yang gagal 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
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
DELTA, INT64, By
Jumlah byte yang dikirim dari load balancer ke layanan backend callout.
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 callout. Dibuat sampelnya setiap 60 detik.

Langkah berikutnya