使用 Fleet Debugger 以圖表呈現記錄

車隊偵錯工具 (https://googlemaps.github.io/fleet-debugger/) 是一項開放原始碼網路工具，可讓您從 Cloud Logging 視覺化呈現 Fleet Engine 記錄。這項工具提供互動式地圖和時間軸，可分析車輛和工作/行程資料，完全在瀏覽器中執行。

主要功能與特色

車隊偵錯工具提供下列功能，協助您瞭解複雜的行程和車輛行為：

  • 互動式地圖和時間軸重播功能，可依序查看事件。
  • 地圖、資料表和時間軸之間的同步處理。
  • 詳細檢查記錄項目，深入瞭解 API 要求和回應。
  • 規劃路線和流量的視覺化呈現 (需要受限制用途記錄)。
  • 比較要求與實際停靠站位置 (需要受限用途記錄)。

車隊偵錯工具介面，顯示地圖和記錄項目

從 Cloud Logging 載入資料

使用 Fleet Debugger 的主要方式，是將其直接連線至 Google Cloud 專案的 Cloud Logging。如要這樣做，請按照下列步驟操作：

  1. 開啟工具：前往「車隊偵錯工具」。
  2. 選取資料集：按一下「選取資料集」按鈕。
  3. 輸入參數：輸入專案 ID、車輛 ID 或行程/工作 ID，以及所選時間範圍。
  4. 擷取記錄：按一下「登入並擷取記錄」。
  5. 登入：使用 Google 帳戶進行驗證，該帳戶必須具備存取 Cloud Logging 的必要權限 (例如roles/logging.viewer)。

注意：On-demand trips 完全支援直接匯入 Cloud Logging 的功能。Scheduled tasks 支援有限 (追蹤問題)。

其他資料載入方法

直接連線至 Cloud Logging 通常最簡單，但您可能會基於下列原因使用檔案式方法：

  • 分析團隊成員提供的記錄。
  • 載入先前匯出的資料集，以重新進行分析。

  • 在無法直接存取 GCP 專案時處理記錄。

    • 匯入檔案：您也可以使用「改為載入 JSON 或 ZIP 檔案」按鈕，從 JSON 或 ZIP 檔案載入記錄資料。這些檔案可以是您先前從 Cloud Logging 或工具本身匯出的檔案。
    • 從工具匯出：如要分享資料集，請使用資料集下拉式選單，然後選取「匯出」。系統會下載可壓縮的 JSON 檔案。 這項工具支援載入壓縮的 JSON zip 檔案。

所有資料都會保留在瀏覽器中。

受限使用記錄

啟用「受限用途記錄」並非 Fleet Debugger 的運作條件，但建議您啟用，以取得最完整的視覺化資料。這些記錄可提供重要脈絡，包括：

  • 駕駛人透過 Navigation SDK 規劃的導航路線。
  • 路線沿途的車流量資料。
  • 除了實際地點外，還有原先要求的上車和下車地點。

如果沒有受限記錄，偵錯工具就不會提供這些詳細資料。

資源

支援

這項 Fleet Debugger 工具是依據開放原始碼授權提供。不適用於《Google 地圖平台支援技術支援服務指南》、《服務水準協議》或《廢止政策》。工具使用的基礎 Google 地圖平台服務仍須遵守《Google 地圖平台服務條款》。