Esta página foi traduzida pela API Cloud Translation.

Migrar regras de alerta e receptores do Prometheus

Esta página descreve como migrar regras de alertas do Prometheus para políticas de alertas baseadas em PromQL no Cloud Monitoring. O processo de migração é útil se você usa o PromQL em ambientes fora do Google Cloud. Ao migrar as regras de alerta do Prometheus para o Cloud Monitoring, você pode gerenciar todas as políticas de alerta em um único ambiente.

Para informações gerais sobre políticas de alertas baseadas em PromQL, consulte Visão geral de alertas do PromQL.

Também é possível importar painéis do Grafana. Para mais informações, consulte Importar painéis do Grafana para o Cloud Monitoring.

Como funciona a migração

Na CLI gcloud, é possível migrar as regras e os receptores de alertas atuais para criar políticas de alertas e canais de notificação do Cloud Monitoring. A CLI gcloud pode realizar os seguintes tipos de migração:

Se você fornecer um arquivo de configuração do Prometheus com uma regra de alerta, a CLI gcloud vai criar uma política de alertas baseada em PromQL.

É possível fornecer vários arquivos de configuração do Prometheus ao mesmo tempo para criar várias políticas de alerta baseadas em PromQL.
Se você fornecer um arquivo Alertmanager do Prometheus com pelo menos um receptor, a CLI gcloud vai converter cada receptor em um canal de notificação equivalente no Monitoring.

Observação: só é possível migrar um receptor do AlertManager quando o Cloud Monitoring oferece suporte ao mesmo tipo de canal de notificação. Por exemplo, o Cloud Monitoring não oferece suporte a receptores do Jira, portanto, eles não podem ser migrados de um arquivo AlertManager do Prometheus. Se você tentar migrar um receptor incompatível, a CLI gcloud vai ignorá-lo. Se você quiser usar um receptor que não é compatível com o Cloud Monitoring, crie um canal de notificação que use webhooks para endpoints públicos ou Pub/Sub para endpoints privados.
Se você fornecer um arquivo de Alertmanager do Prometheus e um arquivo de configuração do Prometheus ao mesmo tempo, a CLI gcloud vai criar a política de alertas e os canais de notificação e associar cada novo canal de notificação à nova política de alertas.

Se você fornecer vários arquivos de configuração com regras de alerta, a CLI gcloud vai atribuir todos os canais de notificação do arquivo Alertmanager a cada nova política de alertas.

Se a regra de alerta do Prometheus referenciar uma métrica personalizada, a CLI gcloud vai exigir um descritor de métrica equivalente para criar a política de alertas.

Os arquivos de configuração e do Alertmanager do Prometheus precisam ser formatados como arquivos de regras válidos do Prometheus em YAML ou JSON.

Mapeamento de campo

A CLI gcloud mapeia campos entre uma regra de alerta do Prometheus e uma política de alerta do Cloud Monitoring da seguinte maneira:

Regra de alerta do Prometheus	Política de alertas do Cloud Monitoring
`alert`	`conditionPrometheusQueryLanguage.alertRule`
`expr`	`conditionPrometheusQueryLanguage.query`
`for`	`conditionPrometheusQueryLanguage.duration`
`labels`	`conditionPrometheusQueryLanguage.labels`
`annotations: "summary"`	`documentation.subject`
`annotations: "description"`	`documentation.content`

Google Cloud variáveis de documentação em regras de alerta do Prometheus migradas

O Prometheus usa modelos de campo de alerta para configurar variáveis em anotações e rótulos de regras de alerta. Quando você migra regras de alerta do Prometheus que têm modelos de campo de alerta, o Cloud Monitoring converte os modelos em variáveis de documentação do Cloud Monitoring da seguinte maneira:

Modelo de campo de alerta do Prometheus	Variável da documentação do Cloud Monitoring
`{{$value}}`	`${metric.label.value}` Essa variável é uma implementação de `${metric.label.KEY}`, em que `value` armazena o valor da consulta PromQL.
`{{humanize $value}}`	`${metric.label.value}` Essa variável é uma implementação de `${metric.label.KEY}`, em que `value` armazena o valor da consulta PromQL.
`{{$labels}}`	`${metric_or_resource.labels}`
`{{humanize $labels}}`	`${metric_or_resource.labels}`
`{{$labels.key}}`	Aparece como `${metric_or_resource.label.KEY}` na configuração da documentação da política de alertas. Se `KEY` for um rótulo válido, essa variável será renderizada na notificação como o valor de `${metric.label.KEY}`. Se `KEY` for um recurso válido, essa variável será renderizada na notificação como o valor de `${resource.label.KEY}`. Se `KEY` não for um rótulo nem um recurso válido, essa variável será renderizada na notificação como uma string vazia.
`{{humanize $labels.<key>}}`	Aparece como `${metric_or_resource.label.KEY}` na configuração da documentação da política de alertas. Se `KEY` for um rótulo válido, essa variável será renderizada na notificação como o valor de `${metric.label.KEY}`. Se `KEY` for um recurso válido, essa variável será renderizada na notificação como o valor de `${resource.label.KEY}`. Se `KEY` não for um rótulo nem um recurso válido, essa variável será renderizada na notificação como uma string vazia.

