Tutorial: Installation mithilfe einer AWS CloudFormation Inline-Vorlage Tutorial: Installieren Sie den CloudWatch Agenten mithilfe von AWS CloudFormation Parameter Store Fehlerbehebung bei der Installation des CloudWatch Agenten mit AWS CloudFormation

Installieren Sie den CloudWatch Agenten auf neuen Instanzen mit AWS CloudFormation

In diesem Abschnitt wird beschrieben, wie Sie den CloudWatch Agenten auf neuen EC2 Amazon-Instances mithilfe von installieren AWS CloudFormation.

Anmerkung

Amazon hat mehrere AWS CloudFormation Vorlagen hochgeladen GitHub , die Ihnen bei der Installation und Aktualisierung des CloudWatch Agenten auf neuen EC2 Amazon-Instances helfen können. Weitere Informationen zur Verwendung AWS CloudFormation finden Sie unter Was ist AWS CloudFormation? .

Der Speicherort der Vorlage lautet Deploy the Amazon CloudWatch Agent to EC2 Instances using AWS CloudFormation. Dort finden Sie die beiden Verzeichnisse inline und ssm. Jedes dieser Verzeichnisse enthält Vorlagen für Linux- und Windows-Instances.

Bei den Vorlagen im inline Verzeichnis ist die CloudWatch Agentenkonfiguration in die AWS CloudFormation Vorlage eingebettet. Standardmäßig erfassen die Linux-Vorlagen die Metriken mem_used_percent und swap_used_percent, die Windows-Vorlagen dagegen Memory % Committed Bytes In Use und Paging File % Usage.

Sie können diese Vorlagen ändern, um andere Metriken zu erfassen, indem Sie den folgenden Abschnitt der Vorlage ändern. Das folgende Beispiel stammt aus der Vorlage für Linux-Server. Befolgen Sie das Format und die Syntax der Agentenkonfigurationsdatei, um diese Änderungen vorzunehmen. Weitere Informationen finden Sie unter Erstellen oder bearbeiten Sie die CloudWatch Agenten-Konfigurationsdatei manuell.
```
{
   "metrics":{
      "append_dimensions":{
         "AutoScalingGroupName":"${!aws:AutoScalingGroupName}",
         "ImageId":"${!aws:ImageId}",
         "InstanceId":"${!aws:InstanceId}",
         "InstanceType":"${!aws:InstanceType}"
      },
      "metrics_collected":{
         "mem":{
            "measurement":[
               "mem_used_percent"
            ]
         },
         "swap":{
            "measurement":[
               "swap_used_percent"
            ]
         }
      }
   }
}
```
Anmerkung
In den Inline-Vorlagen müssen alle Platzhaltervariablen ein Ausrufezeichen (!) als Escape-Zeichen vor sich haben. Dies sehen Sie in der Beispielvorlage. Wenn Sie weitere Platzhaltervariablen hinzufügen, achten Sie darauf, dass Sie vor dem Namen ein Ausrufezeichen hinzufügen.
Die Vorlagen im Verzeichnis ssm laden eine Agentenkonfigurationsdatei aus Parameter Store. Um diese Vorlagen verwenden zu können, müssen Sie zunächst eine Konfigurationsdatei erstellen und diese in Parameter Store hochladen. Sie stellen dann den Parameter-Store-Namen der Datei in der Vorlage bereit. Sie können die Konfigurationsdatei manuell oder mit Hilfe des Assistenten erstellen. Weitere Informationen finden Sie unter Erstellen Sie die CloudWatch Agent-Konfigurationsdatei.

Sie können beide Arten von Vorlagen für die Installation des CloudWatch Agenten und für die Aktualisierung der Agentenkonfiguration verwenden.

Tutorial: Installieren und konfigurieren Sie den CloudWatch Agenten mithilfe einer AWS CloudFormation Inline-Vorlage

In diesem Tutorial erfahren Sie AWS CloudFormation , wie Sie den CloudWatch Agenten auf einer neuen EC2 Amazon-Instance installieren. Dieses Tutorial wird auf einer neuen Instance installiert, auf der Amazon Linux 2 ausgeführt wird. Dabei werden die Inline-Vorlagen verwendet, für die weder die JSON Konfigurationsdatei noch der Parameterspeicher verwendet werden müssen. Die Inline-Vorlage enthält die Agent-Konfiguration in der Vorlage. In diesem Tutorial verwenden Sie die in der Vorlage enthaltene Standardagentenkonfiguration.

