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 Explorador de registros do Cloud.

Neste guia, descrevemos como consultar registros de erros de complementos no Explorador de registros do Cloud para que você possa:

  • saber se os usuários encontram erros.
  • Veja com que frequência os erros ocorrem e quais são os mais frequentes.
  • Leia as mensagens de erro descritivas que ajudam na correção.

Pré-requisitos

Antes de consultar os registros de erros de complementos:

Registros de erros dos complementos de consulta

Para fazer o download dos registros de um complemento, faça o seguinte:

  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. O Explorador de registros será aberto.
  4. Para registros de erros de complementos, no criador de consultas, insira a seguinte consulta:

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

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

Ativar ou desativar a geração de registros 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 de complementos no Cloud Logs Explorer, observe estas considerações:

  • Os complementos só registram erros na Análise de registros. Outros tipos de registro não são gravados.
  • 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.