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. Er bietet eine interaktive Karte und eine Zeitachse zur Analyse von Fahrzeug- und Aufgaben- oder Fahrtendaten, die vollständig in Ihrem Browser ausgeführt werden.

Wichtige Features

Der Fleet Debugger hilft Ihnen, komplexe Fahrten und Fahrzeugverhalten zu verstehen. Er bietet folgende Funktionen:

  • Interaktive Karte und Zeitachse zur Wiedergabe von Ereignissen in der richtigen Reihenfolge.
  • Synchronisierung zwischen der Karte, einer Datentabelle und einer Zeitachse.
  • Detaillierte Logeinträge für eine detaillierte Analyse von API-Anfragen und ‑Antworten.
  • Visualisierung von geplanten Routen und Verkehr (erfordert Logs mit eingeschränkter Nutzung).
  • Vergleich der angeforderten und tatsächlichen Haltestellen (erfordert Logs mit eingeschränkter Nutzung).

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

Daten aus Cloud Logging laden

Der Fleet Debugger wird hauptsächlich verwendet, indem er direkt mit Cloud Logging Ihres Google Cloud-Projekts verbunden wird. Gehen Sie dazu so vor:

  1. Tool öffnen: Rufen Sie den Fleet 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 Fahrt- oder Aufgaben-ID(s) und den ausgewählten Zeitraum ein.
  4. Logs abrufen:Klicken Sie auf „Anmelden und Logs abrufen“.
  5. Anmelden:Authentifizieren Sie sich mit Ihrem Google-Konto, das die erforderlichen Berechtigungen für den Zugriff auf Cloud Logging hat (z.B. roles/logging.viewer).

Andere Methoden zum Laden von Daten

Die direkte Verbindung zu Cloud Logging ist oft die einfachste Methode. Es gibt jedoch mehrere Gründe, dateibasierte Methoden zu verwenden:

  • Zum Analysieren von Logs, die von einem Teammitglied bereitgestellt wurden.
  • Zum Laden eines zuvor exportierten Datasets zur erneuten Analyse.

  • Zum Arbeiten mit Logs, wenn Sie keinen direkten Zugriff auf das GCP-Projekt haben.

    • Datei importieren:Sie können Logdaten 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 dem 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 bleiben lokal in Ihrem Browser.

Logs mit eingeschränkter Nutzung

Die Aktivierung von Logs mit eingeschränkter Nutzung ist nicht erforderlich, damit der Fleet Debugger funktioniert. Sie wird jedoch für die vollständigste Visualisierung empfohlen. Diese Logs enthalten wertvolle Informationen, 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 Logs mit eingeschränkter Nutzung sind diese spezifischen Details im Debugger nicht verfügbar.

Ressourcen

Support

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