Migrar regras de alerta e receptores do Prometheus

Para migrar as regras de alerta do Prometheus para políticas de alerta baseadas em PromQL do Cloud Monitoring, use o comando gcloud alpha monitoring policies migrate. Esse comando também permite migrar os receptores do Prometheus para os canais de notificação do Cloud Monitoring.

Para migrar uma regra de alerta, você precisa ter um arquivo YAML ou JSON do Prometheus rule file que contenha a regra de alerta.
Para migrar um receptor, você precisa de um arquivo YAML ou JSON do Alertmanager do Prometheus que contenha o receptor.

Observação: só é possível migrar um receptor do AlertManager quando o Cloud Monitoring oferece suporte ao mesmo tipo de canal de notificação. Por exemplo, o Cloud Monitoring não oferece suporte a receptores do Jira, portanto, eles não podem ser migrados de um arquivo AlertManager do Prometheus. Se você tentar migrar um receptor incompatível, a CLI gcloud vai ignorá-lo. Se você quiser usar um receptor que não é compatível com o Cloud Monitoring, crie um canal de notificação que use webhooks para endpoints públicos ou Pub/Sub para endpoints privados.

OGoogle Cloud não oferece suporte à migração de regras de gravação do Prometheus. Para usar regras de gravação, recomendamos usar um avaliador de regras autoimplantado.

Criar uma política de alertas a partir de um arquivo de configuração do Prometheus

Para criar uma política de alertas em um arquivo de configuração do Prometheus, execute o comando abaixo. É possível criar várias políticas de alerta fornecendo vários caminhos de arquivo:

gcloud alpha monitoring policies migrate \
--policies-from-prometheus-alert-rules-yaml=PATH_TO_FILE_1,PATH_TO_FILE_2

Criar canais de notificação em um arquivo de configuração do Prometheus Alertmanager

Para criar canais de notificação em um arquivo de configuração do Alertmanager do Prometheus, execute o seguinte comando:

gcloud alpha monitoring policies migrate \
--channels-from-prometheus-alertmanager-yaml=PATH_TO_FILE

Criar políticas de alerta e canais de notificação ao mesmo tempo

Para criar políticas de alerta com base em arquivos de configuração do Prometheus e criar canais de notificação de um arquivo de configuração do Alertmanager ao mesmo tempo, execute o seguinte comando:

gcloud alpha monitoring policies migrate \
--policies-from-prometheus-alert-rules-yaml=PATH_TO_FILE_1,PATH_TO_FILE_2 \
--channels-from-prometheus-alertmanager-yaml=PATH_TO_FILE

Exemplo

Você tem um arquivo de configuração do Prometheus com uma regra de alerta que envia um alerta quando a utilização da CPU permanece acima de 75% por um minuto. A regra de alerta é configurada da seguinte maneira:

groups:
- name: Utilization_Alerts
  interval: 30s
  rules:
  - alert: CPU_Utilization_Over_75
    expr: compute_googleapis_com:instance_cpu_utilization > 75
    for: 60s
    labels:
      severity: page
    annotations:
      subject: "Subject: ${metric.label.value}"
      description: "CPU utilization is over 75%"

Você também tem um arquivo AlertManager do Prometheus que contém os receptores de e-mail, PagerDuty e webhook.

receivers:
- name: 'team-emails'
  email_configs:
  - to: EMAIL_ADDRESS
- name: 'team-pager'
  pagerduty_configs:
  - service_key: SERVICE_KEY
- name: 'team-webhook'
  webhook_configs:
  - url: WEBHOOK_ADDRESS

Para criar a política de alertas e o canal de notificação, execute o seguinte comando:

gcloud alpha monitoring policies migrate \
--policies-from-prometheus-alert-rules-yaml=PATH_TO_CONFIG_FILE \
--channels-from-prometheus-alertmanager-yaml=PATH_TO_ALERTMANAGER_FILE

