Criar e gerenciar canais de notificação

Neste documento, descrevemos como configurar canais de notificação usando o console do Google Cloud. O Cloud Monitoring usa esses canais para notificar você ou sua equipe de plantão quando uma política de alertas é disparada. Ao criar uma política de alertas, você seleciona quem é notificado fazendo seleções na lista de canais de notificação configurados. Por exemplo, é possível configurar políticas de alertas que monitoram instâncias do Compute Engine para publicar um tópico do Pub/Sub e notificar o canal do Slack para a equipe de plantão.

Para mais informações, consulte Latência de notificação e Notificações por incidente.

Neste documento, descrevemos como usar o console do Google Cloud. Se você usa a API Cloud Monitoring, consulte Criar e gerenciar canais de notificação por API.

Observação: os dados enviados aos destinatários do canal podem conter informações sensíveis. Revise suas práticas regulatórias antes de criar o canal de notificação.

Antes de começar

Para receber as permissões necessárias para visualizar e configurar canais de notificação usando o console do Google Cloud, peça ao administrador para conceder a você o papel do IAM Editor do Monitoring (roles/monitoring.editor) no projeto. Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.

Também é possível receber as permissões necessárias com papéis personalizados ou 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 um canal de notificação

Ao criar uma política de alertas, é possível selecionar qualquer canal de notificação configurado e adicioná-lo à política. É possível pré-configurar os canais de notificação ou configurá-los como parte do processo de criação de uma política de alertas. Para mais informações, consulte Criar um canal on demand.

Observação: recomendamos a criação de vários canais de notificação para fins de redundância. O Google não tem controle de muitos dos sistemas de entrega depois de passarmos a notificação para esse sistema. Além disso, um único serviço do Google oferece suporte ao Cloud Mobile App, PagerDuty, Webhooks e Slack. Se você usar um desses canais de notificação, use e-mail, SMS ou Pub/Sub como o canal redundante.

Para criar um canal de notificação usando o console do Google Cloud, siga as instruções específicas do canal 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 Monitoring.

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

É possível criar canais de e-mail durante a criação de uma política de alertas. Para mais informações, acesse Criar um canal on demand.

Aplicativo para dispositivos móveis

Use o app para dispositivos móveis do console do Google Cloud para monitorar os recursos do console do Google Cloud e as informações do Monitoring 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 são 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 de app para dispositivos móveis do console do Google Cloud referente a um projeto específico 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.

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

PagerDuty

A integração com o PagerDuty permite a sincronização unidirecional ou bidirecional com o Monitoring. Dependendo da configuração, os itens a seguir serão verdadeiros:

• Se um incidente for criado no Monitoring, um incidente será aberto no PagerDuty.
• Não é possível usar o PagerDuty para encerrar um incidente no Monitoring.

Se você usar a sincronização unidirecional e resolver o incidente no PagerDuty, o estado do incidente no PagerDuty será desacoplado do estado do incidente no Monitoring. Na verdade, se você resolver um incidente no PagerDuty, ele será permanentemente fechado no PagerDuty e não poderá ser reaberto.

Se você usar a sincronização bidirecional, o Monitoring controlará o estado mostrado pelo PagerDuty. Se você resolver o incidente no PagerDuty e se o Monitoring tiver aberto o incidente, ele será reaberto no PagerDuty.

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

1. Na sua conta do PagerDuty, configure a integração em um novo serviço ou adicione a integração a um serviço atual.
   1. Crie uma conta ou faça login em uma conta existente.
   2. Acesse a página Serviços.
   • Para criar um serviço, faça o seguinte:
     1. Clique em + Novo serviço.
     2. Insira um nome e uma descrição do serviço e clique em Próxima.
     3. Configure uma política de encaminhamento e clique em Next.
     4. Se sua conta do PagerDuty for compatível com o agrupamento de alertas e alertas temporários, configure-os e clique em Próxima.
     5. Na página de configuração das integrações, na barra de ferramentas Pesquisar uma integração, digite Events API v1 e clique em Criar serviço. Em seguida, você retornará ao painel Integrações do novo serviço.
   • Para editar um serviço atual, faça o seguinte:
     1. Selecione um serviço do seu diretório de serviços.
     2. Na página do serviço, selecione o painel Integrações.
     3. Clique em + Adicionar outra integração para acessar a página de configuração das integrações.
     4. Na página de configuração das integrações, na barra de ferramentas Pesquisar uma integração, digite Events API v1 e clique em Adicionar. Em seguida, você retornará ao painel Integrações do serviço editado.
   3. No painel Integrações do seu serviço, encontre a listagem da nova integração, expanda o menu correspondente e copie a chave de integração.
2. No Cloud Monitoring, adicione o canal de notificação do PagerDuty:

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

   2. Clique em Editar canais de notificação.
   3. Na seção PagerDuty, clique em Adicionar novo.
   4. Insira o Nome de exibição. Esse nome precisa corresponder ao nome do serviço PagerDuty em que você configurou sua nova integração na etapa 1.
   5. Insira a chave de integração que você copiou na etapa 1 no campo Service Key.
   6. Clique em Salvar.
3. Opcional: se você quiser configurar a sincronização bidirecional, faça o seguinte:
   1. Acesse sua conta do PagerDuty.
   2. Selecione Serviços e o nome do serviço que você inseriu ao configurar a integração.
   3. Selecione o painel Integrações do seu serviço.
   4. Vá para a seção Configurações de alertas e incidentes e clique em Editar.
   5. Selecione Criar incidentes e alertas e salve as alterações.

