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 Cloud Firestore wzorcami użycia.

Zanim zaczniesz

Aby używać Key Visualizer w przypadku 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ściciel (roles/owner). W przeciwnym razie możesz uzyskać to uprawnienie w ramach roli Administrator 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 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, 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 określonego okresu

Każde skanowanie usługi 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 Bazy danych

  2. Wybierz z listy baz danych tę, której potrzebujesz.

  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 kryteriów kwalifikacji. Nie możesz wybierać okresów, które nie kwalifikowały się do skanowania lub są nadal przetwarzane. Przetworzenie 2 ostatnich 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 z rodzajami danych i wybierz dane, które chcesz wyświetlić. Wizualizator kluczy otwiera się domyślnie w przypadku kluczy dokumentów w sekcji Operacje/s, a w przypadku kluczy indeksu w sekcji Operacje zapisu indeksu/s.

Aby porównać dane lub znaleźć korelacje między nimi, możesz wyświetlić kilka rodzajów danych z wizualizatora kluczowych informacji 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 przedziale czasu, sprawdź mapę termiczną dla domyślnego wskaźnika.

Poniższy przykład przedstawia mapę aktywności, na której widać duże różnice w wzorcu użycia w przypadku różnych zakresów kluczy:

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

Przykład skanu w usłudze 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 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

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

Co dalej?