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.

# Verwenden Sie den awslogs-Protokolltreiber
<a name="using_awslogs"></a>

 AWS Batch Aktiviert standardmäßig den `awslogs` Protokolltreiber, Protokollinformationen an CloudWatch Logs zu senden. Mit dieser Funktion können Sie verschiedene Logs aus Ihren Containern an einem zentralen Ort anzeigen und so verhindern, dass Ihre Container-Logs Speicherplatz auf Ihren Container-Instances belegen. Dieses Thema hilft Ihnen bei der Konfiguration des `awslogs` Protokolltreibers in Ihren Jobdefinitionen.

**Anmerkung**  
In der AWS Batch Konsole können Sie den `awslogs` Protokolltreiber im Abschnitt **Konfiguration der Protokollierung** konfigurieren, wenn Sie eine Auftragsdefinition erstellen.

**Anmerkung**  
Die Art der Informationen, die von den Containern in Ihrem Job protokolliert werden, hängt hauptsächlich von deren `ENTRYPOINT` Befehl ab. Standardmäßig zeigen die erfassten Protokolle die Befehlsausgabe, die Sie normalerweise in einem interaktiven Terminal sehen, wenn Sie den Container lokal ausgeführt haben, also die `STDERR` I/O Streams `STDOUT` und. Der `awslogs` Protokolltreiber leitet diese Protokolle einfach von Docker an CloudWatch Logs weiter. Weitere Informationen dazu, wie Docker-Protokolle verarbeitet werden, einschließlich alternativer Möglichkeiten zum Erfassen unterschiedlicher Dateidaten oder Streams, finden Sie unter [Anzeigen von Protokollen für einen Container oder Service](https://docs.docker.com/config/containers/logging/) in der Docker-Dokumentation.

Informationen zum Senden von Systemprotokollen von Ihren Container-Instances an CloudWatch Logs finden Sie unter[CloudWatch Logs verwenden mit AWS Batch](using_cloudwatch_logs.md). Weitere Informationen zu CloudWatch Protokollen finden Sie unter [Überwachung von Protokolldateien](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/WhatIsCloudWatchLogs.html) und [CloudWatch Protokollkontingenten](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/cloudwatch_limits_cwl.html) im *Amazon CloudWatch Logs-Benutzerhandbuch*.

## awslogs-Protokolltreiberoptionen im Datentyp AWS Batch JobDefiniton
<a name="create_awslogs_logdriver_options"></a>

Der `awslogs` Protokolltreiber unterstützt die folgenden Optionen in AWS Batch Jobdefinitionen. Weitere Informationen finden Sie unter [Treiber für die CloudWatch Protokollierung](https://docs.docker.com/config/containers/logging/awslogs/) von Protokollen in der Docker-Dokumentation.

`awslogs-region`  
Erforderlich: Nein  
Geben Sie die Region an, in die der `awslogs` Protokolltreiber Ihre Docker-Logs senden soll. Standardmäßig ist die Region, die verwendet wird, dieselbe wie die für den Job verwendete. In Logs können Sie wählen, ob Sie all Ihre Logs von Jobs in verschiedenen Regionen an eine einzige Region senden möchten. CloudWatch Auf diese Weise können sie alle von einem Ort aus sichtbar sein. Alternativ können Sie sie nach Regionen trennen, um einen detaillierteren Ansatz zu erreichen. Wenn Sie diese Option wählen, stellen Sie jedoch sicher, dass die angegebenen Protokollgruppen in der von Ihnen angegebenen Region vorhanden sind.

`awslogs-group`  
Erforderlich: Optional  
Mit der `awslogs-group` Option können Sie die Protokollgruppe angeben, an die der `awslogs` Protokolltreiber seine Protokollstreams sendet. Wenn dies nicht angegeben `aws/batch/job` ist, wird verwendet.

`awslogs-stream-prefix`  
Erforderlich: Optional  
Mit der `awslogs-stream-prefix` Option können Sie einen Protokollstream mit dem angegebenen Präfix und der Amazon ECS-Aufgaben-ID des AWS Batch Jobs verknüpfen, zu dem der Container gehört. Wenn Sie einen Präfix mit dieser Option angeben, weist der Protokoll-Stream das folgende Format auf:  

```
prefix-name/default/ecs-task-id
```

`awslogs-datetime-format`  
Erforderlich: Nein  
Diese Option definiert einen mehrzeiliges Startmuster im `strftime`-Format von Python. Eine Protokollnachricht besteht aus einer Zeile, die dem Muster entspricht, und allen folgenden Zeilen, die nicht dem Muster entsprechen. Damit ist die zugeordnete Zeile das Trennzeichen zwischen Protokollnachrichten.  
Ein Beispiel für einen Anwendungsfall für die Nutzung dieses Formats ist die Ausgabenanalyse, z. B. einen Stack-Dump, der andernfalls möglicherweise mehrere Einträge protokolliert. Mit dem richtigen Muster kann es in nur einem Eintrag erfasst werden.  
Weitere Informationen finden Sie unter [awslogs-datetime-format](https://docs.docker.com/config/containers/logging/awslogs/#awslogs-datetime-format).  
Diese Option hat immer Vorrang, wenn sowohl `awslogs-datetime-format` als auch `awslogs-multiline-pattern` konfiguriert sind.  
Bei der mehrzeiligen Protokollierung wird eine regelmäßige Ausdrucksanalyse und die Übereinstimmung aller Protokollmeldungen ausgeführt. Dies kann negative Auswirkungen auf die Leistung der Protokollierung haben.

`awslogs-multiline-pattern`  
Erforderlich: Nein  
Diese Option definiert ein mehrzeiliges Startmuster mit einem regulären Ausdruck. Eine Protokollnachricht besteht aus einer Zeile, die dem Muster entspricht, und allen folgenden Zeilen, die nicht dem Muster entsprechen. Somit ist die übereinstimmende Zeile das Trennzeichen zwischen Protokollnachrichten.  
Weitere Informationen finden Sie [awslogs-multiline-pattern](https://docs.docker.com/config/containers/logging/awslogs/#awslogs-multiline-pattern)in der Docker-Dokumentation.  
Diese Option wird ignoriert, wenn `awslogs-datetime-format` ebenfalls konfiguriert ist.  
Bei der mehrzeiligen Protokollierung wird eine regelmäßige Ausdrucksanalyse und die Übereinstimmung aller Protokollmeldungen ausgeführt. Dies kann negative Auswirkungen auf die Leistung der Protokollierung haben.

`awslogs-create-group`  
Erforderlich: Nein  
Geben Sie an, ob die Protokollgruppe automatisch erstellt werden soll. Wenn diese Option nicht angegeben ist, gilt standardmäßig `false`.  
Diese Option wird nicht empfohlen. Es wird empfohlen, die Protokollgruppe im Voraus mithilfe der CloudWatch [CreateLogGroup](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateLogGroup.html)Protokoll-API-Aktion zu erstellen, da jeder Job versucht, die Protokollgruppe zu erstellen, wodurch die Wahrscheinlichkeit steigt, dass der Job fehlschlägt.
Die IAM-Richtlinie für Ihre Ausführungsrolle muss die `logs:CreateLogGroup` entsprechende Genehmigung enthalten, bevor Sie versuchen, sie zu verwenden`awslogs-create-group`.

## Geben Sie in Ihrer Jobdefinition eine Protokollkonfiguration an
<a name="specify-log-config"></a>

 AWS Batch Aktiviert standardmäßig den `awslogs` Protokolltreiber. In diesem Abschnitt wird beschrieben, wie Sie die `awslogs` Protokollkonfiguration für einen Job anpassen. Weitere Informationen finden Sie unter [Erstellen Sie eine Auftragsdefinition mit einem Knoten](create-job-definition.md).

In den folgenden JSON-Snippets für die Protokollkonfiguration ist für jeden `logConfiguration` Job ein Objekt angegeben. Einer ist für einen WordPress Job, der Protokolle an eine Protokollgruppe namens sendet`awslogs-wordpress`, und ein anderer ist für einen MySQL-Container, der Protokolle an eine Protokollgruppe namens sendet`awslogs-mysql`. Beide Container verwenden den Protokoll-Stream-Präfix `awslogs-example`.

```
"logConfiguration": {
    "logDriver": "awslogs",
    "options": {
        "awslogs-group": "awslogs-wordpress",
        "awslogs-stream-prefix": "awslogs-example"
    }
}
```

```
"logConfiguration": {
    "logDriver": "awslogs",
    "options": {
        "awslogs-group": "awslogs-mysql",
        "awslogs-stream-prefix": "awslogs-example"
    }
}
```

In der AWS Batch Konsole wird die Protokollkonfiguration für die `wordpress` Auftragsdefinition wie in der folgenden Abbildung dargestellt angegeben. 

![\[Log configuration interface showing awslogs driver with group and stream prefix options.\]](http://docs.aws.amazon.com/de_de/batch/latest/userguide/images/awslogs-console-config.png)


Nachdem Sie eine Aufgabendefinition beim `awslogs` Protokolltreiber in einer Protokollkonfiguration für die Auftragsdefinition registriert haben, können Sie einen Job mit dieser Auftragsdefinition einreichen, um mit dem Senden von Protokollen an Logs zu CloudWatch beginnen. Weitere Informationen finden Sie unter [Tutorial: Einen Job einreichen](submit_job.md).