Mit einem Assistenten eine Verbindung zu einer vordefinierten Datenquelle herstellen - Amazon CloudWatch
Amazon Managed Service für Prometheus OpenSearch Amazon-Dienst Amazon RDS für PostgreSQL und Amazon RDS für MySQL Amazon-S3-CSV-Dateien Microsoft Azure Monitor Prometheus Benachrichtigung über verfügbare Aktualisierungen

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.

Mit einem Assistenten eine Verbindung zu einer vordefinierten Datenquelle herstellen

Dieses Thema enthält Anweisungen zur Verwendung des Assistenten, um eine Verbindung CloudWatch zu den folgenden Datenquellen herzustellen.

  • OpenSearch Amazon-Dienst

  • Amazon Managed Service für Prometheus

  • Amazon RDS für MySQL

  • Amazon RDS für PostgreSQL

  • Amazon-S3-CSV-Dateien

  • Microsoft Azure Monitor

  • Prometheus

Später in diesem Abschnitt finden Sie Unterabschnitte mit Hinweisen zur Verwaltung und Abfrage jeder dieser Datenquellen.

So erstellen Sie einen Konnektor zu Datenquellen

  1. Öffnen Sie die CloudWatch Konsole unter https://console.aws.amazon.com/cloudwatch/.

  2. Wählen Sie im Navigationsbereich Settings (Einstellungen).

  3. Wählen Sie die Registerkarte Metrik-Datenquellen.

  4. Klicken Sie auf Create data source.

  5. Wählen Sie die gewünschte Quelle aus und wählen Sie dann Weiter.

  6. Geben Sie einen Namen für die Datenquelle ein.

  7. Geben Sie je nach der ausgewählten Datenquelle die anderen erforderlichen Informationen ein. Dies kann Anmeldeinformationen für den Zugriff auf die Datenquelle und identifizierende Informationen wie den Namen des Prometheus-Workspace, den Datenbanknamen oder den Amazon-S3-Bucket-Namen beinhalten. Bei AWS Diensten erkennt der Assistent die Ressourcen und fügt sie in das Auswahl-Dropdown-Menü ein.

    Weitere Hinweise zu der von Ihnen verwendeten Datenquelle finden Sie in den Abschnitten nach diesem Verfahren.

  8. Um eine CloudWatch Verbindung mit der Datenquelle in einer VPC herzustellen, wählen Sie Use a VPC und wählen Sie die zu verwendende VPC aus. Wählen Sie danach das Subnetz und die Sicherheitsgruppe aus.

  9. Wählen Sie Ich bestätige, dass AWS CloudFormation IAM-Ressourcen erstellt werden. Diese Ressource ist die Ausführungsrolle der Lambda-Funktion.

  10. Klicken Sie auf Create data source.

    Die neue Quelle, die Sie gerade hinzugefügt haben, wird erst angezeigt, wenn der AWS CloudFormation Stapel sie erstellt hat. Um den Fortschritt zu überprüfen, können Sie „Status meines CloudFormation Stacks anzeigen“ wählen. Oder Sie können das Aktualisierungssymbol wählen, um diese Liste zu aktualisieren.

    Wenn Ihre neue Datenquelle in dieser Liste angezeigt wird, kann sie verwendet werden. Sie können „Abfrage“ aus CloudWatch Metriken auswählen, um mit der Abfrage zu beginnen. Weitere Informationen finden Sie unter Erstellen eines Diagramms mit Metriken aus einer anderen Datenquelle.

Amazon Managed Service für Prometheus

Aktualisieren der Datenquellen-Konfiguration

  • Sie können mithilfe der folgenden Verfahren Ihre Datenquelle manuell aktualisieren:

    • Um die Workspace-ID von Amazon Managed Service für Prometheus zu aktualisieren, aktualisieren Sie die AMAZON_PROMETHEUS_WORKSPACE_ID-Umgebungsvariable für die Lambda-Funktion des Datenquellen-Konnektors.

    • Weitere Informationen zum Aktualisieren der VPC-Konfiguration finden Sie unter Konfigurieren des VPC-Zugriffs (Konsole).

