Eseguire query sui log degli errori per i componenti aggiuntivi di Google Workspace

Quando un componente aggiuntivo Google Workspace pubblicato restituisce un errore, l'interfaccia del componente aggiuntivo restituisce un messaggio generico: "Si è verificato un errore 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 Esplora log di Cloud, in modo da poter:

  • Scopri se gli utenti riscontrano errori.
  • Scopri con quale frequenza si verificano gli errori e quali sono i più frequenti.
  • Leggi i messaggi di errore descrittivi che ti aiutano a risolverli.

Prerequisiti

Prima di eseguire query sui log degli errori dei componenti aggiuntivi:

  • Abilita l'"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 sul Marketplace, consulta Pubblicare un'app.

Eseguire query sui log degli errori dei componenti aggiuntivi

Per ottenere i log di un componente aggiuntivo:

  1. Apri la console Google Cloud.
  2. Accanto a "Google Cloud Platform", fai clic sulla Freccia giù e seleziona il progetto del componente aggiuntivo.
  3. Nell'angolo in alto a sinistra, fai clic su Menu > Registrazione. Si apre Esplora log.

  4. Per i log degli errori dei componenti aggiuntivi, inserisci la seguente query in Query Builder:

    severity>=ERROR
protoPayload.serviceName="gsuiteaddons.googleapis.com"

  5. Per visualizzare gli errori recenti, fai clic su Esegui query. In alternativa, per visualizzare gli errori man mano che 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 sulla scrittura di query, consulta quanto segue:

Attivare o disattivare la registrazione degli errori

Per impostazione predefinita, la registrazione degli errori è attiva. Quando il logging degli errori è attivato, il file manifest contiene quanto segue:

"exceptionLogging": "STACKDRIVER",

Per disattivare la registrazione degli errori, sostituisci "exceptionLogging": "STACKDRIVER", con la seguente riga nel file manifest:

// Disable error logging
"exceptionLogging": "NONE"

Per riattivare la registrazione degli errori, sostituisci "exceptionLogging": "NONE" con "exceptionLogging": "STACKDRIVER",.

Considerazioni

Quando lavori con i log degli errori dei componenti aggiuntivi in Esplora log di Cloud Logging, tieni presente queste considerazioni:

  • I componenti aggiuntivi registrano gli errori solo in Esplora log. Gli altri tipi di log non vengono registrati.
  • I messaggi di errore sono sempre scritti in inglese.
  • Cloud Logging comporta un costo. Per ulteriori informazioni sui prezzi di Cloud Logging, consulta la pagina Prezzi di Google Cloud Observability.