Ao criar uma política de alertas, selecione PagerDuty na seção Notificações e escolha sua configuração do PagerDuty.

O pacote JSON para o PagerDuty tem o seguinte formato:

 {
     "description": A string of various fields in the incident,
     "details": JSON payload with schema version 1.2.
 }

Para ver um exemplo e o esquema do campo details, expanda as seções a seguir.

Exemplos JSON

Por padrão, o back-end de alertas tenta gerar um pacote JSON com a formatação da versão 1.2. Para mais informações sobre essa formatação, consulte a próxima seção.

Veja a seguir um exemplo desse pacote:

{
  "incident": {
    "incident_id": "0.opqiw61fsv7p",
    "scoping_project_id": "internal-project",
    "scoping_project_number": 12345,
    "url": "https://console.cloud.google.com/monitoring/alerting/incidents/0.lxfiw61fsv7p?project=internal-project",
    "started_at": 1577840461,
    "ended_at": 1577877071,
    "state": "closed",
    "resource_id": "11223344",
    "resource_name": "internal-project gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_display_name": "gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_type_display_name": "VM Instance",
    "resource": {
      "type": "gce_instance",
      "labels": {
        "instance_id": "11223344",
        "project_id": "internal-project",
        "zone": "us-central1-c"
      }
    },
    "metric": {
      "type": "compute.googleapis.com/instance/cpu/utilization",
      "displayName": "CPU utilization",
      "labels": {
        "instance_name": "the name of the VM instance"
      }
    },
    "metadata": {
      "system_labels": { "labelkey": "labelvalue" },
      "user_labels": { "labelkey": "labelvalue" }
    },
    "policy_name": "Monitor-Project-Cluster",
    "policy_user_labels" : {
        "user-label-1" : "important label",
        "user-label-2" : "another label"
    },
    "condition_name": "VM Instance - CPU utilization [MAX]",
    "threshold_value": "0.9",
    "observed_value": "0.835",
    "condition": {
      "name": "projects/internal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789",
      "displayName": "VM Instance - CPU utilization [MAX]",
      "conditionThreshold": {
        "filter": "metric.type=\\"compute.googleapis.com/instance/cpu/utilization\\" resource.type=\\"gce_instance\\" metadata.system_labels.\\"state\\"=\\"ACTIVE\\"",
        "aggregations": [
          {
            "alignmentPeriod": "120s",
            "perSeriesAligner": "ALIGN_MEAN"
          }
        ],
        "comparison": "COMPARISON_GT",
        "thresholdValue": 0.9,
        "duration": "0s",
        "trigger": {
          "count": 1
        }
      }
    },
    "documentation": {
      "content": "TEST ALERT\n\npolicy.name=projects/internal-project/alertPolicies/1234567890123456789\n\npolicy.display_name=Monitored-Project-NO-GROUPBY\n\ncondition.name=projects/nternal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789\n\ncondition.display_name=VM Instance - CPU utilization [MAX]\n\nproject=internal-project\n\nresrouce.project=internal-project \n\nDONE\n",
      "mime_type": "text/markdown"
    },
    "summary": "CPU utilization for internal-project gke-cluster-1-16-default-pool-e2df4cbd-dgp3 with metric labels {instance_name=gke-cluster-1-default-pool-e2df4cbd-dgp3} and system labels {state=ACTIVE} returned to normal with a value of 0.835."
  },
  "version": "1.2"
}
       

Estrutura do esquema, versão 1.2

Esta seção descreve a versão 1.2 do esquema de payload. Talvez alguns campos não apareçam em todos os pacotes retornados ou tenham valores vazios, dependendo da configuração da política de alertas, do estado do incidente ou do recurso que está sendo monitorado. Alguns campos aceitam estruturas incorporadas como valores; Essas estruturas são descritas por referência porque o conteúdo delas também pode variar.

Em um pacote retornado, os campos podem ocorrer em qualquer ordem. Na descrição a seguir, eles são organizados em grupos relacionados.

