Configurar e gerenciar notificações

É possível configurar o Error Reporting para enviar notificações pelos canais do Cloud Monitoring, alertando sua equipe em tempo real quando novos erros ocorrem ou quando erros resolvidos reaparecem.

O Error Reporting aciona notificações nos seguintes cenários:

• Quando um evento de erro não pode ser agrupado com erros existentes, indicando um novo problema.
• Quando um evento de erro ocorre em um grupo de erros marcado como Resolvido, indicando uma regressão.

Antes de começar

1. Para ter as permissões necessárias para configurar notificações no Error Reporting, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:

   • Configurar notificações no Error Reporting: usuário do Error Reporting (roles/errorreporting.user)
   • Visualizar canais de notificação no Monitoring: leitor do Monitoring (roles/monitoring.viewer)
   • Criar canais de notificação no Monitoring: editor do Monitoring (roles/monitoring.editor)

   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 com papéis personalizados ou outros papéis predefinidos.

2. Verifique se os canais de notificação que você quer usar existem. Para o Error Reporting, é possível usar canais de notificação por e-mail, dispositivos móveis, Slack e webhooks.

   1. No Google Cloud console do, acesse a página  Alertas:

      Acessar a página Alertas

      Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.

   2. Na barra de ferramentas, selecione Editar canais de notificação.

      A página Canais de notificação é aberta e lista os canais configurados.

   Se os canais que você quer usar existirem, a próxima etapa será configurar as notificações no Error Reporting. Caso contrário, crie esses canais. Para informações sobre como preencher as caixas de diálogo para os diferentes tipos de canais de notificação, consulte Criar e gerenciar canais de notificação no Monitoring.

Configurar notificações no Error Reporting

Para selecionar para onde você quer enviar notificações quando novos grupos de erros ocorrerem, siga as etapas a seguir:

1. No Google Cloud console do, acesse a página Error Reporting:

   Acessar o Error Reporting

   Também é possível encontrar essa página usando a barra de pesquisa.

2. Clique em Configurar notificações para abrir a página Notificações de erro.

3. No menu Canais de notificação, selecione os canais que você quer receber notificações.

4. Depois de selecionar os canais, clique em Salvar.

Criar e gerenciar canais de notificação no Monitoring

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, dispositivos móveis, Slack e webhooks.

Criar um 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:

E-mail

Para adicionar um canal de notificação por e-mail, faça o seguinte:

1. No Google Cloud console do, acesse a página  Alertas:

   Acessar a página Alertas

   Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.

2. 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.
3. Clique em Editar canais de notificação.
4. Na seção E-mail, clique em Adicionar novo.
5. Insira um único endereço de e-mail e uma descrição.
6. 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 [e-mail].

App móvel

Use o Google Cloud app móvel do console para monitorar seus Google Cloud recursos do console e Monitoring informações de qualquer lugar. Google Cloud As notificações do app móvel do console 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 app móvel do console 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 canal de notificação do app móvel do Google Cloud console para um Google Cloud projeto específico, faça o seguinte:

1. Instale o app móvel do Google Cloud console na loja de aplicativos do seu dispositivo móvel.

2. Selecione um projeto para visualização no app móvel do Google Cloud console.

   Depois de selecionar um projeto, ocorre uma troca de dados entre o app 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

Observação: Para concluir estas etapas, você precisa ser proprietário ou administrador do espaço de trabalho do Slack. Para mais informações, consulte Gerenciar solicitações de convite.

Para configurar as notificações do Slack, faça o seguinte:

1. No Slack: crie um espaço de trabalho e um canal no site do Slack. Grave o URL do canal.

2. No Google Cloud console do, acesse a página  Alertas:

   Acessar a página Alertas

   Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.

3. 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.

4. Clique em Editar canais de notificação.