Abfragen der Datenquelle

  • Bei der Abfrage von Amazon Managed Service für Prometheus können Sie, nachdem Sie die Datenquelle auf der Registerkarte Abfrage mit mehreren Quellen ausgewählt und einen Konnektor von Amazon Managed Service für Prometheus ausgewählt haben, den Abfrageassistenten verwenden, um Metriken und Labels zu ermitteln und einfache PromQL-Abfragen bereitzustellen. Sie können auch den PromQL-Abfragen-Editor verwenden, um eine PromQL-Abfrage zu erstellen.

  • Mehrzeilige Abfragen werden von den CloudWatch Datenquellen-Connectoren nicht unterstützt. Jeder Zeilenvorschub wird durch ein Leerzeichen ersetzt, wenn die Abfrage ausgeführt wird oder wenn Sie mit der Abfrage einen Alarm oder ein Dashboard-Widget erstellen. In einigen Fällen kann dies dazu führen, dass Ihre Abfrage ungültig ist. Wenn Ihre Abfrage beispielsweise einen einzeiligen Kommentar enthält, ist sie nicht gültig. Wenn Sie versuchen, ein Dashboard oder einen Alarm mit einer mehrzeiligen Abfrage über die Befehlszeile oder Infrastructure as Code zu erstellen, lehnt die API die Aktion mit einem Analysefehler ab.

OpenSearch Amazon-Dienst

Erstellen der Datenquelle

Wenn die OpenSearch Domain für FGAC aktiviert ist, müssen Sie die Ausführungsrolle der Connector-Lambda-Funktion einem Benutzer in Service zuordnen. OpenSearch Weitere Informationen finden Sie im Abschnitt Benutzer zu Rollen zuordnen unter Verwaltung von Berechtigungen in der OpenSearch Servicedokumentation.

Wenn auf Ihre OpenSearch Domain nur innerhalb einer Virtual Private Cloud (VPC) zugegriffen werden kann, müssen Sie manuell eine neue Umgebungsvariable in die aufgerufene Lambda-Funktion aufnehmen. AMAZON_OPENSEARCH_ENDPOINT Der Wert für diese Variable sollte die Stammdomäne des Endpunkts OpenSearch sein. Sie können diese Stammdomäne erhalten, indem Sie https:// und <region>.es.amazonaws.com von dem in der OpenSearch Servicekonsole aufgeführten Domänenendpunkt entfernen. Wenn Ihr Domänenendpunkt beispielsweise lautethttps://sample-domain.us-east-1.es.amazonaws.com, wäre dies die Stammdomänesample-domain.

Aktualisieren der Datenquelle

  • Sie können mithilfe der folgenden Verfahren Ihre Datenquelle manuell aktualisieren:

    • Um die OpenSearch Dienstdomäne zu aktualisieren, aktualisieren Sie die AMAZON_OPENSEARCH_DOMAIN_NAME Umgebungsvariable für die Lambda-Funktion des Datenquellenkonnektors.

    • Weitere Informationen zum Aktualisieren der VPC-Konfiguration finden Sie unter Konfigurieren des VPC-Zugriffs (Konsole).

Abfragen der Datenquelle

  • Gehen Sie bei der Abfrage von OpenSearch Service nach der Auswahl der Datenquelle auf der Registerkarte Multiquellenabfrage wie folgt vor:

    • Wählen Sie den Index aus, der abgefragt werden soll.

    • Wählen Sie den Metriknamen (beliebiges Zahlenfeld im Dokument) und die Statistik aus.

    • Wählen Sie die Zeitachse aus (beliebiges Datumsfeld im Dokument).

    • Wählen Sie die anzuwendenden Filter aus (Beliebiges Zeichenfolgenfeld im Dokument).

    • Wählen Sie Graph-Abfrage.

Amazon RDS für PostgreSQL und Amazon RDS für MySQL

Erstellen der Datenquelle

Aktualisieren der Datenquelle

  • Sie können mithilfe der folgenden Verfahren Ihre Datenquelle manuell aktualisieren:

    • Um die Datenbank-Instance zu aktualisieren, aktualisieren Sie die RDS_INSTANCE-Umgebungsvariable für die Lambda-Funktion des Datenquellen-Konnektors.

    • Um den Benutzernamen und das Passwort für die Verbindung mit Amazon RDS zu aktualisieren, verwenden Sie AWS Secrets Manager. Sie finden den ARN des für die Datenquelle verwendeten Geheimnisses in der Umgebungsvariable RDS_SECRET der Lambda-Funktion der Datenquelle. Weitere Informationen zum Aktualisieren des Geheimnisses in AWS Secrets Manager finden Sie unter Ein AWS Secrets Manager -Geheimnis ändern.

    • Weitere Informationen zum Aktualisieren der VPC-Konfiguration finden Sie unter Konfigurieren des VPC-Zugriffs (Konsole).