{
  "version": "1.2",
  "incident": {
    
    Informações sobre o incidente.
    
    "incident_id": string, ID gerado para esse incidente.
    "scoping_project_id": string, o ID do projeto que hospeda o escopo das métricas.
    "scoping_project_number": número, o número do projeto do escopo.
    "url": string, URL do console do Google Cloud para este incidente.
    "started_at": número, horário (em segundos de época do Unix) em que o incidente foi aberto.
    "ended_at": número, horário (em segundos de época do Unix) em que o incidente foi encerrado. Preenchido apenas quando state é closed.
    "state": string, estado do incidente: open ou closed. Se for open, ended_at será nulo.
    "summary": string, resumo textual gerado do incidente.
    "apigee_url": string, URL da Apigee para este incidente, apenas para os tipos de recurso da Apigee Environment e Proxy*.
    "observed_value": a string, o valor observado que acionou/resolveu o alerta, pode estar vazia se a condição tiver expirado.
    
    Informações sobre o recurso monitorado do incidente
    
    "resource": {
      "type": string, identificador do tipo de recurso monitorado que está sendo alertado, por exemplo, gce_instance. Consulte a Lista de recursos monitorados.
      "labels": objeto, pares de chave-valor para os rótulos associados ao recurso monitorado.
    },
    "resource_type_display_name": string, nome de exibição do tipo de recurso monitorado.
    "resource_id": string, ID da instância do recurso monitorado, mesmo valor de resource.labels.instance_id.
    "resource_display_name": string, nome de exibição do recurso monitorado.
    "resource_name": string, nome gerado para este recurso monitorado. Consiste em valores de outros campos.
    
    Informações sobre o tipo de métrica dos dados da série temporal.
    
    "metric": {
      "type": string, identificador do tipo de métrica que está recebendo o alerta, por exemplo, compute.googleapis.com/instance/cpu/utilization. Consulte Lista de métricas.
      "displayName": string, nome de exibição do tipo de métrica.
      "labels": objeto, pares de chave-valor para os rótulos associados à métrica.
    },
    "metadata": {
      "system_labels": objeto, pares de chave-valor para rótulos de metadados do sistema.
      "user_labels": objeto, pares de chave-valor para rótulos de metadados do usuário.
    },
    
    Informações sobre a política de alertas e a condição que abriu/resolveu o incidente.
    Os valores são extraídos do objeto AlertPolicy relevante.
    
    "policy_name": string, nome de exibição da política de alertas.
    "policy_user_labels": objeto, pares de chave-valor para qualquer rótulo de usuário anexado à política.
    "documentation": objeto, uma estrutura incorporada do formulário Documentation.
    "condition": objeto, uma estrutura incorporada do formulário Condition.
    "condition_name": string, nome de exibição da condição, mesmo valor de condition.displayName.
    "severity": string, nível de gravidade dos incidentes. Se esse campo não for definido durante a criação da política de alertas, o Cloud Monitoring definirá a gravidade da política de alertas como No Severity.
    "threshold_value": a string, o valor limite dessa condição, poderá ficar em branco se a condição não for uma condição de limite.
  },
}

Política de suspensão de uso

O esquema de payload está sujeito à política de suspensão de uso do Google Cloud descrita na Seção 1.4(d) dos Termos de Serviço do Google Cloud Platform. O esquema não controla os formatos dos valores de campo gerados, e esses formatos podem ser alterados sem aviso prévio. Por exemplo, incident.summary, incident.documentation.content e incident.url devem incluir dados pertencentes aos campos deles, mas o esquema não tem restrições para garantir uma análise precisa desses campos. É possível consumir o valor como um todo e esperar que ele obedeça à política de descontinuação, mas não dependa da análise dos campos gerados.

SMS

Para configurar notificações por SMS, 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 Monitoring.

2. Clique em Editar canais de notificação.
3. Na seção SMS, clique em Adicionar novo.
4. Preencha a caixa de diálogo e clique em Salvar.

Ao configurar sua política de alertas, selecione o tipo de notificação SMS e escolha um número de telefone confirmado 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 Como gerenciar solicitações de convite.

Com a integração entre Monitoring e Slack, é possível publicar as políticas de alertas em um canal do Slack quando um novo incidente é criado. 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 Monitoring.

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

4. 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 que o Cloud Monitoring acesse 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 notificações.
   4. No campo Nome de exibição do Cloud Alerting, insira uma breve instrução descritiva. O Monitoring exibe o valor desse campo na página Canal de notificações.
   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 bem-sucedida, você verá a 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.

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

   1. Abra o Slack.

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

   3. Para convidar o app do Monitoring para o canal, digite e envie a seguinte mensagem no canal:

      /invite @Google Cloud Monitoring

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

   Quando você criar uma política de alerta, selecione Slack na seção Notifications e escolha a configuração do Slack.

Webhooks

Observação: os webhooks dão suporte apenas a endpoints públicos. Se você precisar de notificações enviadas para um endpoint que não seja público, crie um canal de notificação do Pub/Sub e configure uma assinatura para o tópico do Pub/Sub. Para mais informações, consulte As notificações de webhook falham quando configuradas para um endpoint particular.

Observação: se uma função do Cloud estiver configurada como endpoint do webhook para um canal de notificação, verifique se o usuário que está chamando a função tem a permissão de autenticação necessária. Para mais informações, consulte Como autenticar a 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 Monitoring.

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 Testar conexão para enviar um payload de teste ao endpoint do webhook. Acesse o endpoint de recebimento para verificar a entrega.
7. Clique em Salvar.

Ao criar uma política de alertas, selecione Webhook na seção Notifications e escolha a configuração de webhook. As notificações enviadas pelo Error Reporting seguem o esquema 1.0, enquanto as notificações enviadas pelo Monitoring seguem o esquema 1.2:

Exemplos JSON

Por padrão, o back-end de alertas tenta gerar um pacote JSON com a formatação da versão 1.2. Para mais informações sobre essa formatação, consulte a próxima seção.

Veja a seguir um exemplo desse pacote:

