sam logs

Esta página fornece informações de referência para o AWS Serverless Application Model comando Command Line Interface (AWS SAMCLI)sam logs.

Para obter uma introdução ao AWS SAMCLI, consulteO que é o AWS SAMCLI?.

O sam logs comando busca registros que são gerados por suas AWS Lambda funções.

Uso

$ sam logs <options>

Opções

--config-env TEXT

O nome do ambiente que especifica os valores de parâmetros padrão no arquivo de configuração a serem usados. O valor padrão é “padrão”. Para obter mais informações sobre esses arquivos de configuração, consulte Arquivo de configuração do AWS SAM CLI.

--config-file PATH

O caminho e o nome do arquivo de configuração contendo valores de parâmetros padrão a serem usados. O valor padrão é “samconfig.toml” na raiz do diretório do projeto. Para obter mais informações sobre esses arquivos de configuração, consulte Arquivo de configuração do AWS SAM CLI.

--cw-log-group LIST

Inclui registros dos grupos de CloudWatch registros de registros que você especifica. Se você especificar essa opção junto comname, AWS SAM incluirá registros dos grupos de registros especificados, além dos registros dos recursos nomeados.

--debug

Ativa o registro de depuração para imprimir a mensagem de depuração gerada pelo AWS SAMCLI e exibir timestamps.

---end-time, e TEXT

Busca registros até agora. A hora pode ser valores relativos, como '5 minutos atrás', 'amanhã' ou um carimbo de data/hora formatado como '2018-01-01 10:10:10'.

--filter TEXT

Permite especificar uma expressão para encontrar rapidamente registros que correspondam a termos, frases ou valores nos seus eventos de log. Isso pode ser uma palavra-chave simples (por exemplo, “erro”) ou um padrão compatível com o Amazon CloudWatch Logs. Para a sintaxe, consulte a documentação do Amazon CloudWatch Logs.

--help

Mostra esta mensagem e sai.

--include-traces

Inclui traços de X-Ray na saída do log.

--name, -n TEXT

O nome do recurso para o qual buscar registros. Se esse recurso fizer parte de uma AWS CloudFormation pilha, esse pode ser o ID lógico do recurso da função no AWS SAM modelo AWS CloudFormation/. Vários nomes podem ser fornecidos repetindo o parâmetro novamente. Se o recurso estiver em uma pilha aninhada, o nome poderá ser precedido pelo nome da pilha aninhada para extrair registros desse recurso (/). NestedStackLogicalId ResourceLogicalId Se o nome do recurso não for fornecido, a pilha fornecida será verificada e as informações de registro serão extraídas de todos os recursos compatíveis. Se você não especificar essa opção, AWS SAM buscará os registros de todos os recursos na pilha especificada. Os seguintes tipos de registro são compatíveis:

• 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

Especifica o formato de saída para logs. Para imprimir registros formatados, especifiquetext. Para imprimir os registros como JSON, especifique json.

--profile TEXT

O perfil específico do seu arquivo de credenciais que obtém as AWS credenciais.

--region TEXT

A AWS região para a qual implantar. Por exemplo, us-east-1.

--save-params

Salve os parâmetros fornecidos na linha de comando no arquivo AWS SAM de configuração.

--stack-name TEXT

O nome da AWS CloudFormation pilha da qual o recurso faz parte.

--start-time, -s TEXT

Busca registros a partir desse momento. A hora pode ser valores relativos, como '5 minutos atrás', 'ontem' ou um carimbo de data/hora formatado como '2018-01-01 10:10:10'. O padrão é '10 minutos atrás'.

--tail, -t

Encerra a saída do log. Isso ignora o argumento de horário de término e continua a buscar os registros à medida que eles se tornam disponíveis.

Exemplos

Quando suas funções fazem parte de uma AWS CloudFormation pilha, você pode buscar registros usando o ID lógico da função ao especificar o nome da pilha.

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

Visualize os registros de um intervalo de tempo específico usando as opções -s (--start-time) e -e (--end-time).

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

Você também pode adicionar a opção --tail de aguardar novos registros e vê-los à medida que chegam.

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

Use a opção --filter para encontrar rapidamente os logs que correspondem a determinados termos, frases ou valores nos eventos de log.

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

Visualize os registros de um recurso em uma pilha secundária.

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

Registros finais de todos os recursos compatíveis em seu aplicativo.

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

Busque registros de uma função do Lambda específica e da API Gateway API em seu aplicativo.

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

Busque registros de todos os recursos compatíveis em seu aplicativo e, além disso, dos grupos de registros especificados.

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