Pierwsze kroki z narzędziem Key Visualizer

Na tej stronie opisano, jak za pomocą narzędzia Key Visualizer sprawdzać problemy z wydajnością związane ze wzorcami użycia Cloud Firestore.

Zanim zaczniesz

Aby używać narzędzia Key Visualizer w przypadku bazy danych Cloud Firestore, musisz włączyć interfejs Firestore Key Visualizer API.

Role wymagane do włączania interfejsów API

Aby włączyć interfejsy API, musisz mieć uprawnienie serviceusage.services.enable. Jeśli projekt został utworzony przez Ciebie, prawdopodobnie masz już to uprawnienie w ramach roli właściciela (roles/owner). W przeciwnym razie możesz uzyskać to uprawnienie w ramach roli administratora wykorzystania usługi (roles/serviceusage.serviceUsageAdmin). Dowiedz się, jak przyznawać role

Włączanie interfejsu API

Wymagane role

Upewnij się, że Twoje konto ma jedną z tych ról uprawnień:

  • Właściciel Cloud Datastore
  • Wyświetlający skany Key Visualizer dla Cloud Datastore
  • Edytujący
  • Właściciel

Te role obejmują te uprawnienia uprawnień, które są wymagane do uzyskania dostępu do Key Visualizer:

  • datastore.keyVisualizerScans.get
  • datastore.keyVisualizerScans.list
  • datastore.databases.getMetadata
  • resourcemanager.projects.get

Możesz też zdefiniować rolę niestandardową z wymaganymi uprawnieniami.

Wyświetlanie skanowania z danego okresu

Każde skanowanie Key Visualizer obejmuje okres 2 godzin. Skanowanie w danym okresie jest dostępne w przypadku baz danych, w których ruch przekracza 3000 operacji na dokumentach w dowolnej minucie w tym okresie.

Aby uruchomić narzędzie Key Visualizer:

  1. W konsoli Google Cloud otwórz stronę Bazy danych.

    Otwórz stronę Bazy danych

  2. Wybierz wymaganą bazę danych z listy baz danych.

  3. W menu nawigacyjnym kliknij Key Visualizer.

  4. Wybierz przedział czasu i wskaźnik z dostępnych skanowań Key Visualizer:

    1. W prawym górnym rogu kliknij ikonę ołówka. Wybierz datę i przedział czasu.

      Skanowanie jest dostępne w zależności od kryteriów kwalifikacji. Nie możesz wybrać przedziałów czasowych, które nie kwalifikują się do skanowania lub są nadal przetwarzane. Przetworzenie 2 ostatnich skanów z danego dnia może trochę potrwać, zanim będą dostępne.

    2. Jako źródło wybierz Wszystkie dane dokumentu lub Wszystkie dane indeksu.

    3. Kliknij Aktualizuj.

  5. Wybierz dane do analizy:

    Kliknij menu z rodzajami danych w lewym górnym rogu i wybierz dane, które chcesz wyświetlić. Domyślnie Key Visualizer otwiera się w widoku danych Operacje/s w przypadku kluczy dokumentów i Operacje zapisu indeksu/s w przypadku kluczy indeksu.

Aby porównać dane lub poszukać korelacji danych, możesz wyświetlić kilka danych Key Visualizer jednocześnie. Zobacz Znajdowanie powiązań między różnymi danymi.

Wyświetlanie przeglądu aktywności

Aby uzyskać przegląd aktywności w wybranym 2-godzinnym okresie, sprawdź mapę termiczną domyślnego wskaźnika.

Poniższy przykład pokazuje mapę termiczną, na której występują duże różnice we wzorcu wykorzystania różnych zakresów kluczy:

  • Zakresy wyświetlane w ciemnych kolorach oznaczają niewielką aktywność lub jej brak.
  • Zakresy w jasnych kolorach oznaczają znacznie większą aktywność.
  • Świecący na biało zakres pośrodku oznacza bardzo wysoką aktywność.

Przykład skanowania w Key Visualizer

Skanowanie kluczy dokumentów

Wskaźnik Operacje/s mierzy liczbę żądań na sekundę dla każdego zakresu kluczy. Ten wskaźnik to suma żądań zapisu, wyszukiwania i zapytań. Key Visualizer domyślnie wyświetla te dane po otwarciu mapy termicznej.

Po uzyskaniu ogólnego obrazu aktywności w bazie danych możesz kontynuować analizę, sprawdzając inne dane i skupiając się na kluczowych zakresach, które mogą powodować problemy. Więcej informacji

Skanowanie kluczy indeksu

Wskaźnik Operacje zapisu indeksu na sekundę w danej komórce mierzy średnią liczbę operacji zapisu indeksu na sekundę w odpowiednim 10-sekundowym przedziale czasu i zakresie kluczy.

Co dalej?