{
  "incident": {
    "incident_id": "0.opqiw61fsv7p",
    "scoping_project_id": "internal-project",
    "scoping_project_number": 12345,
    "url": "https://console.cloud.google.com/monitoring/alerting/incidents/0.lxfiw61fsv7p?project=internal-project",
    "started_at": 1577840461,
    "ended_at": 1577877071,
    "state": "closed",
    "resource_id": "11223344",
    "resource_name": "internal-project gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_display_name": "gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_type_display_name": "VM Instance",
    "resource": {
      "type": "gce_instance",
      "labels": {
        "instance_id": "11223344",
        "project_id": "internal-project",
        "zone": "us-central1-c"
      }
    },
    "metric": {
      "type": "compute.googleapis.com/instance/cpu/utilization",
      "displayName": "CPU utilization",
      "labels": {
        "instance_name": "the name of the VM instance"
      }
    },
    "metadata": {
      "system_labels": { "labelkey": "labelvalue" },
      "user_labels": { "labelkey": "labelvalue" }
    },
    "policy_name": "Monitor-Project-Cluster",
    "policy_user_labels" : {
        "user-label-1" : "important label",
        "user-label-2" : "another label"
    },
    "condition_name": "VM Instance - CPU utilization [MAX]",
    "threshold_value": "0.9",
    "observed_value": "0.835",
    "condition": {
      "name": "projects/internal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789",
      "displayName": "VM Instance - CPU utilization [MAX]",
      "conditionThreshold": {
        "filter": "metric.type=\\"compute.googleapis.com/instance/cpu/utilization\\" resource.type=\\"gce_instance\\" metadata.system_labels.\\"state\\"=\\"ACTIVE\\"",
        "aggregations": [
          {
            "alignmentPeriod": "120s",
            "perSeriesAligner": "ALIGN_MEAN"
          }
        ],
        "comparison": "COMPARISON_GT",
        "thresholdValue": 0.9,
        "duration": "0s",
        "trigger": {
          "count": 1
        }
      }
    },
    "documentation": {
      "content": "TEST ALERT\n\npolicy.name=projects/internal-project/alertPolicies/1234567890123456789\n\npolicy.display_name=Monitored-Project-NO-GROUPBY\n\ncondition.name=projects/nternal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789\n\ncondition.display_name=VM Instance - CPU utilization [MAX]\n\nproject=internal-project\n\nresrouce.project=internal-project \n\nDONE\n",
      "mime_type": "text/markdown"
    },
    "summary": "CPU utilization for internal-project gke-cluster-1-16-default-pool-e2df4cbd-dgp3 with metric labels {instance_name=gke-cluster-1-default-pool-e2df4cbd-dgp3} and system labels {state=ACTIVE} returned to normal with a value of 0.835."
  },
  "version": "1.2"
}
       

Estrutura do esquema, versão 1.2

Esta seção descreve a versão 1.2 do esquema de payload. Talvez alguns campos não apareçam em todos os pacotes retornados ou tenham valores vazios, dependendo da configuração da política de alertas, do estado do incidente ou do recurso que está sendo monitorado. Alguns campos aceitam estruturas incorporadas como valores; Essas estruturas são descritas por referência porque o conteúdo delas também pode variar.

Em um pacote retornado, os campos podem ocorrer em qualquer ordem. Na descrição a seguir, eles são organizados em grupos relacionados.

{
  "version": "1.2",
  "incident": {
    
    Informações sobre o incidente.
    
    "incident_id": string, ID gerado para esse incidente.
    "scoping_project_id": string, o ID do projeto que hospeda o escopo das métricas.
    "scoping_project_number": número, o número do projeto do escopo.
    "url": string, URL do console do Google Cloud para este incidente.
    "started_at": número, horário (em segundos de época do Unix) em que o incidente foi aberto.
    "ended_at": número, horário (em segundos de época do Unix) em que o incidente foi encerrado. Preenchido apenas quando state é closed.
    "state": string, estado do incidente: open ou closed. Se for open, ended_at será nulo.
    "summary": string, resumo textual gerado do incidente.
    "apigee_url": string, URL da Apigee para este incidente, apenas para os tipos de recurso da Apigee Environment e Proxy*.
    "observed_value": a string, o valor observado que acionou/resolveu o alerta, pode estar vazia se a condição tiver expirado.
    
    Informações sobre o recurso monitorado do incidente
    
    "resource": {
      "type": string, identificador do tipo de recurso monitorado que está sendo alertado, por exemplo, gce_instance. Consulte a Lista de recursos monitorados.
      "labels": objeto, pares de chave-valor para os rótulos associados ao recurso monitorado.
    },
    "resource_type_display_name": string, nome de exibição do tipo de recurso monitorado.
    "resource_id": string, ID da instância do recurso monitorado, mesmo valor de resource.labels.instance_id.
    "resource_display_name": string, nome de exibição do recurso monitorado.
    "resource_name": string, nome gerado para este recurso monitorado. Consiste em valores de outros campos.
    
    Informações sobre o tipo de métrica dos dados da série temporal.
    
    "metric": {
      "type": string, identificador do tipo de métrica que está recebendo o alerta, por exemplo, compute.googleapis.com/instance/cpu/utilization. Consulte Lista de métricas.
      "displayName": string, nome de exibição do tipo de métrica.
      "labels": objeto, pares de chave-valor para os rótulos associados à métrica.
    },
    "metadata": {
      "system_labels": objeto, pares de chave-valor para rótulos de metadados do sistema.
      "user_labels": objeto, pares de chave-valor para rótulos de metadados do usuário.
    },
    
    Informações sobre a política de alertas e a condição que abriu/resolveu o incidente.
    Os valores são extraídos do objeto AlertPolicy relevante.
    
    "policy_name": string, nome de exibição da política de alertas.
    "policy_user_labels": objeto, pares de chave-valor para qualquer rótulo de usuário anexado à política.
    "documentation": objeto, uma estrutura incorporada do formulário Documentation.
    "condition": objeto, uma estrutura incorporada do formulário Condition.
    "condition_name": string, nome de exibição da condição, mesmo valor de condition.displayName.
    "severity": string, nível de gravidade dos incidentes. Se esse campo não for definido durante a criação da política de alertas, o Cloud Monitoring definirá a gravidade da política de alertas como No Severity.
    "threshold_value": a string, o valor limite dessa condição, poderá ficar em branco se a condição não for uma condição de limite.
  },
}

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 requer um parâmetro de string de consulta no URL do endpoint e uma chave que o servidor espera ser 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 bisbilhoteiros saibam o token.

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

