O recurso de coleta personalizada permite coletar métricas de endpoints específicos em seus 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 Create an ACK managed cluster e Create 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 console do ARMS.
Faça login no console do Cloud Monitor.
No painel de navegação à esquerda, clique em Integration Management.
Na aba Integrated Environments, localize o ambiente desejado 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 coletas personalizadas
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, Edit Configuration e Delete tarefas. No canto superior direito da página, clique em Create para adicionar uma tarefa de coleta e pesquisar tarefas por Task Name.
Criar 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. Você pode definir vários 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 com que o Prometheus coleta dados do endpoint de destino. Por exemplo, interval: 5s significa 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 que o intervalo de coleta seja de 5s, o Grafana pode exibir dados com granularidade de 15s ou 30s ao visualizar um longo período.
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 seu 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
Editar coleta personalizada
Para editar uma tarefa de coleta personalizada, localize-a na lista e clique em Edit Configuration na coluna Operation. Modifique o conteúdo YAML no painel Edit Custom Collection Task.
Excluir coleta personalizada
Para excluir uma tarefa de coleta personalizada, localize-a na lista e clique em Delete 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.