Cloud Logging を設定する
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
Cloud Logging を有効にする
Fleet Engine では、ロギングが自動的に有効になります。
- ログ エクスプローラを開きます。
次のクエリを入力します。
resource.type:"fleetengine.googleapis.com"
クエリの結果にログが一覧表示される場合、ロギングは有効になっています。
このクエリの結果にログが表示されない場合は、プロジェクトで Cloud Logging が有効になっていない可能性があります。Cloud Logging を有効にするには、Google Maps Platform サポートにお問い合わせください。
制限付き使用ログを有効にする
モビリティ サービス固有の規約に従い、Fleet Engine が生成するログデータの一部は 30 日間のみ保持される場合があります。Fleet Engine はこれらのログに TOS_RESTRICTED
というラベルを付け、制限付き保持ログバケットに分類します。このバケットは、次の例に示すように作成する必要があります。
他のすべてのログデータは、デフォルトのバケットに割り当てられます。このバケットでは、モビリティ サービス固有の規約で定義されているように、より長く保持できます。ログバケットとその保持期間のカスタマイズについては、Google Cloud コンソールのログ ストレージをご覧ください。
分析では、制限付きログとデフォルト ログのデータを結合して、ログデータの完全なセットを取得できます。
制限付き使用ログを有効にするには、次の操作を行います。
制限付き使用ログのシンクとバケットを作成し、ログを適切なバケットにフィルタします。
制限付き使用ログを有効にするには、サポートにお問い合わせください。
詳しくは、次のセクションをご覧ください。
プロジェクトに制限付きログのシンクとバケットを作成する
[ログ エクスプローラ] の左側のナビゲーションで、[ログルーター] ページを開きます。
制限付き使用ログを除外するように _Default ロギング バケットを変更します。
- [ログルーター シンク] で、_Default ロギング バケットを選択します。
- [アクション] メニューから [シンクを編集] を選択します。
- [シンクに含めないログの選択] セクションに移動し、[除外設定を追加] ボタンをクリックします。
- [除外フィルタ名] を ExcludeRestrictedLogs に設定します。
- [除外フィルタの作成] ボックスに、次のフィルタを貼り付けます。
labels.restriction="TOS_RESTRICTED"
- [シンクを更新] をクリックします。
制限付き使用ログを保存するための制限付きロギング バケットを作成します。これを行うには、すべてのログのシンクとバケットを作成し、制限のないログを除外します。
- [ログルーター] ページの上部にある [シンクを作成] を選択します。
- [シンクの詳細] に入力します。
- 名前: RestrictedLogs
- 説明: Fleet Engine の制限付き使用ログを転送します。
- [次へ] をクリックします。
- [シンクの宛先] に入力します。
- シンクサービスを選択: Logging バケット
- ログバケットを選択: [新しいログバケットを作成] を選択します。
- [バケットの詳細] ダイアログで、次の項目を入力します。
- 名前: Restricted
- 説明: Fleet Engine の制限付き使用ログが含まれています。
- 残りの設定はそのままにして、[次へ] をクリックします。
- [保持期間] を 30 日に設定します。(保持期間は 30 日を超えてはなりません)。
- [バケットを作成] をクリックします。
- シンク作成ダイアログに戻り、[シンクに含めるログ] セクションを空のままにします。
- [シンクに含めないログ] セクションで、[除外設定を追加] をクリックして、次の項目を入力します。
- 除外フィルタ名: ExcludeNonRestrictedLogs
- 除外フィルタ:
NOT (resource.type =
"fleetengine.googleapis.com/Fleet" OR resource.type =
"fleetengine.googleapis.com/DeliveryFleet") NOT (labels.restriction
= "TOS_RESTRICTED")
- [シンクを作成] をクリックします。
- Google Maps Platform のサポートに移動します。
- [ケースを作成] をクリックして、新しいサポート リクエストを開始します。
次の情報を入力します。
- 有効にするプロジェクト ID。
- 変更をリクエストしたユーザーのメールアドレス。このユーザーには、リストに表示する Google Cloud プロジェクトの編集権限が必要です。
はいと入力して、以下に同意します。Cloud Logging で制限付き使用の Google マップ コンテンツを有効にすると、Google マップ コンテンツに関連するキャッシュ保存と使用許可の要件を含め、Google Maps Platform の利用規約とモビリティ サービス固有の利用規約を遵守することに同意したことになります。
サポートチームがリクエストを処理すると、プロジェクトでロギングが有効になったことを確認するメールが届きます。
次のステップ
ログ エクスプローラでログを操作する方法を確認する。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-08-31 UTC。
[null,null,["最終更新日 2025-08-31 UTC。"],[[["\u003cp\u003eFleet Engine automatically enables logging, verifiable via a query in the Logs Explorer using \u003ccode\u003eresource.type:"fleetengine.googleapis.com"\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eRestricted-use logs, labeled \u003ccode\u003eTOS_RESTRICTED\u003c/code\u003e, require a dedicated bucket with a 30-day retention period due to the Mobility Service Specific Terms.\u003c/p\u003e\n"],["\u003cp\u003eEnabling restricted-use logs involves creating a separate sink and bucket, then contacting Google Maps Platform Support for activation.\u003c/p\u003e\n"],["\u003cp\u003eFleet Engine logs may contain sensitive information and require careful access management using Google Cloud's Identity and Access Management for Cloud Logging.\u003c/p\u003e\n"]]],[],null,["Enable Cloud Logging\n\nFleet Engine should automatically have logging enabled.\n\n1. Open the [Logs Explorer](https://cloud.google.com/logging/docs/view/logs-explorer-interface).\n2. Enter the following query:\n\n resource.type:\"fleetengine.googleapis.com\"\n\nIf the results for the query list logs, then logging is enabled.\n\nIf you don't see any logs listed in the results for this query,\nCloud Logging may not be enabled for your project. To enable\nCloud Logging, contact [Google Maps Platform Support](https://console.cloud.google.com/google/maps-apis/support).\n\nEnable restricted use logs\n\nIn accordance with the [Mobility Service Specific Terms](/maps/documentation/transportation-logistics-terms/mobility/service-terms), some\nof the log data that Fleet Engine generates may only be retained for 30 days.\nFleet Engine labels those logs as `TOS_RESTRICTED` and sorts them into a\nrestricted-retention log bucket, which you must create as shown below.\n\nAll other log data is assigned to the default bucket where it can be retained\nlonger, as defined in the [Mobility Service Specific Terms](/maps/documentation/transportation-logistics-terms/mobility/service-terms).\nSee [Logs Storage](/maps/documentation/mobility/operations/cloud-logging/console.cloud.google.come/logs/storage) in the Google Cloud\nConsole about customizing your log buckets and their retention periods.\n\nFor analysis, you can join the data from restricted and default logs for a\ncomplete set of log data.\n\nDo the following to enable restricted use logs:\n\n1. Create a sink and bucket for restricted-use logs, and filter logs into their\n appropriate buckets.\n\n2. Contact support to enable restricted-use logs.\n\nFor details, see the following sections.\n\nCreate a sink and bucket for restricted logs in your project\n\n1. In the [Logs Explorer](https://cloud.google.com/logging/docs/view/logs-explorer-interface), in the left-hand\n navigation, open the **Log Router** page.\n\n2. Modify the _Default logging bucket to exclude restricted-use logs.\n\n 1. Under **Log Router Sinks**, select the _Default logging bucket.\n 2. Choose **Edit sink** from the **Actions** menu.\n 3. Go to the **Choose logs to filter out of sink** section and click the **Add Exclusion** button.\n 4. Set the **Exclusion filter name** to *ExcludeRestrictedLogs*.\n 5. In the **Build and exclusion filter** box, paste this filter: `labels.restriction=\"TOS_RESTRICTED\"`\n 6. Click **Update sink**.\n3. Create a restricted logging bucket to store the restricted-use logs. You do\n this by creating a sink and bucket for all logs, and then excluding the\n non-restricted logs.\n\n 1. On the [Log Router page](https://console.cloud.google.com/logs/router), towards the top, select **Create sink**.\n 2. Fill in the **Sink details** :\n 1. Name: *RestrictedLogs*\n 2. Description: *Routes Fleet Engine restricted-use logs.*\n 3. Click **Next**.\n 4. Fill in the **Sink destination** :\n 1. Select Sink service: Logging bucket\n 2. Select log bucket: Select **Create new log bucket**.\n 3. In the **Bucket details** dialog, fill in:\n 1. Name: *Restricted*\n 2. Description: *Contains Fleet Engine restricted-use logs.*\n 4. Leave the rest as is and click **Next**.\n 5. Set the **Retention period** to 30 days. (The retention period must not exceed 30 days.)\n 6. Click **Create bucket**.\n 5. Back in the sink creation dialog, leave the **Logs to include in sink** section empty.\n 6. In the **Logs to filter out of sink** section, click **Add Exclusion** and fill in:\n 1. Exclusion filter name: *ExcludeNonRestrictedLogs*\n 2. Exclusion filter: `NOT (resource.type =\n \"fleetengine.googleapis.com/Fleet\" OR resource.type =\n \"fleetengine.googleapis.com/DeliveryFleet\") NOT (labels.restriction\n = \"TOS_RESTRICTED\")`\n 7. Click **Create sink.**\n\nContact support to enable restricted-use logs\n\n1. Go to [Google Maps Platform Support](https://console.cloud.google.com/google/maps-apis/support)\n2. Click **Create Case** to start a new support request.\n3. Provide the following information:\n\n - Project ID(s) to enable.\n - Email address of the person requesting the change. This person should have edit access to the Google Cloud Projects you are listing.\n4. Agree to the following by writing **Yes** : *By enabling restricted-use\n Google Maps Content in Cloud Logging, you agree to adhere to the\n [Google Maps Platform terms](https://cloud.google.com/maps-platform/terms/) and [Mobility service specific\n terms](/maps/documentation/transportation-logistics-terms/mobility/service-terms), including caching and permitted use requirements as they relate\n to Google Maps Content.*\n\nOnce the support team handles your request, you will receive a confirmation that\nlogging has been enabled for your project.\n| **Note:** Fleet Engine logs may contain sensitive vehicle and trip information. You can restrict and audit access to these logs with Google Cloud [Identity and Access Management for Cloud Logging](https://cloud.google.com/logging/docs/access-control).\n\nWhat's next\n\nLearn how to [Work with logs in Logs Explorer](/maps/documentation/mobility/operations/cloud-logging/work-with-logs)."]]