Alertas para políticas de alertas com base em métricas

Com os alertas do Cloud Monitoring, é possível rastrear e investigar problemas quando os dados de série temporal atendem às condições de uma política de alertas com base em métricas. Para cada alerta, o Monitoring envia uma notificação e cria uma página Detalhes do alerta para ajudar você a resolver problemas na falha e gerenciar o ciclo de vida do alerta.

Na página Detalhes do alerta, é possível conferir a linha do tempo do alerta, gráficos de dados de métricas monitoradas e links para alertas e entradas de registro relacionados. Se uma política tiver várias condições, ela vai especificar se o atendimento de uma única condição abre um alerta. O Monitoring não cria um alerta se a política estiver em espera ou desativada, ou se o número de políticas de alertas ou alertas exceder os limites de alertas.

Esse recurso só está disponível para projetos Google Cloud . Para configurações do App Hub, selecione o projeto host ou de gerenciamento do App Hub.

Antes de começar

Para ter as permissões necessárias para visualizar e gerenciar alertas, peça ao administrador para conceder a você os seguintes papéis do IAM 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 usando 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.

Ver alertas

Para ver alertas no seu projeto, use o console Google Cloud , a CLI gcloud ou a API Monitoring.

Console do Google Cloud

Para listar os alertas no seu projeto 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. Na barra de ferramentas do console Google Cloud , selecione seu projeto Google Cloud . Para configurações do App Hub, selecione o projeto host ou de gerenciamento do App Hub.

    A página Alertas mostra informações sobre suas políticas de alertas, adiamentos e alertas:

    • O painel Resumo lista o número de alertas abertos.
    • A tabela Alertas mostra os alertas abertos mais recentes. Para listar os alertas mais recentes na tabela, incluindo aqueles que foram fechados, clique em Mostrar alertas fechados.

  3. Para ver os detalhes de um alerta específico, selecione-o na lista.

    A página Detalhes do alerta é aberta. Para mais informações sobre a página Detalhes do alerta, consulte a seção Investigar um alerta deste documento.

Encontrar alertas mais antigos

A tabela Alertas na página Alertas mostra os alertas abertos mais recentes. Para ver alertas mais antigos, siga um destes procedimentos:

  • Para navegar pelas entradas na tabela Alertas, clique em  Mais recentes ou  Mais antigos.

  • Para abrir uma página que permite listar e filtrar seus alertas, clique em Ver todos os alertas. A página Alertas é aberta. Nessa página, faça o seguinte:

    • Mostrar todos os alertas, incluindo os fechados. Para mostrar todos os alertas, clique em Mostrar alertas fechados.
    • Filtrar alertas. Para informações sobre como adicionar filtros, consulte Filtrar alertas.
    • Confirmar ou fechar um alerta ou ativar a soneca da política de alertas. Para acessar essas opções, clique em  Mais opções na linha do alerta e faça uma seleção no menu. Para mais informações, consulte Gerenciar alertas.

Filtrar alertas

Para restringir os alertas mostrados na tabela, adicione filtros. Se você adicionar vários filtros, a tabela vai mostrar apenas os alertas que atendem a todos eles.

Para filtrar a tabela de alertas, faça o seguinte:

  1. Na página Alertas, clique em  Filtrar tabela e selecione uma propriedade de filtro. As propriedades de filtro incluem o seguinte:

    • Estado do alerta
    • Nome da política de alertas
    • Quando o alerta foi aberto ou fechado
    • Tipo de métrica
    • Tipo de recurso

  2. Selecione um valor no menu secundário ou insira um valor na barra de filtro.

    Por exemplo, se você selecionar Tipo de métrica e inserir usage_time, poderá ver apenas as seguintes opções no menu secundário:

    agent.googleapis.com/cpu/usage_time
compute.googleapis.com/guest/container/cpu/usage_time
container.googleapis.com/container/cpu/usage_time

    A tabela Alertas lista o filtro.

gcloud

É possível usar a gcloud para receber e listar alertas.

Receber alerta

Antes de usar os dados do comando abaixo, faça estas substituições:

  • ALERT_NAME: o nome do recurso do alerta. Por exemplo, projects/my-project/alerts/my-alert-id.

Execute o comando gcloud alpha monitoring alerts describe:

Linux, macOS ou Cloud Shell

gcloud alpha monitoring alerts describe ALERT_NAME

Windows (PowerShell)

gcloud alpha monitoring alerts describe ALERT_NAME

Windows (cmd.exe)

gcloud alpha monitoring alerts describe ALERT_NAME
 O comando retorna uma resposta com detalhes do alerta, como estado do alerta, rótulos anexados e a política de alertas de origem. A resposta será semelhante a: 
{
  "name": "projects/my-project/alerts/my-alert-id1",
  "state": "OPEN",
  "open_time": "2025-06-11T09:53:46Z",
  "close_time": "2025-06-13T10:11:36Z",
  "resource": {
    "type": "gce_instance",
    "labels": {
      "zone": "us-west1",
      "instance_id": "123456789",
      "project_id": "my-project"
    }
  },
  "metric": {
    "labels": {
      "instance_name": "my-instance1"
    },
    "type": "compute.googleapis.com/instance/cpu/usage_time"
  },
  "policy": {
    "name": "projects/my-project/alertPolicies/POLICY_1",
    "displayName": "my-policy"
  },
  "summaryText": "[ALERT] VM Instance - CPU usage on my-project my-instance1"
}

Listar alertas

É possível listar alertas no projeto e filtrar os resultados usando a CLI gcloud.

Antes de usar os dados do comando abaixo, faça estas substituições:

  • PROJECT_ID: o identificador do projeto.

Execute o comando gcloud alpha monitoring alerts list:

Linux, macOS ou Cloud Shell

gcloud alpha monitoring alerts list

Windows (PowerShell)

gcloud alpha monitoring alerts list

Windows (cmd.exe)

gcloud alpha monitoring alerts list
 O comando retorna uma resposta com detalhes do alerta, como estado do alerta, rótulos anexados e a política de alertas de origem. A resposta será semelhante a: 
{
  "alerts": [
    {
      "name": "projects/my-project/alerts/my-alert-id1",
      "state": "OPEN",
      "open_time": "2025-06-11T09:53:46Z",
      "close_time": "2025-06-13T10:11:36Z",
      "resource": {
        "type": "gce_instance",
        "labels": {
          "zone": "us-west1",
          "instance_id": "123456789",
          "project_id": "my-project"
        }
      },
      "metric": {
        "labels": {
          "instance_name": "my-instance1"
        },
        "type": "compute.googleapis.com/instance/cpu/usage_time"
      },
      "policy": {
        "name": "projects/my-project/alertPolicies/POLICY_1",
        "displayName": "my-policy"
      },
      "summaryText": "[ALERT] VM Instance - CPU usage on my-project my-instance1"
    }
  ]
}
Também é possível usar as seguintes flags opcionais para filtrar, classificar ou modificar a saída:

  • --filter: forneça uma expressão de filtro para filtrar alertas por hora ou rótulo. Por exemplo, filtre por tempo com --filter='close_time>="2025-09-10T00:00:00Z"' ou por rótulo com --filter='resource.labels.key="value"'.

  • --sort-by: uma lista separada por vírgulas de campos para ordenar a saída. Por exemplo, --sort-by=open_time.

  • --uri: A resposta ao comando gera uma lista de URIs de recursos em vez da saída padrão.

  • --limit: defina essa flag como 2 ou maior para limitar o número de alertas retornados. Não use essa flag com a flag --filter.

API Monitoring

É possível usar a API Monitoring para receber e listar alertas.

Receber alerta

Para receber detalhes sobre um único alerta com a API Monitoring, use o método alerts.get.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • PROJECT_ID: o identificador do projeto.
  • ALERT_ID: o ID do alerta.

Método HTTP e URL: 

GET https://monitoring.googleapis.com/v3/projects/PROJECT_ID/alerts/ALERT_ID

Para enviar a solicitação, expanda uma destas opções:

O comando retorna uma resposta com detalhes do alerta, como estado do alerta, rótulos anexados e a política de alertas de origem. A resposta será semelhante a: 
{
  "name": "projects/my-project/alerts/my-alert-id1",
  "state": "OPEN",
  "open_time": "2025-06-11T09:53:46Z",
  "close_time": "2025-06-13T10:11:36Z",
  "resource": {
    "type": "gce_instance",
    "labels": {
      "zone": "us-west1",
      "instance_id": "123456789",
      "project_id": "my-project"
    }
  },
  "metric": {
    "labels": {
      "instance_name": "my-instance1"
    },
    "type": "compute.googleapis.com/instance/cpu/usage_time"
  },
  "policy": {
    "name": "projects/my-project/alertPolicies/POLICY_1",
    "displayName": "my-policy"
  },
  "summaryText": "[ALERT] VM Instance - CPU usage on my-project my-instance1"
}

Listar alertas

Para listar alertas no seu projeto e filtrar os resultados com a API Monitoring, use o método alerts.list.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • PROJECT_ID: o identificador do projeto.

Método HTTP e URL: 

GET https://monitoring.googleapis.com/v3/projects/PROJECT_ID/alerts

Para enviar a solicitação, expanda uma destas opções:

O comando retorna uma resposta com detalhes do alerta, como estado do alerta, rótulos anexados e a política de alertas de origem. A resposta será semelhante a: 
{
  "alerts": [
    {
      "name": "projects/my-project/alerts/my-alert-id1",
      "state": "OPEN",
      "open_time": "2025-06-11T09:53:46Z",
      "close_time": "2025-06-13T10:11:36Z",
      "resource": {
        "type": "gce_instance",
        "labels": {
          "zone": "us-west1",
          "instance_id": "123456789",
          "project_id": "my-project"
        }
      },
      "metric": {
        "labels": {
          "instance_name": "my-instance1"
        },
        "type": "compute.googleapis.com/instance/cpu/usage_time"
      },
      "policy": {
        "name": "projects/my-project/alertPolicies/POLICY_1",
        "displayName": "my-policy"
      },
      "summaryText": "[ALERT] VM Instance - CPU usage on my-project my-instance1"
    }
  ]
}
Os usuários do Curl podem adicionar a flag --data-urlencode seguida de uma expressão de filtro para filtrar alertas por hora ou rótulo. Veja os exemplos a seguir:

Listar alertas abertos na última hora:

--data-urlencode "filter=(open_time>=\"`date -u -d "1 hour ago" +"%Y-%m-%dT%H:%M:%SZ"`\")"

Listar e filtrar alertas abertos no último dia:

--data-urlencode "filter=(open_time>=\"`date -u -d "1 DAY ago" +"%Y-%m-%dT%H:%M:%SZ"`\" AND state=open)"

Listar e filtrar alertas abertos entre dois períodos:

--data-urlencode "filter=(open_time>=\"`date -u -d "2 DAY ago" +"%Y-%m-%dT%H:%M:%SZ"`\" AND open_time<=\"`date -u -d "1 DAY ago" +"%Y-%m-%dT%H:%M:%SZ"`\")"

Liste e filtre alertas por rótulo do usuário. Neste exemplo, filtre por um rótulo de usuário com o nome app e o valor my-gke-app:

--data-urlencode "filter=(policy.user_labels.app=\"my-gke-app\")"
Os usuários do PowerShell podem usar o exemplo a seguir para adicionar um filtro com base no tempo ao URL da solicitação: 
$baseUrl = "https://monitoring.googleapis.com/v3/projects/my-project/alerts"
$filterValue = (Get-Date).AddHours(-1).ToString("yyyy-MM-ddTHH:mm:ssZ")
$filter = 'open_time >= "' + $filterValue + '"'
$encodedFilter = [System.Uri]::EscapeDataString($filter)
$url = $baseUrl + "?filter=" + $encodedFilter

Investigar um alerta

A página Detalhes do alerta contém informações que podem ajudar você a identificar a causa de um alerta.

Acessar dados de métricas

Para analisar o estado da métrica antes e depois da ocorrência do alerta, use o gráfico Métricas de alerta. Esse gráfico mostra uma linha do tempo e a série temporal que fez com que a condição da política de alertas fosse atendida.

É possível ajustar o intervalo da linha do tempo para procurar tendências e padrões nos dados de métricas em relação ao alerta:

  • Para alternar entre mostrar apenas as série temporal que causaram a condição e mostrar todas as série temporal que a condição avalia, clique em Mostrar todas as séries temporais.

  • Para mudar o período mostrado no gráfico, use o seletor de período na barra de ferramentas ou destaque os períodos no gráfico com o ponteiro.

Você também pode analisar os dados de métricas com mais detalhes no Metrics Explorer. Para fazer isso, acesse o gráfico Métricas de alerta e clique em Explorar dados. Por padrão, o Metrics Explorer agrega e filtra dados de métricas para que o gráfico de métricas se alinhe à série temporal mostrada na linha do tempo Métricas de alerta.

Analisar entradas de registro

O painel Registros na página Detalhes do alerta mostra entradas de registro que correspondem ao tipo de recurso e aos rótulos do recurso monitorado da sua métrica. Você pode analisar essas entradas de registro para encontrar mais informações que ajudem a resolver problemas no alerta.

  • Para ver as entradas de registro na Análise de registros, clique em Ver na Análise de registros e selecione um projeto de escopo. A Análise de registros oferece outras ferramentas para analisar dados de entrada de registro, como uma linha do tempo de quando as entradas de registro relacionadas foram criadas.
  • Para ver e editar a consulta usada para filtrar as entradas de registro no Metrics Explorer, clique em Explorar dados.

Ver informações do aplicativo

Para políticas de alertas associadas a um aplicativo do App Hub, acesse a seção Associado ao aplicativo. Uma entrada nesta seção lista o ID do aplicativo e links para um painel que mostra informações sobre ele. A segunda entrada lista uma carga de trabalho ou um serviço e links para um painel.

Ver informações complementares

A seção Marcadores mostra os marcadores e valores do recurso monitorado e a métrica da série temporal que causou o alerta, além dos marcadores definidos pelo usuário na política de alertas. Essas informações podem ajudar a identificar o recurso monitorado específico que causou o alerta. Para mais informações, consulte Anotar alertas com rótulos.

A seção Documentação mostra o modelo de documentação para notificações que você forneceu ao criar a política de alertas. Essas informações podem incluir uma descrição do que a política de alertas monitora, bem como dicas de mitigação. Para mais informações, consulte Anotar notificações com documentação definida pelo usuário.

Se você não configurou a documentação para sua política de alertas, o painel Documentação vai mostrar "Nenhuma documentação foi configurada".

Para ajudar você a descobrir problemas subjacentes no aplicativo, é possível analisar alertas relacionados a outras condições política de alertas.

A seção Alertas relacionados mostra uma lista de alertas que correspondem a um dos seguintes itens:

  • O alerta foi criado quando uma condição da mesma política de alertas foi atendida.
  • O alerta compartilha um rótulo com o alerta mostrado na página Detalhes do alerta.

Gerenciar alertas

Os alertas estão em um dos seguintes estados:

  •  Aberto: O conjunto de condições da política de alertas está sendo atendido ou não há dados que indiquem que a condição não está mais atendida. Se uma política de alertas tiver várias condições, os alertas serão abertos dependendo de como essas condições são combinadas. Para mais informações, consulte Políticas com várias condições.

  •  Confirmado: O alerta está aberto e foi marcado manualmente como confirmado. Normalmente, esse status indica que o alerta está sendo investigado.

  •  Fechado: O sistema observou que a condição deixou de ser atendida, você fechou o alerta ou passaram sete dias sem uma observação de que a condição continuava sendo atendida.

Ao configurar uma política de alertas, verifique se o estado estável fornece um sinal quando tudo está OK. Isso é necessário para garantir que o estado sem erros possa ser identificado e, se um alerta estiver aberto, para que ele seja fechado. Se não houver um indicador de que uma condição de erro foi interrompida, depois que um alerta for aberto, ele vai permanecer aberto por sete dias após o acionamento da política de alertas.

Por exemplo, se você criar uma política de alertas que notifica quando a contagem de erros é maior que zero, verifique se ela produz uma contagem de zero erros quando não há erros. Se a política de alertas retornar nulo ou vazio no estado sem erros, não haverá um sinal para indicar quando os erros pararam. Se necessário, o PromQL permite especificar um valor padrão que é usado quando nenhum valor medido está disponível.

Confirmar alertas

Recomendamos que você marque um alerta como confirmado quando começar a investigar a causa dele.

