View a markdown version of this page

Integrieren Sie Amazon OpenSearch Service - Amazon CloudWatch
VoraussetzungenSchritt 1: Konfigurieren Sie die Scrape-KonfigurationSchritt 2: Erstellen Sie den ScraperVerfügbare MetrikenÜberprüfen Sie die Erfassung von KennzahlenCross-account BeobachtbarkeitAktuelle Einschränkungen

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.

Integrieren Sie Amazon OpenSearch Service

Mit einem von Amazon CloudWatch verwalteten Prometheus-Collector können Sie automatisch Prometheus kompatible Metriken aus Ihren Amazon Service-Domains erfassen. OpenSearch Der verwaltete Collector stellt eine Verbindung zu Ihrer VPC her, erfasst Cluster-, Knoten- und Index-Metriken aus der Domain und übermittelt diese Metriken direkt an. CloudWatch Mit dieser Integration können Sie den Zustand und die Leistung Ihrer Domains überwachen, CloudWatch ohne Agenten oder Exporteure einsetzen zu müssen.

Anmerkung

Wenn ein von Amazon CloudWatch verwalteter Prometheus-Collector Ihre Amazon OpenSearch Service-Metriken übermittelt CloudWatch, reichert er jede Metrik automatisch mit Attributen an, die ihren Ursprung identifizieren. Jede Metrik enthält den Instrumentierungsumfang des Collectors, Cloud-Attribute, die das AWS Konto und die Region aufzeichnen, und eine Einheit, die der Collector aus dem Metriknamen ableitet. Sie können diese Attribute filtern und gruppieren, wenn Sie Ihre Metriken mit PromQL abfragen.

Voraussetzungen

Bei diesem Verfahren wird davon ausgegangen, dass Sie mit der Amazon OpenSearch Service-Domainverwaltung und den Amazon VPC-Netzwerkkonzepten vertraut sind.

  • Eine Amazon OpenSearch Service-Domain mit VPC-Zugriff. Verwaltete Collectors unterstützen nur Domains, die VPC-Zugriff haben. Domains mit öffentlichem Zugriff werden nicht unterstützt.

  • Mindestens zwei Subnetze in verschiedenen Availability Zones

  • Sicherheitsgruppenregeln, die es dem Collector ermöglichen, Ihren Domain-Endpunkt über HTTPS (Port 443) zu erreichen. Fügen Sie der Sicherheitsgruppe der Domain eine Regel für eingehenden Verkehr hinzu, die HTTPS-Verkehr aus der Sicherheitsgruppe zulässt, die Sie für den Collector angeben.

Schritt 1: Konfigurieren Sie die Scrape-Konfiguration

Im Folgenden finden Sie ein Beispiel für eine Scrape-Konfiguration für Amazon OpenSearch Service. Der verwaltete Collector stellt eine Verbindung zu der von Ihnen angegebenen Domain her und erfasst seine Metriken automatisch, sodass Sie in der Konfiguration keine Scrape-Ziele angeben. Die Konfiguration muss einen scrape_configs Abschnitt mit einem Job enthalten, dessen Name exakt job_name opensearch-exporter ist. Sie verweisen auf diese Konfiguration, wenn Sie den Scraper im nächsten Schritt erstellen. Weitere Informationen zu Konfigurationsoptionen finden Sie unterScraper-Konfiguration.

global:
  external_labels:
    domain_name: my-opensearch-domain

scrape_configs:
  - job_name: opensearch-exporter
    scrape_interval: 60s

Schritt 2: Erstellen Sie den Scraper

Erstellen Sie den Scraper mit einem CloudWatch Ziel. Sie geben im exporters Feld die Domain an, von der Daten erfasst werden sollen, und geben das Netzwerk (Subnetze und Sicherheitsgruppe) im source Feld an.

AWS API

Verwenden Sie die CreateScraper API-Operation, um einen Scraper mit einem CloudWatch Ziel zu erstellen. Ersetzen Sie die Subnetz-, Sicherheitsgruppen-, Domänen- und Datensatzinformationen durch Ihre eigenen Werte.

