使用 Fleet Debugger 可视化日志

Fleet Debugger (https://googlemaps.github.io/fleet-debugger/) 是一种开源网络工具，可让您直观呈现 Cloud Logging 中的 Fleet Engine 日志。它提供了一个交互式地图和时间轴，用于分析车辆和任务或行程数据，并且完全在您的浏览器中运行。

主要特性

Fleet Debugger 可提供以下功能，帮助您了解复杂的行程和车辆行为：

  • 交互式地图和时间轴重放，可按顺序查看事件。
  • 地图、数据表和时间轴之间的同步。
  • 详细的日志条目检查，可深入了解 API 请求和响应。
  • 直观呈现计划路线和路况（需要 受限使用日志）。
  • 比较请求的停靠地点与实际停靠地点（需要 受限使用日志）。

Fleet Debugger 界面，显示地图和日志条目

从 Cloud Logging 加载数据

使用 Fleet Debugger 的主要方法是将其直接连接到 Google Cloud 项目的 Cloud Logging。为此，请按以下步骤操作：

  1. 打开工具： 前往 Fleet Debugger。
  2. 选择数据集： 点击“选择数据集”按钮。
  3. 输入参数： 输入您的项目 ID、车辆 ID 或行程/任务 ID，以及所选的时间范围。
  4. 提取日志： 点击“登录并提取日志”。
  5. 登录： 使用具有 Cloud Logging 访问所需权限（例如 roles/logging.viewer）的 Google 账号进行身份验证。

其他数据加载方法

虽然直接连接到 Cloud Logging 通常最简单，但您可能会出于以下几个原因而使用基于文件的方法：

  • 分析团队成员提供的日志。
  • 加载之前导出的数据集以进行重新分析。

  • 在您无法直接访问 GCP 项目时使用日志。

    • 文件导入： 您还可以使用“改为加载 JSON 或 ZIP 文件”按钮从 JSON 或 ZIP 文件加载日志数据。这些文件可以是您之前从 Cloud Logging 或工具本身导出的文件。
    • 从工具导出： 如需共享数据集，请使用数据集下拉菜单并选择“导出”。这会下载一个可以压缩的 JSON 文件。 该工具支持加载压缩的 JSON zip 文件。

所有数据都保留在您的浏览器本地。

受限使用日志

启用 受限使用日志 **不是** Fleet Debugger 正常运行的必要条件，但建议您启用这些日志，以便获得 最完整的可视化效果。这些日志提供了有价值的背景信息，包括：

  • Navigation SDK 中驾驶员的计划导航路线。
  • 沿路线的路况数据。
  • 原始请求的上车地点和下车地点，以及实际地点。

如果没有受限日志，调试程序中将不会提供这些具体详细信息。

资源

支持

此 Fleet Debugger 工具根据开源许可提供。它不受 Google Maps Platform 支持 技术支持服务准则、 服务等级协议 (SLA)或 弃用政策的约束。该工具使用的底层 Google Maps Platform 服务仍受 Google Maps Platform 服务条款的约束。