sam logs

Questa pagina fornisce informazioni di riferimento per il AWS Serverless Application Model comando Command Line Interface (AWS SAMCLI)sam logs.

Per un'introduzione a AWS SAMCLI, vedereChe cos'è il? AWS SAMCLI.

Il sam logs comando recupera i log generati dalle tue AWS Lambda funzioni.

Utilizzo

$ sam logs <options>

Opzioni

--config-env TEXT

Il nome dell'ambiente che specifica i valori dei parametri predefiniti nel file di configurazione da utilizzare. Il valore predefinito è «default». Per ulteriori informazioni sui file di configurazione, consulta AWS SAMCLIfile di configurazione.

--config-file PATH

Il percorso e il nome del file di configurazione contenente i valori dei parametri predefiniti da utilizzare. Il valore predefinito è «samconfig.toml» nella radice della directory del progetto. Per ulteriori informazioni sui file di configurazione, consulta AWS SAMCLIfile di configurazione.

--cw-log-group LIST

Include i log dei gruppi di CloudWatch log Logs specificati. Se si specifica questa opzione insieme aname, AWS SAM include i registri dei gruppi di log specificati oltre ai registri delle risorse denominate.

--debug

Attiva la registrazione di debug per stampare il messaggio di debug generato dai timestamp e visualizzarli. AWS SAMCLI

---end-time, e TEXT

Recupera i log aggiornati a quest'ora. L'ora può essere costituita da valori relativi come «5 minuti fa», «domani» o un timestamp formattato come «2018-01-01 10:10:10».

--filter TEXT

Consente di specificare un'espressione per trovare rapidamente i log che corrispondono a termini, frasi o valori negli eventi di registro. Può trattarsi di una semplice parola chiave (ad esempio «errore») o di un pattern supportato da Amazon CloudWatch Logs. Per la sintassi, consulta la documentazione di Amazon CloudWatch Logs.

--help

Mostra questo messaggio ed esce.

--include-traces

Include tracce X-Ray nell'output del registro.

--name, -n TEXT

Il nome della risorsa per la quale recuperare i log. Se questa risorsa fa parte di uno AWS CloudFormation stack, può essere l'ID logico della risorsa funzionale nel AWS CloudFormation modello /.AWS SAM È possibile fornire più nomi ripetendo nuovamente il parametro. Se la risorsa si trova in uno stack nidificato, al nome può essere aggiunto il nome dello stack nidificato per estrarre i log da quella risorsa (/). NestedStackLogicalId ResourceLogicalId Se il nome della risorsa non viene fornito, lo stack specificato verrà scansionato e verranno recuperate le informazioni di registro per tutte le risorse supportate. Se non specificate questa opzione, AWS SAM recupera i log per tutte le risorse nello stack specificato. Sono supportati i seguenti tipi di risorse:

• 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

Speciifica il formato di output per i registri. Per stampare registri formattati, specificare. text Per stampare i log come JSON, specificare. json

--profile TEXT

Il profilo specifico del file delle credenziali che ottiene le credenziali. AWS

--region TEXT

La AWS regione in cui effettuare la distribuzione. Ad esempio, us-east-1.

--save-params

Salva i parametri forniti dalla riga di comando nel file di AWS SAM configurazione.

--stack-name TEXT

Il nome dello AWS CloudFormation stack di cui fa parte la risorsa.

--start-time, -s TEXT

Recupera i log a partire da questo momento. L'ora può essere costituita da valori relativi come «5 minuti fa», «ieri» o un timestamp formattato come «2018-01-01 10:10:10». Il valore predefinito è «10 minuti fa».

--tail, -t

Coordina l'output del registro. Questo ignora l'argomento dell'ora di fine e continua a recuperare i log non appena diventano disponibili.

Esempi

Quando le funzioni fanno parte di uno AWS CloudFormation stack, puoi recuperare i log utilizzando l'ID logico della funzione quando specifichi il nome dello stack.

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

Visualizza i log per un intervallo di tempo specifico utilizzando le opzioni -s (--start-time) e -e (--end-time).

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

Puoi anche aggiungere l'--tailopzione per attendere nuovi log e vederli man mano che arrivano.

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

Utilizza l'--filteropzione per trovare rapidamente i log che corrispondono a termini, frasi o valori nei tuoi eventi di registro.

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

Visualizza i log di una risorsa in uno stack secondario.

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

Registri di coda per tutte le risorse supportate nell'applicazione.

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

Recupera i log per una funzione Lambda specifica e l'API API Gateway nella tua applicazione.

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

Recupera i log per tutte le risorse supportate nell'applicazione e, in aggiunta, dai gruppi di log specificati.

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