フリート デバッガでログを可視化する

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、タスク 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 利用規約が適用されます。