A CLI gcloud cria uma política de alertas como o exemplo abaixo:

  {
  "name": "projects/PROJECT_ID/alertPolicies/POLICY_ID",
  "displayName": "Utilization_Alerts/CPU_Utilization_Over_75",
  "documentation": {
    "content": "CPU utilization is over 75%",
    "mimeType": "text/markdown",
    "subject": "Subject: ${metric.label.value}"
  },
  "userLabels": {},
  "conditions": [
    {
      "name": "projects/PROJECT_ID/alertPolicies/POLICY_ID/conditions/CONDITION_ID",
      "displayName": "CPU_Utilization_Over_75"
      "conditionPrometheusQueryLanguage": {
        "alertRule": "CPU_Utilization_Over_75",
        "duration": "60s",
        "evaluationInterval": "30s",
        "labels": {
          "severity": "page"
        },
        "query": "compute_googleapis_com:instance_cpu_utilization > 75",
        "ruleGroup": "Utilization_Alerts"
      }
    }
  ],
  "alertStrategy": {},
  "combiner": "OR",
  "enabled": true,
  "notificationChannels": [
    "projects/google.com:PROJECT_ID/notificationChannels/CHANNEL_ID_1",
    "projects/google.com:PROJECT_ID/notificationChannels/CHANNEL_ID_2",
    "projects/google.com:PROJECT_ID/notificationChannels/CHANNEL_ID_3"
  ]
}

Migrar regras de alerta do Managed Service para Prometheus

Google Cloud configura a avaliação de regras gerenciadas para o Managed Service para Prometheus usando os recursos personalizados Rules, ClusterRules e GlobalRules.

Para migrar esses recursos para uma Google Cloud política de alertas baseada em PromQL, faça o seguinte:

Copie a seção groups do recurso personalizado para um novo arquivo de regras do Prometheus.
Migrar o arquivo de regra usando a CLI gcloud.

Por exemplo, você tem o seguinte recurso personalizado de regras:

apiVersion: monitoring.googleapis.com/v1
kind: Rules
metadata:
  namespace: NAMESPACE_NAME
  name: example-rules
spec:
  groups:
  - name: example
    interval: 30s
    rules:
    - alert: FewerThanTenInstancesUp
      expr: sum(up) < 10

O arquivo de regras do Prometheus criado copiando groups do recurso personalizado de regras anterior fica assim:

  groups:
  - name: example
    interval: 30s
    rules:
    - alert: FewerThanTenInstancesUp
      expr: sum(up) < 10

Migrar vários recursos personalizados de regras

Se você quiser migrar várias regras, regras personalizadas ou regras globais, recomendamos criar e migrar um arquivo de regras separado para cada recurso. Para mais informações, consulte a documentação do Prometheus.

Gerenciar expressões de filtro e agregação

As regras e as ClusterRules filtram automaticamente as expressões de alerta do Prometheus com base em determinados rótulos. Para preservar esse comportamento na consulta de uma política de alertas migrada, inclua explicitamente esses rótulos em um filtro ou expressão de agregação no arquivo de regras do Prometheus antes de migrar o arquivo.

Por exemplo, o avaliador de regras gerenciado do serviço gerenciado para Prometheus executa a expressão sum(up) < 10 da seguinte maneira:

sum(up{project_id="test-project", cluster="test-cluster", namespace="NAMESPACE_NAME"}) < 10

No entanto, se uma política de alertas tiver a consulta PromQL sum(up) < 10, o Cloud Monitoring vai executar a consulta como apenas sum(up) < 10. Essa consulta é aplicada a todos os projetos, clusters e namespaces do Google Cloud no escopo das métricas. Para evitar esse comportamento, recomendamos agregar por rótulos na consulta para garantir que o Cloud Monitoring execute a consulta conforme o esperado. Por exemplo, ao criar o arquivo de regras no recurso personalizado "Rules", você pode mudar sum(up) < 10 para a seguinte expressão:

sum (up) by (project_id, cluster, namespace) < 10

A expressão anterior gera uma série temporal separada para cada projeto, cluster e namespace do Google Cloud e, em seguida, compara cada série temporal com o limite de alerta de <10.

A tabela a seguir mostra a ordem de avaliação dos filtros de expressão de alerta para regras e regras de cluster:

Tipo de recurso da regra	Filtrar rótulos
Regra	`project_id` `cluster` `namespace`
ClusterRule	`project_id` `cluster`

Para mais informações sobre o comportamento de filtragem em expressões do Prometheus, consulte Seletores de vetor instantâneo.