Logging dan pemantauan bidang kontrol

Dokumen ini menunjukkan cara menggunakan Cloud Logging dan Cloud Monitoring untuk melihat log dan metrik untuk Bidang kontrol Cloud Service Mesh.

Dengan menggunakan mesh layanan, Anda dapat mengamati traffic ke dan dari yang memungkinkan pemantauan dan proses debug yang lebih kaya tanpa perubahan kode dalam layanan itu sendiri. Entri log dapat memberikan informasi penting bagi memecahkan masalah mesh layanan Anda, termasuk catatan koneksi yang berhasil dan pemutusan koneksi, laporan error untuk klien yang salah dikonfigurasi, serta peringatan lebih lanjut mengenai konflik resource API.

Kasus penggunaan

Berikut adalah tiga kasus penggunaan untuk logging dan pemantauan bidang kontrol:

  • Bidang kontrol Cloud Logging untuk Cloud Service Mesh: Anda dapat menyimpan, menelusuri, menganalisis, dan menetapkan pemberitahuan dengan aman di semua Cloud Service Mesh mencatat data dan peristiwa menggunakan semua fitur bawaan dari Pembuatan Log. Cloud Service Mesh mengekspor log ke Logging saat klien Envoy atau gRPC terhubung atau terputus, serta saat mendeteksi masalah konfigurasi.
  • Bidang kontrol Cloud Monitoring untuk Cloud Service Mesh: Cloud Service Mesh mengekspor metrik utama yang menunjukkan jumlah klien yang terhubung ke bidang kontrol Cloud Service Mesh ke Monitoring. Anda dapat menyiapkan dasbor di Monitoring dan memvisualisasikannya secara real time untuk memantau kondisi mesh saat klien terhubung dan memutuskan koneksi. Tindakan ini juga memungkinkan Anda menyiapkan SLO untuk mesh Anda.
  • Segera pecahkan masalah: Cloud Service Mesh mengekspor telemetri ke Logging dan Pemantauan secara default. Tidak diperlukan penyiapan tambahan untuk mengonfigurasi logging dan pemantauan, memungkinkan Anda untuk memecahkan masalah kapan saja termasuk saat pertama kali menyiapkan {i>mesh<i}.

Lihat log

Untuk melihat log Cloud Service Mesh, gunakan Logs Explorer. Hal berikut menampilkan contoh kueri untuk melihat log Cloud Service Mesh, tetapi Anda juga dapat gunakan tautan sebelumnya untuk membuat kueri Anda sendiri.

  1. Di Konsol Google Cloud, buka halaman Logs Explorer.

    Buka Logs Explorer

  2. Dalam daftar Resource,
    • Jika Anda menggunakan API pemilihan rute layanan, pilih Gateway Scope atau Mesh.
    • Jika Anda menggunakan API yang lebih lama, pilih GCE Network.
  3. Di daftar Log name, pilih trafficdirector.googleapis.com/events.
  4. Klik Run query.

Kolom entri log Cloud Service Mesh

Kolom Deskripsi
node_id ID node xDS-client, seperti yang diberikan oleh xDS-client.
client_type Jenis klien xDS yang terhubung ke Cloud Service Mesh. Nilai yang mungkin:
  • ENVOY
  • GRPC-JAVA
  • GRPC-C++
  • GRPC-PYTHON
  • GRPC-GO
  • UNKNOWN
node_ip Alamat IP node sebagaimana disediakan oleh klien.
api_version Versi xDS API yang digunakan oleh klien xDS untuk terhubung ke Cloud Service Mesh. Nilai yang mungkin adalah V2 dan V3.
description Teks deskripsi acara dengan detail tambahan.

Contoh entri log

