É possível configurar o Error Reporting para enviar notificações aos canais de notificação selecionados do Cloud Monitoring quando ocorrem eventos de erro.
O Error Reporting envia notificações nos seguintes casos:
Quando um evento de erro ocorre em um Google Cloud projeto e não pode ser agrupado com erros anteriores.
Se um evento de erro ocorrer em um grupo de erros marcado como Resolvido.
Gerenciar canais de notificação
Crie, edite e exclua canais de notificação no Monitoring. Depois de criar canais de notificação, é possível configurar o Error Reporting para usá-los.
O Error Reporting permite que você selecione quatro tipos de canal de notificação: e-mail, dispositivo móvel, Slack e Webhooks.
Antes de começar
Para receber as permissões necessárias para visualizar e configurar canais de notificação usando o Google Cloud console,
peça ao administrador para conceder a você o
papel Editor do Monitoring (roles/monitoring.editor) do IAM no seu projeto.
Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.
Também é possível conseguir as permissões necessárias usando personalizados papéis ou outros predefinidos papéis.
Para mais informações sobre os papéis do Cloud Monitoring, consulte Controlar o acesso com o Identity and Access Management.
Criar canal de notificação
Para criar um canal de notificação usando o Google Cloud console, siga as instruções específicas do canal contidas na tabela a seguir:
Para adicionar um canal de notificação por e-mail, faça o seguinte:
-
No Google Cloud console do, acesse a página notifications Alertas:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.
- Na barra de ferramentas do Google Cloud console, selecione seu Google Cloud projeto. Para App Hub configurações, selecione o projeto host do App Hub ou o projeto de gerenciamento.
- Clique em Editar canais de notificação.
- Na seção E-mail, clique em Adicionar novo.
- Insira um único endereço de e-mail e uma descrição.
- Clique em Salvar.
Se um endereço de e-mail de grupo for utilizado como o canal de notificação de
uma política de alertas, configure o grupo para aceitar e-mails de
ErrorReportingNotifications-noreply@google.com.
Aplicativo para dispositivos móveis
Use o Google Cloud aplicativo do console para dispositivos móveis para monitorar seus Google Cloud recursos do console e informações do Monitoring em qualquer lugar. Google Cloud As notificações do aplicativo do console para dispositivos móveis são enviadas para um dispositivo ou usuário específico:
- Dispositivo indica que as notificações são enviadas apenas para o dispositivo específico que criou o canal de notificação. Para canais de notificação com escopo no dispositivo, o Nome de exibição campo inclui informações do dispositivo.
- Usuário indica que as notificações são enviadas para todos os seus dispositivos com o Google Cloud aplicativo do console para dispositivos móveis instalado.
O Cloud Monitoring determina o escopo de notificação quando o canal é criado. Não é possível selecionar ou alterar o escopo.
Para configurar um Google Cloud canal de notificação do aplicativo do console para dispositivos móveis para um projeto Google Cloud específico, faça o seguinte:
- Instale o aplicativo do Google Cloud console para dispositivos móveis da app store do seu dispositivo móvel.
Selecione um projeto para visualização no aplicativo do Google Cloud console para dispositivos móveis.
Depois de selecionar um projeto, ocorre uma troca de dados entre o aplicativo e o projeto selecionado Google Cloud Um canal de notificação é criado quando não existe e, após alguns minutos, esse canal é listado na seção Dispositivos móveis dos Canais de notificação.
Para adicionar seu dispositivo móvel como um canal de notificação para uma política de alertas, na seção Notificações, selecione Google Cloud console (dispositivo móvel) e escolha seu dispositivo móvel na lista.
Slack
Para configurar as notificações do Slack, faça o seguinte:
No Slack: crie um espaço de trabalho e um canal no site do Slack. Grave o URL do canal.
-
No Google Cloud console do, acesse a página notifications Alertas:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.
Na barra de ferramentas do Google Cloud console, selecione seu Google Cloud projeto. Para App Hub configurações, selecione o projeto host do App Hub ou o projeto de gerenciamento.
Clique em Editar canais de notificação.
Na seção Slack, clique em Adicionar novo para abrir a página de login do Slack:
- Selecione o espaço de trabalho do Slack.
- Clique em Permitir para ativar o acesso do Cloud Monitoring ao seu espaço de trabalho do Slack. Essa ação levará você de volta à página de configuração do Monitoring do canal de notificação.
- No campo Nome do canal do Slack, digite o nome do canal do Slack que você quer usar para as notificações.
- No campo Nome de exibição do Cloud Alerting, insira uma declaração descritiva curta. O Monitoring mostra o valor desse campo na página Canal de notificações.
- (Opcional) Para testar a conexão entre
o Cloud Monitoring e o espaço de trabalho do Slack, clique em
Enviar notificação de teste. Se a conexão for estabelecida, então
você vai receber uma mensagem
This is a test alert notification...no canal de notificação do Slack especificado. Verifique o canal de notificação para confirmar o recebimento.
Se o canal do Slack que você quer usar para notificações for um canal particular, convide manualmente o aplicativo do Monitoring para o canal:
- Abra o Slack.
Acesse o canal especificado como seu canal de notificação do Monitoring.
Convide o aplicativo do Monitoring para o canal inserindo e enviando a seguinte mensagem no canal:
/invite @Google Cloud Monitoring
Convide o aplicativo do Monitoring para o canal particular que você especificou ao criar o canal de notificação no Monitoring. O convite do aplicativo do Monitoring para canais públicos é opcional.
Webhooks
Antes de configurar um canal de notificação de webhook, considere o seguinte:
- Webhooks aceitam apenas endpoints públicos. Um endpoint público é totalmente
acessível pela Internet pública, como por HTTP (
port:80) ou HTTPS (port:443). O serviço de notificação precisa estabelecer uma conexão com o endpoint e, no caso de HTTPS, verificar o certificado de segurança do servidor. - Se uma função do Cloud Run estiver configurada como endpoint de webhook para um canal de notificação, verifique se o usuário que invoca a função tem a permissão de autenticação necessária. Para mais informações, consulte Autenticar para invocação e Ativar o acesso a uma função.
- Para enviar dados de notificação do Monitoring para o Microsoft Teams, use um serviço intermediário, como o Power Automate ou as funções do Cloud Run. Configure o serviço para receber a notificação de webhook do Monitoring converter os dados em um formato compatível com o Teams, e encaminhar os dados para o canal do Microsoft Teams apropriado.
Configurar canais de notificação de webhook
Para configurar as notificações de Webhooks, faça o seguinte:
- O gerenciador de webhooks: identifique o URL do endpoint público para receber dados do webhook do Monitoring.
-
No Google Cloud console do, acesse a página notifications Alertas:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.
- Na barra de ferramentas do Google Cloud console, selecione seu Google Cloud projeto. Para App Hub configurações, selecione o projeto host do App Hub ou o projeto de gerenciamento.
- Clique em Editar canais de notificação.
- Na seção Webhook, clique em Adicionar novo.
- Preencha a caixa de diálogo.
- Clique em Testar conexão para enviar um payload de teste ao endpoint do webhook. Acesse o endpoint de recebimento para verificar a entrega.
- Clique em Salvar.
Esquema de webhook
Para visualizar a estrutura do esquema de webhook do Error Reporting, clique no seguinte:
Autenticação básica
Além da solicitação de webhook enviada pelo Cloud Monitoring, a autenticação básica utiliza a especificação HTTP para o nome de usuário e a senha. O Cloud Monitoring exige que o servidor retorne uma resposta 401 com o cabeçalho WWW-Authenticate correto. Para mais informações sobre autenticação básica, consulte: