Memecahkan masalah kueri kumpulan baca

Untuk menyelidiki dan men-debug kueri yang dirutekan AlloyDB untuk PostgreSQL ke instance kumpulan baca, Anda dapat menggunakan teknik diagnostik berikut:

  • Melihat daftar mendetail node penyusun kumpulan baca, termasuk alamat IP-nya.
  • Terhubung langsung ke node kumpulan baca individual untuk proses debug.
  • Periksa log AlloyDB untuk mengidentifikasi node mana yang menangani kueri tertentu.
  • Membuat kueri log untuk semua aktivitas terbaru dari node kumpulan baca tertentu.
  • Melihat metrik Google Cloud yang terkait dengan node kumpulan baca.

Jika digunakan bersama, teknik ini memberi Anda akses diagnostik dan proses debug ke kumpulan baca. Misalnya, jika salah satu kumpulan baca cluster Anda menggunakan jumlah CPU yang tidak biasa saat memproses kueri yang berjalan lama, teknik ini memungkinkan Anda menentukan node mana yang menangani kueri tersebut, lalu terhubung langsung ke node tersebut untuk memeriksa atau menghentikan kueri lebih lanjut.

Mencantumkan detail node kumpulan baca

Dalam penggunaan AlloyDB normal, Anda tidak perlu mengetahui identitas atau alamat node yang membentuk kumpulan baca Anda. Namun, jika perlu, Anda dapat melihat daftar node instance kumpulan baca. Setiap node yang tercantum menyertakan informasi berikut yang berguna untuk diagnostik dan proses debug berikutnya:

Untuk melihat string ID internal dan alamat IP node kumpulan baca, ikuti petunjuk khusus gcloud di Melihat detail instance, tetapi tambahkan argumen command line --view=FULL tambahan:

gcloud

gcloud alloydb instances describe READ_POOL_ID \
 --region=REGION_ID \
 --cluster=CLUSTER_ID \
 --project=PROJECT_ID \
 --view=FULL

Ganti kode berikut:

  • READ_POOL_ID: ID pool baca.
  • REGION_ID: ID wilayah instance.
  • CLUSTER_ID: ID cluster instance.
  • PROJECT_ID: ID project instance.

Output-nya mencakup bagian berlabel nodes, yang terlihat seperti ini:

nodes:
- id: READ_POOL_INSTANCE_ID-edd4f6ed-hcfh
  ip: 10.90.80.57
  state: HEALTHY
  zoneId: us-central1-b
- id: READ_POOL_INSTANCE_ID-edd4f6ed-ldbm
  ip: 10.90.80.56
  state: HEALTHY
  zoneId: us-central1-c

Kolom id dan ip untuk setiap entri sangat relevan dengan teknik lain yang dijelaskan di halaman ini:

  • Kolom ip menampilkan alamat IP node dalam jaringan VPC cluster.

  • Kolom id berisi string ID Google Cloud lengkap node. Hanya empat karakter terakhir dari string ini yang muncul di entri log untuk sebuah node.

    Misalnya, untuk menemukan entri log yang melibatkan node pertama dari dua node dalam contoh output sebelumnya, buat kueri log menggunakan string ID hcfh.

Terhubung langsung ke node

Setelah mengetahui alamat IP node, Anda dapat terhubung langsung ke server PostgreSQL-nya. Misalnya, untuk menggunakan psql agar terhubung ke VM di jaringan VPC cluster Anda, ikuti petunjuk di Menjalankan klien psql. Saat melakukannya, berikan alamat IP node, bukan alamat IP instance kumpulan baca:

psql -h NODE_IP_ADDRESS -U USERNAME

Menemukan aktivitas node di log

AlloyDB menyertakan ID node dalam entri log tentang kueri yang ditangani oleh kumpulan baca. Secara umum, Anda dapat menggunakan ID yang ditemukan ini dengan dua cara:

  • Tentukan IP node tersebut agar Anda dapat terhubung ke node tersebut.
  • Lakukan kueri log lebih lanjut untuk mempelajari lebih lanjut aktivitas terbaru node.

Menentukan node yang menangani kueri yang diketahui

Jika Anda mengetahui bahwa kumpulan baca tertentu sedang memproses kueri yang berjalan lama, Anda dapat menggunakan Logs Explorer untuk menentukan ID node tertentu yang menangani kueri tersebut.

