AWS Lambda
Guia do desenvolvedor

Objeto de contexto do AWS Lambda no Go

Quando o Lambda executa sua função, ele transmite um objeto de contexto para o handler. Esse objeto fornece métodos e propriedades com informações sobre a invocação, a função e o ambiente de execução.

A biblioteca de contexto do Lambda fornece as seguintes variáveis globais, métodos e propriedades.

Variáveis globais

  • FunctionName – The name of the Lambda function.

  • FunctionVersion – The version of the function.

  • MemoryLimitInMB – The amount of memory configured on the function.

  • LogGroupName – The log group for the function.

  • LogStreamName – The log stream for the function instance.

Métodos de contexto

  • Deadline – Returns the date that the execution times out, in Unix time milliseconds.

Propriedades de contexto

  • InvokedFunctionArn – The Amazon Resource Name (ARN) used to invoke the function. Indicates if the invoker specified a version number or alias.

  • AwsRequestID – The identifier of the invocation request.

  • Identity – (mobile apps) Information about the Amazon Cognito identity that authorized the request.

  • ClientContext – (mobile apps) Client context provided to the Lambda invoker by the client application.

Acessar informações do contexto de invocação

As funções do Lambda têm acesso aos metadados sobre seu ambiente e a solicitação da invocação. Isso pode ser acessado no Contexto do pacote. Se o manipulador incluir context.Context como um parâmetro, o Lambda inserirá informações sobre sua função na propriedade Value do contexto. Observe que você precisa importar a biblioteca lambdacontext para acessar o conteúdo do objeto context.Context.

package main import ( "context" "log" "github.com/aws/aws-lambda-go/lambda" "github.com/aws/aws-lambda-go/lambdacontext" ) func CognitoHandler(ctx context.Context) { lc, _ := lambdacontext.FromContext(ctx) log.Print(lc.Identity.CognitoPoolID) } func main() { lambda.Start(CognitoHandler) }

No exemplo acima, lc é a variável usada para consumir as informações que o objeto de contexto capturou, e log.Print(lc.Identity.CognitoPoolID) imprime essas informações, neste caso, o CognitoPoolID.

Monitorar o tempo de execução de uma função

O exemplo a seguir mostra como usar o objeto de contexto para monitorar o tempo necessário para executar a função do Lambda. Isso permite que você analise as expectativas de desempenho e ajuste seu código de função de maneira correspondente, se necessário.

package main import ( "context" "log" "time" "github.com/aws/aws-lambda-go/lambda" ) func LongRunningHandler(ctx context.Context) (string, error) { deadline, _ := ctx.Deadline() deadline = deadline.Add(-100 * time.Millisecond) timeoutChannel := time.After(time.Until(deadline)) for { select { case <- timeoutChannel: return "Finished before timing out.", nil default: log.Print("hello!") time.Sleep(50 * time.Millisecond) } } } func main() { lambda.Start(LongRunningHandler) }