Ta strona zawiera omówienie narzędzia diagnostycznego Key Visualizer dla Cloud Firestore.
Co to jest Key Visualizer?
Key Visualizer to narzędzie, które pomaga analizować wzorce wykorzystania Cloud Firestore. Generuje wizualne raporty, które dzielą wykorzystanie na podstawie dokumentów, do których uzyskujesz dostęp, lub wpisów indeksu, które są zapisywane lub usuwane w miarę modyfikowania dokumentów.
Key Visualizer może dostarczać statystyki dotyczące wzorców wykorzystania na dużą skalę. Narzędzie Key Visualizer może służyć do:
- Rozwiązywanie problemów z wydajnością. Key Visualizer pomaga identyfikować problemy z wydajnością bazy danych spowodowane przez punkty krytyczne wynikające z sekwencyjnych kluczy dokumentów lub indeksów albo nagłych wzrostów natężenia ruchu.
- lepsze zrozumienie sposobu uzyskiwania dostępu do danych przechowywanych w Cloud Firestore;
- Iteracyjne projektowanie modelu danych lub ulepszanie projektu istniejącego modelu danych. W każdej iteracji możesz sprawdzić narzędzie Key Visualizer, aby wykryć problemy powodowane przez model danych.
Aby osiągnąć te cele, Key Visualizer może Ci pomóc w wykonaniu tych zadań:
- Sprawdź, czy odczyty lub zapisy tworzą hotspoty w określonych zakresach dokumentów.
- Sprawdź, jak nagły wzrost ruchu wpływa na opóźnienie.
- Sprawdź, czy wzorce dostępu są zrównoważone w całej bazie danych.
- Sprawdź strukturę kluczy indeksu, aby zidentyfikować definicje indeksu, które powodują problemy z jego wczytywaniem.
- Użyj wizualizacji kluczy indeksu, aby lepiej przewidywać wzorce obciążenia.
Kwalifikowanie się do skanowania
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.
Kwalifikacja do skanowania zależy całkowicie od aktywności w bazie danych. Nie zależy od ilości ani typu danych w bazie danych.
Skanowanie za pomocą narzędzia Key Visualizer
Obraz poniżej przedstawia skanowanie za pomocą narzędzia Key Visualizer. Każde skanowanie obejmuje mapę cieplną, która pokazuje wzorce dostępu lub dane o skuteczności dla grupy kluczy dokumentów lub kluczy indeksu w czasie.
Udostępnianie adresów URL skanowania
Możesz udostępnić lub dodać do zakładek adres URL skanu Key Visualizer. Adres URL otworzy ten sam skan wizualizatora kluczowych informacji i wybierze te same dane. Ten adres URL jest ważny do momentu wygaśnięcia czasu trwania skanowania danych.
Mapy termiczne
Podstawą skanowania w usłudze Key Visualizer jest mapa termiczna, która pokazuje wartość danych na przestrzeni czasu podzieloną na maksymalnie 1000 sąsiadujących ze sobą kluczowych przedziałów.
W przypadku mapy termicznej kluczy dokumentów oś X reprezentuje czas, a oś Y – klucze dokumentów. W przypadku mapy termicznej kluczy indeksu oś X reprezentuje czas, a oś Y – klucze indeksu.
Każde skanowanie Key Visualizer dla Cloud Firestore obejmuje 2 godziny aktywności podzielone na 10-sekundowe segmenty.
Niska wartość danych jest uznawana za „zimną” i wyświetlana w ciemnym kolorze. Wysoka wartość jest „gorąca” i wyświetlana w jasnym kolorze. Najwyższe wartości są wyświetlane na biało.
Różne rodzaje użycia powodują różne wzorce wizualne na mapie aktywności, dzięki czemu można szybko zdiagnozować problemy. Przykłady typowych wzorców znajdziesz w sekcjach Wzorce mapy termicznej kluczy dokumentów i Wzorce mapy termicznej kluczy indeksu.
Key Visualizer udostępnia narzędzia, które pomagają zrozumieć dane w każdym skanowaniu. Zobacz Wprowadzenie do Key Visualizer i Eksplorowanie map cieplnych.
Grupy kluczy
Key Visualizer dzieli wszystkie klucze w bazie danych na maksymalnie 1000 ciągłych zakresów, z których każdy zawiera mniej więcej taką samą liczbę kluczy i operacji na sekundę. Te zakresy są nazywane kluczowymi przedziałami.
Key Visualizer używa łącznej liczby operacji na sekundę w bazie danych do dzielenia zasobników z kluczami, tak aby każdy zasobnik z kluczami obejmował mniej więcej taką samą liczbę operacji na sekundę, przy czym minimalny zamierzony rozmiar to 50 operacji na sekundę na zasobnik z kluczami. W przypadku baz danych o większej łącznej liczbie operacji na sekundę poszczególne przedziały kluczy mogą rejestrować ponad 50 operacji na sekundę. Bazy danych z mniej niż 50 operacjami na sekundę powodują skanowanie z użyciem jednego zasobnika z kluczami.
Key Visualizer podaje większość wskaźników jako średnie wartości w poszczególnych zasobnikach z kluczami lub jako wartości maksymalne w poszczególnych zasobnikach z kluczami.
Dane
W przypadku kluczy dokumentów w skanach Key Visualizer dostępne są te dane:
| Dane | Opis |
|---|---|
| Dane o aktywności | |
| operacji/s | Średnia liczba operacji na dokumentach na sekundę. Jest ona mniej więcej równa sumie zapisów, wyszukiwań i zapytań na sekundę. Ten wskaźnik może wskazywać, które klucze są popularne. |
| Operacje zapisu na sekundę | Średnia liczba operacji na dokumentach na sekundę w przypadku zapisów i usuwań. |
| Operacje wyszukiwania na sekundę | Średnia liczba operacji na dokumentach na sekundę w przypadku wyszukiwań. |
| Operacje zapytań na sekundę | Średnia liczba operacji na dokumentach na sekundę w przypadku zapytań. |
| Dane dotyczące skuteczności | |
| Średni czas oczekiwania na zapis | Średni czas oczekiwania na zapisy i usunięcia w przetworzonych danych w zasobniku. |
| Średni czas oczekiwania na wyszukiwanie | Średni czas oczekiwania na wyszukiwanie w przetworzonych danych w zasobniku. |
| Średni czas oczekiwania na zapytanie | Średni czas oczekiwania na zapytania w przetworzonych danych w zasobniku. |
| Opóźnienie końcowe zapisu | Maksymalny zaobserwowany czas oczekiwania na zapis lub usunięcie w przetworzonych danych w zasobniku. |
| Wyszukiwanie opóźnienia ogona | Maksymalny zaobserwowany czas oczekiwania na wyszukiwanie w przetworzonych danych w zasobniku. |
| Czas oczekiwania na odpowiedź na zapytanie w przypadku najdłuższych zapytań | Maksymalny zaobserwowany czas oczekiwania na zapytanie w przetworzonych danych w zasobniku. |
W przypadku kluczy indeksu w skanach Key Visualizer dostępne są te dane:
| Dane | Opis |
|---|---|
| Operacje zapisu w indeksie na sekundę | Średnia liczba zapisów indeksu na sekundę. |
Średnie wyniki
Średnie dane o czasie oczekiwania są uśredniane w zakresie kluczy w zasobniku z kluczami. Pomiar ten jest wykonywany na warstwie pamięci, więc zgłaszane tu opóźnienie może być mniejsze niż całkowite opóźnienie wywołania interfejsu API.
Limity
Chociaż narzędzie Key Visualizer wyświetla różne dane, nie pokazuje wszystkich pojedynczych danych, które mogą wpływać na skuteczność Cloud Firestore. Przykład:
- Problemy z siecią między aplikacją a usługą Google Cloud mogą być niewidoczne. Mogą one występować w postaci pionowych pasów na wszystkich kluczach w narzędziu Key Visualizer, co daje tylko wskazówki dotyczące tego, kiedy wystąpiły problemy.
Czas trwania danych
Dane zebrane przez Key Visualizer na potrzeby Cloud Firestore są usuwane po 14 dniach.
Dane usługi Key Visualizer są dostępne z ostatnich 14 dni. Jeśli np. uruchomisz Key Visualizer 19 grudnia o 12:45, najwcześniejsza godzina rozpoczęcia 2-godzinnego przedziału czasu, którą możesz wybrać, to 5 grudnia o 13:00.
Ten limit oznacza też, że jeśli dodasz do zakładek lub udostępnisz adres URL skanu Key Visualizer, będzie on ważny maksymalnie przez 14 dni.
Co dalej?
- Dowiedz się, jak zacząć korzystać z Key Visualizer.
- Poznaj kluczowe wzorce dokumentów lub kluczowe wzorce indeksów, które możesz zobaczyć na mapach termicznych usługi Key Visualizer.
- Dowiedz się, jak szczegółowo analizować mapę cieplną.