Abfragen der Datenquelle

  • Bei der Abfrage von Amazon RDS können Sie, nachdem Sie die Datenquelle auf der Registerkarte Abfrage mit mehreren Quellen und einen Amazon-RDS-Konnektor ausgewählt haben, den Datenbank-Entdecker verwenden, um verfügbare Datenbanken, Tabellen und Spalten anzuzeigen. Sie können auch den SQL-Editor verwenden, um eine SQL-Abfrage zu erstellen.

    Sie können die folgenden Variablen in der Abfrage verwenden:

    • $start.iso – Die Startzeit im ISO-Datumsformat

    • $end.iso – Die Endzeit im ISO-Datumsformat

    • $period – Der gewählte Zeitraum in Sekunden

    Sie können beispielsweise SELECT value, timestamp FROM table WHERE timestamp BETWEEN $start.iso and $end.iso abfragen

  • Mehrzeilige Abfragen werden von den CloudWatch Datenquellen-Connectors nicht unterstützt. Jeder Zeilenvorschub wird durch ein Leerzeichen ersetzt, wenn die Abfrage ausgeführt wird oder wenn Sie mit der Abfrage einen Alarm oder ein Dashboard-Widget erstellen. In einigen Fällen kann dies dazu führen, dass Ihre Abfrage ungültig ist. Wenn Ihre Abfrage beispielsweise einen einzeiligen Kommentar enthält, ist sie nicht gültig. Wenn Sie versuchen, ein Dashboard oder einen Alarm mit einer mehrzeiligen Abfrage über die Befehlszeile oder Infrastructure as Code zu erstellen, lehnt die API die Aktion mit einem Analysefehler ab.

Anmerkung

Wenn in den Ergebnissen kein Datumsfeld gefunden wird, werden die Werte für jedes Zahlenfeld zu Einzelwerten summiert und über den angegebenen Zeitraum dargestellt. Wenn die Zeitstempel nicht mit dem ausgewählten Zeitraum in übereinstimmen CloudWatch, werden die Daten automatisch anhand des Zeitraums von aggregiert SUM und an diesem ausgerichtet. CloudWatch

Amazon-S3-CSV-Dateien

Abfragen der Datenquelle

  • Bei der Abfrage von Amazon-S3-CSV-Dateien wählen Sie, nachdem Sie die Datenquelle auf der Registerkarte Abfrage mit mehreren Quellen und einen Amazon-S3-Konnektor ausgewählt haben, den Amazon-S3-Bucket und den Amazon-S3-Schlüssel aus.

    Die CSV-Datei muss wie folgt formatiert werden:

    • Der Zeitstempel muss die erste Spalte sein.

    • Die Tabelle muss eine Kopfzeile haben. Die Überschriften werden verwendet, um Ihre Metriken zu benennen. Der Titel der Zeitstempelspalte wird ignoriert, es werden nur die Titel der Metrikspalten verwendet.

    • Die Zeitstempel müssen im ISO-Datumsformat vorliegen.

    • Bei den Metriken muss es sich um numerische Felder handeln.

    Timestamp, Metric-1, Metric-2, ...

    Im Folgenden wird ein Beispiel gezeigt:

    Zeitstempel CPU (%) Arbeitsspeicher (%) Speicher (%)

    2023-11-23T17:09:41+00:00

    1

    2

    3

    2023-11-23T17:04:41+00:00

    4

    5

    6

    2023-11-23T16:59:41+00:00

    7

    8

    9

    2023-11-23T16:54:41+00:00

    10

    11

    12
Anmerkung

Wenn kein Zeitstempel angegeben wird, werden die Werte für jede Metrik zu Einzelwerten summiert und über den angegebenen Zeitraum dargestellt. Wenn die Zeitstempel nicht mit dem ausgewählten Zeitraum in übereinstimmen CloudWatch, werden die Daten automatisch anhand des Zeitraums von aggregiert SUM und an diesem ausgerichtet. CloudWatch

Microsoft Azure Monitor

Erstellen der Datenquelle

Aktualisieren der Datenquelle

  • Sie können mithilfe der folgenden Verfahren Ihre Datenquelle manuell aktualisieren:

    • Um die Mandanten-ID, die Client-ID und den geheimen Client-Schlüssel zu aktualisieren, die für die Verbindung mit Azure Monitor verwendet werden, finden Sie den ARN des für die Datenquelle verwendeten Geheimnisses als AZURE_CLIENT_SECRET-Umgebungsvariable in der Lambda-Funktion der Datenquelle. Weitere Informationen zum Aktualisieren des Geheimnisses in AWS Secrets Manager finden Sie unter Ändern eines AWS Secrets Manager Geheimnisses.

