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.

# sam logs
<a name="sam-cli-command-reference-sam-logs"></a>

Diese Seite enthält Referenzinformationen für den AWS Serverless Application Model Befehl Command Line Interface (AWS SAMCLI)`sam logs`.

Eine Einführung in den finden AWS SAMCLI Sie unter [Was ist das? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)

Der `sam logs` Befehl ruft Protokolle ab, die von Ihren AWS Lambda Funktionen generiert wurden.

## Usage
<a name="sam-cli-command-reference-sam-logs-usage"></a>

```
$ sam logs <options>
```

## Optionen
<a name="sam-cli-command-reference-sam-logs-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-logs-options-config-env"></a>
Der Umgebungsname, der die Standardparameterwerte in der zu verwendenden Konfigurationsdatei angibt. Der Standardwert ist „default“. Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-logs-options-config-file"></a>
Der Pfad und der Dateiname der Konfigurationsdatei, die die zu verwendenden Standardparameterwerte enthält. Der Standardwert ist „samconfig.toml“ im Stammverzeichnis des Projektverzeichnisses. Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--cw-log-group LIST`  <a name="sam-cli-command-reference-sam-logs-options-cw-log-group"></a>
Schließt Protokolle aus den von Ihnen angegebenen CloudWatch Logs-Protokollgruppen ein. Wenn Sie diese Option zusammen mit angeben`name`, AWS SAM werden zusätzlich zu den Protokollen der genannten Ressourcen auch Protokolle aus den angegebenen Protokollgruppen eingeschlossen.

`--debug`  <a name="sam-cli-command-reference-sam-logs-options-debug"></a>
Aktiviert die Debug-Protokollierung, um die von den generierten Debug-Nachrichten zu drucken AWS SAMCLI und Zeitstempel anzuzeigen.

`---end-time, e TEXT`  <a name="sam-cli-command-reference-sam-logs-options-end-time"></a>
Ruft Protokolle bis zu diesem Zeitpunkt ab. Bei der Uhrzeit kann es sich um relative Werte wie „vor 5 Minuten“, „Morgen“ oder um einen formatierten Zeitstempel wie „2018-01-01 10:10:10“ handeln.

`--filter TEXT`  <a name="sam-cli-command-reference-sam-logs-options-filter"></a>
Ermöglicht die Angabe eines Ausdrucks, um schnell Logs zu finden, die Begriffen, Ausdrücken oder Werten in Ihren Protokollereignissen entsprechen. Dies kann ein einfaches Schlüsselwort (z. B. „Fehler“) oder ein Muster sein, das von Amazon CloudWatch Logs unterstützt wird. Die Syntax finden Sie in der [Amazon CloudWatch Logs-Dokumentation](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/FilterAndPatternSyntax.html).

`--help`  <a name="sam-cli-command-reference-sam-logs-options-help"></a>
Zeigt diese Meldung an und wird beendet.

`--include-traces`  <a name="sam-cli-command-reference-sam-logs-options-include-traces"></a>
Schließt Röntgenspuren in die Protokollausgabe ein.

`--name, -n TEXT`  <a name="sam-cli-command-reference-sam-logs-options-name"></a>
Der Name der Ressource, für die Protokolle abgerufen werden sollen. Wenn diese Ressource Teil eines CloudFormation Stacks ist, kann dies die logische ID der Funktionsressource in der AWS SAM Vorlage CloudFormation/sein. Durch erneutes Wiederholen des Parameters können mehrere Namen angegeben werden. Wenn sich die Ressource in einem verschachtelten Stapel befindet, kann dem Namen der Name des geschachtelten Stacks vorangestellt werden, um Protokolle von dieser Ressource abzurufen (/). NestedStackLogicalId ResourceLogicalId Wenn der Ressourcenname nicht angegeben ist, wird der angegebene Stapel gescannt und es werden Protokollinformationen für alle unterstützten Ressourcen abgerufen. Wenn Sie diese Option nicht angeben, werden Protokolle für alle Ressourcen im AWS SAM Stapel abgerufen, die Sie angeben. Die folgenden Ressourcentypen werden unterstützt:  
+ `AWS::Serverless::Function`
+ `AWS::Lambda::Function`
+ `AWS::Serverless::Api`
+ `AWS::ApiGateway::RestApi`
+ `AWS::Serverless::HttpApi`
+ `AWS::ApiGatewayV2::Api`
+ `AWS::Serverless::StateMachine`
+ `AWS::StepFunctions::StateMachine`

`--output TEXT`  <a name="sam-cli-command-reference-sam-logs-options-output"></a>
Gibt das Ausgabeformat für Protokolle an. Um formatierte Protokolle zu drucken, geben Sie an`text`. Um die Protokolle als JSON zu drucken, geben Sie an`json`.

`--profile TEXT`  <a name="sam-cli-command-reference-sam-logs-options-profile"></a>
Das spezifische Profil aus Ihrer Anmeldeinformationsdatei, das die AWS Anmeldeinformationen abruft.

`--region TEXT`  <a name="sam-cli-command-reference-sam-logs-options-region"></a>
Die AWS Region, in der die Bereitstellung erfolgen soll. Beispiel: us-east-1.

`--save-params`  <a name="sam-cli-command-reference-sam-logs-options-save-params"></a>
Speichern Sie die Parameter, die Sie in der Befehlszeile angeben, in der AWS SAM Konfigurationsdatei.

`--stack-name TEXT`  <a name="sam-cli-command-reference-sam-logs-options-stack-name"></a>
Der Name des CloudFormation Stacks, zu dem die Ressource gehört.

`--start-time, -s TEXT`  <a name="sam-cli-command-reference-sam-logs-options-start-time"></a>
Ruft Logs ab diesem Zeitpunkt ab. Bei der Uhrzeit kann es sich um relative Werte wie „vor 5 Minuten“, „Gestern“ oder um einen formatierten Zeitstempel wie „2018-01-01 10:10:10“ handeln. Der Standardwert ist 'vor 10 Minuten'.

` --tail, -t`  <a name="sam-cli-command-reference-sam-logs-options-tail"></a>
Verfolgt die Protokollausgabe. Dadurch wird das Endzeitargument ignoriert und es werden weiterhin Protokolle abgerufen, sobald sie verfügbar sind.

## Beispiele
<a name="sam-cli-command-reference-sam-logs-examples"></a>

Wenn Ihre Funktionen Teil eines CloudFormation Stacks sind, können Sie Protokolle abrufen, indem Sie bei der Angabe des Stack-Namens die logische ID der Funktion verwenden.

```
$ sam logs -n HelloWorldFunction --stack-name myStack
```

Mithilfe der Optionen -s (--start-time) und -e (--end-time) können Sie Logs für einen bestimmten Zeitraum anzeigen.

```
$ sam logs -n HelloWorldFunction --stack-name myStack -s '10min ago' -e '2min ago'
```

Sie können auch die `--tail` Option hinzufügen, auf neue Protokolle zu warten und sie zu sehen, sobald sie eintreffen.

```
$ sam logs -n HelloWorldFunction --stack-name myStack --tail
```

Verwenden Sie `--filter` diese Option, um schnell nach Protokollen zu suchen, die Begriffen, Ausdrücken oder Werten in Ihren Protokollereignissen entsprechen.

```
$ sam logs -n HelloWorldFunction --stack-name myStack --filter "error"
```

Die Protokolle für eine Ressource in einem untergeordneten Stapel anzeigen.

```
$ sam logs --stack-name myStack -n childStack/HelloWorldFunction
```

Protokolldateien für alle unterstützten Ressourcen in Ihrer Anwendung.

```
$ sam logs --stack-name sam-app --tail
```

Rufen Sie Protokolle für eine bestimmte Lambda-Funktion und API Gateway Gateway-API in Ihrer Anwendung ab.

```
$ sam logs --stack-name sam-app --name HelloWorldFunction --name HelloWorldRestApi
```

Rufen Sie Protokolle für alle unterstützten Ressourcen in Ihrer Anwendung und zusätzlich aus den angegebenen Protokollgruppen ab.

```
$ sam logs --cw-log-group /aws/lambda/myfunction-123 --cw-log-group /aws/lambda/myfunction-456
```