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.

# CodeDeploy Agentenprotokolle senden an CloudWatch
<a name="codedeploy-agent-operations-cloudwatch-agent"></a>

Sie können Metrik- und Protokolldaten für CodeDeploy Agenten an CloudWatch den [Unified CloudWatch Agent](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/UseCloudWatchUnifiedAgent.html) oder, einfacher gesagt, an den CloudWatch Agenten senden.

Verwenden Sie die folgenden Anweisungen, um den CloudWatch Agenten zu installieren und ihn für die Verwendung mit CodeDeploy Agenten zu konfigurieren.

## Voraussetzungen
<a name="codedeploy-agent-operations-cloudwatch-prerequisites"></a>

Führen Sie als Erstes die folgenden Schritte aus:
+ Installieren Sie den CodeDeploy Agenten und stellen Sie sicher, dass er läuft. Weitere Informationen erhalten Sie unter [Installieren Sie den CodeDeploy Agenten](codedeploy-agent-operations-install.md) und [Stellen Sie sicher, dass der CodeDeploy Agent läuft](codedeploy-agent-operations-verify.md).
+ Installieren Sie den CloudWatch Agenten. Weitere Informationen finden Sie unter [Installation des CloudWatch Agenten](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/install-CloudWatch-Agent-on-EC2-Instance.html).
+ Fügen Sie dem CodeDeploy IAM-Instanzprofil die folgenden Berechtigungen hinzu:
  + CloudWatchLogsFullAccess
  + CloudWatchAgentServerPolicy

  Weitere Informationen zum CodeDeploy Instanzprofil finden Sie unter [Schritt 4: Erstellen Sie ein IAM-Instance-Profil für Ihre Amazon EC2 EC2-Instances](getting-started-create-iam-instance-profile.md) von[Erste Schritte mit CodeDeploy](getting-started-codedeploy.md).

## Konfigurieren Sie den CloudWatch Agenten für die Erfassung von CodeDeploy Protokollen
<a name="codedeploy-agent-operations-cloudwatch-configure"></a>

Sie können den CloudWatch Agenten konfigurieren, indem Sie einen Assistenten ausführen oder eine Konfigurationsdatei manuell erstellen oder bearbeiten.

**So konfigurieren Sie den CloudWatch Agenten mit dem Assistenten (Linux)**

