分割ログで長いログエントリを処理する
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
Cloud Logging では、受信ログのサイズが 256 KB に制限されており、これを超えるログは破棄されます。Cloud Logging で大きなログが確実に保持されるように、Fleet Engine はログを一連の小さなログに分割できます。
Cloud Logging は、Fleet Engine から次のログを分割する場合があります。
各分割ログエントリには、次のフィールドが含まれています。
split.uid
: 共通の元のログエントリから分割されたログエントリのグループの固有識別子。このフィールドの値は、元のログエントリから分割されたすべてのエントリで同じです。
split.index
: 一連の分割エントリ内でのエントリの位置。分割された最初のエントリのインデックスは 0.split.index
です。このインデックスは LogEntry.insertId
フィールドにも追加されます。
split.totalSplits
: 元のログエントリが分割されたログエントリの数。このフィールドの値は、元のログエントリから分割されたすべてのエントリで同じです。
split log 1:
insertId: "XXXX-01"
split {index: 0, uuid: "XXXX"}
splitLog 2:
insertId: "XXX-02"
split {index: 1, uuid: "XXXX"}
特定のログから分割されたすべてのログを検索するには、次のようなクエリを使用します。
split.uid="789+2022-02-22T12:22:22.22+05:00"
sortby split.index OR sortby insertID
これらの分割ログの構造は、Cloud Audit Logs のガイドに示されている構造とほぼ同じです。主な違いは、Fleet Engine ログの場合、分割が jsonPayload
フィールドで行われることです。詳細と例については、監査ログエントリの分割をご覧ください。
次のステップ
条件に従ってログをカウントしてフィルタするには、ログベースの指標を作成します。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-09-05 UTC。
[null,null,["最終更新日 2025-09-05 UTC。"],[[["\u003cp\u003eCloud Logging limits log size to 256KB, and Fleet Engine can split larger logs into smaller segments for retention.\u003c/p\u003e\n"],["\u003cp\u003eSplit logs contain unique identifiers (\u003ccode\u003esplit.uid\u003c/code\u003e), index (\u003ccode\u003esplit.index\u003c/code\u003e), and total split count (\u003ccode\u003esplit.totalSplits\u003c/code\u003e) for reassembly.\u003c/p\u003e\n"],["\u003cp\u003eYou can search for related split logs using the \u003ccode\u003esplit.uid\u003c/code\u003e and sort by \u003ccode\u003esplit.index\u003c/code\u003e or \u003ccode\u003einsertId\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eFleet Engine's split log structure is similar to Cloud Audit Logs, with splitting occurring in the \u003ccode\u003ejsonPayload\u003c/code\u003e field.\u003c/p\u003e\n"]]],[],null,["Cloud Logging limits the size on incoming logs to 256KB and drops\nanything bigger. To ensure that Cloud Logging retains your large\nlogs, Fleet Engine can split them into a series of smaller logs.\n\nCloud logging may split the following logs from Fleet Engine:\n\n- [SearchVehiclesLog](/maps/documentation/mobility/operations/cloud-logging/reference/trips/rest/Shared.Types/SearchVehiclesLog)\n- [ListDeliveryVehicle](/maps/documentation/mobility/operations/cloud-logging/reference/tasks/rest/Shared.Types/ListDeliveryVehiclesLog)\n- [ListTasksLog](/maps/documentation/mobility/operations/cloud-logging/reference/tasks/rest/Shared.Types/ListTasksLog)\n- [BatchCreateTasksLog](/maps/documentation/mobility/operations/cloud-logging/reference/tasks/rest/Shared.Types/BatchCreateTasksLog)\n\nEach split log entry contains the following fields:\n\n- `split.uid`: A unique identifier for the group of log entries that were split from a common original log entry. The value of this field is the same for all entries split from the original log entry.\n- `split.index`: The position of this entry in the series of split entries. The first entry from the split has index `0.split.index`. This index is also appended to the `LogEntry.insertId` field.\n- `split.totalSplits`: The number of log entries that the original log entry was split into. The value of this field is the same for all entries split from the original log entry.\n\n split log 1:\n insertId: \"XXXX-01\"\n split {index: 0, uuid: \"XXXX\"}\n\n splitLog 2:\n insertId: \"XXX-02\"\n split {index: 1, uuid: \"XXXX\"}\n\nTo find all the logs that were split from one specific log, use a query like: \n\n split.uid=\"789+2022-02-22T12:22:22.22+05:00\"\n sortby split.index OR sortby insertID\n\nThe structure of these split logs is almost the same as the structure shown in\nthe guide for Cloud Audit Logs. The major difference is that for Fleet Engine\nlogs, the split occurs in the `jsonPayload` field. For details and examples, see\n[Split audit log entries](https://cloud.google.com/logging/docs/audit/split-logs).\n\nWhat's next\n\nTo count and filter logs according to you criteria, [create log-based\nmetrics](/maps/documentation/mobility/operations/cloud-logging/metrics)."]]