Perhatikan bahwa teknik ini hanya berfungsi pada instance kumpulan baca yang telah mengaktifkan ekstensi pgAudit.

  1. Buka Logs Explorer:

    Buka Logs Explorer

  2. Di pembuat kueri, tambahkan resource.labels.instance_id="READ_POOL_ID" ke kolom editor kueri, dengan mengganti READ_POOL_ID dengan nama instance pool baca Anda.

  3. Tambahkan pernyataan SQL yang sedang Anda selidiki, secara keseluruhan atau sebagian, ke kolom editor kueri. Misalnya: select id from MyTable. Input ini tidak peka huruf besar/kecil.

  4. Klik Run query.

  5. Gunakan kontrol Logs Explorer untuk menyesuaikan dan menjalankan ulang kueri sesuai kebutuhan guna memfilter hasil hingga yang paling relevan.

  6. Klik entri log dalam daftar hasil untuk meluaskan tampilannya.

  7. Klik kolom labels di tampilan entri yang diperluas.

  8. Catat nilai NODE_ID di bagian labels.

Hasilnya adalah ID empat karakter dari node yang menangani kueri.

Menghubungkan ke node yang disebutkan dalam entri log

Jika Anda ingin terhubung langsung ke server PostgreSQL node tertentu berdasarkan aktivitas yang dicatat, ikuti langkah-langkah berikut:

  1. Catat string ID empat karakter node yang dicatat dalam log. Anda dapat menemukan ID ini di kolom NODE_ID entri log.

  2. Cantumkan node untuk kumpulan baca.

  3. Dalam daftar tersebut, temukan node dengan string ID yang diakhiri dengan empat karakter yang Anda catat di langkah pertama. Mungkin tidak ada node yang tercantum yang cocok.

  4. Jika Anda menemukan node yang cocok, gunakan alamat IP yang cocok untuk terhubung ke server PostgreSQL node tersebut.

    Jika tidak, jika tidak ada node kumpulan baca yang tercantum di langkah sebelumnya yang memiliki ID yang cocok dengan node yang dicatat dalam log, kumpulan baca telah menonaktifkan node tersebut dalam waktu yang telah berlalu sejak entri log asli. Ini adalah perilaku normal untuk kumpulan baca AlloyDB, seperti yang dijelaskan dalam Catatan tentang efemeralitas node. Dalam hal ini, Anda tidak dapat membuat koneksi langsung ke node tersebut.

Setelah terhubung ke server PostgreSQL node, Anda dapat menggunakan teknik pemantauan PostgreSQL standar, seperti pg_stat_activity, untuk menyelidiki lebih lanjut proses node saat ini, dan menyesuaikannya sesuai kebutuhan.

Melihat entri log lainnya tentang node

Untuk melihat aktivitas terbaru yang dicatat dalam log tentang node dengan ID tertentu:

  1. Buka Logs Explorer:

    Buka Logs Explorer

  2. Tambahkan labels.NODE_ID=NODE_ID ke pembangun kueri Logs Explorer, ganti NODE_ID dengan string ID empat karakter node.

  3. Klik Run Query untuk melihat semua aktivitas dari node tersebut dalam periode waktu yang dipilih, atau sesuaikan kueri untuk memfilternya lebih lanjut.

  4. Ulangi langkah sebelumnya sesuai kebutuhan untuk menyaring penelusuran Anda.

Memantau metrik node

Anda dapat melihat metrik yang terkait dengan setiap node dari dasbor insight Sistem AlloyDB. Untuk mengetahui informasi selengkapnya tentang metrik node yang tersedia, lihat Referensi metrik insight sistem.

Untuk mempelajari ID node mana yang terkait dengan instance pool baca tertentu, lihat Mencantumkan detail node pool baca.

Untuk dokumentasi referensi lengkap tentang metrik AlloyDB ini dan metrik lainnya, lihat alloydb di "metrikGoogle Cloud ".

Catatan tentang efemeralitas node

Meskipun Anda dapat terhubung dengan aman ke node untuk tujuan investigasi atau proses debug sementara, aplikasi yang menggunakan kumpulan baca harus selalu terhubung ke kumpulan tersebut di tingkat instance, menggunakan alamat IP yang ditampilkan clusternya dalam daftar instance.

AlloyDB memperlakukan node kumpulan bacanya sebagai resource sementara yang dapat dipertukarkan. Layanan ini mengubah daftar node kumpulan baca sesering yang diperlukan agar instance kumpulan baca tersebut tetap seimbang dan responsif. Aplikasi yang terhubung langsung ke node kumpulan baca, bukan ke instance kumpulan baca, berisiko terputus secara tiba-tiba dari database Anda setiap kali AlloyDB memperbarui daftar node instance.

Selalu izinkan aplikasi Anda terhubung ke kumpulan baca di level instance, dan biarkan AlloyDB melakukan pekerjaan merutekan kueri Anda secara efisien ke node yang tepat.

Langkah berikutnya