fleet-debugger

Fleet Debugger Tool

Fleet Debugger is an open-source web tool designed to help you visualize and analyze logs from Google Maps Platform’s Mobility solutions, supporting both Scheduled tasks and On-demand trips. It provides an interactive map and timeline to analyze vehicle and task or trip data, running entirely in your browser.

Fleet Debugger interface showing a map and log entries

Key Features

Fleet Debugger helps you understand complex journey and vehicle behaviors by offering:

Using the Demo Site

The fastest way to get started is using our GitHub hosted site.

This site includes demo data for:

Loading Your Data

Click on any empty “Load Dataset” button to open the data loading interface.

Fleet Engine Logs Loading

  1. Configure Parameters: Input your Project ID, Vehicle ID(s) or Trip/Task ID(s), and the selected time range within the UI.
  2. Connect to Cloud Logging: Click the “Sign in and Fetch Logs” button and follow the prompts to authenticate with your Google Account and grant access. You’ll need appropriate IAM permissions (e.g., roles/logging.viewer) to read logs.

2. Import from Log Files

You can load log data from JSON or ZIP files using the “Load JSON or ZIP file instead” button. This is useful for:

You can export logs from the Google Cloud Console’s Logs Explorer.

Note: All data processing happens client-side. Your logs or API keys are not uploaded to any server. Data is stored in your browser’s Local Storage.

Restricted Use Logs

To see features like the driver’s planned navigation route, traffic, and original requested stop locations, you need to enable Restricted Use Logs in your Google Cloud project. This is not required for the tool to function but highly recommended for a richer analysis.

Managing Datasets

Each dataset has a dropdown menu:

Restoring Demo Data

To reload the original demo data:

  1. Select “Delete” from the Dataset 1 dropdown menu.
  2. Refresh the page. The demo data will be automatically reloaded.

Running Your Own Server

Development Setup

  1. Install dependencies:
  2. Clone the repository:
    git clone https://github.com/googlemaps/fleet-debugger.git
    cd fleet-debugger
    
  3. Install node modules:
    npm install
    
  4. Add Maps Javascript API Key to src/constants.js

Start development server

npm start

This will open the app in your default browser, usually at http://localhost:3000.

Building and Deploying

# Generate static build
npm run build

The static files will be in the build folder. You can deploy this folder to any static site hosting service. For Firebase Hosting:

# Optional: Install Firebase CLI globally
npm install -g firebase-tools

# Deploy to Firebase Hosting
firebase deploy --only hosting

(Requires Firebase project setup and firebase login)

Privacy

This project is 100% client-side. Please see our Privacy Policy for full details.

Support & Contributing

This Fleet Debugger tool is offered under an open source license. It is not an officially supported Google product.