Nach der Vorgehensweise zur Installation des Agenten fährt das Tutorial mit der Aktualisierung des Agenten fort.

Wird verwendet AWS CloudFormation , um den CloudWatch Agenten auf einer neuen Instance zu installieren

Laden Sie die Vorlage von herunter GitHub. Laden Sie in diesem Tutorial die Inline-Vorlage für Amazon Linux 2 wie folgt herunter:


curl -O https://raw.githubusercontent.com/aws-cloudformation/aws-cloudformation-templates/main/Solutions/AmazonCloudWatchAgent/inline/amazon_linux.yaml

Öffnen Sie die AWS CloudFormation Konsole unter https://console.aws.amazon.com/cloudformation.
Wählen Sie Stack erstellen aus.
Wählen Sie für Choose a template (Vorlage auswählen) Upload a template to Amazon S3 (Vorlage auf Amazon S3 hochladen), wählen Sie die heruntergeladene Vorlage aus und klicken Sie auf Next (Weiter).
Geben Sie auf der Seite Specify Details (Details angeben) die folgenden Parameter ein und wählen Sie Next (Weiter) aus:
- Stack-Name: Wählen Sie einen Stack-Namen für Ihren AWS CloudFormation Stack.
- IAMRole: Wählen Sie eine IAM Rolle, die berechtigt ist, CloudWatch Metriken, Logs und Traces zu schreiben. Weitere Informationen finden Sie unter IAMRollen zur Verwendung mit dem CloudWatch Agenten auf EC2 Amazon-Instances erstellen.
- Instanz AMI: Wählen Sie eineAMI, die in der Region gültig ist, in der Sie Ihren Stack starten möchten.
- InstanceType: Wählen Sie einen gültigen Instance-Typ.
- KeyName: Um den SSH Zugriff auf die neue Instance zu aktivieren, wählen Sie ein vorhandenes EC2 Amazon-Schlüsselpaar aus. Wenn Sie noch kein EC2 Amazon-Schlüsselpaar haben, können Sie eines in der erstellen AWS Management Console. Weitere Informationen finden Sie unter Amazon EC2 Key Pairs im EC2Amazon-Benutzerhandbuch.
- SSHLocation: Gibt den IP-Adressbereich an, über den eine Verbindung zu der Instance hergestellt werden kannSSH. Der Standard erlaubt den Zugriff von jeder IP-Adresse aus.
Auf der Seite Options (Optionen) können Sie auswählen, Ihre Stack-Ressourcen zu markieren. Wählen Sie Weiter.
Überprüfen Sie auf der Seite Überprüfen Ihre Informationen, bestätigen Sie, dass der Stack möglicherweise IAM Ressourcen generiert, und wählen Sie dann Create aus.

Wenn Sie die Konsole aktualisieren, sehen Sie, dass der neue Stack den CREATE_IN_PROGRESS Status hat.
Wenn die Instance erstellt wurde, können Sie sie in der EC2 Amazon-Konsole sehen. Optional können Sie sich mit dem Host verbinden und den Fortschritt überprüfen.

Verwenden Sie den folgenden Befehl, um zu bestätigen, dass der Agent installiert ist:
```
rpm -qa amazon-cloudwatch-agent
```
Verwenden Sie den folgenden Befehl, um zu bestätigen, dass der Agent ausgeführt wird:
```
ps aux | grep amazon-cloudwatch-agent
```

Das nächste Verfahren zeigt AWS CloudFormation , wie Sie den CloudWatch Agenten mithilfe einer Inline-Vorlage aktualisieren können. Die standardmäßige Inline-Vorlage erfasst die mem_used_percent-Metrik. In diesem Tutorial ändern Sie die Agent-Konfiguration, um die Erfassung dieser Metrik zu stoppen.

Wird verwendet AWS CloudFormation , um den CloudWatch Agenten zu aktualisieren

