Wizualizowanie logów za pomocą narzędzia Fleet Debugger

Narzędzie do debugowania floty (https://googlemaps.github.io/fleet-debugger/) to internetowe narzędzie 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 przejazdach. Działa w całości w przeglądarce.

Najważniejsze funkcje

Debuger floty pomaga zrozumieć złożone zachowania pojazdów i przebieg podróży, ponieważ:

  • 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 w logach, aby dokładnie analizować żądania i odpowiedzi interfejsu API.
  • Wizualizacja zaplanowanych tras i ruchu (wymaga logów o ograniczonym zakresie użycia).
  • Porównanie żądanych i rzeczywistych lokalizacji przystanków (wymaga logów o ograniczonym zakresie użycia).

Interfejs narzędzia Fleet Debugger z mapą i wpisami w dzienniku

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:

  1. Otwórz narzędzie: otwórz debuger floty.
  2. Wybierz zbiór danych: kliknij przycisk „Wybierz zbiór danych”.
  3. Wpisz parametry: wpisz identyfikator projektu, identyfikatory pojazdów lub identyfikatory przejazdów lub zadań oraz wybrany zakres czasu.
  4. Pobierz logi: kliknij „Zaloguj się i pobierz logi”.
  5. Zaloguj się: uwierzytelnij się za pomocą konta Google, które ma wymagane uprawnienia dostępu do Cloud Logging (np. roles/logging.viewer).

Uwaga: funkcja bezpośredniego importowania do Cloud Logging jest w pełni obsługiwana w przypadku On-demand trips. Scheduled tasks jest ograniczona (problem ze śledzeniem).

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:

  • analizować logi udostępnione 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: dane dziennika możesz też wczytać 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, użyj 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 ograniczonego użycia

Włączenie logów dotyczących ograniczonego użycia nie jest wymagane do działania narzędzia Fleet Debugger, ale jest zalecane, aby uzyskać jak najpełniejszą wizualizację. Dzienniki te zawierają cenne informacje kontekstowe, m.in.:

  • Zaplanowana trasa nawigacji kierowcy z pakietu Navigation SDK.
  • dane o ruchu na trasach;
  • Pierwotne lokalizacje odbioru i miejsca docelowego oraz rzeczywiste lokalizacje.

Bez logów z ograniczeniami te szczegółowe informacje nie będą dostępne w debuggerze.

Zasoby

Pomoc

Narzędzie Fleet Debugger jest oferowane na licencji open source. Nie podlegają one Wskazówkom dotyczącym usług pomocy technicznej, gwarancji jakości usług ani zasadom wycofywania usług dotyczącym pomocy technicznej Google Maps Platform. Usługi Google Maps Platform, z których korzysta to narzędzie, nadal podlegają Warunkom korzystania z Google Maps Platform.