Quando un componente aggiuntivo di Google Workspace pubblicato restituisce un errore, l'interfaccia del componente aggiuntivo restituisce il messaggio generico "Si è verificato un problema durante l'esecuzione del componente aggiuntivo". Tuttavia, questi errori vengono registrati in Esplora log di Cloud.
Questa guida descrive come eseguire query sui log degli errori dei componenti aggiuntivi in Cloud Logs Explorer, in modo da poter:
- Scopri di più in caso di errori.
- Scopri con quale frequenza si verificano errori e quali sono più frequenti.
- Leggi messaggi di errore descrittivi che ti aiuteranno a correggerli.
Prerequisiti
Prima di eseguire query sui log degli errori dei componenti aggiuntivi:
- Attivare "API Cloud Logging" nel progetto Google Cloud del componente aggiuntivo. Per abilitare un'API, consulta la sezione Creare un progetto Cloud e abilitare l'API.
- Pubblica il componente aggiuntivo su Google Workspace Marketplace. Per pubblicare un componente aggiuntivo nel Marketplace, consulta Pubblicare un'app.
Esegui query sui log degli errori dei componenti aggiuntivi
Per recuperare i log per un componente aggiuntivo:
- Apri la console Google Cloud.
- Accanto a "Google Cloud Platform", fai clic sulla Freccia giù e seleziona il progetto del componente aggiuntivo.
- Nell'angolo in alto a sinistra, fai clic su Menu > Logging. Si apre Esplora log.
Per i log degli errori dei componenti aggiuntivi, inserisci la seguente query in Query Builder:
severity>=ERROR protoPayload.serviceName="gsuiteaddons.googleapis.com"Per visualizzare gli errori recenti, fai clic su Esegui query. In alternativa, per visualizzare gli errori non appena si verificano, fai clic su Avvia flusso di log. I log degli errori dei componenti aggiuntivi vengono visualizzati nel riquadro "Risultati delle query".
Per ulteriori informazioni su Esplora log di Cloud e la scrittura delle query, consulta quanto segue:
Attivare o disattivare il logging degli errori
Il logging degli errori è abilitato per impostazione predefinita. Quando il logging degli errori è abilitato, il file manifest contiene quanto segue:
"exceptionLogging": "STACKDRIVER",
Per disabilitare il logging degli errori, sostituisci "exceptionLogging": "STACKDRIVER", con la riga seguente nel file manifest:
// Disable error logging
"exceptionLogging": "NONE"
Per riattivare il logging degli errori, sostituisci "exceptionLogging": "NONE" con
"exceptionLogging": "STACKDRIVER",.
considerazioni
Quando utilizzi i log degli errori dei componenti aggiuntivi in Cloud Logs Explorer, tieni presente queste considerazioni:
- I componenti aggiuntivi registrano solo gli errori in Esplora log. Non vengono registrati altri tipi di log.
- I messaggi di errore sono sempre scritti in inglese.
- Cloud Logging prevede un costo. Per ulteriori informazioni sui prezzi di Cloud Logging, consulta la pagina relativa ai prezzi di Google Cloud Observability.