# Configuração do extrator
<a name="managed-prometheus-collectors-scraper-configuration"></a>

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](https://docs.aws.amazon.com/prometheus/latest/APIReference/API_GetDefaultScraperConfiguration.html) para recuperar uma configuração de extrator de uso geral ou fornecer a sua própria.

## Seções de configuração compatíveis
<a name="managed-prometheus-collectors-scraper-configuration-supported"></a>

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
<a name="managed-prometheus-collectors-scraper-configuration-example"></a>

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
<a name="managed-prometheus-collectors-scraper-configuration-limits"></a>
+ 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
<a name="managed-prometheus-collectors-scraper-configuration-troubleshooting"></a>

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](https://docs.aws.amazon.com/prometheus/latest/userguide/AMP-troubleshooting.html) no *Guia do usuário do Amazon Managed Service for Prometheus*.