Questa guida descrive come eseguire query sui log degli errori dell'app Chat in Esplora log di Google Cloud. Esegui query nei log per:
- Scopri di più in caso di errori.
- Scopri con quale frequenza si verificano errori e quali sono più frequenti.
- Leggi i messaggi di errore descrittivi e i dati di log che ti aiutano a correggere gli errori.
Prerequisiti
- Un account Google Workspace con accesso a Google Chat.
- Un'app di Chat. Per creare un'app di Chat, segui questa quickstart.
- Attivare 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 il Query Builder, attiva Mostra query.
Per i log degli errori dell'app Chat, inserisci la query seguente:
severity=ERROR resource.type="chat.googleapis.com/Project"
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 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 degli errori, puoi visualizzare i singoli log costituiti da un payload JSON che descrive il log. Per gli errori dell'app Chat, il formato 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 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 malfunzionamento di un'app:
ERROR
I log dei servizi correlati possono anche essere utili per eseguire il debug di un'app di Chat. Ad esempio, se il deployment di un'app di Chat viene eseguito utilizzando Google Cloud Functions, la best practice prevede anche il controllo di 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 riscontri errori, consulta le seguenti guide per la correzione degli 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 dei link che non vengono visualizzati o funzionano come previsto.
- Scopri come eseguire il debug.