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 제한적 사용 로그를 라우팅합니다.
- 다음을 클릭합니다.
- 싱크 대상을 입력합니다.
- 싱크 서비스 선택: 로깅 버킷
- 로그 버킷 선택: 새 로그 버킷 만들기를 선택합니다.
- 버킷 세부정보 대화상자에 다음을 입력합니다.
- 이름: 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 약관 및 모빌리티 서비스별 약관을 준수하는 데 동의하는 것으로 간주됩니다.
지원팀에서 요청을 처리하면 프로젝트에 로깅이 사용 설정되었다는 확인 이메일이 전송됩니다.
다음 단계
로그 탐색기에서 로그로 작업하는 방법을 알아보세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 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)."]]
