Gerenciar alertas para políticas de alertas com base em registros

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 notifications 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 conferir 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, faça o seguinte:

• Para percorrer as entradas na tabela Alertas, clique em arrow_back_ios Mais recentes ou arrow_forward_ios Mais antigas.

• 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 adiar a política de alertas dele. Para acessar essas opções, clique em more_vert 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 alertas que atendam a todos eles.

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

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

   • Estado do alerta
   • Nome da política de alertas
   • Quando o alerta foi aberto ou fechado

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

   A tabela Alertas lista o filtro.

gcloud

É possível usar o 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:

gcloud alpha monitoring alerts describe ALERT_NAME

gcloud alpha monitoring alerts describe ALERT_NAME

gcloud alpha monitoring alerts describe ALERT_NAME

{
  "name": "projects/my-project/alerts/my-alert-id",
  "state": "OPEN",
  "open_time": "2025-06-11T09:53:46Z",
  "resource": {
    "type": "k8s_cluster",
    "labels": {
      "location": "us-central1",
      "cluster_name": "example_cluster",
      "project_id": "my-project"
    }
  },
  "log": {
    "extracted_labels": {
      "title": "my title"
    }
  },
  "policy": {
    "name": "projects/my-project/alertPolicies/POLICY_1",
    "displayName": "test-policy"
  },
  "summaryText": "[ALERT] test-policy for Kubernetes Cluster with {cluster_name=example_cluster, location=us-central1, project_id=my-project}"
}

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:

gcloud alpha monitoring alerts list

gcloud alpha monitoring alerts list

gcloud alpha monitoring alerts list

{
  "alerts": [
    {
      "name": "projects/my-project/alerts/my-alert-id",
      "state": "OPEN",
      "open_time": "2025-06-11T09:53:46Z",
      "resource": {
        "type": "k8s_cluster",
        "labels": {
          "location": "us-central1",
          "cluster_name": "example_cluster",
          "project_id": "my-project"
        }
      },
      "log": {
        "extracted_labels": {
          "title": "my title"
        }
      },
      "policy": {
        "name": "projects/my-project/alertPolicies/POLICY_1",
        "displayName": "test-policy"
      },
      "summaryText": "[ALERT] test-policy for Kubernetes Cluster with {cluster_name=example_cluster, location=us-central1, project_id=my-project}"
    }
  ]
}

• --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 marcador 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: o comando gera uma lista de URIs de recursos em vez da saída padrão.

• --limit: defina essa flag como 2 ou um valor 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 conferir detalhes sobre um único alerta com a API Monitoring, use o método alerts.get.