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.
# Integration von CloudWatch Metriken mit Amazon Managed Service für Prometheus
Es kann hilfreich sein, alle Ihre Kennzahlen an einem Ort zu haben. Amazon Managed Service for Prometheus nimmt Amazon-Metriken nicht automatisch auf. CloudWatch Sie können jedoch Amazon Data Firehose verwenden und CloudWatch Metriken AWS Lambda an Amazon Managed Service for Prometheus übertragen.
In diesem Abschnitt wird beschrieben, wie Sie einen [ CloudWatch Amazon-Metrik-Stream](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Metric-Streams.html) instrumentieren und [Amazon Data Firehose](https://docs.aws.amazon.com/firehose/latest/dev/what-is-this-service.html) verwenden und [AWS Lambda](https://docs.aws.amazon.com/lambda/latest/dg/welcome.html)Metriken in Amazon Managed Service for Prometheus aufnehmen.
Sie richten mithilfe des [AWS Cloud Development Kit (CDK)](https://aws.amazon.com/cdk/) einen Stack ein, um einen Firehose Delivery Stream, einen Lambda und einen Amazon S3 S3-Bucket zu erstellen, um ein vollständiges Szenario zu demonstrieren.
## Infrastruktur
Als Erstes müssen Sie die Infrastruktur für dieses Rezept einrichten.
CloudWatch Metrik-Streams ermöglichen die Weiterleitung der Streaming-Metrikdaten an einen HTTP-Endpunkt oder einen [Amazon S3 S3-Bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html).
Die Einrichtung der Infrastruktur besteht aus 4 Schritten:
+ Voraussetzungen konfigurieren
+ Workspace von Amazon Managed Service für Prometheus erstellen
+ Installieren von Abhängigkeiten
+ Den Stack bereitstellen
**Voraussetzungen**
+ Das AWS CLI ist in Ihrer Umgebung [installiert](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html) und [konfiguriert](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html).
+ Das [AWS CDK -Typescript](https://docs.aws.amazon.com/cdk/latest/guide/work-with-cdk-typescript.html) ist in Ihrer Umgebung installiert.
+ Node.js und Go sind in Ihrer Umgebung installiert.
+ Das [Github-Repository (`CWMetricsStreamExporter`) für den Export von AWS CloudWatch Observability-Metriken](https://github.com/aws-observability/observability-best-practices/tree/main/sandbox/CWMetricStreamExporter) wurde auf Ihren lokalen Computer geklont.
**So erstellen Sie einen Workspace in Amazon Managed Service für Prometheus**
1. Die Demo-App in diesem Rezept wird auf Amazon Managed Service für Prometheus ausgeführt. Erstellen Sie Ihren Workspace für Amazon Managed Service für Prometheus mithilfe des folgenden Befehls:
```
aws amp create-workspace --alias prometheus-demo-recipe
```
1. Stellen Sie sicher, dass Ihr Workspace mit dem folgenden Befehl erstellt wurde:
```
aws amp list-workspaces
```
Weitere Informationen zu Amazon Managed Service für Prometheus finden Sie im Benutzerhandbuch von [Amazon Managed Service für Prometheus](https://docs.aws.amazon.com/prometheus/latest/userguide/AMP-getting-started.html).
**So installieren Sie Abhängigkeiten**
1. **Abhängigkeiten installieren**
Ändern Sie im Stammverzeichnis des Repositorys `aws-o11y-recipes` Ihr Verzeichnis zu `CWMetricStreamExporter` mit dem folgenden Befehl:
```
cd sandbox/CWMetricStreamExporter
```
Dies wird nun in Zukunft als das Stammverzeichnis des Repos betrachtet.
1. Wechseln Sie das Verzeichnis zu `/cdk` über den folgenden Befehl:
```
cd cdk
```
1. Führen Sie den folgenden Befehl aus, um die CDK-Abhängigkeit zu installieren.
```
npm install
```
1. Wechseln Sie zurück zum Stammverzeichnis des Repos und wechseln Sie dann das Verzeichnis zu `/lambda` mit dem folgenden Befehl:
```
cd lambda
```
1. Sobald Sie sich im Ordner `/lambda` befinden, installieren Sie die Go-Abhängigkeiten mit:
```
go get
```
Alle Abhängigkeiten sind jetzt installiert.
**So stellen Sie den Stack bereit**
1. Öffnen Sie `config.yaml` im Stammverzeichnis des Repos und ändern Sie die Workspace-URL von Amazon Managed Service für Prometheus, indem Sie `{workspace}` durch die neu erstellte Workspace-ID und die Region ersetzen, in der sich Ihr Workspace in Amazon Managed Service für Prometheus befindet.
Nutzen Sie dazu beispielsweise Folgendes:
```
AMP:
remote_write_url: "https://aps-workspaces.us-east-2.amazonaws.com/workspaces/{workspaceId}/api/v1/remote_write"
region: us-east-2
```
Ändern Sie die Namen des Firehose-Lieferstreams und des Amazon S3 S3-Buckets nach Ihren Wünschen.
1. Um den AWS CDK und den Lambda-Code zu erstellen, führen Sie im Stammverzeichnis des Repos den folgenden Befehl aus:
```
npm run build
```
Dieser Build-Schritt stellt sicher, dass die Go Lambda-Binärdatei erstellt wird, und stellt das CDK für bereit. CloudFormation
1. Um die Bereitstellung abzuschließen, überprüfen und akzeptieren Sie die für den Stack erforderlichen IAM-Änderungen.
1. Optional können Sie überprüfen, ob der Stack erstellt wurde, indem Sie den folgenden Befehl ausführen.
```
aws cloudformation list-stacks
```
Ein Stack mit dem Namen `CDK Stack` wird in der Liste angezeigt.
## Einen CloudWatch Amazon-Stream erstellen
Da Sie nun über eine Lambda-Funktion zur Verarbeitung der Metriken verfügen, können Sie den Metrik-Stream von Amazon CloudWatch erstellen.
**Um einen CloudWatch Metrik-Stream zu erstellen**
1. **Gehen Sie zur CloudWatch Konsole unter [https://console.aws.amazon.com/cloudwatch/\#metric -streams:StreamsList](https://console.aws.amazon.com/cloudwatch/home#metric-streams:streamsList) und wählen Sie Metrik-Stream erstellen aus.**
1. Wählen Sie die benötigten Metriken aus, entweder alle Metriken oder nur die aus ausgewählten Namespaces.
1. Wählen Sie unter `Configuration` die Option **Vorhandenes Firehose auswählen, das Ihrem Konto gehört**.
1. Sie werden den Firehose verwenden, der zuvor vom CDK erstellt wurde. Wählen Sie in der Dropdownliste **Wählen Sie Ihren Kinesis-Daten-Firehose-Stream aus** den zuvor erstellten Stream aus. Er wird einen Namen wie `CdkStack-KinesisFirehoseStream123456AB-sample1234` haben.
1. Ändern Sie das Ausgabeformat in **JSON**.
1. Geben Sie dem Metrik-Stream einen Namen, der für Sie von Bedeutung ist.
1. Wählen Sie **Metrikstream erstellen** aus.
1. (Optional) Um den Lambda-Funktionsaufruf zu überprüfen, navigieren Sie zur [Lambda-Konsole](https://console.aws.amazon.com/lambda/home) und wählen Sie die Funktion `KinesisMessageHandler` aus. Wählen Sie die Registerkarte **Monitor** und die Unterregisterkarte **Protokolle** aus. Unter **Letzte Aufrufe** sollten Einträge der Lambda-Funktion angezeigt werden, die ausgelöst wird.
**Anmerkung**
Es kann bis zu 5 Minuten dauern, bis Aufrufe auf der Registerkarte **Überwachen** angezeigt werden.
Ihre Messwerte werden jetzt von Amazon CloudWatch an Amazon Managed Service for Prometheus gestreamt.
## Bereinigen
Möglicherweise möchten Sie die Ressourcen bereinigen, die in diesem Beispiel verwendet wurden. In den folgenden Verfahren wird erläutert, wie das geht. Dadurch wird der von Ihnen erstellte Metrik-Stream gestoppt.
**So bereinigen Sie Ressourcen**
1. Löschen Sie zunächst den CloudFormation Stack mit den folgenden Befehlen:
```
cd cdk
cdk destroy
```
1. Workspace von Amazon Managed Service für Prometheus entfernen:
```
aws amp delete-workspace --workspace-id \
`aws amp list-workspaces --alias prometheus-sample-app --query 'workspaces[0].workspaceId' --output text`
```
1. Entfernen Sie abschließend den Amazon CloudWatch Metric Stream mithilfe der [ CloudWatch Amazon-Konsole](https://console.aws.amazon.com/cloudwatch/home#metric-streams:streamsList).