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.
# CloudWatch Log-Beispiele mit AWS CLI
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with CloudWatch Logs Aktionen ausführen und allgemeine Szenarien implementieren.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `create-log-group`
Das folgende Codebeispiel zeigt, wie Sie`create-log-group`.
**AWS CLI**
Der folgende Befehl erstellt eine Protokollgruppe mit dem Namen `my-logs`.
```
aws logs create-log-group --log-group-name my-logs
```
+ Einzelheiten zur API finden Sie [CreateLogGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/create-log-group.html)in der *AWS CLI Befehlsreferenz*.
### `create-log-stream`
Das folgende Codebeispiel zeigt die Verwendung`create-log-stream`.
**AWS CLI**
Im folgenden Beispiel wird ein Protokollstream mit dem Namen `20150601` in der Protokollgruppe `my-logs` erstellt.
```
aws logs create-log-stream --log-group-name my-logs --log-stream-name 20150601
```
+ Einzelheiten zur API finden Sie [CreateLogStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/create-log-stream.html)in der *AWS CLI Befehlsreferenz*.
### `delete-log-group`
Das folgende Codebeispiel zeigt die Verwendung`delete-log-group`.
**AWS CLI**
Mit dem folgenden Befehl wird eine Protokollgruppe mit dem Namen `my-logs` gelöscht:
```
aws logs delete-log-group --log-group-name my-logs
```
+ Einzelheiten zur API finden Sie [DeleteLogGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/delete-log-group.html)in der *AWS CLI Befehlsreferenz*.
### `delete-log-stream`
Das folgende Codebeispiel zeigt die Verwendung`delete-log-stream`.
**AWS CLI**
Mit dem folgenden Befehl wird der Protokollstream mit dem Namen `20150531` aus der Protokollgruppe `my-logs` gelöscht:
```
aws logs delete-log-stream --log-group-name my-logs --log-stream-name 20150531
```
+ Einzelheiten zur API finden Sie [DeleteLogStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/delete-log-stream.html)in der *AWS CLI Befehlsreferenz*.
### `delete-retention-policy`
Das folgende Codebeispiel zeigt die Verwendung`delete-retention-policy`.
**AWS CLI**
Mit dem folgenden Befehl wird die Aufbewahrungsrichtlinie entfernt, die zuvor auf eine Protokollgruppe mit dem Namen `my-logs` angewendet wurde:
```
aws logs delete-retention-policy --log-group-name my-logs
```
+ Einzelheiten zur API finden Sie [DeleteRetentionPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/delete-retention-policy.html)in der *AWS CLI Befehlsreferenz*.
### `describe-log-groups`
Das folgende Codebeispiel zeigt die Verwendung`describe-log-groups`.
**AWS CLI**
Der folgende Befehl beschreibt eine Protokollgruppe mit dem Namen `my-logs`:
```
aws logs describe-log-groups --log-group-name-prefix my-logs
```
Ausgabe:
```
{
"logGroups": [
{
"storedBytes": 0,
"metricFilterCount": 0,
"creationTime": 1433189500783,
"logGroupName": "my-logs",
"retentionInDays": 5,
"arn": "arn:aws:logs:us-west-2:0123456789012:log-group:my-logs:*"
}
]
}
```
+ Einzelheiten zur API finden Sie [DescribeLogGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/describe-log-groups.html)in der *AWS CLI Befehlsreferenz*.
### `describe-log-streams`
Das folgende Codebeispiel zeigt die Verwendung`describe-log-streams`.
**AWS CLI**
Der folgende Befehl zeigt alle Protokollstreams in der Protokollgruppe `my-logs` an, die mit dem Präfix `2015` beginnen:
```
aws logs describe-log-streams --log-group-name my-logs --log-stream-name-prefix 2015
```
Ausgabe:
```
{
"logStreams": [
{
"creationTime": 1433189871774,
"arn": "arn:aws:logs:us-west-2:0123456789012:log-group:my-logs:log-stream:20150531",
"logStreamName": "20150531",
"storedBytes": 0
},
{
"creationTime": 1433189873898,
"arn": "arn:aws:logs:us-west-2:0123456789012:log-group:my-logs:log-stream:20150601",
"logStreamName": "20150601",
"storedBytes": 0
}
]
}
```
+ Einzelheiten zur API finden Sie [DescribeLogStreams](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/describe-log-streams.html)in der *AWS CLI Befehlsreferenz*.
### `get-log-events`
Das folgende Codebeispiel zeigt die Verwendung`get-log-events`.
**AWS CLI**
Der folgende Befehl ruft Protokollereignisse aus einem Protokollstream mit dem Namen `20150601` in der Protokollgruppe `my-logs` ab:
```
aws logs get-log-events --log-group-name my-logs --log-stream-name 20150601
```
Ausgabe:
```
{
"nextForwardToken": "f/31961209122447488583055879464742346735121166569214640130",
"events": [
{
"ingestionTime": 1433190494190,
"timestamp": 1433190184356,
"message": "Example Event 1"
},
{
"ingestionTime": 1433190516679,
"timestamp": 1433190184356,
"message": "Example Event 1"
},
{
"ingestionTime": 1433190494190,
"timestamp": 1433190184358,
"message": "Example Event 2"
}
],
"nextBackwardToken": "b/31961209122358285602261756944988674324553373268216709120"
}
```
+ Einzelheiten zur API finden Sie [GetLogEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/get-log-events.html)in der *AWS CLI Befehlsreferenz*.
### `put-log-events`
Das folgende Codebeispiel zeigt die Verwendung`put-log-events`.
**AWS CLI**
Mit dem folgenden Befehl werden Protokollereignisse im Protokollstream `20150601` in der Protokollgruppe `my-logs` gespeichert:
```
aws logs put-log-events --log-group-name my-logs --log-stream-name 20150601 --log-events file://events
```
Ausgabe:
```
{
"nextSequenceToken": "49542672486831074009579604567656788214806863282469607346"
}
```
Mit dem obigen Beispiel wird ein JSON-Array von Ereignissen aus einer Datei mit dem Namen `events` im aktuellen Verzeichnis gelesen:
```
[
{
"timestamp": 1433190184356,
"message": "Example Event 1"
},
{
"timestamp": 1433190184358,
"message": "Example Event 2"
},
{
"timestamp": 1433190184360,
"message": "Example Event 3"
}
]
```
Für jeden nachfolgenden Aufruf muss das nächste Sequenz-Token, das vom vorherigen Aufruf bereitgestellt wurde, mit der Sequenz-Token-Option angegeben werden:
```
aws logs put-log-events --log-group-name my-logs --log-stream-name 20150601 --log-events file://events2 --sequence-token "49542672486831074009579604567656788214806863282469607346"
```
Ausgabe:
```
{
"nextSequenceToken": "49542672486831074009579604567900991230369019956308219826"
}
```
+ Einzelheiten zur API finden Sie [PutLogEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/put-log-events.html)in der *AWS CLI Befehlsreferenz*.
### `put-retention-policy`
Das folgende Codebeispiel zeigt die Verwendung`put-retention-policy`.
**AWS CLI**
Mit dem folgenden Befehl wird einer Protokollgruppe mit dem Namen `my-logs` eine Aufbewahrungsrichtlinie für 5 Tage hinzugefügt:
```
aws logs put-retention-policy --log-group-name my-logs --retention-in-days 5
```
+ Einzelheiten zur API finden Sie [PutRetentionPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/put-retention-policy.html)in der *AWS CLI Befehlsreferenz*.