POST /scrapers HTTP/1.1

{
  "alias": "opensearch-metrics-scraper",
  "source": {
    "vpcConfiguration": {
      "subnetIds": ["subnet-subnet-id-1", "subnet-subnet-id-2"],
      "securityGroupIds": ["sg-security-group-id"]
    }
  },
  "exporters": [
    {
      "openSearchConfiguration": {
        "domainArn": "arn:aws:es:us-west-2:123456789012:domain/my-opensearch-domain"
      }
    }
  ],
  "destination": {
    "cloudWatchConfiguration": {
      "datasetArn": "arn:aws:cloudwatch:us-west-2:123456789012:dataset/default"
    }
  },
  "scrapeConfiguration": {
    "configurationBlob": "base64-encoded-blob"
  }
}
AWS CLI

Verwenden Sie den create-scraper Befehl, um einen Scraper mit einem CloudWatch Ziel zu erstellen. Ersetzen Sie die Subnetz-, Sicherheitsgruppen-, Domänen- und Datensatzinformationen durch Ihre eigenen Werte.

aws amp create-scraper \
  --alias "opensearch-metrics-scraper" \
  --source '{
    "vpcConfiguration": {
      "subnetIds": ["subnet-subnet-id-1", "subnet-subnet-id-2"],
      "securityGroupIds": ["sg-security-group-id"]
    }
  }' \
  --exporters '[
    {
      "openSearchConfiguration": {
        "domainArn": "arn:aws:es:us-west-2:123456789012:domain/my-opensearch-domain"
      }
    }
  ]' \
  --scrape-configuration configurationBlob=$(base64 -w 0 opensearch-config.yaml) \
  --destination '{
    "cloudWatchConfiguration": {
      "datasetArn": "arn:aws:cloudwatch:us-west-2:123456789012:dataset/default"
    }
  }'

Verfügbare Metriken

  • Cluster-Metriken — Zustand und Status des Clusters, Anzahl der Knoten und Datenknoten, aktive und sich verschiebende Shards sowie ausstehende Aufgaben.

  • Knoten-Metriken — CPU-Auslastung, JVM-Heap-Nutzung und Garbage Collection, Betriebssystemspeicher, Festplattennutzung und Threadpool-Aktivität für jeden Knoten.

  • Indexmetriken — Indexierungs- und Suchraten und Latenzen, Anzahl der Dokumente, Aktivitäten zum Zusammenführen und Aktualisieren sowie Cachenutzung.

Eine vollständige Liste der verfügbaren Metriken finden Sie unter Von Amazon OpenSearch Service gesammelte Metriken im Amazon Managed Service for Prometheus User Guide.

Überprüfen Sie die Erfassung von Kennzahlen

Um zu bestätigen, dass der Collector Metriken aus Ihrer Domain liefert, führen Sie die folgende Abfrage in CloudWatch Query Studio aus. Die Abfrage gibt den Cluster-Integritätsstatus für Ihre Domain zurück. Wenn Datenpunkte zurückgegeben werden, erfasst der Collector erfolgreich Metriken aus Ihrer Domain.

opensearch_cluster_health_status

Cross-account Beobachtbarkeit

Für die kontoübergreifende Amazon OpenSearch Service-Überwachung empfehlen wir die Nutzung der CloudWatch Amazon-Metrikzentralisierung. Weitere Informationen finden Sie unter Zentralisierung von CloudWatch Metriken.

Weitere Informationen zu alternativen kontoübergreifenden Scraper-Konfigurationen mithilfe von Rollenverkettung finden Sie unter Integrieren von Amazon OpenSearch Service im Amazon Managed Service for Prometheus-Benutzerhandbuch.

Aktuelle Einschränkungen

  • Verwaltete Collectors unterstützen nur Domains mit VPC-Zugriff.

  • Ein Scraper sammelt Metriken aus einer einzelnen Amazon OpenSearch Service-Domain. Um Metriken von mehr als einer Domain zu sammeln, erstellen Sie für jede Domain einen separaten Scraper.