Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -124,6 +124,10 @@ npm install -g firebase-tools
firebase deploy --only hosting
```

## Privacy Policy

This project is 100% client-side and does not collect or store any user data on servers. Please see our [Privacy Policy](docs/PRIVACY.md) for full details.

## Disclaimer

This is not an officially supported Google product.
Expand Down
43 changes: 43 additions & 0 deletions docs/PRIVACY.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
# Fleet Debugger Tool Privacy Policy

**Last Updated:** March 15, 2025

This Privacy Policy describes how the Fleet Debugger Tool (the "Tool") handles your information when you use it to access Google Cloud Logging data. The Tool is a *completely static* web application; it does *not* collect, store, or transmit any personal data or Google Cloud Logging data to any servers.

## Information Access and Usage

The Tool is designed to help you visualize and debug your Google Maps Platform Mobility Solutions data stored in Google Cloud Logging. To function, it requires access to your Google Cloud project's Cloud Logging data through the following sensitive OAuth scope:

* `https://www.googleapis.com/auth/logging.read`: This scope allows the Tool to read your Cloud Logging entries *within your browser*.
* `https://www.googleapis.com/auth/cloud-platform.read-only`: This scope is used *solely* to enable access to Google Cloud Logging. While this is a broad scope, the Tool uses it in a *strictly limited* way. It *only* uses this scope to retrieve and process log entries related to Fleet Engine and does *not* access any other resources or data within your Google Cloud project.

**Crucially:**

1. **No Server-Side Storage:** The Tool operates entirely within your web browser. No data, including your Google Cloud Logging data, your Google credentials, or any other information you provide, is sent to, stored on, or processed by any external server controlled by the Tool's developers.
2. **Client-Side Processing:** All data processing, filtering, visualization, and analysis happens *exclusively* within your browser's memory and local storage.
3. **Temporary Data Storage (Browser Local Storage):** The Tool *may* temporarily store data in your browser's Local Storage to improve performance and allow you to work with previously loaded datasets. This data is *only* accessible to the Tool running in your browser and is *not* transmitted to any external server. You can clear this data at any time by using the "Delete" option for datasets within the Tool or by clearing your browser's Local Storage.
4. **Data Export:** The tool *may* allow you to export the processed data and its representation. This operation is triggered by the user, and the data remains 100% client side.
5. **OAuth Authorization:** When you connect the Tool to your Google Cloud project, you will be redirected to Google's standard OAuth consent screen. This screen will clearly explain the permissions the Tool is requesting. You can revoke these permissions at any time through your Google Account settings ([https://myaccount.google.com/permissions](https://myaccount.google.com/permissions)). The Tool itself does *not* store your OAuth tokens; they are managed by your browser.
6. **No Sharing with Third Parties:** The Tool does *not* share your data with any third parties.

## Your Choices and Control

* **Granting and Revoking Access:** You have full control over granting and revoking the Tool's access to your Google Cloud Logging data via Google's OAuth system.
* **Deleting Data:** You can delete any data stored locally in your browser by using the dataset "Delete" feature within the Tool or by clearing your browser's Local Storage.
* **Not Using the Tool:** If you do not agree with this Privacy Policy, you should not use the Tool.

## Data Security

While the Tool does not store or transmit your data, the security of your data ultimately depends on the security of your Google Cloud project and your own device. We recommend following Google Cloud's security best practices, including:

* Using strong passwords and enabling two-factor authentication for your Google Account.
* Following the principle of least privilege when configuring IAM permissions for your Google Cloud project. Ensure the service account or user account you use to access Cloud Logging only has the necessary `roles/logging.viewer` role (or a custom role with equivalent limited permissions). Do *not* grant broader permissions than necessary.
* Keeping your browser and operating system up to date.

## Changes to this Privacy Policy

We may update this Privacy Policy from time to time. We will post any changes on this page and update the "Last Updated" date. Your continued use of the Tool after any changes constitutes your acceptance of the revised Privacy Policy.

## Contact Us

If you have any questions about this Privacy Policy, please contact us [via GitHub issues](https://github.com/googlemaps/fleet-debugger/issues/new/choose).
6 changes: 3 additions & 3 deletions docs/reporting-issues.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Data file

Since all the data is in the browsers local storage only, sending deep link url's is not really a feature. This would only center the map.
For this reason, if you experience an issue zip compress your cloud logging json file that reporoduces the issue.
Search and replace sensitive strings, for instance vehicle ID or trip ID before sending this file in a bug report or similar.
S
For this reason, if you experience an issue, save the data from the dataset via the dropdown save.
Search and replace sensitive strings in this file, for instance vehicle or trip ids.
Compress your cloud logging JSON file before sending this file in a [bug report](https://github.com/googlemaps/fleet-debugger/issues/new/choose).
Loading