Esegui query sui log degli errori per le app Google Chat

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

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 di 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 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.

Se dopo aver eseguito query sui log degli errori trovi errori, consulta le seguenti guide per correggere gli errori: