Registros de erros de consulta dos complementos do Google Workspace

Quando um complemento publicado do Google Workspace retorna um erro, a interface do complemento retorna uma mensagem genérica de "Algo deu errado ao executar o complemento". No entanto, esses erros são registrados no Análise de registros do Cloud.

Neste guia, descrevemos como consultar registros de erros do complemento na Análise de registros do Cloud para que você possa:

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

Pré-requisitos

Antes de consultar os registros de erros dos complementos, faça o seguinte:

Registros de erro do complemento de consulta

Para acessar os registros de um complemento:

  1. Abra o Console do Google Cloud.
  2. Ao lado de "Google Cloud Platform", clique na seta para baixo e selecione o projeto complementar.
  3. No canto superior esquerdo, clique em Menu > Logging. A Análise de registros será aberta.
  4. Para registros de erros de complementos, insira a seguinte consulta no criador de consultas:

    severity>=ERROR
    protoPayload.serviceName="gsuiteaddons.googleapis.com"
    
  5. Para acessar os erros recentes, clique em Executar consulta. Ou, para ver os erros conforme eles ocorrem, clique em Fazer streaming de registros. Os registros de erro de complementos aparecem no painel "Resultados da consulta".

Para mais informações sobre a Análise de registros do Cloud e como gravar consultas, consulte os seguintes itens:

Ativar ou desativar o registro de erros

Por padrão, a geração de registros de erros está ativada. Quando a geração de registros de erros está ativada, o arquivo de manifesto tem o seguinte:

"exceptionLogging": "STACKDRIVER",

Para desativar a geração de registros de erros, substitua "exceptionLogging": "STACKDRIVER", pela seguinte linha no arquivo de manifesto:

// Disable error logging
"exceptionLogging": "NONE"

Para reativar a geração de registros de erros, substitua "exceptionLogging": "NONE" por "exceptionLogging": "STACKDRIVER",.

considerações

Ao trabalhar com registros de erros complementares no Cloud Logs Explorer, observe estas considerações:

  • Os complementos registram erros apenas na Análise de registros. Outros tipos de registro não são registrados.
  • 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 de observabilidade do Google Cloud.