Esegui query sui log degli errori per le app Google Chat

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 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 guida rapida.
• Attiva la registrazione degli errori per l'app Chat.

Log degli errori delle query

1. Nella console Google Cloud, fai clic su Menu > Altri prodotti > Logging > Esplora log.

   Vai a Esplora log

2. Se necessario, per visualizzare Query Builder, attiva Mostra query.

3. Per i log degli errori dell'app Chat, inserisci la seguente query:

   severity=ERROR
   resource.type="chat.googleapis.com/Project"
   

4. Per visualizzare gli errori recenti, fai clic su Esegui query. In alternativa, per visualizzare gli errori man mano che si verificano, fai clic su Log di streaming. 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:

• Visualizza i log utilizzando Esplora log
• Creare query in 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 file JSON include il messaggio di errore in 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 lavori con i log degli errori dell'app Chat in Esplora log di Google Cloud, tieni presente queste considerazioni:

• Per le app Google Chat, Esplora log include attualmente i log con le seguenti gravità, che aiutano a risolvere i problemi di un'app malfunzionante:

  • ERROR

  Anche i log dei servizi correlati possono essere utili per il debug di un'app Chat. Ad esempio, se un'app Chat viene implementata utilizzando Google Cloud Functions, è una best practice controllare anche i log di Cloud Functions in Esplora log.

• 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 della suite operativa di Google Cloud.

Argomenti correlati

Dopo aver eseguito una query nei log degli errori, se ne trovi, consulta le seguenti guide per ricevere assistenza nella 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 della carta, ad esempio messaggi, finestre di dialogo o anteprime dei link della carta che non vengono visualizzati o non funzionano come previsto.
• Scopri come eseguire il debug.