Pierwsze kroki z narzędziem Key Visualizer

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

Zanim zaczniesz

Aby używać Key Visualizer w przypadku Cloud Firestore, musisz włączyć interfejs Firestore Key Visualizer API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

Wymagane role

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

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

Te role obejmują następujące uprawnienia, które są wymagane do uzyskania dostępu do narzędzia 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 określonego przedziału czasu

Każde skanowanie w usłudze 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 tego okresu.

Aby uruchomić narzędzie Key Visualizer:

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

    Otwórz stronę Bazy danych

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

  3. W menu nawigacyjnym kliknij Key Visualizer.

  4. Wybierz przedział czasu i dane z dostępnych skanów 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 wybierać okresów, które nie kwalifikowały się do skanowania lub są nadal przetwarzane. Przetworzenie 2 najnowszych skanów z danego dnia zajmie trochę czasu, 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:

    W lewym górnym rogu kliknij menu danych i wybierz dane, które chcesz wyświetlić. Wizualizator kluczy otwiera się domyślnie w przypadku kluczy dokumentów w metryce Operacje/s, a w przypadku kluczy indeksu w metryce Operacje zapisu indeksu/s.

Aby porównać dane lub znaleźć korelacje, możesz wyświetlić kilka rodzajów danych z wizualizatora kluczowych danych jednocześnie. Zobacz Znajdowanie powiązań między różnymi rodzajami danych.

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 przedstawia mapę cieplną, na której widać duże różnice w wzorcu użycia w przypadku różnych zakresów kluczy:

  • Zakresy w ciemnych kolorach wykazują niewielką aktywność lub nie wykazują jej wcale.
  • Zakresy w jasnych kolorach wykazują znacznie większą aktywność.
  • Świecący na biało zakres na środku wykazuje bardzo wysoką aktywność.

Przykład skanowania w usłudze Key Visualizer

Skanowanie kluczy dokumentów

Dane Operacje/s mierzą liczbę żądań na sekundę dla każdego zakresu kluczy. Ten wskaźnik to suma żądań zapisu, wyszukiwania i zapytań. Key Visualizer wyświetla ten wskaźnik domyślnie 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

Wartość Operacje zapisu indeksu na sekundę w danej komórce to średnia liczba zapisów indeksu na sekundę w odpowiednim 10-sekundowym przedziale czasu i zakresie kluczy.

Co dalej?