Política de suspensão de uso

O esquema de payload está sujeito à política de suspensão de uso do Google Cloud descrita na Seção 1.4(d) dos Termos de Serviço do Google Cloud Platform. O esquema não controla os formatos dos valores de campo gerados, e esses formatos podem ser alterados sem aviso prévio. Por exemplo, incident.summary, incident.documentation.content e incident.url devem incluir dados pertencentes aos campos deles, mas o esquema não tem restrições para garantir uma análise precisa desses campos. É possível consumir o valor como um todo e esperar que ele obedeça à política de descontinuação, mas não dependa da análise dos campos gerados.

Pub/Sub

Nesta seção, descrevemos como configurar canais de notificação do Pub/Sub. Para redundância, recomendamos criar vários canais de notificação. É recomendável parear o Pub/Sub com o app para dispositivos móveis, PagerDuty, Webhooks ou Slack do console do Google Cloud, porque o Pub/Sub usa um mecanismo de entrega diferente.

Para configurar um canal de notificação do Pub/Sub:

1. Ativar as APIs necessárias e criar um tópico
2. Configurar o canal de notificação para um tópico
3. Autorizar uma conta de serviço
4. Definir o canal de notificação em uma política de alertas

Para entender o esquema de dados, consulte o Exemplo de esquema.

Para receber as notificações de alerta, você também precisa criar uma destas assinaturas: pull, push ou BigQuery.

Quando a assinatura estiver em um projeto diferente do tópico, crie uma conta de serviço no projeto do assinante e conceda a ela o papel de roles/pubsub.subscriber.

Antes de começar

Quando você adiciona o primeiro canal de notificação do Pub/Sub a um projeto do Google Cloud, o Cloud Monitoring cria uma conta de serviço para esse projeto. Ele também concede o papel Agente de serviço de notificação do Monitoring à conta de serviço do Identity and Access Management. Essa conta de serviço permite que o Monitoring envie notificações para canais de notificação baseados em Pub/Sub neste projeto.

A conta de serviço tem o seguinte formato:

[e-mail]

O nome da conta de serviço de notificações inclui um número de projeto exclusivo do Google Cloud. É possível encontrar o nome, o ID e o número do projeto no painel dele no console do Google Cloud ou recuperá-los com o seguinte comando:

gcloud projects describe PROJECT_ID --format="value(project_number)"

É possível visualizar e editar a conta de serviço usando o console do Google Cloud ou a Google Cloud CLI.

Ativar as APIs necessárias e criar um tópico

No projeto do Google Cloud em que você planeja criar o canal de notificação e o tópico do Pub/Sub, faça o seguinte:

1. Faça login na sua conta do Google Cloud. Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.

2. No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

   Observação: se você não pretende manter os recursos criados neste procedimento, crie um projeto novo em vez de selecionar um que já existe. Depois de concluir essas etapas, é possível excluir o projeto. Para fazer isso, basta remover todos os recursos associados a ele.

   Acessar o seletor de projetos

3. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

4. Ative as APIs Pub/Sub and Cloud Monitoring.

   Ative as APIs

5. No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

   Observação: se você não pretende manter os recursos criados neste procedimento, crie um projeto novo em vez de selecionar um que já existe. Depois de concluir essas etapas, é possível excluir o projeto. Para fazer isso, basta remover todos os recursos associados a ele.

   Acessar o seletor de projetos

6. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

7. Ative as APIs Pub/Sub and Cloud Monitoring.

   Ative as APIs

8. Crie um tópico do Pub/Sub. Para mais informações sobre como criar um tópico, consulte Criar um tópico. Por exemplo, para criar um tópico chamado notificationTopic usando a Google Cloud CLI, execute o seguinte comando:

   gcloud pubsub topics create notificationTopic

Observação: se você planeja criar seu canal de notificação e tópico do Pub/Sub em diferentes projetos do Google Cloud, ative as APIs Pub/Sub e Monitoring nos dois projetos.

Em seguida, configure os canais de notificação do Pub/Sub.

Configurar notificações para um tópico

Para criar um canal de notificação do Pub/Sub, use a API Monitoring, a Google Cloud CLI ou o console do Google Cloud. Depois de criar o canal, autorize a conta de serviço de notificações a publicar cada tópico que você está usando como um canal de notificação.

Para informações sobre como usar a API Monitoring ou a Google Cloud CLI para criar o canal de notificação, consulte Como criar canais.

Para usar o console do Google Cloud para criar o canal de notificação, 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 Monitoring.

2. Selecione o projeto do Google Cloud que contém o tópico do Pub/Sub que você criou.
3. Clique em Editar canais de notificação.

4. Na seção Pub/Sub, clique em Adicionar novo.

   A caixa de diálogo Canal do Pub/Sub criado exibe o nome da conta de serviço que o Monitoring criou.

5. Autorize a conta de serviço. Sua conta de serviço pode publicar todos os tópicos ou tópicos específicos:

   • Para publicar todos os tópicos, selecione Gerenciar papéis e adicione o papel de Editor do Pub/Sub.

     Depois de concluir as etapas para configurar o canal de notificação, pule a próxima seção, Autorizar conta de serviço, e prossiga para Definir o canal de notificação em uma política de alertas.

   • Para publicar tópicos específicos, prossiga para a próxima etapa e autorize a conta de serviço a publicar tópicos específicos depois de concluir a configuração do canal de notificação. Para instruções sobre como autorizar a conta de serviço, consulte Autorizar conta de serviço.
