View a markdown version of this page

Configuración del raspador - Amazon CloudWatch
Secciones de configuración admitidasConfiguración de ejemploLimitacionesSolución de problemas

Configuración del raspador

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 para recuperar la configuración de un extractor de uso general o proporcionar la suya propia.

Secciones de configuración admitidas

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

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

  • 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

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 en la Guía del usuario de Amazon Managed Service para Prometheus.