Todos os produtos
Search
Central de documentação

Managed Service for Prometheus:Editar RecordingRule.yaml

Última atualização: Jul 05, 2026

Este tópico descreve como configurar regras de gravação e visualizar as métricas geradas por elas.

Informações básicas

As regras de gravação pré-calculam expressões frequentes ou computacionalmente custosas e salvam os resultados como um novo conjunto de séries temporais. Essa prática transfere a carga de processamento pesado do lado da consulta para o lado da escrita, o que melhora o desempenho das consultas e reduz o consumo de recursos na execução delas. Em clusters de grande escala ou cenários de negócios complexos, as regras de gravação simplificam expressões PromQL, aumentam a performance das consultas e ajudam a resolver problemas relacionados a consultas lentas e configurações complexas.

Nota

A configuração das regras de gravação é idêntica à do Prometheus open source. As regras são organizadas em grupos de regras. Cada grupo pode conter uma ou mais regras, e o nome de cada regra deve seguir as

convenções de nomenclatura de métricas do Prometheus

. As regras dentro do mesmo grupo são executadas sequencialmente em intervalos regulares. O serviço armazena as métricas pré-calculadas no banco de dados remoto sob o novo nome de métrica definido pela regra.

Configurar regras de gravação

  1. Faça login no console do ARMS.

  2. No painel de navegação à esquerda, escolha Managed Service for Prometheus > Instances.

  3. Faça login no console do Cloud Monitor.

  4. No painel de navegação à esquerda, escolha Managed Service for Prometheus > Instances para abrir a lista de instâncias do Managed Service for Prometheus.

  5. No canto superior esquerdo, selecione a região desejada e clique em nome da instância Prometheus de destino.

  6. No painel de navegação à esquerda, clique em Settings. Na aba Settings, clique em Edit RecordingRule.yaml.

  7. Na caixa de diálogo, exclua o modelo padrão, insira sua configuração e clique em Save.

    Nota

    Cada cluster requer apenas um arquivo

    RecordingRule.yaml

    . O nome de cada grupo de regras deve ser único.

    bc

    Veja abaixo um exemplo de configuração de regra de gravação:

    groups:
      - name: apiserver_request_total
        interval: 60s
        rules:
          - record: job_instance_mode:apiserver_request_total:avg_rate5m
            expr: avg by (job, instance, mode) (rate(apiserver_request_total[5m]))
            labels:
              team: operations
          - record: job:apiserver_request_total:sum_rate10m
            expr: sum by (job)(rate(apiserver_request_total[10m]))
            labels:
              team: operations
    Parâmetro Descrição
    groups Os grupos de regras. É possível configurar vários grupos de regras em um único arquivo RecordingRule.yaml.
    name Nome do grupo de regras. Deve ser único dentro do arquivo.
    interval (Opcional) Intervalo de avaliação do grupo de regras. O valor padrão é 60s.
    rules As regras. Um grupo de regras pode conter uma ou mais regras.
    record Nome da nova série temporal. Deve ser um nome de métrica Prometheus válido.
    Nota O formato recomendado para o nome de uma regra de gravação é level:metric:operations.
    • level: Nível de agregação e rótulos de saída da regra.
    • metric: Nome da métrica.
    • operations: Lista de operações aplicadas à métrica, com a operação mais recente listada primeiro.
    expr Expressão PromQL a ser avaliada. O Managed Service for Prometheus usa essa expressão para calcular a métrica pré-computada. A expressão deve ser uma consulta PromQL válida.
    labels (Opcional) Rótulos a serem adicionados à nova métrica.

Visualizar métricas de regras de gravação

Método 1: Painel do Grafana

  1. Faça login no Grafana como administrador.

  2. No painel de navegação à esquerda, selecione Explore.

  3. Na página Explore, selecione o cluster Kubernetes de destino. Em seguida, no campo ao lado de Metrics, insira o nome da nova métrica para visualizar seus dados.

    fg

Método 2: Console do Prometheus

  1. Faça login no console do ARMS.

  2. No painel de navegação à esquerda, escolha Managed Service for Prometheus > Instances.

  3. Faça login no console do Cloud Monitor.

  4. No painel de navegação à esquerda, escolha Managed Service for Prometheus > Instances para abrir a lista de instâncias do Managed Service for Prometheus.

  5. No canto superior esquerdo, selecione a região desejada e clique em nome da instância Prometheus de destino.

  6. No painel de navegação à esquerda, clique em Service Discovery. Na aba Metrics, insira o nome da nova métrica na caixa de pesquisa para visualizar seus detalhes.

Escrita remota para regras de gravação

O Managed Service for Prometheus oferece suporte ao recurso de escrita remota para regras de gravação, assim como no Prometheus open source.

  1. Faça login no console do ARMS.

  2. No painel de navegação à esquerda, escolha Managed Service for Prometheus > Instances.

  3. Faça login no console do Cloud Monitor.

  4. No painel de navegação à esquerda, escolha Managed Service for Prometheus > Instances para abrir a lista de instâncias do Managed Service for Prometheus.

  5. No canto superior esquerdo, selecione a região desejada e clique em nome da instância Prometheus de destino.

  6. No painel de navegação à esquerda, clique em Settings. Na aba Settings, clique em Edit Prometheus.yaml.

  7. Na caixa de diálogo Edit Prometheus.yaml, configure as definições de escrita remota.

    jk

    Nota

    A configuração de escrita remota segue o mesmo padrão do Prometheus open source. É possível configurar múltiplos endpoints de escrita remota e utilizar

    write_relabel_configs

    .

    Essa configuração se aplica tanto ao agente quanto ao componente de regra de gravação. Caso deseje enviar remotamente apenas as métricas geradas pelas regras de gravação para outro banco de dados, configure uma seção

    write_relabel_configs

    correspondente. Veja abaixo um exemplo de configuração:

    remote_write:
      - url: "https://xxxx/api/v1/prom/write?db=dbname&u=username&p=password"    // The endpoint of the remote write database.
        write_relabel_configs:
          - source_labels: [__name__]
            regex: job_instance_mode:apiserver_request_total:avg_rate5m
            action: keep
    Nota

    Essa configuração garante que apenas a métrica da regra de gravação especificada (

    job_instance_mode:apiserver_request_total:avg_rate5m

    ) seja enviada ao endpoint de escrita remota.

Operações relacionadas

Para usar a escrita remota nas métricas geradas pelas regras de gravação, a URL de destino deve ser um endpoint público. Se precisar adicionar o componente de regra de gravação a uma lista de permissões de rede, adicione os endereços IP correspondentes à sua região.

 China (Beijing): 101.200.XX.XX
 China (Hangzhou): 118.31.XX.XX
 China (Shanghai): 106.14.XX.XX
 China (Shenzhen): 8.129.XX.XX
 China (Zhangjiakou): 39.103.XX.XX
 China (Qingdao): 139.129.XX.XX
 China (Chengdu): 47.108.XX.XX
 China (Hong Kong): 47.242.XX.XX
 Singapore: 47.241.XX.XX

Para obter os endereços IP específicos para a lista de permissões, envie um ticket ou entre em contato com um especialista do produto buscando a conta de plantão do Prometheus no DingTalk (ID: aliprometheus).