sam logs - AWS Serverless Application Model

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

Obtiene los registros generados por la función Lambda.

Cuando tus funciones forman parte de unAWS CloudFormationstack, puede obtener registros utilizando el ID lógico de la función cuando especifique el nombre de la pila.

Uso:

sam logs [OPTIONS]

Ejemplos:

sam logs -n HelloWorldFunction --stack-name mystack # You can view logs for a specific time range using the -s (--start-time) and -e (--end-time) options sam logs -n HelloWorldFunction --stack-name mystack -s '10min ago' -e '2min ago' # You can also add the --tail option to wait for new logs and see them as they arrive. sam logs -n HelloWorldFunction --stack-name mystack --tail # Use the --filter option to quickly find logs that match terms, phrases or values in your log events. sam logs -n HelloWorldFunction --stack-name mystack --filter "error" # View the logs for a resource in a child stack. sam logs --stack-name mystack -n childstack/HelloWorldFunction # Tail logs for all supported resources in your application. sam logs --stack-name sam-app --tail # Fetch logs for a specific Lambda function and API Gateway API in your application. sam logs --stack-name sam-app --name HelloWorldFunction --name HelloWorldRestApi # Fetch logs for all supported resources in your application, and additionally from the specified log groups. sam logs --cw-log-group /aws/lambda/myfunction-123 --cw-log-group /aws/lambda/myfunction-456

Opciones:

Opción Descripción
-n, --name TEXT El nombre del recurso para el que desea obtener registros. Si este recurso forma parte de unAWS CloudFormationstack, este puede ser el ID lógico del recurso de función en elAWS CloudFormation/AWS SAMplantilla. Se pueden proporcionar varios nombres repitiendo el parámetro de nuevo. Si el recurso se encuentra en una pila anidada, el nombre puede ir prependido por el nombre del nombre de la pila anidada para extraer registros de ese recurso (NestedStackLogicalId/ResourceLogicalId). Si no se proporciona el nombre del recurso, se escaneará la pila dada y se extraerá información de registro de todos los recursos admitidos. Si no especifica esta opción,AWS SAMobtiene registros de todos los recursos de la pila que especifique. Se admiten los siguientes tipos de recursos:
  • AWS::Serverless::Function

  • AWS::Lambda::Function

  • AWS::Serverless::Api

  • AWS::ApiGateway::RestApi

  • AWS::Serverless::HttpApi

  • AWS::ApiGatewayV2::Api

  • AWS::Serverless::StateMachine

  • AWS::StepFunctions::StateMachine

--stack-name TEXT El nombre delAWS CloudFormationpila de la que forma parte el recurso.
--filter TEXT Permite especificar una expresión para encontrar rápidamente registros que coincidan con términos, frases o valores incluidos en los eventos de registro. Puede ser una palabra clave simple (por ejemplo, «error») o un patrón compatible con Amazon CloudWatch Registros. Para obtener información sobre la sintaxis, consulte laAmazon CloudWatch Documentación de registros.
-s, --start-time TEXT Obtiene registros a partir de este momento. El tiempo puede ser valores relativos como «Hace 5 minutos», «ayer» o una marca de tiempo formateada como «2018-01-01 10:10:10». Por defecto es «hace 10 minutos».
-e, --end-time TEXT Obtiene registros hasta este momento. La hora puede ser valores relativos como «Hace 5 minutos», «mañana» o una marca de tiempo formateada como «2018-01-01 10:10:10».
--profile TEXT El perfil específico del archivo de credenciales que obtieneAWSCredenciales de .
--region TEXT LaAWSRegión en la que desea realizar la implementación. Por ejemplo, us-east-1.
-t, --tail Realiza la salida del registro. Esto ignora el argumento de la hora de finalización y continúa obteniendo registros a medida que están disponibles.
--include-traces

Incluye rastros de rayos X en la salida del registro.

--output TEXT

Especifica el formato de salida de los registros. Para imprimir registros con formato, especifiquetext. Para imprimir los registros como JSON, especifiquejson.

--cw-log-group LIST Incluye registros del CloudWatch Registra los grupos de registros que especifique. Si especifica esta opción junto conname,AWS SAMincluye registros de los grupos de registros especificados además de registros de los recursos con nombre.
--config-file PATH Ruta y nombre del archivo de configuración que contiene 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 AWS SAMArchivo de configuración de la CLI.
--config-env TEXT El nombre del entorno que especifica los valores de parámetros predeterminados en el archivo de configuración que se va a utilizar. El valor predeterminado es «predeterminado». Para obtener más información sobre los archivos de configuración, consulte AWS SAMArchivo de configuración de la CLI.
--debug Activa el registro de depuración para imprimir el mensaje de depuración generado por elAWS SAMCLI y marcas de hora de visualización.
--help Muestra este mensaje y termina.