Registros de erros de consulta para apps do Google Chat

Neste guia, descrevemos como consultar os registros de erros do app do Chat na Análise de registros do Google Cloud. Consulte os registros para:

  • Saiba se os usuários encontram erros.
  • Veja com que frequência os erros ocorrem e quais são os mais frequentes.
  • Leia mensagens de erro descritivas e dados de registro que ajudem a corrigir os erros.

Pré-requisitos

Registros de erros de consulta

  1. No console do Google Cloud, clique em Menu > Mais produtos > Geração de registros > Análise de registros.

    Acessar a Análise de registros

  2. Se necessário, ative a opção Mostrar consulta para mostrar o Criador de consultas.

  3. Para os registros de erros do app do Chat, digite a seguinte consulta:

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

  4. Para acessar os erros recentes, clique em Executar consulta. Ou clique em Fazer streaming de registros para ver os erros à medida que eles ocorrem. Os registros de erros do app do Chat aparecem nos "Resultados da consulta" .

Para saber mais sobre a Análise de registros do Google Cloud e como escrever consultas, consulte estes guias na documentação da Análise de registros:

Ler uma mensagem de erro de um registro

Depois de consultar um registro de erros, é possível visualizar registros individuais que consistem em um payload JSON que descreve o registro. Para erros do app do Chat, o JSON inclui a mensagem em jsonPayload.error.message. Por exemplo, no registro de amostra a seguir, a mensagem de erro informa que houve falha na execução de uma função do Apps Script:

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"
}

Considerações

Ao trabalhar com os registros de erro do app do Chat na Análise de registros do Google Cloud, observe estas considerações:

  • Nos apps do Google Chat, a Análise de registros inclui registros com as seguintes gravidades, que ajudam a resolver problemas de um app com falha:

    • ERROR

    Os registros de serviços relacionados também podem ajudar a depurar um app do Chat. Por exemplo, se um app de chat for implantado usando o Google Cloud Functions, é recomendável verificar os registros do Cloud Functions na Análise de registros.

  • As mensagens de erro são sempre escritas em inglês.

  • O Cloud Logging tem um custo. Para mais informações sobre os preços do Cloud Logging, consulte os preços do pacote de operações do Google Cloud.

Depois de consultar os registros de erros, se você encontrar erros, consulte os seguintes guias para ajudar a corrigir erros: