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 ono 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 podczas modyfikowania dokumentów.
Key Visualizer może dostarczać informacji o wzorcach wykorzystania na dużą skalę. Przykłady zastosowań Key Visualizer:
- Rozwiązywanie problemów z wydajnością. Key Visualizer pomaga identyfikować problemy z wydajnością w bazie danych spowodowane przez hotspoty z sekwencyjnych kluczy dokumentów lub indeksów albo nagłe wzrosty 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ć 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.
- Zobacz, jak nagły wzrost ruchu wpływa na czas oczekiwania.
- 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 obciążeniem indeksu.
- Użyj wizualizacji kluczy indeksu, aby lepiej przewidywać wzorce obciążenia.
Kryteria kwalifikacji do skanowania
Każde skanowanie Key Visualizer obejmuje okres 2 godzin. Skanowanie za dany okres jest dostępne w przypadku baz danych, w których ruch przekracza 3000 operacji na dokumentach w dowolnej minucie tego okresu.
Kryteria kwalifikacji do skanowania zależą wyłącznie od aktywności bazy danych. Nie zależą od ilości danych ani od typu danych w bazie danych.
Skanowania Key Visualizer
Na tym obrazie widać skanowanie Key Visualizer. Każde skanowanie obejmuje mapę termiczną, 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 skanowania Key Visualizer. Adres URL otworzy to samo skanowanie Key Visualizer i wybierze te same dane. Ten adres URL jest ważny do momentu wygaśnięcia okresu ważności danych skanowania.
Mapy termiczne
W przypadku mapy termicznej kluczy dokumentów oś X mapy termicznej przedstawia czas, a oś Y – klucze dokumentów. W przypadku mapy termicznej kluczy indeksu oś X mapy termicznej przedstawia 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 uważana za „zimną” i jest wyświetlana w ciemnym kolorze. Wysoka wartość jest „gorąca” i jest wyświetlana w jasnym kolorze. Najwyższe wartości są wyświetlane na biało.
Różne typy wykorzystania powodują różne wzorce wizualne na mapie termicznej, co może ułatwić szybkie zdiagnozowanie problemów. Przykłady niektórych typowych wzorców znajdziesz w sekcjach Wzorce mapy termicznej dla kluczy dokumentów i Wzorce mapy termicznej dla kluczy indeksu.
Key Visualizer udostępnia narzędzia, które pomagają zrozumieć dane w każdym skanowaniu. Zapoznaj się z artykułami Wprowadzenie do Key Visualizer i Przeglądanie map termicznych.
Zasobniki z kluczami
Key Visualizer dzieli wszystkie klucze w bazie danych na maksymalnie 1000 sąsiadujących ze sobą zakresów, z których każdy zawiera mniej więcej taką samą liczbę kluczy i operacji na sekundę. Te zakresy są nazywane zasobnikami z kluczami.
Key Visualizer używa łącznej liczby operacji na sekundę w bazie danych do dzielenia zasobników z kluczami, tak aby każdy zasobnik zawierał 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 wyższej łącznej liczbie operacji na sekundę zasobniki z kluczami mogą zawierać więcej niż 50 operacji na sekundę. W przypadku baz danych z mniej niż 50 operacjami na sekundę skanowania zawierają tylko 1 zasobnik z kluczami.
Key Visualizer podaje większość danych jako średnie w każdym zasobniku z kluczami lub jako wartości maksymalne w każdym zasobniku z kluczami.
Dane
W skanowaniach Key Visualizer dostępne są te dane dotyczące kluczy dokumentów:
| Dane | Opis |
|---|---|
| Dane o aktywności | |
| Operacje/s | Średnia liczba operacji na dokumentach na sekundę. Jest ona mniej więcej równa sumie zapisów, wyszukiwań i zapytań na sekundę. Te dane mogą wskazywać, które klucze są gorące. |
| Operacje zapisu/s | Średnia liczba operacji na dokumentach na sekundę w przypadku zapisów i usuwania. |
| Operacje wyszukiwania/s | Średnia liczba operacji na dokumentach na sekundę w przypadku wyszukiwań. |
| Operacje zapytań/s | Średnia liczba operacji na dokumentach na sekundę w przypadku zapytań. |
| Dane o skuteczności | |
| Średni czas oczekiwania na zapis | Średni czas oczekiwania na zapisy i usuwanie 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 zapisu w ogonie | Maksymalny zaobserwowany czas oczekiwania na zapis lub usunięcie w przetworzonych danych w zasobniku. |
| Opóźnienie wyszukiwania w ogonie | Maksymalny zaobserwowany czas oczekiwania na wyszukiwanie w przetworzonych danych w zasobniku. |
| Opóźnienie zapytania w ogonie | Maksymalny zaobserwowany czas oczekiwania na zapytanie w przetworzonych danych w zasobniku. |
W skanowaniach Key Visualizer dostępne są te dane dotyczące kluczy indeksu:
| Dane | Opis |
|---|---|
| Operacje zapisu w indeksie/s | Średnia liczba zapisów w indeksie na sekundę. |
Średnie wartości skuteczności
Dane o średnim czasie oczekiwania są obliczane na podstawie średniej wartości kluczy w zasobniku z kluczami. Ponieważ pomiar jest wykonywany na warstwie pamięci masowej, czas oczekiwania podany w tym miejscu może być niższy niż łączny czas oczekiwania wywołania interfejsu API.
Limity
Chociaż Key Visualizer pokazuje różne dane, nie wyświetla wszystkich danych, które mogą wpływać na skuteczność Cloud Firestore. Na przykład:
- Problemy z siecią między aplikacją a Google Cloud mogą być niewidoczne. Mogą one pojawiać się jako pionowe pasy we wszystkich kluczach w Key Visualizer, co daje tylko wskazówki dotyczące czasu wystąpienia problemów.
Okres ważności danych
Dane zebrane przez Key Visualizer dla Cloud Firestore są usuwane po 14 dniach.
Dane Key Visualizer są dostępne przez ostatnie 14 dni. Jeśli na przykład uruchomisz Key Visualizer 19 grudnia o 12:45, najwcześniejszy czas rozpoczęcia, który możesz wybrać w przypadku 2-godzinnego przedziału czasu, to 5 grudnia o 13:00.
Ten limit oznacza też, że jeśli dodasz do zakładek lub udostępnisz adres URL skanowania Key Visualizer, adres URL będzie ważny maksymalnie przez 14 dni.
Co dalej?
- Dowiedz się, jak zacząć korzystać z Key Visualizer.
- Poznaj wzorce kluczy dokumentów lub wzorce kluczy indeksu, które mogą być widoczne na mapach termicznych Key Visualizer.
- Dowiedz się, jak szczegółowo przeglądać mapę termiczną.