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:

  • Scoprire se gli utenti riscontrano errori.
  • Scoprire la frequenza degli errori e quali sono i più frequenti.
  • Leggere i messaggi di errore descrittivi e i dati di log che ti aiutano a correggere gli errori.

Prerequisiti

Eseguire query sui log degli errori

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

    Vai a Esplora log

  2. Se necessario, per visualizzare il generatore di query, 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 Trasmetti log. I log degli errori dell'app Chat vengono visualizzati nel riquadro "Risultati 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 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 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 lavori con i log degli errori dell'app Chat in Esplora log di Google Cloud, tieni presente le seguenti considerazioni:

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

    • ERROR

    I log dei servizi correlati possono anche aiutarti a eseguire il debug di un'app Chat. Ad esempio, se esegui il deployment dell'app Chat utilizzando le funzioni di Google Cloud Run, controlla anche i log delle funzioni di Cloud Run 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 Prezzi della suite operativa di Google Cloud.

Dopo aver eseguito query sui log degli errori, se riscontri errori, consulta le seguenti guide per ricevere assistenza nella correzione degli errori: