View a markdown version of this page

Configuração do extrator - Amazon CloudWatch
Seções de configuração compatíveisExemplo de configuraçãoLimitaçõesSolução de problemas

Configuração do extrator

Os coletores do Prometheus gerenciados pelo Amazon CloudWatch usam uma configuração YAML compatível com o Prometheus para definir como o coletor extrai métricas. Você fornece essa configuração como um blob codificado em base64 ao criar ou atualizar um extrator. A configuração usa o formato de configuração de extração padrão do Prometheus, com algumas limitações específicas para coletores gerenciados.

Você pode usar GetDefaultScraperConfiguration para recuperar uma configuração de extrator de uso geral ou fornecer a sua própria.

Seções de configuração compatíveis

As seguintes seções de nível superior da configuração de extração do Prometheus são compatíveis:

  • global: configurações globais, incluindo scrape_interval, scrape_timeout e external_labels.

  • scrape_configs: uma lista de tarefas de extração, cada uma definindo os destinos e como extraí-los.

Em cada entrada scrape_configs, os seguintes campos são compatíveis:

  • job_name: um nome exclusivo para a tarefa de extração.

  • metrics_path: o caminho HTTP para extrair (o padrão é /metrics).

  • scheme: o esquema do protocolo (http ou https).

  • scrape_interval: sobreposição do intervalo global de extração por tarefa.

  • scrape_timeout: sobreposição do tempo limite de extração por tarefa.

  • static_configs: lista estática de destinos.

  • dns_sd_configs: descoberta de serviços baseada em DNS.

  • relabel_configs: regras de rerrotulagem aplicadas antes da extração.

  • metric_relabel_configs: regras de rerrotulagem aplicadas depois da extração.

  • tls_config: configuração TLS para destinos HTTPS.

Exemplo de configuração

O seguinte exemplo demonstra uma configuração básica de extração:

global:
  scrape_interval: 60s
  scrape_timeout: 10s
  external_labels:
    environment: production

scrape_configs:
  - job_name: 'my-service'
    metrics_path: /metrics
    scheme: http
    static_configs:
      - targets:
          - '10.0.1.10:9090'
          - '10.0.1.11:9090'
        labels:
          team: platform
    relabel_configs:
      - source_labels: [__address__]
        target_label: instance
    metric_relabel_configs:
      - source_labels: [__name__]
        regex: 'go_.*'
        action: drop

Limitações

  • O scrape_interval mínimo é de 30 segundos.

  • Os coletores gerenciados não são compatíveis com a descoberta de serviços baseada em arquivos (file_sd_configs).

  • Os coletores gerenciados não são compatíveis com o Consul, o Eureka ou outros mecanismos externos de descoberta de serviços.

  • As configurações de gravação e leitura remotas não se aplicam, pois o coletor gerencia a entrega para o CloudWatch.

  • O tamanho máximo da configuração é 256 KB.

Solução de problemas

Se o seu extrator não estiver coletando métricas conforme esperado, verifique o seguinte:

  • Verifique se o grupo de segurança anexado ao extrator permite tráfego de saída para suas portas de destino.

  • Confirme se seus destinos podem ser acessados pelas sub-redes que você especificou na configuração do extrator.

  • Verifique se os nomes DNS usados em dns_sd_configs são resolvidos corretamente na VPC.

  • Certifique-se de que seus destinos respondam no metrics_path configurado com o formato de exposição válido do Prometheus.

Para obter orientação adicional sobre solução de problemas, consulte Solução de problemas de coletores gerenciados no Guia do usuário do Amazon Managed Service for Prometheus.