Narzędzie do debugowania floty (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, które umożliwiają analizowanie danych o pojazdach, zadaniach i trasach. Działa w całości w przeglądarce.
Najważniejsze funkcje
Debuger floty pomaga zrozumieć złożone zachowania pojazdów i podróży, oferując:
- Interaktywna mapa i odtwarzanie osi czasu, aby zobaczyć zdarzenia w kolejności.
- Synchronizacja między mapą, tabelą danych i osią czasu.
- szczegółowe sprawdzanie wpisów logu w celu szczegółowego omówienia żądań do interfejsu API i odpowiedzi.
- Wizualizacja zaplanowanych tras i ruchu (wymaga logów z ograniczonym użyciem).
- Porównanie żądanych i rzeczywistych lokalizacji przystanków (wymaga dzienników z ograniczonym dostępem).
Wczytywanie danych z Cloud Logging
Głównym sposobem korzystania z Fleet Debuggera jest połączenie go bezpośrednio z Cloud Logging w projekcie Google Cloud. Aby to zrobić, wykonaj te czynności:
- Otwórz narzędzie: przejdź do narzędzia do debugowania floty.
- Wybierz zbiór danych: kliknij przycisk „Wybierz zbiór danych”.
- Wpisz parametry: podaj identyfikator projektu, identyfikatory pojazdów, przejazdów lub zadań oraz wybrany zakres czasowy.
- 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 najprostsze, ale z kilku powodów możesz używać metod opartych na plikach:
- analizowanie logów dostarczonych przez członka zespołu;
- Aby wczytać wyeksportowany wcześniej zbiór danych do ponownej analizy.
Praca z logami, gdy nie masz bezpośredniego dostępu do projektu GCP.
- Importowanie pliku: możesz też wczytać dane dziennika z plików JSON lub ZIP, klikając przycisk „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, użyj menu zbioru danych i wybierz „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 ograniczonego użycia
Włączenie logów ograniczonego użytku nie jest wymagane do działania narzędzia Fleet Debugger, ale jest zalecane, aby uzyskać jak najpełniejszą wizualizację. Te logi zawierają cenny kontekst, w tym:
- Zaplanowana trasa nawigacji kierowcy z pakietu Navigation SDK.
- Dane o ruchu na trasach.
- pierwotne żądane miejsca odbioru i wysiadki, a także rzeczywiste lokalizacje;
Bez logów z ograniczeniami te szczegółowe informacje nie będą dostępne w debugerze.
Zasoby
- Debuger floty
- Repozytorium GitHub: w tym repozytorium znajdziesz kod źródłowy i możesz zgłaszać problemy.
Pomoc
Narzędzie Fleet Debugger jest oferowane na podstawie licencji open source. Nie podlegają one Wskazówkom dotyczącym usług wsparcia technicznego, gwarancji jakości usług ani zasadom wycofywania usług dotyczącym pomocy w Google Maps Platform. Usługi Google Maps Platform, z których korzysta to narzędzie, nadal podlegają Warunkom korzystania z Google Maps Platform.
- Aby zgłosić błędy lub poprosić o dodanie funkcji, otwórz problem w GitHub.
- Jeśli masz pytania techniczne lub chcesz wziąć udział w dyskusji, skorzystaj z kanałów społeczności deweloperów Google Maps Platform.
- Aby wnieść swój wkład w projekt, zapoznaj się z przewodnikami w repozytorium.