Configurar o Cloud Logging
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Ativar Cloud Logging
O Fleet Engine deve ter a geração de registros ativada automaticamente.
- Abra a Análise de registros.
Digite a seguinte consulta:
resource.type:"fleetengine.googleapis.com"
Se os resultados da consulta listarem registros, a geração de registros estará ativada.
Se não houver registros nos resultados da consulta, talvez o Cloud Logging não esteja ativado para seu projeto. Para ativar o
Cloud Logging, entre em contato com o suporte da Plataforma Google Maps.
Ativar registros de uso restrito
De acordo com os Termos específicos do serviço de mobilidade, alguns dos dados de registro gerados pelo Fleet Engine podem ser retidos por apenas 30 dias.
O Fleet Engine rotula esses registros como TOS_RESTRICTED e os classifica em um bucket de registros de retenção restrita, que você precisa criar conforme mostrado abaixo.
Todos os outros dados de registros são atribuídos ao bucket padrão, onde podem ser retidos por mais tempo, conforme definido nos Termos específicos do serviço de mobilidade.
Consulte Armazenamento de registros no console do Google Cloud para saber como personalizar seus buckets de registro e os períodos de retenção deles.
Para análise, é possível combinar os dados dos registros restritos e padrão para ter um conjunto completo de dados de registro.
Faça o seguinte para ativar os registros de uso restrito:
Crie um coletor e um bucket para registros de uso restrito e filtre os registros nos buckets apropriados.
Entre em contato com o suporte para ativar os registros de uso restrito.
Confira mais detalhes nas próximas seções.
Crie um coletor e um bucket para registros restritos no seu projeto
Na Análise de registros, no painel de navegação à esquerda, abra a página Roteador de registros.
Modifique o bucket de registros _Default para excluir registros de uso restrito.
- Em Coletores do Log Router, selecione o bucket de registros _Default.
- Escolha Editar coletor no menu Ações.
- Acesse a seção Escolher os registros para filtrar o coletor e clique no botão
Adicionar exclusão.
- Defina o Nome do filtro de exclusão como ExcludeRestrictedLogs.
- Na caixa Criar um filtro de exclusão, cole este filtro:
labels.restriction="TOS_RESTRICTED"
- Clique em Atualizar coletor.
Crie um bucket de registro restrito para armazenar os registros de uso restrito. Para isso, crie um coletor e um bucket para todos os registros e exclua os registros não restritos.
- Na página do Roteador de registros, na parte de cima, selecione Criar coletor.
- Preencha os Detalhes do coletor:
- Nome: RestrictedLogs
- Descrição: Faz o roteamento dos registros de uso restrito do Fleet Engine.
- Clique em Próxima.
- Preencha o Destino do coletor:
- Selecione Serviço do coletor: bucket do Logging
- Selecione o bucket de registros: selecione Criar novo bucket de registros.
- Na caixa de diálogo Detalhes do bucket, preencha:
- Nome: Restrito
- Descrição: contém registros de uso restrito do Fleet Engine.
- Deixe o resto como está e clique em Próxima.
- Defina o Período de retenção como 30 dias. O período de retenção não pode exceder 30 dias.
- Clique em Criar bucket.
- De volta à caixa de diálogo de criação do coletor, deixe a seção Registros a serem incluídos no coletor vazia.
- Na seção Registros para filtrar do coletor, clique em Adicionar exclusão
e preencha:
- Nome do filtro de exclusão: ExcludeNonRestrictedLogs
- Filtro de exclusão:
NOT (resource.type =
"fleetengine.googleapis.com/Fleet" OR resource.type =
"fleetengine.googleapis.com/DeliveryFleet") NOT (labels.restriction
= "TOS_RESTRICTED")
- Clique em Criar coletor.
- Acesse o suporte da Plataforma Google Maps
- Clique em Criar caso para iniciar uma nova solicitação de suporte.
Forneça as seguintes informações:
- IDs de projeto a serem ativados.
- Endereço de e-mail da pessoa que está solicitando a mudança. Essa pessoa precisa ter acesso de edição aos projetos do Google Cloud que você está listando.
Escreva Sim para concordar com o seguinte: Ao ativar o conteúdo do Google Maps de uso restrito no Cloud Logging, você concorda em obedecer aos termos da Plataforma Google Maps e aos termos específicos do serviço de mobilidade, incluindo os requisitos de uso permitido e de armazenamento em cache relacionados ao conteúdo do Google Maps.
Depois que a equipe de suporte processar sua solicitação, você vai receber uma confirmação de que
o registro em log foi ativado para seu projeto.
A seguir
Saiba como trabalhar com registros no Explorador de registros.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-09-05 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-05 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)."]]
