Menganalisis statistik performa kueri
Halaman ini menjelaskan cara menggunakan dasbor Query Insights untuk mendeteksi dan menganalisis performa kueri.
Ringkasan Query Insights
Gunakan dasbor Query Insights untuk memantau kueri terkait metrik. Berdasarkan metrik, Anda dapat mengidentifikasi kueri yang paling sering digunakan dan kueri dengan latensi tinggi yang mungkin memerlukan pengoptimalan. Gunakan dasbor Query Insights untuk membantu Anda dalam:
- Pengoptimalan performa kueri: mengidentifikasi kueri dengan latensi tinggi dan yang mungkin memerlukan pengoptimalan.
- Pengelolaan biaya kueri: temukan kueri berbiaya tinggi dan optimalkan untuk mengurangi biaya.
- Pemantauan statistik kueri: melacak statistik kueri dari waktu ke waktu.
- Rekomendasi indeks: mengidentifikasi indeks komposit yang tidak ada atau kurang optimal dan membuat indeks yang direkomendasikan langsung dari dasbor (edisi Enterprise).
Data Query Insights
Query Insights mencakup data dari metode API berikut:
Anda dapat melihat data tentang kueri yang menggunakan metode ini untuk project, database, dan durasi waktu tertentu mulai dari 1 menit hingga 30 hari. Data untuk kueri dengan struktur yang setara dicatat dalam satu kueri yang dinormalisasi.
Query Insights menampilkan informasi berikut tentang kueri:
| Teks kueri yang dinormalisasi | Struktur kueri yang ditampilkan dalam teks. |
| Jumlah eksekusi | Jumlah eksekusi dalam rentang waktu yang dipilih. |
| Jumlah error | Jumlah error dalam rentang waktu yang dipilih. |
| Durasi eksekusi rata-rata(md) | Waktu rata-rata dalam milidetik yang dibutuhkan database untuk memproses kueri. |
| Jumlah rata-rata hasil yang ditampilkan | Jumlah hasil yang ditampilkan oleh kueri. Hasil mencakup dokumen, ID koleksi, dan bucket gabungan. |
| Jumlah rata-rata dokumen yang dipindai | Jumlah dokumen yang dipindai dalam kueri. |
| Jumlah rata-rata entri indeks yang dipindai | Jumlah entri indeks yang diperiksa untuk menjalankan kueri. |
| Muatan menurut waktu rata-rata | Data untuk membantu memfilter kueri terpopuler berdasarkan latensi rata-rata. |
| Muatan menurut total operasi baca (yang dapat ditagih) | Data untuk membantu memfilter kueri terpopuler berdasarkan total operasi baca yang dapat ditagih. |
| Rekomendasi indeks | Indeks gabungan yang direkomendasikan, indeks yang digunakan, dan estimasi dampak workload untuk kueri di database edisi Enterprise. |
Perincian dan retensi data
Perincian data bergantung pada durasi yang ditentukan:
- Perincian 1 menit untuk interval hingga 6 jam yang lalu
- Perincian 10 menit untuk interval hingga 4 hari yang lalu
- Perincian 1 jam untuk interval hingga 30 hari yang lalu
Retensi data maksimum untuk Query Insights adalah 30 hari. Data 1 menit disimpan selama 6 jam, data 10 menit disimpan selama 4 hari, dan data per jam disimpan selama 30 hari.
Melihat Query Insights
Untuk melihat Query Insights untuk database Firestore, lakukan hal berikut:
Di konsol Google Cloud , buka halaman Databases.
Dari daftar database, pilih database.
Di menu navigasi, klik Query Insights.
Halaman Query Insights menampilkan grafik deret waktu kueri teratas Anda bersama dengan tabel statistik kueri yang dinormalisasi. Untuk menganalisis performa kueri:
- Pilih rentang waktu untuk melihat tren historis atau metrik hampir real-time dengan interval 1 menit.
- Gunakan daftar Jenis muatan untuk memberi peringkat kueri teratas berdasarkan latensi rata-rata atau total operasi baca.
- Pilih setiap kueri dalam tabel untuk memetakan dan membandingkan jumlah eksekusi, latensi, dokumen yang dipindai, entri indeks yang dipindai, dan jumlah error pada grafik.
Rekomendasi indeks
Rekomendasi indeks untuk Query Insights secara otomatis mengidentifikasi konfigurasi indeks komposit yang tidak ada atau kurang optimal untuk bentuk kueri yang sering dieksekusi di database edisi Firestore Enterprise.Di edisi Firestore Enterprise, kueri dapat berjalan bahkan tanpa indeks komposit yang cocok, yang dapat mengakibatkan pemindaian koleksi lengkap atau operasi pengurutan dalam memori yang lambat. Dasbor Query Insights menganalisis statistik eksekusi kueri historis dan menyarankan indeks gabungan yang ditargetkan untuk mengoptimalkan latensi kueri dan mengurangi dokumen yang dipindai yang dapat ditagih.
Cara kerja rekomendasi indeks
Pipeline batch offline mengevaluasi kueri teratas historis secara berkala:
- Analisis struktur kueri: Mengekstrak predikat kesetaraan, pengurutan, dan rentang dari kueri yang sering dieksekusi.
- Pembuatan indeks kandidat: Membuat definisi indeks komposit prospektif menggunakan heuristik pengurutan indeks (Kesetaraan > Pengurutan > Rentang).
- Evaluasi pengoptimal: Memasukkan indeks kandidat ke dalam model biaya mesin kueri untuk membandingkan biaya eksekusi kueri dasar pengukuran dengan rencana eksekusi hipotetis yang diindeks.
- Peringkat dampak workload: Memberi peringkat indeks yang direkomendasikan ke dalam tingkat dampak berdasarkan total estimasi penghematan biaya workload:
- TINGGI: Mengonversi pemindaian koleksi lengkap menjadi pencarian indeks selektif, sehingga mengurangi pembacaan dokumen dan latensi eksekusi secara signifikan.
- MEDIUM: Menghilangkan operasi yang mahal seperti pengurutan dalam memori dengan memberikan hasil indeks yang telah diurutkan sebelumnya.
- RENDAH: Menawarkan sedikit peningkatan pencarian.
Melihat dan membuat indeks yang direkomendasikan
Untuk melihat rekomendasi indeks dan membuat indeks yang disarankan dari konsolGoogle Cloud :Di konsol Google Cloud , buka halaman Databases.
Dari daftar database, pilih database edisi Enterprise.
Di menu navigasi, klik Query Insights.
Di tabel kueri, pilih bentuk kueri untuk melihat kartu Rekomendasi. Kartu menampilkan:
- Definisi indeks komposit yang direkomendasikan (koleksi, kolom, tata urutan, atau properti array-contains).
- Tingkat dampak workload yang diperkirakan (HIGH, MEDIUM, atau LOW).
- Indeks yang digunakan, atau indikasi bahwa pemindaian koleksi lengkap sedang dilakukan.
Klik Create index di kartu rekomendasi. Dialog akan terbuka dengan koleksi, cakupan kueri, dan kolom yang telah diisi otomatis.
Klik Create untuk mulai membuat indeks. Anda dapat memantau progres pembuatan indeks di halaman Indexes di konsol Google Cloud .
Edisi dan mode yang didukung
Rekomendasi indeks didukung untuk database edisi Firestore Enterprise, termasuk:
- Firestore dalam mode Native
- Firestore dengan kompatibilitas MongoDB
Database edisi Standard tidak didukung untuk rekomendasi indeks.
Batasan
- Pemroses real-time tidak disertakan dalam statistik Query Insights.
- Data Query Insights tersedia dalam hitungan menit setelah eksekusi kueri.
- Rekomendasi indeks dibuat secara berkala berdasarkan data kueri historis, bukan secara real time.
- Rekomendasi indeks menyarankan indeks komposit baru; rekomendasi ini tidak menyarankan modifikasi atau penghapusan indeks yang ada.
- Pembuatan indeks otomatis tidak didukung; indeks yang direkomendasikan harus dibuat secara manual.
- Normalisasi kueri mengganti nilai literal dengan placeholder. Rekomendasi indeks didasarkan pada template kueri yang dinormalisasi, bukan nilai runtime tertentu.
- Evaluasi biaya menggunakan heuristik, bukan pengambilan sampel data langsung. Indeks yang direkomendasikan mungkin tidak meningkatkan performa dalam setiap skenario, dan pembuatan indeks akan menambah overhead penulisan dan penyimpanan.
Harga
Tidak ada biaya tambahan untuk Query Insights atau rekomendasi indeks.
Peran yang diperlukan
Untuk mendapatkan izin yang diperlukan guna melihat dasbor Query Insights dan membuat indeks yang direkomendasikan, minta administrator untuk memberi Anda peran IAM berikut di project Anda:
-
Melihat Query insights:
Datastore Viewer (
roles/datastore.viewer) -
Buat indeks yang direkomendasikan:
- Datastore Index Admin (
roles/datastore.indexAdmin) - Cloud Datastore Owner (
roles/datastore.owner) - Editor (
roles/editor) - Pemilik (
roles/owner)
- Datastore Index Admin (
Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.
Peran bawaan ini berisi izin yang diperlukan untuk melihat dasbor Query Insights dan membuat indeks yang direkomendasikan. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk melihat dasbor Query Insights dan membuat indeks yang direkomendasikan:
-
Melihat Query Insights:
datastore.insights.get -
Buat indeks yang direkomendasikan:
-
datastore.indexes.create -
datastore.indexes.update
-
Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.
Langkah berikutnya
- Menggunakan penjelasan kueri untuk meningkatkan performa kueri
- Memantau penggunaan