

Weitere AWS SDK-Beispiele sind im [AWS Doc SDK Examples ](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub Repo verfügbar.

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 Protokolliert Beispiele mit AWS CLI
<a name="cli_2_cloudwatch-logs_code_examples"></a>

Die folgenden Codebeispiele zeigen, wie Sie mithilfe von AWS Command Line Interface with CloudWatch Logs Aktionen ausführen und gängige 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
<a name="actions"></a>

### `create-log-group`
<a name="cloudwatch-logs_CreateLogGroup_cli_2_topic"></a>

Das folgende Codebeispiel zeigt die Verwendung`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}}
```
+  API-Details finden Sie [ CreateLogGroup ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/create-log-group.html) in der *AWS CLI Befehlsreferenz*. 

### `Log-Stream erstellen`
<a name="cloudwatch-logs_CreateLogStream_cli_2_topic"></a>

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}}
```
+  API-Details finden Sie [ CreateLogStream ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/create-log-stream.html) in der *AWS CLI Befehlsreferenz*. 

### `Protokollgruppe löschen`
<a name="cloudwatch-logs_DeleteLogGroup_cli_2_topic"></a>

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}}
```
+  API-Details finden Sie [ DeleteLogGroup ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/delete-log-group.html) in der *AWS CLI Befehlsreferenz*. 

### `log-stream löschen`
<a name="cloudwatch-logs_DeleteLogStream_cli_2_topic"></a>

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}}
```
+  API-Details finden Sie [ DeleteLogStream ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/delete-log-stream.html) in der *AWS CLI Befehlsreferenz*. 

### `Aufbewahrungsrichtlinie löschen`
<a name="cloudwatch-logs_DeleteRetentionPolicy_cli_2_topic"></a>

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}}
```
+  API-Details finden Sie [ DeleteRetentionPolicy ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/delete-retention-policy.html) in der *AWS CLI Befehlsreferenz*. 

### `Beschreiben Sie Protokollgruppen`
<a name="cloudwatch-logs_DescribeLogGroups_cli_2_topic"></a>

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:*"
        }
    ]
}
```
+  API-Details finden Sie [ DescribeLogGroups ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/describe-log-groups.html) in der *AWS CLI Befehlsreferenz*. 

### `Beschreiben Sie Log-Streams`
<a name="cloudwatch-logs_DescribeLogStreams_cli_2_topic"></a>

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
        }
    ]
}
```
+  API-Details 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`
<a name="cloudwatch-logs_GetLogEvents_cli_2_topic"></a>

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"
}
```
+  API-Details finden Sie [ GetLogEvents ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/get-log-events.html) in der *AWS CLI Befehlsreferenz*. 

### `Put-Log-Ereignisse`
<a name="cloudwatch-logs_PutLogEvents_cli_2_topic"></a>

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"
}
```
+  API-Details finden Sie [ PutLogEvents ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/put-log-events.html) in der *AWS CLI Befehlsreferenz*. 

### `Put-Retention-Richtlinie`
<a name="cloudwatch-logs_PutRetentionPolicy_cli_2_topic"></a>

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}}
```
+  API-Details finden Sie [ PutRetentionPolicy ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/put-retention-policy.html) in der *AWS CLI Befehlsreferenz*. 