sam logs

Esta página proporciona información de referencia para el AWS Serverless Application Model comando Command Line Interface (AWS SAMCLI)sam logs.

Para obtener una introducción al AWS SAMCLI, consulte¿Qué es el? AWS SAMCLI.

El sam logs comando busca los registros generados por sus AWS Lambda funciones.

Uso

$ sam logs <options>

Opciones

--config-env TEXT

El nombre del entorno que especifica los valores de los parámetros predeterminados del archivo de configuración que se va a utilizar. El valor por defecto es “predeterminado”. Para obtener más información sobre los archivos de configuración, consulte Archivo de configuración de la CLI de AWS SAM.

--config-file PATH

La ruta y el nombre del archivo de configuración que contiene los valores de parámetros predeterminados que se van a utilizar. El valor predeterminado es “samconfig.toml” en la raíz del directorio del proyecto. Para obtener más información sobre los archivos de configuración, consulte Archivo de configuración de la CLI de AWS SAM.

--cw-log-group LIST

Incluye los registros de CloudWatch los grupos de registros que especifique. Si especifica esta opción junto conname, AWS SAM incluye los registros de los grupos de registros especificados, además de los registros de los recursos nombrados.

--debug

Activa el registro de depuración para imprimir el mensaje de depuración que genera la CLI de AWS SAM y muestra las marcas temporales.

---end-time, e TEXT

Recupera los registros hasta este momento. La hora puede estar formada con valores relativos como “Hace 5 minutos”, “mañana” o una marca de tiempo con formato como “01-01-2018 10:10:10”.

--filter TEXT

Permite especificar una expresión para encontrar rápidamente registros que coincidan con términos, frases o valores en los eventos de registro. Puede ser una palabra clave simple (por ejemplo, «error») o un patrón compatible con Amazon CloudWatch Logs. Para obtener información sobre la sintaxis, consulte la documentación de Amazon CloudWatch Logs.

--help

Muestra este mensaje y sale.

--include-traces

Incluye los seguimientos de X-Ray en la salida del registro.

--name, -n TEXT

El nombre del recurso según el cual se van a buscar los registros. Si este recurso forma parte de una AWS CloudFormation pila, puede ser el ID lógico del recurso de la función en la AWS SAM plantilla AWS CloudFormation/. Para proporcionar varios nombres, repita de nuevo el parámetro. Si el recurso está en una pila anidada, el nombre puede ir precedido del nombre de la pila anidada para extraer los registros de ese recurso (/). NestedStackLogicalId ResourceLogicalId Si no se proporciona el nombre del recurso, se escaneará la pila en cuestión y se extraerá la información de registro de todos los recursos compatibles. Si no especificas esta opción, AWS SAM busca los registros de todos los recursos de la pila que especifiques. Los tipos de recurso siguientes son compatibles:

• 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 el formato de salida de los registros. Para imprimir registros formateados, especifique text. Para imprimir los registros como JSON, especifique json.

--profile TEXT

El perfil específico del archivo de credenciales que obtiene AWS las credenciales.

--region TEXT

La AWS región en la que se va a realizar el despliegue. Por ejemplo, us-east-1.

--save-params

Guarde los parámetros que proporcione en la línea de comandos en el archivo AWS SAM de configuración.

--stack-name TEXT

El nombre de la AWS CloudFormation pila de la que forma parte el recurso.

--start-time, -s TEXT

Recupera los registros que comienzan en este momento. La hora puede estar formada con valores relativos como “Hace 5 minutos”, “ayer” o una marca de tiempo con formato como “01-01-2018 10:10:10”. El valor predeterminado es “Hace 10 minutos”.

--tail, -t

Sigue la salida del registro. Esto ignora el argumento de la hora de finalización y continúa buscando los registros a medida que están disponibles.

Ejemplos

Cuando las funciones forman parte de una AWS CloudFormation pila, puede recuperar los registros mediante el ID lógico de la función al especificar el nombre de la pila.

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

Consulte los registros de un intervalo de tiempo específico mediante las opciones -s (--start-time) y -e (--end-time).

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

También puede agregar la opción --tail para esperar a que lleguen nuevos registros y verlos a medida que lleguen.

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

Utilice la opción --filter para encontrar rápidamente registros que coincidan con términos, frases o valores de sus eventos de registro.

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

Vea los registros de un recurso en una pila secundaria.

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

Registros finales de todos los recursos compatibles con la aplicación.

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

Obtenga los registros de una función de Lambda específica y de la API correspondiente a API Gateway de su aplicación.

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

Obtenga los registros de todos los recursos admitidos en su aplicación y, además, de los grupos de registros especificados.

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