CloudWatch Logs verwenden mit AWS Batch

Sie können Ihre AWS Batch Jobs auf EC2-Ressourcen so konfigurieren, dass detaillierte Protokollinformationen und Metriken an CloudWatch Logs gesendet werden. Auf diese Weise können Sie verschiedene Protokolle Ihrer Jobs an einem zentralen Ort einsehen. Weitere Informationen zu CloudWatch Logs finden Sie unter Was ist Amazon CloudWatch Logs? im CloudWatch Amazon-Benutzerhandbuch.

Anmerkung

Standardmäßig ist CloudWatch Logs für AWS Fargate-Container aktiviert.

Um die CloudWatch Log-Protokollierung zu aktivieren und anzupassen, überprüfen Sie die folgenden einmaligen Konfigurationsaufgaben:

• Für AWS Batch Rechenumgebungen, die auf EC2-Ressourcen basieren, fügen Sie der Rolle eine IAM-Richtlinie hinzu. ecsInstanceRole Weitere Informationen finden Sie unter Fügen Sie eine CloudWatch Logs-IAM-Richtlinie hinzu.

• Erstellen Sie eine Amazon EC2 EC2-Startvorlage, die eine detaillierte CloudWatch Überwachung beinhaltet, und geben Sie die Vorlage dann an, wenn Sie Ihre AWS Batch Datenverarbeitungsumgebung erstellen. Sie können den CloudWatch Agenten auch auf einem vorhandenen Image installieren und das Image dann im Assistenten für die AWS Batch erste Ausführung angeben.

• (Optional) Konfigurieren Sie den awslogs-Treiber. Sie können Parameter hinzufügen, die das Standardverhalten sowohl auf EC2- als auch auf Fargate-Ressourcen ändern. Weitere Informationen finden Sie unter Verwenden des awslogs-Protokolltreibers.

Fügen Sie eine CloudWatch Logs-IAM-Richtlinie hinzu

Bevor Ihre Jobs Protokolldaten und detaillierte Metriken an CloudWatch Logs senden können, müssen Sie eine IAM-Richtlinie erstellen, die die CloudWatch Logs-APIs verwendet. Nachdem Sie die IAM-Richtlinie erstellt haben, fügen Sie sie der ecsInstanceRole Rolle hinzu.

Anmerkung

Wenn die ECS-CloudWatchLogs Richtlinie nicht an die ecsInstanceRole Rolle angehängt ist, können grundlegende Metriken trotzdem an CloudWatch Logs gesendet werden. Die Basiskennzahlen enthalten jedoch keine Protokolldaten oder detaillierte Messwerte wie den freien Festplattenspeicher.

AWS Batch Rechenumgebungen verwenden Amazon EC2 EC2-Ressourcen. Wenn Sie mit dem Assistenten für die AWS Batch erste Ausführung eine Datenverarbeitungsumgebung erstellen, AWS Batch erstellt er die ecsInstanceRole Rolle und konfiguriert die Umgebung damit.

Wenn Sie den Assistenten für die erste Ausführung nicht verwenden, können Sie die ecsInstanceRole Rolle angeben, wenn Sie eine Rechenumgebung in der AWS Command Line Interface OR-API erstellen. AWS Batch Weitere Informationen finden Sie in der AWS CLI Befehlsreferenz oder AWS Batch API-Referenz.

So erstellen Sie die ECS-CloudWatchLogs-IAM-Richtlinie

1. Öffnen Sie die IAM-Konsole unter https://console.aws.amazon.com/iam/.

2. Wählen Sie im Navigationsbereich Policies aus.

3. Wählen Sie Richtlinie erstellen aus.

4. Wählen Sie JSON und geben Sie dann die folgende Richtlinie ein:

   {
       "Version": "2012-10-17",
       "Statement": [
           {
               "Effect": "Allow",
               "Action": [
                   "logs:CreateLogGroup",
                   "logs:CreateLogStream",
                   "logs:PutLogEvents",
                   "logs:DescribeLogStreams"
               ],
               "Resource": [
                   "arn:aws:logs:*:*:*"
               ]
           }
       ]
   }

5. Wählen Sie Weiter: Markierungen.

6. (Optional) Wählen Sie unter Tags hinzufügen die Option Tag hinzufügen aus, um der Richtlinie ein Tag hinzuzufügen.

7. Wählen Sie Weiter: Prüfen aus.

8. Geben Sie auf der Seite „Richtlinie überprüfen“ als Namen eine Beschreibung einECS-CloudWatchLogs, und geben Sie dann optional eine Beschreibung ein.

9. Wählen Sie Richtlinie erstellen aus.

So fügen Sie die Richtlinie ECS-CloudWatchLogs an die ecsInstanceRole an

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 ecsInstanceRole. Wenn die Rolle nicht existiert, folgen Sie den Verfahren unter Amazon-ECS-Instance-Rolle So erstellen Sie die Rolle.

4. Wählen Sie „Berechtigungen hinzufügen“ und anschließend „Richtlinien anhängen“.

5. Wählen Sie die CloudWatchECS-Logs-Richtlinie und anschließend die Option Richtlinie anhängen aus.

Installieren und konfigurieren Sie den CloudWatch Agenten

Sie können eine Amazon EC2 EC2-Startvorlage erstellen, die die CloudWatch Überwachung beinhaltet. Weitere Informationen finden Sie unter Starten einer Instance über eine Startvorlage und Erweiterte Details im Amazon EC2 EC2-Benutzerhandbuch.

Sie können den CloudWatch Agenten auch auf einem vorhandenen Amazon EC2 EC2-AMI installieren und dann das Image im Assistenten für die AWS Batch erste Ausführung angeben. Weitere Informationen finden Sie unter Installation des CloudWatch Agenten und Erste Schritte mit. AWS Batch

Anmerkung

Startvorlagen werden auf AWS Fargate Ressourcen nicht unterstützt.

CloudWatch Protokolle anzeigen

Sie können CloudWatch Log-Logs in der anzeigen und durchsuchen AWS Management Console.

Anmerkung

Es kann einige Minuten dauern, bis Daten in CloudWatch Logs angezeigt werden.

Um Ihre CloudWatch Logs-Daten einzusehen

1. Öffnen Sie die CloudWatch Konsole unter https://console.aws.amazon.com/cloudwatch/.

2. Wählen Sie im linken Navigationsbereich Logs und anschließend Log groups aus.

   

3. Wählen Sie eine Protokollgruppe aus, die angezeigt werden soll.

   

4. Wählen Sie einen Protokollstream aus, der angezeigt werden soll. Standardmäßig werden die Streams durch die ersten 200 Zeichen des Jobnamens und der Amazon ECS-Aufgaben-ID identifiziert.

   Tipp

   Um Log-Stream-Daten herunterzuladen, wählen Sie Aktionen.