Configurar e gerenciar notificações

É possível configurar o Error Reporting para enviar notificações de erro aos canais de notificação selecionados do Cloud Monitoring.

O Error Reporting envia notificações nos seguintes casos:

• Quando ocorre um erro em um projeto do Google Cloud pela primeira vez e não é possível agrupá-lo com erros anteriores.

• Se um erro marcado como Resolvido ocorrer novamente.

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 escolher entre quatro tipos de notificação canais: e-mail, dispositivos móveis, Slack e Webhooks.

Antes de começar

Para receber as permissões necessárias para visualizar e configurar canais de notificação no console do Google Cloud, faça o seguinte: peça ao administrador para conceder a você Papel do IAM Editor do Monitoring (roles/monitoring.editor) no 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 por meio de papéis personalizados ou de outros papéis predefinidos.

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 console do Google Cloud: siga as instruções específicas do canal descritas na tabela a seguir:

E-mail

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

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

   Acessar Alertas

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

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

Aplicativo para dispositivos móveis

Use o app para dispositivos móveis do console do Google Cloud para monitorar sua Recursos e monitoramento do console do Google Cloud informações de qualquer lugar. As notificações do app para dispositivos móveis do console do Google Cloud são enviadas a um dispositivo específico ou a um 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 campo Nome de exibição inclui informações do dispositivo.
• Usuário indica que as notificações foram enviadas para todos os dispositivos com o app para dispositivos móveis do console do Google Cloud 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 para dispositivos móveis do console do Google Cloud para um usuário projeto do Google Cloud, faça o seguinte:

1. Instale o app para dispositivos móveis do console do Google Cloud pela app store do seu dispositivo móvel.

2. Selecione um projeto para exibir no app para dispositivos móveis do console do Google Cloud.

   Depois de selecionar um projeto, ocorre uma troca de dados entre o aplicativo e o projeto do Google Cloud selecionado. 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.

Adicionar seu dispositivo móvel como um canal de notificação para alertas política, na seção Notificações de alertas, selecione Console do Google Cloud (dispositivo móvel) e escolha seu dispositivo móvel no da lista.

Slack

Observação: para concluir estas etapas, você precisa ser um proprietário ou administrador do espaço de trabalho do Slack. Para mais informações, consulte Como 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 console do Google Cloud, acesse a página  Alertas:

   Acessar Alertas

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

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

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

   1. Selecione o espaço de trabalho do Slack.
   2. Clique em Permitir para ativar o Cloud Monitoring. ao 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 notificações.
   4. No campo Nome de exibição do alerta do Cloud, insira uma breve declaração descritiva. O Monitoring exibe o valor deste campo na página Canal de notificações.
   5. (Opcional) Para testar a conexão entre no Cloud Monitoring e no espaço de trabalho do Slack, Envie uma notificação de teste. Se a conexão for bem-sucedida, aparece a mensagem This is a test alert notification... O canal de notificação do Slack que você especificou. Consulte a canal de notificação para confirmar o recebimento.

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

   1. Abra o Slack.

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

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

      /invite @Google Cloud Monitoring

      Convide o app Monitoring para o canal especificado ao criar o canal de notificação e monitoramento. Convidar o app do Monitoring a canais públicos é opcional.

Webhooks

Observação: os webhooks só oferecem suporte a endpoints públicos.

Observação:se uma função do Cloud Run for configurado como endpoint de webhook para um canal de notificação, verifique se o usuário que invoca a função tem as permissões permissão. Para mais informações, consulte Autenticação de função para chamadas de função e Como ativar o acesso a uma função.

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

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

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

   Acessar Alertas

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

3. Clique em Editar canais de notificação.
4. Na seção Webhook, clique em Adicionar novo.
5. Preencha a caixa de diálogo.
6. Clique em Test Connection para enviar um payload de teste ao endpoint do webhook. Acesse o endpoint de recebimento para verificar a entrega.
7. Clique em Salvar.

Esquema de webhook

Para conferir a estrutura do esquema do webhook para o Error Reporting, clique em:

Estrutura do esquema, versão 1.0

{
  "version": "1.0",
  "subject": 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 da notificação de erro do grupo de erros.
  },
  "exception_info": {
    "type": , tipo da 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 ponto de extremidade e uma chave que o servidor espera ser secreto 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, seu servidor pode validar o token anexado. Esse método de A autenticação é mais eficaz quando usada com SSL/TLS para criptografar a solicitação HTTP impedindo que bisbilhoteiros saibam 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 console do Google Cloud, faça o seguinte: faça o seguinte:

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

   Acessar Alertas

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

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 Edit. 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 console do Google Cloud quando o canal está associado a uma política de alertas. No entanto, é possível excluir o canal usando a CLI do Google Cloud ou a API Cloud Monitoring. Para saber mais, consulte Criar e gerenciar canais de notificação por API.

Selecionar canais de notificação no console do Google Cloud

Para selecionar um canal de notificação existente, é necessário ter um dos seguintes papéis:

• Usuário do Error Reporting
• Administrador do Error Reporting
• Editor do projeto
• Proprietário do projeto

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

1. No console do Google Cloud, 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 suspenso Canais de notificação, selecione os canais para os quais você quer enviar as notificações.

   Se você não encontrar o canal necessário, clique em Gerenciar canais de notificação para criar um novo canal. Para criar um canal de notificação, seu papel precisa ser aquele listado em Como criar canais.

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

Mais informações

Veja a seguir informações adicionais que se aplicam ao criar e gerenciar notificações no Error Reporting.

Conteúdo da notificação

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

A mensagem de erro é incluída na notificação somente quando o grupo de erros é identificado pelas entradas de registro em um bucket de registros com a região global.

Quando as notificações são enviadas

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

• Quando o grupo de erros nunca foi detectado pelo Error Reporting.
• Quando ocorre um erro em um grupo de erros existente e o status do grupo de erros é definido como Resolved.

Para receber futuras notificações sobre o grupo de erros, defina o grupo de erros como Resolved. Nenhuma outra ação, como usar a API para excluir o ou a espera pela expiração dos dados, resultam em uma notificação se outro erro ocorrer.

Limite da taxa de notificação

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

• No máximo, cinco notificações devido a um erro podem ser enviadas em uma janela de 60 minutos.

• Se mais de cinco erros ocorrerem em uma janela de 60 minutos, o seguinte vai acontecer:

  • Você recebe uma notificação informando que outras notificações serão silenciadas nas próximas seis horas.

  • Uma entrada de registro com o nível de gravidade do aviso é gravada.

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

Status da resolução

Se um erro com status de resolução Resolvido ocorrer novamente, mesmo que tenha sido excluído anteriormente, o status de resolução será revertido para Aberto e o Error Reporting enviará uma notificação.

O Error Reporting não enviará uma notificação se um erro Item silenciado ocorrer outra vez.

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

Notificações no dispositivo móvel

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

Faça o download do app Google Cloud