6. Insira um nome de exibição para seu canal e o nome do tópico do Pub/Sub.
7. Opcional: para verificar se o canal está configurado corretamente, clique em Enviar notificação de teste.
8. Selecione Adicionar canal.

Em seguida, autorize a conta de serviço.

Autorizar conta de serviço

Observação: conclua esta etapa ao criar o canal de notificação usando a API ou a Google Cloud CLI e quando tiver pulado a etapa de autorização ao usar o console do Google Cloud.

A autorização permite que a conta de serviço de notificações publique cada tópico do Pub/Sub que você está usando como um canal de notificação. Nesta seção, descrevemos como:

• Autorizar uma conta de serviço para um tópico específico.
• Autorizar uma conta de serviço para todos os tópicos.

Autorizar uma conta de serviço para um tópico específico

É possível autorizar uma conta de serviço a publicar um tópico específico usando o console do Google Cloud e a Google Cloud CLI. Nesta seção, descrevemos as duas abordagens.

Para autorizar sua conta de serviço para um tópico específico usando o console do Google Cloud, faça o seguinte:

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

   Acesse Temas

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

2. Selecione o tópico.
3. Na guia Permissões, selecione Adicionar principal.
4. No campo Novo principal, insira o nome da conta de serviço de notificações. A conta de serviço tem a seguinte convenção de nomenclatura:

   [e-mail]

5. Selecione o papel Publicador do Pub/Sub e, em seguida, clique em Salvar.

Para autorizar sua conta de serviço a um tópico específico usando a Google Cloud CLI, conceda à conta de serviço o papel pubsub.publisher do IAM para o tópico. Por exemplo, o comando a seguir configura o papel do IAM para o tópico notificationTopic:

gcloud pubsub topics add-iam-policy-binding \
projects/PROJECT_NUMBER/topics/notificationTopic --role=roles/pubsub.publisher \
--member=serviceAccount:[e-mail]
 

Uma resposta para uma execução bem-sucedida do comando add-iam-policy-binding é semelhante a esta:

 Updated IAM policy for topic [notificationTopic].
 bindings:
 ‐ members:
    ‐ serviceAccount:[e-mail]
    role: roles/pubsub.publisher
 etag: BwWcDOIw1Pc=
 version: 1
 

Para mais informações, consulte a página de referência do pubsub topics add-iam-policy-binding.

Autorizar uma conta de serviço para todos os tópicos

Para autorizar sua conta de serviço para todos os tópicos, faça o seguinte:

1. No console do Google Cloud, abra a página IAM.

   Acessar o IAM

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

2. Selecione Incluir concessões de papéis fornecidos pelo Google, como mostrado na imagem a seguir:
   
3. Pesquise a conta de serviço com o seguinte formato:

   [e-mail]

   Atualize a página quando a conta de serviço não estiver listada.

4. Selecione Editar para a conta de serviço de notificações, selecione Adicionar outro papel e adicione o papel Editor do Pub/Sub.

Em seguida, defina o canal de notificação em uma política de alertas.

Definir o canal de notificação em uma política de alertas

Para usar um canal de notificação do Pub/Sub em uma política de alertas, selecione Pub/Sub como o tipo de canal e selecione o tópico.

Exemplo de esquema

Para ver um exemplo de pacote JSON e o esquema, expanda as seções a seguir.

Exemplos JSON

Por padrão, o back-end de alertas tenta gerar um pacote JSON com a formatação da versão 1.2. Para mais informações sobre essa formatação, consulte a próxima seção.

Veja a seguir um exemplo desse pacote:

{
  "incident": {
    "incident_id": "0.opqiw61fsv7p",
    "scoping_project_id": "internal-project",
    "scoping_project_number": 12345,
    "url": "https://console.cloud.google.com/monitoring/alerting/incidents/0.lxfiw61fsv7p?project=internal-project",
    "started_at": 1577840461,
    "ended_at": 1577877071,
    "state": "closed",
    "resource_id": "11223344",
    "resource_name": "internal-project gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_display_name": "gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_type_display_name": "VM Instance",
    "resource": {
      "type": "gce_instance",
      "labels": {
        "instance_id": "11223344",
        "project_id": "internal-project",
        "zone": "us-central1-c"
      }
    },
    "metric": {
      "type": "compute.googleapis.com/instance/cpu/utilization",
      "displayName": "CPU utilization",
      "labels": {
        "instance_name": "the name of the VM instance"
      }
    },
    "metadata": {
      "system_labels": { "labelkey": "labelvalue" },
      "user_labels": { "labelkey": "labelvalue" }
    },
    "policy_name": "Monitor-Project-Cluster",
    "policy_user_labels" : {
        "user-label-1" : "important label",
        "user-label-2" : "another label"
    },
    "condition_name": "VM Instance - CPU utilization [MAX]",
    "threshold_value": "0.9",
    "observed_value": "0.835",
    "condition": {
      "name": "projects/internal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789",
      "displayName": "VM Instance - CPU utilization [MAX]",
      "conditionThreshold": {
        "filter": "metric.type=\\"compute.googleapis.com/instance/cpu/utilization\\" resource.type=\\"gce_instance\\" metadata.system_labels.\\"state\\"=\\"ACTIVE\\"",
        "aggregations": [
          {
            "alignmentPeriod": "120s",
            "perSeriesAligner": "ALIGN_MEAN"
          }
        ],
        "comparison": "COMPARISON_GT",
        "thresholdValue": 0.9,
        "duration": "0s",
        "trigger": {
          "count": 1
        }
      }
    },
    "documentation": {
      "content": "TEST ALERT\n\npolicy.name=projects/internal-project/alertPolicies/1234567890123456789\n\npolicy.display_name=Monitored-Project-NO-GROUPBY\n\ncondition.name=projects/nternal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789\n\ncondition.display_name=VM Instance - CPU utilization [MAX]\n\nproject=internal-project\n\nresrouce.project=internal-project \n\nDONE\n",
      "mime_type": "text/markdown"
    },
    "summary": "CPU utilization for internal-project gke-cluster-1-16-default-pool-e2df4cbd-dgp3 with metric labels {instance_name=gke-cluster-1-default-pool-e2df4cbd-dgp3} and system labels {state=ACTIVE} returned to normal with a value of 0.835."
  },
  "version": "1.2"
}
       