Entfernen Sie in der Vorlage, die Sie im vorherigen Verfahren heruntergeladen haben, die folgenden Zeilen und speichern Sie die Vorlage:
```
"mem": {
                        
     "measurement": [
         "mem_used_percent"
       ]
 },
```
Öffnen Sie die AWS CloudFormation Konsole unter https://console.aws.amazon.com/cloudformation.
Wählen Sie im AWS CloudFormation Dashboard den Stack aus, den Sie erstellt haben, und wählen Sie Stack aktualisieren aus.
Wählen Sie für Select Template (Vorlage auswählen) Upload a template to Amazon S3 (Vorlage auf Amazon S3 hochladen), wählen Sie die von Ihnen modifizierte Vorlage aus und klicken Sie auf Next (Weiter).
Wählen Sie auf der Seite Options (Optionen) die Option Next (Weiter) gefolgt von Next (Weiter) aus.
Prüfen Sie auf der Seite Review (Überprüfen) die Daten, und wählen Sie Update (Aktualisieren) aus.

Nach einiger Zeit sehen Sie UPDATE_COMPLETE.

Tutorial: Installieren Sie den CloudWatch Agenten mithilfe von AWS CloudFormation Parameter Store

In diesem Tutorial erfahren Sie AWS CloudFormation , wie Sie den CloudWatch Agenten auf einer neuen EC2 Amazon-Instance installieren. Dieses Tutorial wird auf einer neuen Instance installiert, die Amazon Linux 2 mit einer Agent-Konfigurationsdatei ausführt, die Sie in Parameter Store erstellt und gespeichert haben.

Nach der Vorgehensweise zur Installation des Agenten fährt das Tutorial mit der Aktualisierung des Agenten fort.

Wird verwendet AWS CloudFormation , um den CloudWatch Agenten mithilfe einer Konfiguration aus dem Parameter Store auf einer neuen Instance zu installieren

Falls Sie dies noch nicht getan haben, laden Sie das CloudWatch Agentenpaket auf einen Ihrer Computer herunter, damit Sie die Agenten-Konfigurationsdatei erstellen können. Weitere Informationen zum Herunterladen des Agenten mittels Parameter Store finden Sie unter Laden Sie den CloudWatch Agenten herunter, konfigurieren Sie ihn und führen Sie ihn aus mit SSM. Weitere Informationen zum Herunterladen des Pakets mithilfe der Befehlszeile finden Sie unter Laden Sie den CloudWatch Agenten über die Befehlszeile herunter und konfigurieren Sie ihn.
Erstellen Sie die Agentenkonfigurationsdatei und speichern Sie sie in Parameter Store. Weitere Informationen finden Sie unter Erstellen Sie die CloudWatch Agent-Konfigurationsdatei.

Laden Sie die Vorlage GitHub wie folgt herunter:


curl -O https://raw.githubusercontent.com/awslabs/aws-cloudformation-templates/master/aws/solutions/AmazonCloudWatchAgent/ssm/amazon_linux.template

Öffnen Sie die AWS CloudFormation Konsole unter https://console.aws.amazon.com/cloudformation.
Wählen Sie Stack erstellen aus.
Wählen Sie für Choose a template (Vorlage auswählen) Upload a template to Amazon S3 (Vorlage auf Amazon S3 hochladen), wählen Sie die Vorlage aus, die Sie heruntergeladen haben, und klicken Sie auf Next (Weiter).
Füllen Sie auf der Seite Specify Details (Details angeben) die folgenden Parameter entsprechend aus, und klicken Sie dann auf Next (Weiter):
- Stack-Name: Wählen Sie einen Stack-Namen für Ihren AWS CloudFormation Stack.
- IAMRole: Wählen Sie eine IAM Rolle, die berechtigt ist, CloudWatch Metriken, Logs und Traces zu schreiben. Weitere Informationen finden Sie unter IAMRollen zur Verwendung mit dem CloudWatch Agenten auf EC2 Amazon-Instances erstellen.
- Instanz AMI: Wählen Sie eineAMI, die in der Region gültig ist, in der Sie Ihren Stack starten möchten.
- InstanceType: Wählen Sie einen gültigen Instance-Typ.
- KeyName: Um den SSH Zugriff auf die neue Instance zu aktivieren, wählen Sie ein vorhandenes EC2 Amazon-Schlüsselpaar aus. Wenn Sie noch kein EC2 Amazon-Schlüsselpaar haben, können Sie eines in der erstellen AWS Management Console. Weitere Informationen finden Sie unter Amazon EC2 Key Pairs im EC2Amazon-Benutzerhandbuch.
- SSHLocation: Gibt den IP-Adressbereich an, über den eine Verbindung zu der Instance hergestellt werden kannSSH. Der Standard erlaubt den Zugriff von jeder IP-Adresse aus.
- SSMKey: Gibt die Agent-Konfigurationsdatei an, die Sie im Parameter Store erstellt und gespeichert haben.
Auf der Seite Options (Optionen) können Sie auswählen, Ihre Stack-Ressourcen zu markieren. Wählen Sie Weiter.
Überprüfen Sie auf der Seite Überprüfen Ihre Informationen, bestätigen Sie, dass der Stack möglicherweise IAM Ressourcen erstellt, und wählen Sie dann Erstellen aus.

