Logs mit dem Fleet Debugger visualisieren

Der Fleet Debugger (https://googlemaps.github.io/fleet-debugger/) ist ein Open-Source-Webtool, mit dem Sie Fleet Engine-Logs aus Cloud Logging visualisieren können. Sie bietet eine interaktive Karte und Zeitachse, um Fahrzeug- und Aufgaben- oder Fahrtdaten zu analysieren, und wird vollständig im Browser ausgeführt.

Wichtige Features

Mit Fleet Debugger können Sie komplexe Fahrten und Fahrzeugverhalten besser nachvollziehen. Dazu bietet das Tool folgende Funktionen:

  • Interaktive Karte und Zeitachse zur sequenziellen Wiedergabe von Ereignissen.
  • Synchronisierung zwischen Karte, Datentabelle und Zeitachse.
  • Detaillierte Prüfung von Logeinträgen für detaillierte Analysen von API-Anfragen und ‑Antworten.
  • Visualisierung geplanter Routen und des Verkehrs (erfordert Logs mit eingeschränkter Nutzung).
  • Vergleich der angeforderten mit den tatsächlichen Haltestellen (erfordert Logs zur eingeschränkten Nutzung).

Fleet Debugger-Oberfläche mit einer Karte und Logeinträgen

Daten aus Cloud Logging laden

Die primäre Methode zur Verwendung von Fleet Debugger besteht darin, ihn direkt mit Cloud Logging Ihres Google Cloud-Projekts zu verbinden. Gehen Sie dazu so vor:

  1. Tool öffnen: Rufen Sie den Flotten-Debugger auf.
  2. Dataset auswählen:Klicken Sie auf die Schaltfläche „Dataset auswählen“.
  3. Parameter eingeben:Geben Sie Ihre Projekt-ID, Fahrzeug-ID(s) oder Fahrten- oder Aufgaben-ID(s) und den ausgewählten Zeitraum ein.
  4. Logs abrufen:Klicke auf „Anmelden und Logs abrufen“.
  5. Anmelden:Authentifizieren Sie sich mit Ihrem Google-Konto, das die erforderlichen Berechtigungen für den Cloud Logging-Zugriff hat (z.B. roles/logging.viewer).

Andere Methoden zum Laden von Daten

Die direkte Verbindung zu Cloud Logging ist oft am einfachsten. Es gibt jedoch mehrere Gründe, warum Sie dateibasierte Methoden verwenden sollten:

  • Logs analysieren, die von einem Teammitglied bereitgestellt wurden.
  • Zuvor exportiertes Dataset zur erneuten Analyse laden.

  • So können Sie mit Logs arbeiten, wenn Sie keinen direkten Zugriff auf das GCP-Projekt haben.

    • Dateiimport:Sie können Protokolldaten auch aus JSON- oder ZIP-Dateien laden. Klicken Sie dazu auf die Schaltfläche „Stattdessen JSON- oder ZIP-Datei laden“. Diese Dateien können zuvor aus Cloud Logging oder aus dem Tool selbst exportiert worden sein.
    • Aus Tool exportieren:Wenn Sie ein Dataset freigeben möchten, verwenden Sie das Drop-down-Menü für das Dataset und wählen Sie „Exportieren“ aus. Dadurch wird eine JSON-Datei heruntergeladen, die komprimiert werden kann. Das Tool unterstützt das Laden komprimierter JSON-ZIP-Dateien.

Alle Daten verbleiben lokal in Ihrem Browser.

Logs zur eingeschränkten Nutzung

Die Aktivierung von Protokollen zur eingeschränkten Nutzung ist nicht erforderlich, damit der Fleet Debugger funktioniert. Sie wird jedoch für eine möglichst vollständige Visualisierung empfohlen. Diese Logs liefern wertvolle Kontextinformationen, darunter:

  • Die geplante Navigationsroute des Fahrers aus dem Navigation SDK.
  • Verkehrsdaten entlang der Routen.
  • Die ursprünglich angeforderten Abhol- und Absetzorte sowie die tatsächlichen Orte.

Ohne eingeschränkte Logs sind diese spezifischen Details im Debugger nicht verfügbar.

Ressourcen

Support

Dieses Fleet Debugger-Tool wird unter einer Open-Source-Lizenz angeboten. Sie unterliegt nicht den Richtlinien für technische Support-Dienste, dem SLA oder der Richtlinie zur Einstellung von Produkten und Diensten für den Google Maps Platform-Support. Die zugrunde liegenden Google Maps Platform-Dienste, die vom Tool verwendet werden, unterliegen weiterhin den Nutzungsbedingungen der Google Maps Platform.