Estrutura do esquema, versão 1.2

Esta seção descreve a versão 1.2 do esquema de payload. Talvez alguns campos não apareçam em todos os pacotes retornados ou tenham valores vazios, dependendo da configuração da política de alertas, do estado do incidente ou do recurso que está sendo monitorado. Alguns campos aceitam estruturas incorporadas como valores; Essas estruturas são descritas por referência porque o conteúdo delas também pode variar.

Em um pacote retornado, os campos podem ocorrer em qualquer ordem. Na descrição a seguir, eles são organizados em grupos relacionados.

{
  "version": "1.2",
  "incident": {
    
    Informações sobre o incidente.
    
    "incident_id": string, ID gerado para esse incidente.
    "scoping_project_id": string, o ID do projeto que hospeda o escopo das métricas.
    "scoping_project_number": número, o número do projeto do escopo.
    "url": string, URL do console do Google Cloud para este incidente.
    "started_at": número, horário (em segundos de época do Unix) em que o incidente foi aberto.
    "ended_at": número, horário (em segundos de época do Unix) em que o incidente foi encerrado. Preenchido apenas quando state é closed.
    "state": string, estado do incidente: open ou closed. Se for open, ended_at será nulo.
    "summary": string, resumo textual gerado do incidente.
    "apigee_url": string, URL da Apigee para este incidente, apenas para os tipos de recurso da Apigee Environment e Proxy*.
    "observed_value": a string, o valor observado que acionou/resolveu o alerta, pode estar vazia se a condição tiver expirado.
    
    Informações sobre o recurso monitorado do incidente
    
    "resource": {
      "type": string, identificador do tipo de recurso monitorado que está sendo alertado, por exemplo, gce_instance. Consulte a Lista de recursos monitorados.
      "labels": objeto, pares de chave-valor para os rótulos associados ao recurso monitorado.
    },
    "resource_type_display_name": string, nome de exibição do tipo de recurso monitorado.
    "resource_id": string, ID da instância do recurso monitorado, mesmo valor de resource.labels.instance_id.
    "resource_display_name": string, nome de exibição do recurso monitorado.
    "resource_name": string, nome gerado para este recurso monitorado. Consiste em valores de outros campos.
    
    Informações sobre o tipo de métrica dos dados da série temporal.
    
    "metric": {
      "type": string, identificador do tipo de métrica que está recebendo o alerta, por exemplo, compute.googleapis.com/instance/cpu/utilization. Consulte Lista de métricas.
      "displayName": string, nome de exibição do tipo de métrica.
      "labels": objeto, pares de chave-valor para os rótulos associados à métrica.
    },
    "metadata": {
      "system_labels": objeto, pares de chave-valor para rótulos de metadados do sistema.
      "user_labels": objeto, pares de chave-valor para rótulos de metadados do usuário.
    },
    
    Informações sobre a política de alertas e a condição que abriu/resolveu o incidente.
    Os valores são extraídos do objeto AlertPolicy relevante.
    
    "policy_name": string, nome de exibição da política de alertas.
    "policy_user_labels": objeto, pares de chave-valor para qualquer rótulo de usuário anexado à política.
    "documentation": objeto, uma estrutura incorporada do formulário Documentation.
    "condition": objeto, uma estrutura incorporada do formulário Condition.
    "condition_name": string, nome de exibição da condição, mesmo valor de condition.displayName.
    "severity": string, nível de gravidade dos incidentes. Se esse campo não for definido durante a criação da política de alertas, o Cloud Monitoring definirá a gravidade da política de alertas como No Severity.
    "threshold_value": a string, o valor limite dessa condição, poderá ficar em branco se a condição não for uma condição de limite.
  },
}

Política de suspensão de uso

O esquema de payload está sujeito à política de suspensão de uso do Google Cloud descrita na Seção 1.4(d) dos Termos de Serviço do Google Cloud Platform. O esquema não controla os formatos dos valores de campo gerados, e esses formatos podem ser alterados sem aviso prévio. Por exemplo, incident.summary, incident.documentation.content e incident.url devem incluir dados pertencentes aos campos deles, mas o esquema não tem restrições para garantir uma análise precisa desses campos. É possível consumir o valor como um todo e esperar que ele obedeça à política de descontinuação, mas não dependa da análise dos campos gerados.

Google Chat

Visualização

Este produto ou recurso está sujeito aos "Termos das ofertas pré-GA" na seção "Termos de Serviço gerais" dos Termos específicos do serviço. Os produtos e recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

O app Google Cloud Monitoring permite que os espaços do Google Chat recebam notificações.

Antes de começar

Se você estiver em uma organização, para instalar o app Google Cloud Monitoring, é necessário ter acesso ao app Google Cloud Monitoring. Caso não tenha, solicite que um administrador do Google Workspace faça o seguinte:

