View a markdown version of this page

Scraper-Konfiguration - Amazon CloudWatch

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Scraper-Konfiguration

Von Amazon CloudWatch verwaltete Prometheus-Collectors verwenden eine Prometheus -kompatible YAML-Konfiguration, um zu definieren, wie der Collector Metriken scrapt. Sie geben diese Konfiguration als Base64-kodierten Blob an, wenn Sie einen Scraper erstellen oder aktualisieren. Die Konfiguration verwendet das Prometheus Standard-Scrape-Konfigurationsformat mit einigen Einschränkungen, die speziell für verwaltete Collectors gelten.

Sie können GetDefaultScraperConfiguration es verwenden, um eine Allzweck-Scraper-Konfiguration abzurufen oder Ihre eigene bereitzustellen.

Unterstützte Konfigurationsabschnitte

Die folgenden Abschnitte der Prometheus Scrape-Konfiguration auf oberster Ebene werden unterstützt:

  • global— Globale Einstellungen einschließlich scrape_intervalscrape_timeout, und. external_labels

  • scrape_configs— Eine Liste von Scrape-Jobs, von denen jeder Ziele definiert und erklärt, wie man sie abschafft.

In jedem scrape_configs Eintrag werden die folgenden Felder unterstützt:

  • job_name— Ein eindeutiger Name für den Scrape-Job.

  • metrics_path— Der HTTP-Pfad zum Scrapen (standardmäßig). /metrics

  • scheme— Das Protokollschema (httpoderhttps).

  • scrape_interval— Per-job Überschreibung des globalen Scrape-Intervalls.

  • scrape_timeout— Per-job Überschreibung des globalen Scrape-Timeouts.

  • static_configs— Statische Liste von Zielen.

  • dns_sd_configs— Erkennung von DNS-based Diensten.

  • relabel_configs— Regeln für die Umbenennung, die vor dem Scraping angewendet wurden.

  • metric_relabel_configs— Regeln für die Neuetikettierung, die nach dem Scraping angewendet werden.

  • tls_config— TLS-Konfiguration für HTTPS-Ziele.

Beispielkonfiguration

Das folgende Beispiel zeigt eine grundlegende Scrape-Konfiguration:

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

Einschränkungen

  • Das Minimum scrape_interval beträgt 30 Sekunden.

  • Verwaltete Collectors unterstützen keine dateibasierte Serviceerkennung ()file_sd_configs.

  • Verwaltete Collectors unterstützen Consul, Eureka oder andere externe Service-Discovery-Mechanismen nicht.

  • Konfigurationen für Fernschreiben und Fernlesen gelten nicht, da der Collector die Zustellung an übernimmt. CloudWatch

  • Die maximale Konfigurationsgröße beträgt 256 KB.

Fehlerbehebung

Wenn Ihr Scraper nicht wie erwartet Metriken sammelt, überprüfen Sie Folgendes:

  • Stellen Sie sicher, dass die an den Scraper angehängte Sicherheitsgruppe ausgehenden Datenverkehr zu Ihren Zielports zulässt.

  • Stellen Sie sicher, dass Ihre Ziele von den Subnetzen aus erreichbar sind, die Sie in der Scraper-Konfiguration angegeben haben.

  • Überprüfen Sie, ob die in der VPC verwendeten DNS-Namen korrekt dns_sd_configs aufgelöst werden.

  • Stellen Sie sicher, dass Ihre Ziele auf das konfigurierte metrics_path und gültige Prometheus Expositionsformat reagieren.

Weitere Anleitungen zur Fehlerbehebung finden Sie unter Problembehandlung bei verwalteten Collectors im Amazon Managed Service für Prometheus-Benutzerhandbuch.