5. Na seção Slack, clique em Adicionar novo para abrir a página de login do Slack:

   1. Selecione o espaço de trabalho do Slack.
   2. 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.
   3. No campo Nome do canal do Slack, digite o nome do canal do Slack que você quer usar para as notificações.
   4. No campo Nome de exibição de alertas do Cloud, insira uma declaração descritiva curta. O Monitoring mostra o valor desse campo na página Canais de notificação.
   5. (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.

6. Se o canal do Slack que você quer usar para notificações for um canal particular, convide manualmente o app do Monitoring para o canal:

   1. Abra o Slack.

   2. Acesse o canal especificado como seu canal de notificação do Monitoring.

   3. Convide o app do Monitoring para o canal inserindo e enviando a seguinte mensagem no canal:

      /invite @Google Cloud Monitoring

      Convide o app do Monitoring para o canal particular especificado ao criar o canal de notificação no Monitoring. O convite do app 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 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 um 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 apropriado do Microsoft Teams.

Configurar canais de notificação de webhook

Para configurar notificações de webhook, faça o seguinte:

1. O gerenciador de webhooks: identifique o URL do endpoint público para receber dados do webhook do Monitoring.

2. No Google Cloud console do, acesse a página  Alertas:

   Acessar a página Alertas

   Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.

3. 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.
4. Clique em Editar canais de notificação.
5. Na seção Webhook, clique em Adicionar novo.
6. Preencha a caixa de diálogo.
7. Clique em Testar conexão para enviar um payload de teste ao endpoint do webhook. Acesse o endpoint de recebimento para verificar a entrega.
8. Clique em Salvar.

Esquema de webhook

Para visualizar a estrutura do esquema de webhook do Error Reporting, clique no seguinte:

Estrutura do esquema, versão 1.0

{
  "version": "1.0",
  "subject": string, descrição do grupo de erros novo ou reaberto.
  "group_info": {
    "project_id": string, projeto proprietário do grupo de erros.
    "detail_link": string, link para a página Detalhes do Error Reporting do grupo de erros.
  },
  "exception_info": {
    "type": string, tipo de exceção registrada no evento.
    "message": string, mensagem de exceção para o evento.
  },
  "event_info": {
    "log_message": string
    "request_method": string
    "request_url": string
    "referrer": string
    "user_agent": string
    "service": string
    "version": string
    "response_status": string
  },
}

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:

• Especificação RFC
• Autenticação básica

Autenticação de token

A autenticação de token exige um parâmetro de string de consulta no URL do endpoint e uma chave que o servidor espera que seja secreta entre ele e o Monitoring. Veja a seguir um URL de exemplo que inclui um token:

https://www.myserver.com/stackdriver-hook?auth_token=1234-abcd

Se o Monitoring postar um incidente no URL do endpoint, o servidor poderá validar o token anexado. Esse método de autenticação é mais eficaz quando usado com SSL/TLS para criptografar a solicitação HTTP, impedindo que terceiros não autorizados aprendam o token.

Para um exemplo de servidor em Python, consulte este servidor de exemplo.

Editar e excluir canais de notificação

Para editar ou excluir um canal de notificação usando o Google Cloud console, faça o seguinte:

1. No Google Cloud console do, acesse a página  Alertas:

   Acessar a página Alertas

   Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.

2. Clique em Editar canais de notificação.

   O painel Canais de notificação contém uma seção para cada tipo de canal de notificação. Cada seção lista todas as configurações desse tipo:

   • Para modificar uma entrada, clique em Editar. Clique em Salvar depois que suas alterações forem concluídas.
   • Para excluir uma entrada, clique em Excluir. Clique em Excluir na caixa de diálogo de confirmação.

Observação: não é possível excluir um canal de notificação usando o Google Cloud console quando ele está associado a uma política de alertas. No entanto, é possível excluir o canal usando a Google Cloud CLI ou a API Cloud Monitoring. Para mais informações, consulte Criar e gerenciar canais de notificação por API.

Comportamento e limites de notificação

As seções a seguir descrevem o conteúdo, os acionadores e os limites de taxa de notificação no Error Reporting.

Conteúdo da notificação

As notificações de grupos de erros contêm informações relacionadas às entradas de registro no grupo. As informações incluídas dependem do tipo de recurso monitorado em que o evento de erro ocorreu. Por exemplo, algumas notificações podem conter o nome e a versão do recurso monitorado.

Uma mensagem que descreve um evento de erro é incluída na notificação somente quando o grupo de erros é identificado pelas entradas de registro em um bucket de registros cuja região é global.

Acionadores e resolução de notificações

O Error Reporting envia uma notificação em dois cenários:

• Quando um evento de erro ocorre e não há um grupo de erros.

  Para receber notificações futuras do grupo de erros, defina o status do grupo de erros como Resolvido. Nenhuma outra ação, como usar a API para excluir o grupo de erros ou aguardar o envelhecimento dos dados, resulta em uma notificação se outro evento de erro ocorrer.

• Quando um evento de erro ocorre para um grupo de erros e o status do grupo de erros está definido como Resolvido.

  O Error Reporting atualiza o status do grupo de erros para Aberto.

O Error Reporting não envia notificações quando eventos de erro ocorrem e o status do grupo de erros correspondente é Silenciado.

Para gerenciar o status de resolução dos grupos de erros, acesse Gerenciar grupos de erros.

Limite da taxa de notificação

O Error Reporting usa as seguintes regras para limitar o número de notificações que você pode receber devido a eventos de erro:

• No máximo, cinco notificações por Google Cloud projeto podem ser enviadas em uma janela de 60 minutos.

• Se mais de cinco notificações de erro em um Google Cloud projeto ocorrerem em uma janela de 60 minutos, o seguinte vai acontecer:

  • Você vai receber uma notificação de que outras notificações para o Google Cloud projeto serão silenciadas nas próximas seis horas.

  • Uma entrada de registro com um nível de gravidade WARNING é gravada.

• Quando você resolve um grupo de erros, as notificações desse grupo de erros são suspensas por cinco minutos.

Notificações no dispositivo móvel

O Error Reporting envia notificações para dispositivos móveis no Google Cloud app do console para Android e iOS. Para receber notificações para dispositivos móveis, é preciso instalar o app no seu dispositivo móvel primeiro:

Faça o download do Google Cloud app

A seguir

• Visualizar e filtrar grupos de erros
• Gerenciar grupos de erros