sam logs - AWS Serverless Application Model
UsoOpcionesEjemplos

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

sam logs

Esta página proporciona información de referencia para el comando sam logs de la Interfaz de línea de comando de AWS Serverless Application Model (AWS SAMCLI).

Para obtener una introducción a la CLI de AWS SAM, consulte ¿Qué es el? AWS SAMCLI.

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

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, consulta 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, consulta Archivo de configuración de la CLI de AWS SAM.

--cw-log-group LIST

Incluye registros de los grupos de registros de CloudWatch Logs que especifica. Si especificas esta opción junto con name, AWS SAM incluye los registros de los grupos de registros especificados, además de los registros de los recursos mencionados.

--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 Registros de Amazon CloudWatch. Para obtener información sobre la sintaxis, consulta la documentación de Registros de Amazon CloudWatch.

--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 pila CloudFormation, puede ser el ID lógico del recurso de la función en la plantilla CloudFormation/AWS SAM. Para proporcionar varios nombres, repita de nuevo el parámetro. Si el recurso está en una pila anidada, el nombre de esta 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 especifica esta opción, AWS SAM obtiene registros de todos los recursos de la pila que especifica. 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, especifica text. Para imprimir los registros como JSON, especifica json.

--profile TEXT

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

--region TEXT

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

--save-params

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

--stack-name TEXT

El nombre de la pila CloudFormation 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 pila CloudFormation, puede recuperar los registros mediante el identificador 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

Utiliza 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

Obtén 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

Obtén 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