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.
# Beispiel: Verwendung benutzerdefinierter CloudWatch Amazon-Metriken
Dieses Thema enthält ein Konfigurationsbeispiel, das Elastic Beanstalk-Metriken mit Amazon CloudWatch Agent für Plattformen integriert, die auf Amazon Linux 2 und höher basieren. Das Konfigurationsbeispiel verwendet Dateien und Befehle in einer `.ebextensions` Konfigurationsdatei.
Amazon CloudWatch ist ein Webservice, mit dem Sie verschiedene Metriken überwachen, verwalten und veröffentlichen sowie Alarmaktionen auf der Grundlage von Daten aus Metriken konfigurieren können. Sie können benutzerdefinierte Metriken für Ihren eigenen Gebrauch definieren, und Elastic Beanstalk überträgt diese Metriken an Amazon. CloudWatch Sobald Amazon Ihre benutzerdefinierten Metriken CloudWatch enthält, können Sie diese in der CloudWatch Amazon-Konsole anzeigen.
**Der CloudWatch Amazon-Agent**
Der CloudWatch Amazon-Agent ermöglicht die Erfassung von CloudWatch Metriken und Protokollen sowohl von EC2 Amazon-Instances als auch von lokalen Servern über Betriebssysteme hinweg. Der Agent unterstützt Metriken, die auf Systemebene erfasst wurden. Er unterstützt auch die benutzerdefinierte Protokoll- und Metrikenerfassung aus Ihren Anwendungen und Services. Weitere Informationen über den CloudWatch Amazon-Agenten finden Sie im * CloudWatch Amazon-Benutzerhandbuch* unter [Erfassung von Metriken und Protokollen mit dem CloudWatch Agenten](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Install-CloudWatch-Agent.html).
**Anmerkung**
Elastic Beanstalk [Enhanced Health Reporting](health-enhanced.md) bietet native Unterstützung für die Veröffentlichung einer Vielzahl von Instanz- und Umgebungsmetriken für. CloudWatch Details dazu finden Sie unter [Veröffentlichen CloudWatch benutzerdefinierter Amazon-Metriken für eine Umgebung](health-enhanced-cloudwatch.md).
**Topics**
+ [.Ebextensions-Konfigurationsdatei](#customize-containers-cw-update-roles)
+ [Berechtigungen](#customize-containers-cw-policy)
+ [Metriken in der CloudWatch Konsole anzeigen](#customize-containers-cw-console)
## .Ebextensions-Konfigurationsdatei
In diesem Beispiel werden Dateien und Befehle in einer .ebextensions-Konfigurationsdatei verwendet, um den CloudWatch Amazon-Agenten auf der Amazon Linux 2-Plattform zu konfigurieren und auszuführen. Der Agent ist in Amazon Linux 2 enthalten. Wenn Sie ein anderes Betriebssystem verwenden, sind möglicherweise zusätzliche Schritte zur Installation des Agenten erforderlich. Weitere Informationen finden Sie unter [Installation des CloudWatch Agenten](https://docs.aws.amazon.com//AmazonCloudWatch/latest/monitoring/install-CloudWatch-Agent-on-EC2-Instance.html) im * CloudWatch Amazon-Benutzerhandbuch*.
Damit Sie dieses Beispiel einsetzen können, speichern Sie es in einer Datei mit dem Namen `cloudwatch.config` in einem Verzeichnis mit dem Namen `.ebextensions` im Top-Level-Verzeichnis des Projekts. Dann stellen Sie die Anwendung über die Elastic Beanstalk-Konsole (binden Sie das Verzeichnis .ebextensions in das [Quell-Bundle](applications-sourcebundle.md) ein) oder die [EB CLI](eb-cli3.md) bereit.
Weitere Informationen zu Konfigurationsdateien finden Sie unter [Erweiterte Umgebungsanpassung mit Konfigurationsdateien (`.ebextensions`)](ebextensions.md).
Diese Datei hat zwei Bereiche:
+ `files` – In diesem Abschnitt wird die Agentenkonfigurationsdatei hinzugefügt. Es gibt an, welche Metriken und Protokolle der Agent an Amazon senden soll CloudWatch. In diesem Beispiel senden wir nur die *mem\$1used\$1percent*-Metrik. Eine vollständige Liste der vom CloudWatch Amazon-Agenten unterstützten Metriken auf Systemebene finden Sie unter [Vom CloudWatch Agenten gesammelte Metriken](https://docs.aws.amazon.com//AmazonCloudWatch/latest/monitoring/metrics-collected-by-CloudWatch-agent.html) im * CloudWatch Amazon-Benutzerhandbuch*.
+ `container_commands` – Dieser Abschnitt enthält den Befehl, der den Agenten startet und die Konfigurationsdatei als Parameter übergibt. Weitere Einzelheiten zu `container_commands` finden Sie unter [Container-Befehle](customize-containers-ec2.md#linux-container-commands).
**.ebextensions/cloudwatch.config**
```
files:
"/opt/aws/amazon-cloudwatch-agent/bin/config.json":
mode: "000600"
owner: root
group: root
content: |
{
"agent": {
"metrics_collection_interval": 60,
"run_as_user": "root"
},
"metrics": {
"namespace": "System/Linux",
"append_dimensions": {
"AutoScalingGroupName": "${aws:AutoScalingGroupName}"
},
"metrics_collected": {
"mem": {
"measurement": [
"mem_used_percent"
]
}
}
}
}
container_commands:
start_cloudwatch_agent:
command: /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -a append-config -m ec2 -s -c file:/opt/aws/amazon-cloudwatch-agent/bin/config.json
```
## Berechtigungen
Die Instances in Ihrer Umgebung benötigen die richtigen IAM-Berechtigungen, um benutzerdefinierte CloudWatch Amazon-Metriken mithilfe des CloudWatch Amazon-Agenten zu veröffentlichen. Sie erteilen den Umgebungs-Instances die Berechtigungen, indem Sie diese zum [Instance-Profil](concepts-roles-instance.md) der Umgebung hinzufügen. Die Berechtigungen für das Instance-Profil können Sie vor oder nach der Anwendungsbereitstellung hinzufügen.
**Um Berechtigungen zur Veröffentlichung CloudWatch von Metriken zu erteilen**
1. Öffnen Sie unter [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) die IAM-Konsole.
1. Wählen Sie im Navigationsbereich **Rollen**.
1. Wählen Sie die Instance-Profilrolle der Umgebung aus. Wenn Sie eine Umgebung mit der Elastic Beanstalk-Konsole oder der [EB CLI](eb-cli3.md) erstellen, ist das standardmäßig `aws-elasticbeanstalk-ec2-role`.
1. Wählen Sie die Registerkarte **Berechtigungen**.
1. Unter **Berechtigungsrichtlinien** im Abschnitt **Berechtigungen** wählen Sie **Richtlinien anfügen** aus.
1. Wählen **Sie unter Berechtigungen anhängen** die AWS verwaltete Richtlinie aus **CloudWatchAgentServerPolicy**. Klicken Sie dann auf **Attach Policy (Richtlinie anfügen)**.
Weitere Informationen zum Verwalten von Richtlinien finden Sie unter [Arbeiten mit Richtlinien](https://docs.aws.amazon.com/IAM/latest/UserGuide/ManagingPolicies.html) im *IAM-Benutzerhandbuch*.
## Metriken in der CloudWatch Konsole anzeigen
Nachdem Sie die CloudWatch Konfigurationsdatei in Ihrer Umgebung bereitgestellt haben, überprüfen Sie die [ CloudWatchAmazon-Konsole](https://console.aws.amazon.com/cloudwatch/home), um Ihre Messwerte einzusehen. Benutzerdefinierte Metriken werden im **CWAgent**Namespace gespeichert.
Weitere Informationen finden Sie unter [Verfügbare Messwerte anzeigen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/viewing_metrics_with_cloudwatch.html) im * CloudWatch Amazon-Benutzerhandbuch*.