1. Führen Sie den Assistenten aus, wie unter Den [Assistenten zur CloudWatch Agentenkonfiguration ausführen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create-cloudwatch-agent-configuration-file-wizard.html#cloudwatch-agent-running-wizard) beschrieben.

1. Geben Sie im Assistenten die `Do you want to monitor any log files?` Eingabetaste ein, wenn Sie dazu aufgefordert **1** werden.

1. Geben Sie die CodeDeploy Agent-Protokolldatei wie folgt an:

   1. `Log file path`Geben Sie den Pfad für die CodeDeploy Protokolldatei ein, zum Beispiel:**/var/log/aws/codedeploy-agent/codedeploy-agent.log**.

   1. `Log group name`Geben Sie einen Namen für die Protokollgruppe ein, zum Beispiel:**codedeploy-agent-log**.

   1. `Log stream name`Geben Sie einen Namen für den Protokollstream ein, zum Beispiel:**\$1instance\$1id\$1-codedeploy-agent-log**.

1. Wenn Sie dazu aufgefordert werden`Do you want to specify any additional log files?`, geben Sie ein**1**.

1. Geben Sie die CodeDeploy Agenten-Bereitstellungsprotokolle wie folgt an:

   1. `Log file path`Geben Sie zum Beispiel den Pfad für die CodeDeploy Bereitstellungsprotokolldatei ein:**/opt/codedeploy-agent/deployment-root/deployment-logs/codedeploy-agent-deployments.log**.

   1. `Log group name`Geben Sie einen Namen für die Protokollgruppe ein, zum Beispiel:**codedeploy-agent-deployment-log**.

   1. `Log stream name`Geben Sie einen Namen für den Protokollstream ein, zum Beispiel:**\$1instance\$1id\$1-codedeploy-agent-deployment-log**.

1. Wenn Sie dazu aufgefordert werden`Do you want to specify any additional log files?`, geben Sie ein**1**.

1. Geben Sie die CodeDeploy Agent-Updater-Protokolle wie folgt an:

   1. `Log file path`Geben Sie zum Beispiel den Pfad für die CodeDeploy Updater-Protokolldatei ein:. **/tmp/codedeploy-agent.update.log**

   1. `Log group name`Geben Sie einen Namen für die Protokollgruppe ein, zum Beispiel:**codedeploy-agent-updater-log**.

   1. `Log stream name`Geben Sie einen Namen für den Protokollstream ein, zum Beispiel:**\$1instance\$1id\$1-codedeploy-agent-updater-log**.

**Um den CloudWatch Agenten mit dem Assistenten zu konfigurieren (Windows)**

1. Führen Sie den Assistenten aus, wie unter Den [Assistenten zur CloudWatch Agentenkonfiguration ausführen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create-cloudwatch-agent-configuration-file-wizard.html#cloudwatch-agent-running-wizard) beschrieben.

1. Geben Sie im Assistenten die `Do you want to monitor any customized log files?` Eingabetaste ein, wenn Sie dazu aufgefordert **1** werden.

1. Geben Sie die CodeDeploy Protokolldatei wie folgt an:

   1. `Log file path`Geben Sie für den Pfad oder die CodeDeploy Agenten-Protokolldatei ein, zum Beispiel:**C:\$1ProgramData\$1Amazon\$1CodeDeploy\$1log\$1codedeploy-agent-log.txt**.

   1. `Log group name`Geben Sie einen Protokollgruppennamen ein, zum Beispiel:**codedeploy-agent-log**.

   1. `Log stream name`Geben Sie einen Namen für den Protokollstream ein, zum Beispiel:**\$1instance\$1id\$1-codedeploy-agent-log**.

1. Wenn Sie dazu aufgefordert werden`Do you want to specify any additional log files?`, geben Sie ein**1**.

1. Geben Sie die CodeDeploy Agenten-Bereitstellungsprotokolle wie folgt an:

   1. `Log file path`Geben Sie den Pfad der CodeDeploy Bereitstellungsprotokolldatei ein, zum Beispiel:**C:\$1ProgramData\$1Amazon\$1CodeDeploy\$1deployment-logs\$1codedeploy-agent-deployments.log**.

   1. `Log group name`Geben Sie einen Namen für die Protokollgruppe ein, zum Beispiel:**codedeploy-agent-deployment-log**.

   1. `Log stream name`Geben Sie einen Namen für den Protokollstream ein, zum Beispiel:**\$1instance\$1id\$1-codedeploy-agent-deployment-log**.

**Um den CloudWatch Agenten durch manuelles Erstellen oder Bearbeiten einer Konfigurationsdatei zu konfigurieren (Linux)**

1. Erstellen oder bearbeiten Sie die CloudWatch Agenten-Konfigurationsdatei wie unter [Manuelles Erstellen oder Bearbeiten der CloudWatch Agenten-Konfigurationsdatei](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-Configuration-File-Details.html) beschrieben.

1. Stellen Sie sicher, dass die Datei aufgerufen wird `/opt/aws/amazon-cloudwatch-agent/etc/amazon-cloudwatch-agent.json` und den folgenden Code enthält:

   ```
   ...
   "logs": {
       "logs_collected": {
           "files": {
               "collect_list": [
                   {
                       "file_path": "/var/log/aws/codedeploy-agent/codedeploy-agent.log",
                       "log_group_name": "codedeploy-agent-log",
                       "log_stream_name": "{instance_id}-agent-log"
                   },
                   {
                       "file_path": "/opt/codedeploy-agent/deployment-root/deployment-logs/codedeploy-agent-deployments.log",
                       "log_group_name": "codedeploy-agent-deployment-log",
                       "log_stream_name": "{instance_id}-codedeploy-agent-deployment-log"
                   },
                   {
                       "file_path": "/tmp/codedeploy-agent.update.log",
                       "log_group_name": "codedeploy-agent-updater-log",
                       "log_stream_name": "{instance_id}-codedeploy-agent-updater-log"
                   }
               ]
           }
       }
   }
   ...
   ```

**Um den CloudWatch Agenten durch manuelles Erstellen oder Bearbeiten einer Konfigurationsdatei zu konfigurieren (Windows)**

1. Erstellen oder bearbeiten Sie die CloudWatch Agent-Konfigurationsdatei wie unter [Manuelles Erstellen oder Bearbeiten der CloudWatch Agenten-Konfigurationsdatei](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-Configuration-File-Details.html) beschrieben.

1. Stellen Sie sicher, dass die Datei aufgerufen wird `C:\ProgramData\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent.json` und den folgenden Code enthält:

   ```
   ...
   "logs": {
           "logs_collected": {
               "files": {
                   "collect_list": [
                       {
                           "file_path": "C:\\ProgramData\\Amazon\\CodeDeploy\\log\\codedeploy-agent-log.txt",
                           "log_group_name": "codedeploy-agent-log",
                           "log_stream_name": "{instance_id}-codedeploy-agent-log"
                       },
                       {
                           "file_path": "C:\\ProgramData\\Amazon\\CodeDeploy\\deployment-logs\\codedeploy-agent-deployments.log",
                           "log_group_name": "codedeploy-agent-deployment-log",
                           "log_stream_name": "{instance_id}-codedeploy-agent-deployment-log"
                       }
                   ]
               },
               ...
           }
       },
   ...
   ```

## Starten Sie den CloudWatch Agenten neu
<a name="codedeploy-agent-operations-cloudwatch-restart"></a>

Nachdem Sie Ihre Änderungen vorgenommen haben, starten Sie den CloudWatch Agenten neu, wie unter [ CloudWatch Agent starten](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/install-CloudWatch-Agent-on-EC2-Instance-fleet.html#start-CloudWatch-Agent-EC2-fleet) beschrieben.