Questa guida descrive come eseguire query sui log degli errori dell'app di Chat in Esplora log di Google Cloud. Le query vengono eseguite nei log di:
- Scopri se gli utenti riscontrano errori.
- Scopri con quale frequenza si verificano gli errori e quali sono più frequenti.
- Leggi i messaggi di errore e i dati di log descrittivi che ti aiuteranno a correggerli.
Prerequisiti
- Un account Google Workspace con accesso a Google Chat.
- Un'app di Chat. Per creare un'app di Chat, segui questa guida rapida.
- Attiva il logging degli errori per l'app Chat.
Log degli errori delle query
Nella console Google Cloud, fai clic su Menu. > Altri prodotti > Logging > Esplora log.
Se necessario, per visualizzare Query Builder, attiva Mostra query.
Per i log degli errori dell'app di Chat, inserisci la seguente query:
severity=ERROR resource.type="chat.googleapis.com/Project"
Per visualizzare gli errori recenti, fai clic su Esegui query. In alternativa, per visualizzare gli errori a mano a mano che si verificano, fai clic su Avvia flusso di log. I log degli errori dell'app di chat vengono visualizzati nella sezione "Risultati delle query" riquadro.
Per saperne di più su Esplora log di Google Cloud e sulla scrittura di query, consulta queste guide nella documentazione di Esplora log:
Leggere un messaggio di errore da un log
Dopo aver eseguito una query su un log degli errori, puoi visualizzare i singoli log costituiti da un payload JSON che descrive il log. Per gli errori dell'app Chat, il codice JSON include il messaggio di errore all'indirizzo jsonPayload.error.message
. Ad esempio, nel seguente log di esempio, il messaggio di errore indica che l'esecuzione di una funzione Apps Script non è riuscita:
JSON
{
"insertId": "INSERT_ID",
"jsonPayload": {
"@type": "type.googleapis.com/google.chat.logging.v1.ChatAppLogEntry",
"error": {
"code": 9,
"message": "An Apps Script function failed to execute. To review AppsScript error logs, see \"Logging\" (https://developers.google.com/apps-script/guides/logging)."
},
"deployment": "DEPLOYMENT_ID"
},
"resource": {
"type": "chat.googleapis.com/Project",
"labels": {
"project_id": "PROJECT_ID"
}
},
"timestamp": "2022-12-06T05:24:18.697255Z",
"severity": "ERROR",
"logName": "projects/PROJECT_ID/logs/chat.googleapis.com%2Ferrors",
"receiveTimestamp": "2022-12-06T05:24:19.207936968Z"
}
Considerazioni
Quando utilizzi i log degli errori dell'app di Chat in Esplora log di Google Cloud, tieni presente queste considerazioni:
Per le app Google Chat, Esplora log attualmente include i log con le seguenti gravità, che aiutano a risolvere i problemi di un'app che non funziona:
ERROR
I log dei servizi correlati possono anche aiutare a eseguire il debug di un'app di Chat. Ad esempio, se il deployment di un'app di chat viene eseguito utilizzando Google Cloud Functions, è consigliabile controllare anche Esplora log per i log di Cloud Functions.
I messaggi di errore sono sempre scritti in inglese.
Cloud Logging prevede un costo. Per saperne di più sui prezzi di Cloud Logging, consulta i prezzi della suite operativa di Google Cloud.
Argomenti correlati
Se dopo aver eseguito query sui log degli errori trovi errori, consulta le seguenti guide per correggere gli errori:
- Scopri come correggere gli errori dell'app Google Chat, ad esempio "L'app non risponde", "L'API Google Chat è disponibile solo per gli utenti di Google Workspace" o "Gli utenti possono essere esclusi dagli spazi".
- Scopri come correggere gli errori delle schede, ad esempio messaggi delle schede, finestre di dialogo o anteprime di link che non vengono visualizzate o non funzionano come previsto.
- Scopri come eseguire il debug.