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łączenia 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ług (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, 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 zakres czasu.

      Skanowanie jest dostępne w zależności od kryteriów kwalifikacji. Nie możesz wybrać przedziałów czasowych, które nie spełniają kryteriów 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ć. Wizualizator kluczy domyślnie otwiera się w przypadku kluczy dokumentów w widoku danych Operacje/s, a w przypadku kluczy indeksu – w widoku danych Operacje zapisu indeksu/s.

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 użycia dla różnych zakresów kluczy:

  • Zakresy wyświetlane w ciemnych kolorach mają niewielką aktywność lub nie mają jej wcale.
  • Zakresy w jasnych kolorach mają 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 zapoznaniu się z ogólną 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?