Fleet Debugger (https://googlemaps.github.io/fleet-debugger/) to narzędzie internetowe typu open source, które umożliwia wizualizację logów Fleet Engine z Cloud Logging. Zawiera interaktywną mapę i oś czasu do analizowania danych o pojazdach, zadaniach lub przejazdach. Działa w całości w przeglądarce.
Najważniejsze funkcje
Fleet Debugger pomaga zrozumieć złożone zachowania pojazdów i przejazdów, oferując:
- interaktywną mapę i oś czasu, które umożliwiają odtwarzanie zdarzeń w kolejności;
- synchronizację między mapą, tabelą danych i osią czasu;
- szczegółowe sprawdzanie wpisów logu, które umożliwia dokładne analizowanie żądań do interfejsu API i odpowiedzi;
- wizualizację zaplanowanych tras i natężenia ruchu (wymaga logów z ograniczonym użyciem);
- porównanie żądanych i rzeczywistych lokalizacji przystanków (wymaga logów z ograniczonym użyciem).
Wczytywanie danych z Cloud Logging
Głównym sposobem korzystania z Fleet Debugger jest połączenie go bezpośrednio z Cloud Logging w projekcie Google Cloud. Aby to zrobić:
- Otwórz narzędzie: otwórz Fleet Debugger.
- Wybierz zbiór danych: kliknij przycisk „Wybierz zbiór danych”.
- Wpisz parametry: wpisz identyfikator projektu, identyfikatory pojazdów lub identyfikatory przejazdów albo zadań oraz wybrany zakres czasu.
- Pobierz logi: kliknij „Zaloguj się i pobierz logi”.
- Zaloguj się: uwierzytelnij się za pomocą konta Google, które ma wymagane uprawnienia dostępu do Cloud Logging (np.
roles/logging.viewer).
Inne metody wczytywania danych
Bezpośrednie połączenie z Cloud Logging jest często najłatwiejsze, ale z kilku powodów możesz użyć metod opartych na plikach:
- Aby analizować logi udostępnione przez członka zespołu.
- Aby wczytać wyeksportowany wcześniej zbiór danych do ponownej analizy.
Aby pracować z logami, gdy nie masz bezpośredniego dostępu do projektu GCP.
- Importowanie pliku: możesz też wczytać dane logów z plików JSON lub ZIP, klikając przycisk „Zamiast tego wczytaj plik JSON lub ZIP”. Mogą to być pliki, które zostały wcześniej wyeksportowane z Cloud Logging lub z samego narzędzia.
- Eksportowanie z narzędzia: aby udostępnić zbiór danych, otwórz menu zbioru danych i kliknij „Eksportuj”. Spowoduje to pobranie pliku JSON, który można skompresować. Narzędzie obsługuje wczytywanie skompresowanych plików JSON ZIP.
Wszystkie dane pozostają lokalne w przeglądarce.
Logi z ograniczonym użyciem
Włączenie logów z ograniczonym użyciem nie jest wymagane do działania Fleet Debugger, ale jest zalecane, aby uzyskać jak najbardziej kompletną wizualizację. Te logi zawierają przydatne informacje, m.in.:
- zaplanowaną trasę nawigacji kierowcy z Navigation SDK;
- dane o natężeniu ruchu na trasach;
- pierwotne żądane lokalizacje odbioru i wysiadki oraz rzeczywiste lokalizacje.
Bez logów z ograniczonym użyciem te szczegółowe informacje nie będą dostępne w debugerze.
Zasoby
- Fleet Debugger
- Repozytorium GitHub: w tym repozytorium znajdziesz kod źródłowy i możesz zgłaszać problemy.
Pomoc
Narzędzie Fleet Debugger jest udostępniane na licencji open source. Nie podlegają mu Wskazówki dotyczące usług wsparcia technicznego Google Maps Platform pomocy technicznej, SLA ani Zasady wycofywania. Usługi Google Maps Platform, z których korzysta narzędzie, nadal podlegają Warunkom korzystania z Google Maps Platform.
- Aby zgłosić błędy lub poprosić o dodanie funkcji, utwórz zgłoszenie w GitHub.
- W przypadku pytań technicznych i dyskusji skorzystaj z kanałów społeczności deweloperów Google Maps Platform.
- Aby współtworzyć projekt, zapoznaj się z przewodnikami dla współtwórców w repozytorium.