Para marcar um alerta como confirmado, faça o seguinte:

  1. Na tabela Alertas da página Alertas, clique em Ver todos os alertas.

  2. Na página Alertas, encontre o alerta que você quer confirmar e faça uma destas ações:

    • Clique em  Mais opções e selecione Confirmar.
    • Abra a página de detalhes do alerta e clique em Confirmar alerta.

Se a política de alertas estiver configurada para enviar notificações repetidas, o reconhecimento de um alerta não vai interromper as notificações. Para interromper, faça o seguinte:

  • Crie uma suspensão para a política de alertas.
  • Desative a política de alertas.

Suspender uma política de alertas

Para impedir que o Monitoring crie alertas e envie notificações durante um período específico, adie a política de alertas relacionada. Quando você adia uma política de alertas, o Monitoring também fecha todos os alertas relacionados a ela.

Para criar uma soneca para um alerta que você está visualizando, faça o seguinte:

  1. Na página Detalhes do alerta, clique em Adiar política.

  2. Selecione a duração do adiamento. Depois de selecionar a duração, o adiamento começa imediatamente.

Você também pode adiar uma política de alertas na página Alertas. Para isso, encontre o alerta que você quer adiar, clique em  Mais opções e selecione Adiar. É possível adiar as políticas de alertas durante interrupções para evitar mais notificações durante o processo de solução de problemas.

Fechar alertas

Você pode deixar o Monitoring fechar um alerta ou fazer isso quando as observações pararem de chegar. Se você fechar um alerta e depois chegarem dados que indicam que a condição foi atendida, um novo alerta será criado. Quando você fecha um alerta, essa ação não fecha outros alertas abertos para a mesma condição. Se você suspender uma política de alertas, os alertas abertos serão fechados quando a suspensão começar.

O Monitoring fecha automaticamente um alerta quando ocorre uma das seguintes situações:

  • Condições de limite de métrica:

    • Uma observação chega indicando que o limite não foi violado.

    • Nenhuma observação chega, a condição está configurada para fechar alertas quando as observações pararem de chegar, e o estado do recurso subjacente é desconhecido ou não está desativado.

    • Nenhuma observação chega durante o período de fechamento automático da política de alertas, e a condição não está configurada para fechar alertas automaticamente quando as observações param de chegar. Para configurar a duração do fechamento automático, use o console do Google Cloud ou a API Monitoring. Por padrão, a duração do fechamento automático é de sete dias. A duração mínima de fechamento automático é de 30 minutos.

  • Condições de ausência de métrica:

    • Uma observação ocorre.
    • Nenhuma observação chega por 24 horas após o término do período de fechamento automático da política de alertas. Para configurar a duração do fechamento automático, use o console do Google Cloud ou a API Monitoring. Por padrão, a duração do fechamento automático é de sete dias.

  • Condições de previsão:

    • Uma previsão é gerada e prevê que a série temporal não vai violar o limite dentro da janela de previsão.

    • Nenhuma observação chega por 10 minutos, a condição está configurada para fechar alertas quando as observações pararem de chegar, e o estado do recurso subjacente é desconhecido ou não está desativado.

    • Nenhuma observação chega durante o período de fechamento automático da política de alertas, e a condição não está configurada para fechar alertas automaticamente quando as observações param de chegar.

Por exemplo, uma política de alertas gerou um alerta porque a latência de resposta HTTP foi maior que 2 segundos por 10 minutos consecutivos. Se a próxima medição da latência de resposta HTTP for menor ou igual a dois segundos, o alerta será fechado. Da mesma forma, se nenhum dado for recebido por sete dias, o alerta será fechado.

Para fechar um alerta, faça o seguinte:

  1. Na tabela Alertas da página Alertas, clique em Ver todos os alertas.

  2. Na página Alertas, encontre o alerta que você quer encerrar e faça uma destas ações:

    • Clique em  Ver mais e selecione Fechar alerta
    • Abra a página Detalhes do alerta e clique em Fechar alerta.

Se você vir a mensagem Unable to close alert with active conditions, o alerta não poderá ser fechado porque dados foram recebidos no período de alerta mais recente.

Se a mensagem Unable to close alert. Please try again in a few minutes. aparecer, o alerta não poderá ser fechado devido a um erro interno.

Retenção e limites de dados

Para informações sobre limites e o período de armazenamento dos alertas, consulte Limites para alertas.

A seguir