Wenn Sie die Konsole aktualisieren, sehen Sie, dass der neue Stack den CREATE_IN_PROGRESS Status hat.
Wenn die Instance erstellt wurde, können Sie sie in der EC2 Amazon-Konsole sehen. Optional können Sie sich mit dem Host verbinden und den Fortschritt überprüfen.

Verwenden Sie den folgenden Befehl, um zu bestätigen, dass der Agent installiert ist:
```
rpm -qa amazon-cloudwatch-agent
```
Verwenden Sie den folgenden Befehl, um zu bestätigen, dass der Agent ausgeführt wird:
```
ps aux | grep amazon-cloudwatch-agent
```

Das nächste Verfahren zeigt, wie AWS CloudFormation Sie den CloudWatch Agenten mithilfe einer Agentenkonfiguration aktualisieren, die Sie im Parameter Store gespeichert haben.

Wird verwendet AWS CloudFormation , um den CloudWatch Agenten mithilfe einer Konfiguration im Parameter Store zu aktualisieren

Ändern Sie die Agentenkonfigurationsdatei, die in Parameter Store gespeichert ist, auf die neue Konfiguration, die Sie wünschen.
Ändern Sie in der AWS CloudFormation Vorlage, die Sie im Tutorial: Installieren Sie den CloudWatch Agenten mithilfe von AWS CloudFormation Parameter Store Thema heruntergeladen haben, die Versionsnummer. Sie können z. B. VERSION=1.0 zu VERSION=2.0 ändern.
Öffnen Sie die AWS CloudFormation Konsole unter https://console.aws.amazon.com/cloudformation.
Wählen Sie im AWS CloudFormation Dashboard den Stack aus, den Sie erstellt haben, und wählen Sie Stack aktualisieren aus.
Wählen Sie für Select Template (Vorlage auswählen) Upload a template to Amazon S3 (Vorlage auf Amazon S3 hochladen), wählen Sie die Vorlage aus, die Sie gerade geändert haben, und klicken Sie auf Next (Weiter).
Wählen Sie auf der Seite Options (Optionen) die Option Next (Weiter) gefolgt von Next (Weiter) aus.
Prüfen Sie auf der Seite Review (Überprüfen) die Daten, und wählen Sie Update (Aktualisieren) aus.

Nach einiger Zeit sehen Sie UPDATE_COMPLETE.

Fehlerbehebung bei der Installation des CloudWatch Agenten mit AWS CloudFormation

Dieser Abschnitt hilft Ihnen bei der Behebung von Problemen bei der Installation und Aktualisierung des CloudWatch Agenten mithilfe von AWS CloudFormation.

Erkennen, wenn eine Aktualisierung fehlschlägt

Wenn Sie Ihre CloudWatch Agentenkonfiguration aktualisieren und eine ungültige Konfiguration verwenden, sendet der Agent keine Metriken mehr an CloudWatch. AWS CloudFormation Eine schnelle Möglichkeit, um zu überprüfen, ob ein Update der Agentenkonfiguration erfolgreich war, ist ein Blick in die Datei cfn-init-cmd.log. Auf einem Linux-Server befindet sich die Datei unter /var/log/cfn-init-cmd.log. Auf einer Windows-Instance befindet sich die Datei unter C:\cfn\log\cfn-init-cmd.log.

Metriken fehlen

Wenn Sie die nach der Installation oder Aktualisierung des Agenten erwarteten Metriken nicht sehen, stellen Sie sicher, dass der Agent so konfiguriert ist, dass er diese Metrik erfasst. Überprüfen Sie dazu die Datei amazon-cloudwatch-agent.json, um sicherzustellen, dass die Metrik aufgelistet ist. Prüfen Sie auch, ob die Suche im korrekten Metrik-Namespace erfolgt. Weitere Informationen finden Sie unter CloudWatch Agentendateien und Speicherorte.

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

Installieren Sie den CloudWatch Agenten auf lokalen Servern

CloudWatch Präferenz für Agenten-Anmeldeinformationen