Neste guia, descrevemos como consultar os registros de erros do app do Chat na Análise de registros do Google Cloud. Consultar registros para:
- Saiba se os usuários encontram erros.
- Veja com que frequência os erros ocorrem e quais são mais frequentes.
- Leia mensagens de erro descritivas e dados de registro que ajudam a corrigir os erros.
Pré-requisitos
- Uma conta do Google Workspace com acesso ao Google Chat.
- Um app do Chat. Para criar um app do Chat, siga este quickstart.
- Ative a geração de registros de erros no app do Chat.
Registros de erro de consulta
No Console do Google Cloud, clique em Menu > Mais produtos > Logging > Análise de registros.
Se necessário, ative Mostrar consulta para exibir o Criador de consultas.
Para registros de erros do app do Chat, digite a seguinte consulta:
severity=ERROR resource.type="chat.googleapis.com/Project"
Para acessar os erros recentes, clique em Executar consulta. Para ver os erros à medida que eles ocorrem, clique em Fazer streaming de registros. Os registros de erros do app de chat aparecem no painel "Resultados da consulta".
Para saber mais sobre a Análise de registros do Google Cloud e como criar 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 descrevendo o registro. Para erros no app do Chat, o JSON inclui a mensagem de erro em jsonPayload.error.message
. Por exemplo, no exemplo de registro a seguir, a mensagem de erro informa que uma função do Apps Script não foi executada:
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, preste atenção a estas considerações:
Nos apps do Google Chat, a Análise de registros inclui registros com as seguintes gravidades, que ajudam a resolver problemas no app:
ERROR
Os registros de serviços relacionados também podem ajudar a depurar um app do Chat. Por exemplo, se um app do Chat for implantado usando o Google Cloud Functions, também é uma prática recomendada verificar a Análise de registros para os registros do Cloud Functions.
As mensagens de erro são sempre escritas em inglês.
O Cloud Logging gera um custo. Para mais informações sobre os preços do Cloud Logging, consulte Preços do pacote de operações do Google Cloud.
Temas relacionados
Depois de consultar os registros de erros, se você encontrar erros, consulte os seguintes guias para corrigir erros:
- Saiba como corrigir erros no app Google Chat, como "O app não está respondendo", "A API Google Chat está disponível apenas para usuários do Google Workspace" ou "Os usuários podem ser excluídos dos espaços".
- Saiba como corrigir erros de card, como mensagens, caixas de diálogo ou visualizações de links que não são renderizadas ou funcionam como esperado.
- Saiba como depurar.