Contoh entri log Deskripsi
"Cloud Service Mesh tidak dapat menemukan konfigurasi apa pun untuk klien xDS." Log ini dibuat saat klien xDS ditolak oleh Cloud Service Mesh karena tidak ada konfigurasi. Hal ini mungkin disebabkan oleh tidak lengkap dari resource API yang relevan dengan Cloud Service Mesh.
"Klien telah berhasil terhubung." Jenis pesan log ini dihasilkan setiap kali klien terhubung ke Cloud Service Mesh.
"Klien berhasil terputus." Jenis pesan log ini dibuat setiap kali terputus dari Cloud Service Mesh.
"Variabel metadata TRAFFICDIRECTOR_INTERCEPTION_PORT tidak ditetapkan. Konfigurasi {i>routing<i} untuk pemroses intersepsi ada, tetapi akan diabaikan". Jenis pesan log ini dibuat saat resource Cloud Service Mesh dikonfigurasi dengan benar, tetapi TRAFFICDIRECTOR_INTERCEPTION_PORT variabel ini belum ditetapkan di metadata node klien xDS, jadi konfigurasi tidak dapat ditambahkan ke klien.
"Pemroses intersepsi dibangun pada porta 15001 yang diberikan, tetapi perutean tidak ada konfigurasi untuknya." Jenis pesan log ini dibuat saat Variabel TRAFFICDIRECTOR_INTERCEPTION_PORT ditetapkan di xDS-client metadata node, tetapi tidak ada resource yang dikonfigurasi untuk Cloud Service Mesh membuat respons xDS lengkap.
"Gagal mengirim respons ADS dari Cloud Service Mesh. Penemuan terakhir dari {i>node<i} memiliki versi dan/atau nonce yang salah." Jenis pesan log ini dibuat saat Cloud Service Mesh dapat tidak memproses respons xDS dengan benar karena komunikasi yang rusak dari klien xDS. Pesan ini menunjukkan error penerapan di dengan klien besar. Sebaiknya periksa log klien.
"Klien mengirim traffic lintas region ke layanan backend backend_service_id. Wilayah sumber: source_region Wilayah tujuan: destination_region1, destination_region2" Jenis pesan log ini dibuat ketika klien melaporkan Cloud Service Mesh yang mengirim traffic lintas region dari region sumber ke satu atau beberapa region tujuan.

Lihat metrik

Cloud Service Mesh mengekspor tiga metrik ke Cloud Monitoring: xDS API Connected Streams, Request count, dan Request count by zona. xDS API Connected Streams menunjukkan jumlah klien yang terhubung ke bidang kontrol Anda; Request count menunjukkan jumlah permintaan yang dikirim ke layanan backend, dikelompokkan berdasarkan region sumber, tujuan wilayah, dan status permintaan. Request count by zone menunjukkan jumlah permintaan yang dikirim ke layanan backend, yang dikelompokkan berdasarkan zona sumber, tujuan zona waktu, dan status permintaan. Untuk melihat metrik tersebut, gunakan Metrics Explorer.

Untuk melihat metrik Cloud Service Mesh, lakukan hal berikut:

  1. Di Konsol Google Cloud, buka halaman Metrics Explorer.

    Buka Metrics Explorer

  2. Di daftar Resource type, pilih resource.
    • Jika Anda menggunakan API pemilihan rute layanan, pilih Gateway Scope atau Mesh.
    • Jika Anda menggunakan API yang lebih lama, pilih Network.
  3. Dalam daftar Metrik, pilih connected_clients.
  4. Kembali ke daftar Resource type, lalu pilih Compute Engine Backend Service.
  5. Dalam daftar Metrik, pilih Request count atau Request count by zone.

Atau, Anda dapat menggunakan kueri untuk melihat jumlah permintaan lintas region:

  1. Pilih MQL.
  2. Di kolom tersebut, masukkan contoh kueri berikut: 
    fetch gce_backend_service
| metric 'trafficdirector.googleapis.com/xds/server/request_count'
| filter ( ne(metric.source_region, metric.destination_region))
| align rate(1m)
| every 1m
| group_by [metric.source_region, metric.destination_region, resource.backend_service_id],
[value_request_count_aggregate: aggregate(value.request_count)]
  3. Klik Run query.

Menyiapkan pemberitahuan dan metrik berbasis log

Langkah-langkah berikut mengharuskan Anda menyiapkan metrik berbasis log. Untuk selengkapnya tentang cara menyiapkan metrik berbasis log, lihat ringkasan.

Anda dapat mengonfigurasi pemberitahuan yang akan memberi tahu Anda saat pesan yang ditentukan pengguna muncul di log yang Anda sertakan. Peringatan ini dapat memberi tahu operator ketika sesuatu tidak terduga terjadi. Misalnya, jika perubahan pada konfigurasi Cloud Service Mesh mengakibatkan konflik resource API, Anda dapat menerima pemberitahuan tentang error tersebut untuk membuat pesan email baru. Untuk menyiapkan pemberitahuan pada metrik berbasis log, lihat Konfigurasi diagram dan pemberitahuan.