O recurso de coleta personalizada permite coletar métricas de endpoints específicos em contêineres ou instâncias ECS, tornando o Prometheus mais flexível, automatizado e gerenciável. Este documento usa um ambiente de contêiner como exemplo.
Limitações
Somente ambientes de contêiner e ECS têm suporte.
Faturamento
A coleta personalizada gera custos. Para mais informações, consulte Prometheus instance billing.
Pré-requisitos
Tenha um contêiner ou uma instância ECS. Para obter instruções, consulte Crie an ACK managed cluster e Crie an instance.
Um endpoint de destino no cluster de contêineres ou na instância ECS deve expor métricas.
Acesso
Faça login no ARMS console.
Faça login no Cloud Monitor console.
No painel de navegação à esquerda, clique em Integration Management.
Na aba Integrated Environments, localize o ambiente de destino na lista Container Environment. Clique em Metric Scraping na coluna Actions para abrir a página Metric Scraping.
Na aba Metric Scraping, clique em Customize Collection.
Lista de coleta personalizada
A página Customize Collection exibe todas as configurações de coleta personalizada do ambiente atual de contêiner ou ECS.
A lista inclui as seguintes colunas: Name, Job Name, Component, Service Discovery Method, Scrape Path, Scrape Interval e Actions. Na coluna Actions, você pode Disable, Edite Configuration e Exclua tarefas. No canto superior direito da página, clique em Crie para adicionar uma tarefa de coleta e pesquisar tarefas por Task Name.
Crie coleta personalizada
Na página Customize Collection, clique em Create. No painel Add Custom Collection Task, insira um Job Name, cole a configuração YAML de coleta personalizada no editor de código e clique em Precheck and Create.
A configuração YAML usa o formato scrape_configs do Prometheus. Defina múltiplos jobs, como job1 e job2. Cada job pode incluir campos como honor_timestamps, honor_labels, scrape_interval (por exemplo, 30s), scheme (por exemplo, http), metrics_path (por exemplo, /metric) e targets em static_configs (por exemplo, 127.0.0.1:9090).
Intervalo de coleta e passo de consulta do Grafana
O parâmetro scrape_interval na configuração YAML (ou interval em um ServiceMonitor/PodMonitor) controla a frequência de coleta de dados do endpoint de destino pelo Prometheus. Por exemplo, interval: 5s indica que o Prometheus coleta métricas a cada 5 segundos.
O passo da consulta determina a granularidade dos dados exibidos em um painel do Grafana, independentemente do intervalo de coleta. O Grafana calcula o passo real da consulta com a fórmula: max(Min interval, Time range / Max data points). Mesmo com um intervalo de coleta de 5s, o Grafana pode exibir dados com granularidade de 15s ou 30s ao visualizar longos períodos.
Para alinhar a granularidade dos dados do Grafana ao intervalo de coleta, expanda Query options no editor do painel. Defina o Min interval com o mesmo valor do intervalo de coleta (por exemplo, 5s) e visualize um período mais curto. O Min interval estabelece apenas um limite inferior para o passo da consulta; essa configuração não surte efeito se o passo calculado já for maior.
Operações relacionadas
Edite coleta personalizada
Para edite uma tarefa de coleta personalizada, localize-a na lista e clique em Edite Configuration na coluna Operation. Modifique o conteúdo YAML no painel Edit Custom Collection Task.
Exclua coleta personalizada
Para exclua uma tarefa de coleta personalizada, localize-a na lista e clique em Exclua na coluna Operation.
Desativar coleta personalizada
Para desativar uma tarefa de coleta personalizada, localize-a na lista e clique em Disable na coluna Operation. Uma tarefa desativada interrompe a coleta de métricas.