sam logs

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 unterWas ist das? AWS SAMCLI.

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

Verwendung

$ sam logs <options>

Optionen

--config-env TEXT

Der Umgebungsname, der die Standardparameterwerte in der zu verwendenden Konfigurationsdatei angibt. Der Standardwert ist „default“. Weitere Informationen zu Konfigurationsdateien finden Sie unter AWS SAMCLIKonfigurationsdatei.

--config-file PATH

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.

--cw-log-group LIST

Schließt Protokolle aus den von Ihnen angegebenen CloudWatch Logs-Protokollgruppen ein. Wenn Sie diese Option zusammen mit angebenname, AWS SAM werden zusätzlich zu den Protokollen der genannten Ressourcen auch Protokolle aus den angegebenen Protokollgruppen eingeschlossen.

--debug

Aktiviert die Debug-Protokollierung, um die von den generierten Debug-Nachrichten zu drucken AWS SAMCLI und Zeitstempel anzuzeigen.

---end-time, e TEXT

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

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.

--help

Zeigt diese Meldung an und wird beendet.

--include-traces

Schließt Röntgenspuren in die Protokollausgabe ein.

--name, -n TEXT

Der Name der Ressource, für die Protokolle abgerufen werden sollen. Wenn diese Ressource Teil eines AWS CloudFormation Stacks ist, kann dies die logische ID der Funktionsressource in der AWS SAM Vorlage AWS 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

Gibt das Ausgabeformat für Protokolle an. Um formatierte Protokolle zu drucken, geben Sie antext. Um die Protokolle als JSON zu drucken, geben Sie anjson.

--profile TEXT

Das spezifische Profil aus Ihrer Anmeldeinformationsdatei, das die AWS Anmeldeinformationen abruft.

--region TEXT

Die AWS Region, in der die Bereitstellung erfolgen soll. Beispiel: us-east-1.

--save-params

Speichern Sie die Parameter, die Sie in der Befehlszeile angeben, in der AWS SAM Konfigurationsdatei.

--stack-name TEXT

Der Name des AWS CloudFormation Stacks, zu dem die Ressource gehört.

--start-time, -s TEXT

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

Verfolgt die Protokollausgabe. Dadurch wird das Endzeitargument ignoriert und es werden weiterhin Protokolle abgerufen, sobald sie verfügbar sind.

Beispiele

Wenn Ihre Funktionen Teil eines AWS 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