Beispiel: Verwendung benutzerdefinierter CloudWatch Amazon-Metriken

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 EC2 EC2-Benutzerhandbuch.

Der CloudWatch Amazon-Agent

Der CloudWatch Amazon-Agent ermöglicht die Erfassung von CloudWatch Metriken und Protokollen sowohl von Amazon EC2-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 von benutzerdefinierten Amazon-CloudWatch-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.

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 ein) oder die EB CLI bereit.

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 fetch-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 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 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 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-Konsole oder der EB CLI erstellen, ist das 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 zum Verwalten von Richtlinien finden Sie unter Arbeiten mit Richtlinien im IAM-Benutzerhandbuch.

Metriken in der CloudWatch Konsole anzeigen

Nachdem Sie die CloudWatch Konfigurationsdatei in Ihrer Umgebung bereitgestellt haben, überprüfen Sie die CloudWatch Amazon-Konsole, um Ihre Messwerte einzusehen. Benutzerdefinierte Metriken befinden sich im CWAgent-Namespace.

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