Abfragen der Datenquelle

  • Bei der Abfrage von Azure Monitor geben Sie, nachdem Sie die Datenquelle auf der Registerkarte Abfrage mit mehreren Quellen und einen Azure-Monitor-Konnektor ausgewählt haben, das Azure-Abonnement sowie die Ressourcengruppe und die Ressource an. Anschließend können Sie den Metrik-Namespace, die Metrik und die Aggregation auswählen und nach Dimensionen filtern.

Prometheus

Erstellen der Datenquelle

  • Sie müssen den Prometheus-Endpunkt sowie den Benutzer und das Passwort angeben, die für die Abfrage von Prometheus erforderlich sind. Die Anmeldeinformationen werden in gespeichert AWS Secrets Manager.

  • Wenn auf Ihre Datenquelle nur in einer VPC zugegriffen werden kann, müssen Sie die VPC-Konfiguration für den Konnektor angeben, wie unter Mit einem Assistenten eine Verbindung zu einer vordefinierten Datenquelle herstellen beschrieben. Wenn die Datenquelle für Anmeldeinformationen eine Verbindung zur VPC herstellen soll, muss der Endpunkt in der VPC konfiguriert werden. Weitere Informationen finden Sie unter Verwenden eines AWS Secrets Manager VPC-Endpunkts.

Aktualisieren der Datenquellen-Konfiguration

  • Sie können mithilfe der folgenden Verfahren Ihre Datenquelle manuell aktualisieren:

    • Um den Prometheus-Endpunkt zu aktualisieren, geben Sie den neuen Endpunkt als PROMETHEUS_API_ENDPOINT-Umgebungsvariable in der Lambda-Funktion der Datenquelle an.

    • Um den Benutzernamen und das Passwort für die Verbindung mit Prometheus zu aktualisieren, finden Sie den ARN des für die Datenquelle verwendeten Geheimnisses als PROMETHEUS_API_SECRET-Umgebungsvariable in der Lambda-Funktion der Datenquelle. Weitere Informationen zum Aktualisieren des Geheimnisses in finden Sie AWS Secrets Manager unter Ändern eines AWS Secrets Manager Geheimnisses.

    • Weitere Informationen zum Aktualisieren der VPC-Konfiguration finden Sie unter Konfigurieren des VPC-Zugriffs (Konsole).

Abfragen der Datenquelle

Wichtig

Prometheus-Metriktypen unterscheiden sich von CloudWatch Metriken, und viele über Prometheus verfügbare Metriken sind konstruktionsbedingt kumulativ. Wenn Sie Prometheus-Metriken abfragen, wendet CloudWatch keine zusätzliche Transformation auf die Daten an: Wenn Sie nur den Namen oder die Bezeichnung der Metrik angeben, ist der angezeigte Wert kumulativ. Weitere Informationen finden Sie unter Metriktypen in der Prometheus-Dokumentation.

Um Prometheus-Metrikdaten wie CloudWatch Metriken als diskrete Werte anzuzeigen, müssen Sie die Abfrage bearbeiten, bevor Sie sie ausführen. Sie könnten beispielsweise einen Aufruf der Rate-Funktion über Ihren Prometheus-Metriknamen hinzufügen. Eine Dokumentation zur Rate-Funktion und anderen Prometheus-Funktionen finden Sie unter rate() in der Prometheus-Dokumentation.

Mehrzeilige Abfragen werden von den CloudWatch Datenquellen-Konnektoren nicht unterstützt. Jeder Zeilenvorschub wird durch ein Leerzeichen ersetzt, wenn die Abfrage ausgeführt wird oder wenn Sie mit der Abfrage einen Alarm oder ein Dashboard-Widget erstellen. In einigen Fällen kann dies dazu führen, dass Ihre Abfrage ungültig ist. Wenn Ihre Abfrage beispielsweise einen einzeiligen Kommentar enthält, ist sie nicht gültig. Wenn Sie versuchen, ein Dashboard oder einen Alarm mit einer mehrzeiligen Abfrage über die Befehlszeile oder Infrastructure as Code zu erstellen, lehnt die API die Aktion mit einem Analysefehler ab.

Benachrichtigung über verfügbare Aktualisierungen

Von Zeit zu Zeit informiert Amazon Sie möglicherweise darüber, dass wir empfehlen, Ihre Konnektoren mit einer neueren verfügbaren Version zu aktualisieren und stellt Ihnen Anweisungen dazu zur Verfügung.