Configura Cloud Logging
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Abilita Cloud Logging
Il logging dovrebbe essere abilitato automaticamente per Fleet Engine.
- Apri Esplora log.
Inserisci la seguente query:
resource.type:"fleetengine.googleapis.com"
Se i risultati della query elencano i log, il logging è abilitato.
Se non vedi alcun log elencato nei risultati di questa query,
Cloud Logging potrebbe non essere abilitato per il tuo progetto. Per attivare
Cloud Logging, contatta l'assistenza Google Maps Platform.
Abilita log di utilizzo limitato
In conformità con i Termini di servizio specifici per i servizi di mobilità, alcuni
dei dati di log generati da Fleet Engine possono essere conservati solo per 30 giorni.
Fleet Engine etichetta questi log come TOS_RESTRICTED e li ordina in un bucket dei log con periodo di conservazione limitato, che devi creare come mostrato di seguito.
Tutti gli altri dati di log vengono assegnati al bucket predefinito in cui possono essere conservati
più a lungo, come definito nei Termini di servizio specifici per la mobilità.
Consulta Archiviazione log nella console Google Cloud per informazioni sulla personalizzazione dei bucket di log e dei relativi periodi di conservazione.
Per l'analisi, puoi unire i dati dei log con accesso limitato e predefiniti per ottenere un
set completo di dati di log.
Per attivare i log di utilizzo con limitazioni:
Crea un sink e un bucket per i log a uso limitato e filtra i log nei bucket appropriati.
Contatta l'assistenza per attivare i log di utilizzo con limitazioni.
Per maggiori dettagli, consulta le sezioni seguenti.
Crea un sink e un bucket per i log con accesso limitato nel tuo progetto
In Esplora log, nel riquadro di navigazione a sinistra, apri la pagina Router dei log.
Modifica il bucket di logging _Default per escludere i log a uso limitato.
- In Sink di Log Router, seleziona il bucket di logging _Default.
- Scegli Modifica sink dal menu Azioni.
- Vai alla sezione Scegli i log da escludere dal sink e fai clic sul pulsante
Aggiungi esclusione.
- Imposta Nome filtro di esclusione su ExcludeRestrictedLogs.
- Nella casella Crea filtro di esclusione, incolla questo filtro:
labels.restriction="TOS_RESTRICTED"
- Fai clic su Aggiorna sink.
Crea un bucket di logging con accesso limitato per archiviare i log a uso limitato. Per farlo, crea un sink e un bucket per tutti i log, quindi escludi i log non soggetti a limitazioni.
- Nella pagina Log Router, nella parte superiore, seleziona
Crea sink.
- Compila i dettagli del sink:
- Nome: RestrictedLogs
- Descrizione: Registra i log di utilizzo con limitazioni di Fleet Engine Routes.
- Fai clic su Avanti.
- Compila il campo Destinazione sink:
- Seleziona il servizio sink: bucket di Logging
- Seleziona bucket di log: seleziona Crea nuovo bucket di log.
- Nella finestra di dialogo Dettagli bucket, compila:
- Nome: Restricted
- Descrizione: contiene i log di utilizzo con limitazioni di Fleet Engine.
- Lascia invariate le altre impostazioni e fai clic su Avanti.
- Imposta il Periodo di conservazione su 30 giorni. Il periodo di conservazione non deve superare i 30 giorni.
- Fai clic su Crea bucket.
- Nella finestra di dialogo di creazione del sink, lascia vuota la sezione Log da includere nel sink.
- Nella sezione Log da escludere dal sink, fai clic su Aggiungi esclusione
e compila:
- Nome del filtro di esclusione: ExcludeNonRestrictedLogs
- Filtro di esclusione:
NOT (resource.type =
"fleetengine.googleapis.com/Fleet" OR resource.type =
"fleetengine.googleapis.com/DeliveryFleet") NOT (labels.restriction
= "TOS_RESTRICTED")
- Fai clic su Crea sink.
- Vai all'assistenza Google Maps Platform.
- Fai clic su Crea richiesta per avviare una nuova richiesta di assistenza.
Fornisci le seguenti informazioni:
- ID progetto da attivare.
- L'indirizzo email della persona che richiede la modifica. Questa persona deve
disporre dell'accesso in modifica ai progetti Google Cloud che stai elencando.
Accetta quanto segue scrivendo Sì: Se attivi i contenuti di Google Maps a uso limitato in Cloud Logging, accetti di rispettare i termini della piattaforma Google Maps e i termini specifici del servizio di mobilità, inclusi i requisiti di memorizzazione nella cache e di utilizzo consentito in relazione ai contenuti di Google Maps.
Una volta che il team di assistenza avrà gestito la tua richiesta, riceverai una conferma che
la registrazione è stata attivata per il tuo progetto.
Passaggi successivi
Scopri come lavorare con i log in Esplora log.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-09-05 UTC.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 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)."]]