1. Adicione o app à lista de permissões de apps do Marketplace e ative o acesso na unidade organizacional superior.
2. Defina as configurações de instalação do usuário do app do Marketplace para que os usuários possam instalar o app.

Instalar o app Google Cloud Monitoring

Use o procedimento a seguir para instalar o app Google Cloud Monitoring. Não é possível instalar pela listagem do Google Workspace Marketplace.

Para instalar o app e configurar um espaço como um canal de notificação, faça o seguinte:

1. No Google Chat, abra ou crie o espaço em que você quer receber notificações.

2. Instale o app Google Cloud Monitoring:

   1. Selecione o nome do espaço e clique em Apps e integrações.

   2. Se o app Google Cloud Monitoring não aparecer na lista de apps, retorne ao seu espaço, digite @Google Cloud Monitoring e pressione Enter.

   3. Clique em Adicionar ao espaço.

3. Copie o ID do espaço do Chat para a área de transferência.

   Se você instalou o app Google Cloud Monitoring, o ID do espaço de chat será incluído na confirmação da instalação. Caso contrário, você vai encontrar o ID do espaço do chat como uma série de números e letras após space/ no final do URL do espaço.

4. Abra uma nova guia do navegador e configure o canal de notificação:

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

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

   3. Acesse a seção Google Chat e clique em Adicionar novo.

   4. Digite o ID do espaço do Chat no campo ID do espaço do Chat e clique em Salvar.

Observação: não é possível visualizar ou gerenciar o incidente usando o app Google Cloud Monitoring. Para confirmar o incidente ou adiar a política de alertas relacionada, use o console do Google Cloud, a Google Cloud CLI ou a API Cloud Monitoring.

Criar um canal on demand

Ao adicionar um canal de notificação a uma política de alertas, é necessário selecionar um canal em uma lista. Para atualizar a lista de opções ao criar uma política de alertas, use o seguinte processo:

1. Na caixa de diálogo de notificação, clique em Gerenciar canais de notificação. Você será direcionado para a janela Canais de notificação em uma nova guia do navegador.
2. Para adicionar um novo canal de notificação, localize o tipo de canal, clique em Adicionar novo e siga as instruções específicas do canal contidas na tabela anterior.

3. Retorne à guia original e, na caixa de diálogo de notificação, clique em Atualizar.

   

4. Selecione o canal de notificação na lista atualizada.

Receber notificações em um canal não aceito

Se o canal de notificação de sua preferência não for compatível, crie um pipeline que dependa do envio das notificações para o Pub/Sub. Para um exemplo em Python que usa Flask, consulte Como criar notificações personalizadas com o Cloud Monitoring e o Cloud Run. Para ver outros exemplos, consulte o repositório Git cloud-alerting-notification-forwarding.

Testar um canal de notificação

O Cloud Monitoring não oferece suporte a uma opção de teste para canais de notificação. No entanto, é possível verificar se um canal de notificação está configurado corretamente criando uma política de alertas e definindo a condição a ser atendida.

Para testar manualmente os canais de notificação, crie uma política de alertas que monitore a utilização da CPU de uma das instâncias de máquina virtual (VM):

1. Opcional: se você ainda não tiver uma VM no seu projeto do Google Cloud ou quiser usar uma VM diferente para testes, crie uma VM:

   1. No Console do Google Cloud, acesse a página Instâncias de VM.

      Acessar Instâncias de VM

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

   2. Selecione Criar instância e configure sua VM. Para mais informações sobre como criar VMs, consulte Criar uma instância de VM a partir de uma imagem pública.

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

3. Selecione Criar política.

4. Use o menu Selecionar uma métrica para escolher a métrica Utilização da CPU de uma instância de VM.

5. Clique em Adicionar filtro e adicione um filtro para sua VM.

6. Atualize os campos Configurar gatilho da seguinte forma:

   1. Selecione Abaixo do limite para o campo Posição do limite.

   2. Selecione um valor maior que o uso da CPU da instância. Por exemplo, se o gráfico mostrar a utilização da CPU em cerca de 5%, defina o limite como 10%.

      Essas configurações definem a condição a ser atendida quando a utilização da CPU de uma instância de VM for menor que o limite especificado. Como você selecionou o limite maior que a utilização da CPU da instância de VM, a condição da política de alertas é atendida.

7. Adicione os canais de notificação à sua política.

8. Abra Duração do fechamento automático de incidentes e selecione 30 min.

9. Digite um nome e clique em Criar política.

10. Depois que a condição for atendida, verifique se você recebeu uma notificação em cada canal.

11. Exclua a política de alertas. O incidente é fechado automaticamente depois que esse período expira.

12. Se você criou uma instância de VM para este teste, exclua-a.

Se você não estiver recebendo notificações esperadas, pesquise na Análise de registros para encontrar entradas de registro com informações sobre as notificações ausentes. Para mais informações, consulte As notificações não são recebidas.

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:

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

Ver registros do canal de notificação

Use a Análise de registros para conferir os erros do canal de notificação:

1. No console do Google Cloud, acesse a página Análise de registros:

   Acessar a Análise de registros

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

2. Insira e execute sua consulta. Para consultas específicas sobre erros do canal de notificação, consulte Consultas do Cloud Monitoring.

A seguir

Para informações sobre incidentes, consulte os seguintes documentos:

• Incidentes para políticas de alertas baseadas em métricas
• Incidentes para políticas de alertas com base em registros.