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ć uprawnienie serviceusage.services.enable. Jeśli projekt został utworzony przez Ciebie, prawdopodobnie masz już to uprawnienie dzięki roli Właściciel (roles/owner). W przeciwnym razie możesz uzyskać to uprawnienie dzięki roli Administrator wykorzystania usług (roles/serviceusage.serviceUsageAdmin). Dowiedz się, jak przyznawać role.

Włączanie 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ą 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 określonego 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 danymi 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 omówienia 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ń. Domyślnie narzędzie Key Visualizer wyświetla te dane 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?