Na tej stronie opisano, jak używać panelu Statystyki zapytań do wykrywania i analizowania wydajności zapytań.
Omówienie statystyk zapytań
Użyj panelu Statystyki zapytań, aby monitorować zapytania związane ze wskaźnikami. Na podstawie danych możesz zidentyfikować najczęściej używane zapytania i zapytania o dużych opóźnieniach, które mogą wymagać optymalizacji. Panel Statystyki zapytań może Ci pomóc w tych kwestiach:
- Optymalizacja wydajności zapytań: identyfikuj zapytania o dużych opóźnieniach, które mogą wymagać optymalizacji.
- Zarządzanie kosztami zapytań: wykrywaj kosztowne zapytania i optymalizuj je, aby obniżyć koszty.
- Monitorowanie statystyk zapytań: śledź statystyki zapytań na przestrzeni czasu.
Dane statystyk zapytań
Statystyki zapytań obejmują dane z tych metod interfejsu API:
listDocumentslistCollectionIdsrunQueryrunAggregationQuerypartitionQueryexecutePipeline
Możesz wyświetlać dane o zapytaniach, które używają tych metod, w przypadku danego projektu, bazy danych i okresu od 10 minut do 30 dni. Dane dotyczące zapytań o równoważnych strukturach są rejestrowane w ramach jednego znormalizowanego zapytania.
Statystyki zapytań zwracają te informacje o zapytaniu:
| Znormalizowany tekst zapytania | Struktura zapytania przedstawiona w formie tekstowej. |
| Liczba wykonań | Liczba uruchomień w wybranym przedziale czasu. |
| Liczba błędów | Liczba błędów w wybranym przedziale czasu. |
| Średni czas wykonywania(ms) | Średni czas (w milisekundach) potrzebny bazie danych na przetworzenie zapytania. |
| Średnia liczba zwróconych wyników | Liczba wyników zwróconych przez zapytanie. Wyniki obejmują dokumenty, identyfikatory kolekcji i zagregowane zasobniki. |
| Średnia liczba zeskanowanych dokumentów | Liczba dokumentów przeskanowanych w zapytaniu. |
| Średnia liczba przeskanowanych wpisów indeksu | Liczba wpisów indeksu sprawdzonych w celu wykonania zapytania. |
| Średni czas oczekiwania | Dane ułatwiające filtrowanie najczęstszych zapytań na podstawie średniego czasu oczekiwania. |
| Obciążenie według łącznej liczby operacji odczytu (podlegających opłacie) | Dane ułatwiające filtrowanie najczęstszych zapytań na podstawie łącznej liczby operacji odczytu podlegających opłacie. |
Szczegółowość i przechowywanie danych
Szczegółowość danych zależy od określonego czasu trwania:
- Przedziały 10-minutowe w przypadku okresów do 4 dni wstecz.
- szczegółowość godzinowa w przypadku przedziałów czasowych do 30 dni wstecz,
Maksymalny okres przechowywania danych w przypadku statystyk zapytań wynosi 30 dni. Dane 10-minutowe są przechowywane przez 4 dni, a dane godzinowe przez 30 dni.
Ograniczenia
- Dane Statystyk zapytań są opóźnione o 1–2 godziny.
Ceny
Korzystanie ze Statystyk zapytań nie wiąże się z dodatkowymi kosztami.
Wymagane role
Aby uzyskać uprawnienia potrzebne do wyświetlania panelu Statystyki zapytań, poproś administratora o przyznanie Ci roli uprawnień wyświetlającego Datastore (roles/datastore.viewer) w projekcie.
Ta rola zdefiniowana zawiera uprawnienie datastore.insights.get, które jest wymagane do wyświetlania panelu Statystyki zapytań.
Uprawnienie to możesz też uzyskać, używając ról niestandardowych lub innych ról zdefiniowanych.
Wyświetlanie statystyk zapytań
Aby wyświetlić statystyki zapytań dotyczące bazy danych Cloud Firestore, otwórz panel Statystyki zapytań bazy danych w konsoli Google Cloud.
W konsoli Google Cloud otwórz stronę Bazy danych.
Wybierz bazę danych z listy.
W menu nawigacyjnym kliknij Statystyki zapytań.

Użyj menu Typ obciążenia, aby znaleźć najczęstsze zapytania według opóźnienia lub liczby operacji odczytu.