Questa guida descrive come eseguire query sui log degli errori dell'app Chat in Esplora log di Google Cloud. Esegui query sui log per:
- 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 e i dati di log descrittivi che ti aiutano a risolverli.
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 la registrazione degli errori per l'app Chat.
Log degli errori di query
Nella console Google Cloud, fai clic su Menu > Altri prodotti > Logging > Esplora log.
Se necessario, per visualizzare il generatore di query, attiva Mostra query.
Per i log degli errori dell'app 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 Chat vengono visualizzati nel riquadro "Risultati delle query".
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 di errore, 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 di 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 severità che aiutano a risolvere i problemi di un'app che non funziona correttamente:
ERROR
Anche i log dei servizi correlati possono essere utili per eseguire il debug di un'app Chat. Ad esempio, se un'app Chat viene dispiattata utilizzando Google Cloud Functions, è buona prassi controllare anche i log di Cloud Functions in Esplora log.
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 quando i messaggi, le finestre di dialogo o le anteprime dei link delle schede non vengono visualizzati o non funzionano come previsto.
- Scopri come eseguire il debug.