분할 로그로 긴 로그 항목 처리
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Cloud Logging은 수신 로그의 크기를 256KB로 제한하고 이보다 큰 항목은 삭제합니다. 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 감사 로그 가이드에 표시된 구조와 거의 동일합니다. 가장 큰 차이점은 Fleet Engine 로그의 경우 분할이 jsonPayload
필드에서 발생한다는 것입니다. 자세한 내용과 예시는 감사 로그 항목 분할을 참고하세요.
다음 단계
기준에 따라 로그를 집계하고 필터링하려면 로그 기반 측정항목을 만드세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 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)."]]