# Configuración del raspador
<a name="managed-prometheus-collectors-scraper-configuration"></a>

Los recopiladores de Prometheus administrados por Amazon CloudWatch utilizan una configuración de YAML compatible con Prometheus para definir la forma en que el recopilador extrae las métricas. Esta configuración se proporciona como un blob codificado en base64 al crear o actualizar un extractor. La configuración utiliza el formato de configuración de extracción de Prometheus estándar, con algunas limitaciones específicas para los recopiladores administrados.

Puede utilizar [GetDefaultScraperConfiguration](https://docs.aws.amazon.com/prometheus/latest/APIReference/API_GetDefaultScraperConfiguration.html) para recuperar la configuración de un extractor de uso general o proporcionar la suya propia.

## Secciones de configuración admitidas
<a name="managed-prometheus-collectors-scraper-configuration-supported"></a>

Se admiten las siguientes secciones de nivel superior de la configuración de extracción de Prometheus:
+ `global`: configuración global, que incluye `scrape_interval`, `scrape_timeout` y `external_labels`.
+ `scrape_configs`: una lista de trabajos de extracción, cada uno de los cuales define los destinos y cómo extraer a partir de ellos.

En cada entrada de `scrape_configs`, se admiten los siguientes campos:
+ `job_name`: un nombre único para el trabajo de extracción.
+ `metrics_path`: la ruta HTTP para extraer (el valor predeterminado es `/metrics`).
+ `scheme`: el esquema de protocolo (`http` o `https`).
+ `scrape_interval`: anulación por trabajo del intervalo de extracción global.
+ `scrape_timeout`: anulación por trabajo del tiempo de espera de extracción global.
+ `static_configs`: lista estática de destinos.
+ `dns_sd_configs`: detección de servicios basada en DNS.
+ `relabel_configs`: reglas de reetiquetado aplicadas antes de la extracción.
+ `metric_relabel_configs`: reglas de reetiquetado aplicadas después de la extracción.
+ `tls_config`: configuración de TLS para destinos HTTPS.

## Configuración de ejemplo
<a name="managed-prometheus-collectors-scraper-configuration-example"></a>

En el ejemplo siguiente, se muestra una configuración de extracción básica:

```
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
```

## Limitaciones
<a name="managed-prometheus-collectors-scraper-configuration-limits"></a>
+ El valor mínimo de `scrape_interval` son 30 segundos.
+ Los recopiladores administrados no admiten la detección de servicios basada en archivos (`file_sd_configs`).
+ Los recopiladores administrados no son compatibles con Consul, Eureka ni otros mecanismos de detección de servicios externos.
+ No se aplican las configuraciones de escritura y lectura remotas, ya que el recopilador se encarga del envío a CloudWatch.
+ El tamaño máximo de configuración son 256 KB.

## Solución de problemas
<a name="managed-prometheus-collectors-scraper-configuration-troubleshooting"></a>

Si el extractor no recopila las métricas esperadas, compruebe lo siguiente:
+ Compruebe que el grupo de seguridad adjunto al extractor permita el tráfico saliente a sus puertos de destino.
+ Confirme que se pueda acceder a sus destinos desde las subredes que especificó en la configuración del extractor.
+ Compruebe que los nombres de DNS utilizados en `dns_sd_configs` se resuelvan correctamente en la VPC.
+ Asegúrese de que sus destinos respondan en el valor de `metrics_path` configurado con un formato de exposición de Prometheus válido.

Para obtener orientación adicional sobre la resolución de problemas, consulte [Resolución de problemas de recopiladores administrados](https://docs.aws.amazon.com/prometheus/latest/userguide/AMP-troubleshooting.html) en la *Guía del usuario de Amazon Managed Service para Prometheus*.