View a markdown version of this page

Configuration du scraper - Amazon CloudWatch
Sections de configuration prises en chargeExemple de configurationLimitationsRésolution des problèmes

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Configuration du scraper

Les collecteurs Prometheus CloudWatch gérés par Amazon utilisent une configuration YAML Prometheus compatible pour définir la manière dont le collecteur extrait les métriques. Vous fournissez cette configuration sous la forme d'un blob codé en base64 lors de la création ou de la mise à jour d'un scraper. La configuration utilise le format de configuration Prometheus Scrape standard, avec certaines limitations spécifiques aux collecteurs gérés.

Vous pouvez l'utiliser GetDefaultScraperConfiguration pour récupérer une configuration de scraper à usage général ou fournir la vôtre.

Sections de configuration prises en charge

Les sections de niveau supérieur suivantes de la configuration de Prometheus scrape sont prises en charge :

  • global— Paramètres générauxscrape_interval, y comprisscrape_timeout, etexternal_labels.

  • scrape_configs— Une liste de tâches de scrape, chacune définissant des cibles et la manière de les éliminer.

Dans chaque scrape_configs entrée, les champs suivants sont pris en charge :

  • job_name— Un nom unique pour le scrape job.

  • metrics_path— Le chemin HTTP à scraper (par défaut). /metrics

  • scheme— Le schéma du protocole (httpouhttps).

  • scrape_interval— Per-job remplacement de l'intervalle de grattage global.

  • scrape_timeout— annulation du Per-job délai d'expiration global du scrape.

  • static_configs— Liste statique de cibles.

  • dns_sd_configs— découverte DNS-based de services.

  • relabel_configs— Règles de réétiquetage appliquées avant le grattage.

  • metric_relabel_configs— Règles de réétiquetage appliquées après le grattage.

  • tls_config— Configuration TLS pour les cibles HTTPS.

Exemple de configuration

L'exemple suivant illustre une configuration de base de scrape :

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

Limitations

  • Le minimum scrape_interval est de 30 secondes.

  • Les collecteurs gérés ne prennent pas en charge la découverte de services basée sur des fichiers (file_sd_configs).

  • Les collecteurs gérés ne prennent pas en charge Consul, Eureka ou d'autres mécanismes externes de découverte de services.

  • Les configurations d'écriture et de lecture à distance ne s'appliquent pas, car le collecteur gère la livraison à CloudWatch.

  • La taille de configuration maximale est de 256 Ko.

Résolution des problèmes

Si votre scraper ne collecte pas les statistiques comme prévu, vérifiez les points suivants :

  • Vérifiez que le groupe de sécurité associé au scraper autorise le trafic sortant vers vos ports cibles.

  • Vérifiez que vos cibles sont accessibles depuis les sous-réseaux que vous avez spécifiés dans la configuration du scraper.

  • Vérifiez que les noms DNS utilisés sont correctement dns_sd_configs résolus dans le VPC.

  • Assurez-vous que vos cibles répondent au format d'exposition configuré metrics_path avec un format d'Prometheusexposition valide.

Pour obtenir des conseils de dépannage supplémentaires, consultez la section Résolution des problèmes liés aux collecteurs gérés dans le guide de l'utilisateur d'Amazon Managed Service for Prometheus.