Pierwsze kroki z narzędziem Key Visualizer

Na tej stronie opisujemy, jak używać narzędzia Key Visualizer do sprawdzania problemów z wydajnością związanych ze sposobem korzystania z Cloud Firestore.

Zanim zaczniesz

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

Role wymagane do włączenia interfejsów API

Aby włączyć interfejsy API, musisz mieć rolę administratora wykorzystania usług IAM (roles/serviceusage.serviceUsageAdmin), która zawiera uprawnienie serviceusage.services.enable. Dowiedz się, jak przyznawać role.

Włączanie interfejsu 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
  • Edytujący
  • Właściciel

Te role obejmują te uprawnienia IAM, 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 skanu z danego okresu

Każdy skan Key Visualizer obejmuje okres 2 godzin. Skan z danego okresu jest dostępny 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. Na liście baz danych wybierz 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 przedział czasu.

      Skanowanie jest dostępne w zależności od spełnienia kryteriów skanowania. Nie możesz wybierać przedziałów czasu, które nie spełniają kryteriów 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 dokumentów lub Wszystkie dane indeksu.

    3. Kliknij Aktualizuj.

  5. Wybierz dane do analizy:

    W lewym górnym rogu kliknij menu z rodzajami danych i wybierz dane, które chcesz wyświetlić. Domyślnie narzędzie Key Visualizer otwiera się z danymi Operacje/s dla kluczy dokumentów i Operacje zapisu w indeksie/s dla kluczy indeksu.

Aby porównać dane lub poszukać korelacji, możesz wyświetlić kilka rodzajów 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ę cieplną domyślnych danych.

Poniższy przykład przedstawia mapę cieplną, na której widać duże różnice w sposobie użycia w różnych zakresach kluczy:

  • Zakresy pokazane 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 ma bardzo dużą aktywność.

Przykład skanu w narzędziu Key Visualizer

Skanowanie kluczy dokumentów

Dane Operacje/s mierzą liczbę żądań na sekundę dla każdego zakresu kluczy. Te dane są sumą żądań zapisu, wyszukiwania i zapytań. Narzędzie Key Visualizer domyślnie wyświetla ten wskaźnik po otwarciu mapy cieplnej.

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

Skanowanie kluczy indeksu

Dane Operacje zapisu w indeksie/s w danej komórce mierzą średnią liczbę zapisów w indeksie na sekundę w odpowiednim 10-sekundowym przedziale czasu i zakresie kluczy.

Co dalej?