Beispiel: Verwendung benutzerdefinierter CloudWatch Amazon-Metriken - AWS Elastic Beanstalk

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.

Wichtig

Die CloudWatch Amazon-Überwachungsskripte sind veraltet. Der CloudWatch Agent hat jetzt die CloudWatch Überwachungsskripte ersetzt, um Metriken und Protokolle zu sammeln.

Wenn Sie immer noch von den veralteten Überwachungsskripten zum Agenten migrieren und Informationen zu den Überwachungsskripten benötigen, finden Sie weitere Informationen unter Veraltet: Metriken mithilfe der CloudWatch Überwachungsskripten sammeln im Amazon-Benutzerhandbuch. EC2

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.

Anmerkung

Elastic Beanstalk Enhanced Health Reporting 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.

.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 im CloudWatch Amazon-Benutzerhandbuch.

Um dieses Beispiel zu verwenden, speichern Sie es in einer Datei mit dem Namen cloudwatch.config in einem Verzeichnis, das .ebextensions auf der obersten Ebene Ihres Projektverzeichnisses benannt ist, und stellen Sie Ihre Anwendung dann mit der Elastic Beanstalk Beanstalk-Konsole (schließen Sie das Verzeichnis .ebextensions in Ihrem Quellpaket ein) oder EB bereit. CLI

Weitere Informationen zu Konfigurationsdateien finden Sie unter Erweiterte Umgebungsanpassung mit Konfigurationsdateien (.ebextensions).

.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

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_used_percent-Metrik. Eine vollständige Liste der vom CloudWatch Amazon-Agenten unterstützten Metriken auf Systemebene finden Sie unter Vom CloudWatch Agenten gesammelte Metriken 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.

Berechtigungen

Die Instances in Ihrer Umgebung benötigen die entsprechenden 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 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 von CloudWatch Metriken zu erteilen
  1. Öffnen Sie die IAM Konsole unter https://console.aws.amazon.com/iam/.

  2. Wählen Sie im Navigationsbereich Rollen aus.

  3. Wählen Sie die Instance-Profilrolle der Umgebung aus. Wenn Sie eine Umgebung mit der Elastic Beanstalk Beanstalk-Konsole oder EB erstellenCLI, ist dies standardmäßig. aws-elasticbeanstalk-ec2-role

  4. Wählen Sie die Registerkarte Berechtigungen.

  5. Unter Berechtigungsrichtlinien im Abschnitt Berechtigungen wählen Sie Richtlinien anfügen aus.

  6. Wählen Sie unter Berechtigungen anhängen die AWS verwaltete Richtlinie aus. CloudWatchAgentServerPolicy Klicken Sie dann auf Attach Policy (Richtlinie anfügen).

Weitere Informationen zur Verwaltung von Richtlinien finden Sie im IAMBenutzerhandbuch unter Arbeiten mit Richtlinien.

Metriken in der CloudWatch Konsole anzeigen

Nachdem Sie die CloudWatch Konfigurationsdatei in Ihrer Umgebung bereitgestellt haben, überprüfen Sie die CloudWatchAmazon-Konsole, um Ihre Messwerte einzusehen. Benutzerdefinierte Metriken werden im CWAgentNamespace gespeichert.

Weitere Informationen finden Sie unter Verfügbare Messwerte anzeigen im CloudWatch Amazon-Benutzerhandbuch.