Analizowanie statystyk wydajności zapytań

Na tej stronie opisujemy, 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 Query Insights pomaga w:

  • 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.
  • Rekomendacje dotyczące indeksów: identyfikuj brakujące lub nieoptymalne indeksy złożone i twórz zalecane indeksy bezpośrednio z panelu (wersja Enterprise).

Dane statystyk zapytań

Statystyki zapytań obejmują dane z tych metod interfejsu API:

  • find
  • aggregate

Możesz wyświetlić dane o zapytaniach, które używają tych metod, dla danego projektu, bazy danych i przedziału czasu 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 przeskanowanych dokumentów Liczba dokumentów przeskanowanych w zapytaniu.
Średnia liczba przeskanowanych wpisów w indeksie Liczba wpisów w indeksie sprawdzonych w celu wykonania zapytania.
Obciążenie według średniego czasu Dane ułatwiające filtrowanie najczęstszych zapytań na podstawie średniego czasu oczekiwania.
Obciążenie według łącznej liczby (płatnych) operacji odczytu Dane ułatwiające filtrowanie najczęstszych zapytań na podstawie łącznej liczby operacji odczytu podlegających opłacie.
Rekomendacje dotyczące indeksów Zalecane indeksy wieloskładnikowe, używane indeksy i szacowany wpływ na obciążenie w przypadku zapytań w bazach danych w wersji Enterprise.

Szczegółowość i przechowywanie danych

Szczegółowość danych zależy od określonego czasu trwania:

  • 10-minutowa szczegółowość w przypadku przedziałów czasowych do 4 dni wstecz,
  • szczegółowość godzinowa w przypadku przedziałów czasowych do 30 dni wstecz,

Maksymalny okres przechowywania danych w Statystykach zapytań wynosi 30 dni. Dane 10-minutowe są przechowywane przez 4 dni, a dane godzinowe przez 30 dni.

Wyświetlanie statystyk zapytań

Konsola Firebase
  1. Aby wyświetlić statystyki zapytań dotyczące bazy danych Cloud Firestore, otwórz panel Statystyki zapytań bazy danych w konsoli Google Cloud.
  2. W konsoli Firebase otwórz stronę Baza danych Firestore.

    Otwórz bazę danych Firestore

  3. Wybierz bazę danych z listy baz danych.
  4. Na liście kart kliknij Statystyki zapytań.

    Aby znaleźć najczęstsze zapytania na podstawie opóźnienia lub liczby operacji odczytu, kliknij Opóźnienie lub Operacje odczytu.

Rekomendacje dotyczące indeksów

Rekomendacje indeksów dla Statystyk zapytań automatycznie identyfikują brakujące lub nieoptymalne konfiguracje indeksów złożonych w przypadku często wykonywanych kształtów zapytań w bazach danych Firestore Enterprise.

W wersji Firestore Enterprise zapytania mogą być wykonywane nawet bez pasujących indeksów złożonych, co może skutkować powolnym skanowaniem całej kolekcji lub operacjami sortowania w pamięci. Panel Statystyki zapytań analizuje historyczne statystyki wykonywania zapytań i sugeruje ukierunkowane indeksy wieloskładnikowe, aby zoptymalizować czas oczekiwania na zapytanie i zmniejszyć liczbę płatnych skanowanych dokumentów.

Jak działają rekomendacje dotyczące indeksów

Potok wsadowy offline okresowo ocenia historyczne najczęstsze zapytania:

  • Analiza struktury zapytań: wyodrębnia predykaty równości, sortowania i zakresu z często wykonywanych zapytań.
  • Generowanie indeksów kandydujących: generuje definicje potencjalnych indeksów złożonych za pomocą heurystyki porządkowania indeksów (równość > sortowanie > zakres).
  • Ocena optymalizatora: wstrzykuje indeksy kandydujące do modelu kosztów silnika zapytań, aby porównać bazowe koszty wykonywania zapytań z hipotetycznymi indeksowanymi planami wykonywania.
  • Ranking wpływu na zadania: klasyfikuje zalecane indeksy według poziomów wpływu na podstawie łącznych szacowanych oszczędności kosztów zadań:
    • WYSOKI: przekształca skanowanie całej kolekcji w selektywne wyszukiwanie indeksu, co znacznie zmniejsza liczbę odczytów dokumentów i opóźnienie wykonywania.
    • MEDIUM: eliminuje kosztowne operacje, takie jak sortowanie w pamięci, przez dostarczanie wstępnie posortowanych wyników indeksu.
    • LOW: zapewnia niewielką poprawę wyszukiwania.
Aby wyświetlić rekomendacje dotyczące indeksów i utworzyć sugerowane indeksy w konsoli Firebase:

  1. W konsoli Firebase otwórz stronę Baza danych Firestore.

    Otwórz bazę danych Firestore

  2. Z listy baz danych wybierz bazę danych w wersji Enterprise.

  3. Kliknij kartę Statystyki zapytań.

  4. W tabeli zapytań znajdź kształt zapytania z rekomendacjami i kliknij Sprawdź rekomendacje w wierszu lub wyskakującym okienku.

  5. W oknie rekomendacji indeksu sprawdź definicję indeksu wieloskładnikowego, kolejność pól i szacowany poziom wpływu na zadania (WYSOKI, ŚREDNI lub NISKI).

  6. Kliknij Zapisz. Otworzy się panel Długo trwające operacje (LRO), w którym możesz śledzić postęp tworzenia indeksu.

  7. Po zakończeniu kompilacji indeks pojawi się na karcie Indeksy, a wskaźnik rekomendacji zniknie z wiersza zapytania.

Obsługiwane wersje

Rekomendacje dotyczące indeksów są obsługiwane tylko w przypadku baz danych Firestore w wersji Enterprise. Bazy danych w wersji Standard nie są obsługiwane.

Ograniczenia

  • Dane Statystyk zapytań są opóźnione o 1–2 godziny.
  • Rekomendacje dotyczące indeksów są generowane okresowo na podstawie historycznych danych zapytań, a nie w czasie rzeczywistym.
  • Rekomendacje dotyczące indeksów sugerują nowe indeksy złożone, ale nie sugerują modyfikowania ani usuwania istniejących indeksów.
  • Automatyczne tworzenie indeksów nie jest obsługiwane. Zalecane indeksy należy tworzyć ręcznie.
  • Normalizacja zapytania zastępuje literały zmiennymi zastępczymi. Rekomendacje dotyczące indeksów są oparte na znormalizowanych szablonach zapytań, a nie na konkretnych wartościach środowiska wykonawczego.
  • Ocena kosztów wykorzystuje heurystykę, a nie próbkowanie danych na żywo. Zalecane indeksy mogą nie zwiększyć wydajności w każdym scenariuszu, a utworzenie indeksu zwiększa obciążenie związane z zapisem i pamięcią masową.

Ceny

Korzystanie z usługi Statystyki zapytań i rekomendacji dotyczących indeksów nie wiąże się z dodatkowymi kosztami.

Wymagane role

Aby uzyskać uprawnienia potrzebne do wyświetlania panelu Statystyki zapytań i tworzenia zalecanych indeksów, poproś administratora o przypisanie Ci w projekcie tych ról IAM:

Te role zdefiniowane zawierają uprawnienia datastore.insights.get i datastore.indexes.create.

Uprawnienia te możesz też uzyskać, używając ról niestandardowych lub innych ról zdefiniowanych.

Co dalej?