# Atualizar a versão da extensão do Lambda Insights em uma função
Como prática recomendada, recomendamos manter a sua extensão do Lambda Insights atualizada com a versão mais recente. Os tópicos nesta página explicam como atualizá-la.
**nota**
Esta página explica como atualizar a versão da extensão usada por uma função que já está usando o Lambda Insights. Para obter mais informações sobre como começar a usar o Lambda Insights, consulte [Conceitos básicos do Lambda Insights](Lambda-Insights-Getting-Started.md).
## Usar o console do Lambda para atualizar a versão da extensão do Lambda Insights
Siga as etapas a seguir para usar o console do Lambda para atualizar a versão da extensão do Lambda Insights.
**Para atualizar usando o console do Lambda**
1. Abra o console AWS Lambda em [https://console.aws.amazon.com/lambda/](https://console.aws.amazon.com/lambda/).
1. Escolha o nome da sua função.
1. Na seção **Camadas**, escolha **Editar**.
1. Na lista de camadas, pesquise por **LambdaInsightsExtension** e, em seguida, altere a versão da camada para a versão mais recente listada em [Versões disponíveis da extensão do Lambda Insights](Lambda-Insights-extension-versions.md).
1. Escolha **Salvar**.
## Usar a AWS CLI para atualizar a versão da extensão do Lambda Insights
Para usar a AWS CLI para atualizar a versão da extensão do Lambda Insights, insira o comando a seguir. Substitua o valor do ARN pelo parâmetro de camadas com o ARN correspondente à sua região e à versão da extensão que você deseja usar. Para obter informações sobre a versão mais recente da camada de extensão do Lambda Insights, consulte [Versões disponíveis da extensão do Lambda Insights](Lambda-Insights-extension-versions.md).
```
aws lambda update-function-configuration \
--function-name function-name \
--layers "arn:aws:lambda:us-west-1:111122223333:layer:LambdaInsightsExtension:53"
```
## Usar a CLI do AWS SAM para atualizar a extensão do Lambda Insights em uma ou mais funções
Para atualizar a versão da extensão do Lambda Insights para todas as funções do Lambda, atualize a propriedade `Layers` na seção `Globals` do seu modelo do AWS Serverless Application Model (SAM) com o ARN da camada do Lambda Insights. Para obter informações sobre a versão mais recente da camada de extensão do Lambda Insights, consulte [Versões disponíveis da extensão do Lambda Insights](Lambda-Insights-extension-versions.md).
O exemplo a seguir atualiza todas as suas funções do Lambda.
```
Globals:
Function:
Layers:
- !Sub "arn:aws:lambda:${AWS::Region}:111122223333:layer:LambdaInsightsExtension:53"
```
O exemplo a seguir atualiza apenas uma função.
```
Resources:
MyFunction:
Type: AWS::Serverless::Function
Properties:
Layers:
- !Sub "arn:aws:lambda:${AWS::Region}:111122223333:layer:LambdaInsightsExtension:53"
```
## Usar a CLI do CloudFormation para atualizar a extensão do Lambda Insights em uma ou mais funções
Para atualizar a versão da extensão do Lambda Insights usando o CloudFormation, atualize a camada de extensão na propriedade `Layers` no recurso do CloudFormation da função, como no exemplo a seguir. Para obter informações sobre a versão mais recente da camada de extensão do Lambda Insights, consulte [Versões disponíveis da extensão do Lambda Insights](Lambda-Insights-extension-versions.md).
```
Resources:
MyFunction:
Type: AWS::Lambda::Function
Properties:
Layers:
- !Sub "arn:aws:lambda:${AWS::Region}:111122223333:layer:LambdaInsightsExtension:53"
```
## Usar o AWS CDK para atualizar a extensão do Lambda Insights em uma ou mais funções
Você pode atualizar a versão da extensão na função do Lambda substituindo o valor do ARN pelo parâmetro `layerArn` com o ARN correspondente à sua região e à versão da extensão que você deseja usar. Para obter informações sobre a versão mais recente da camada de extensão do Lambda Insights, consulte [Versões disponíveis da extensão do Lambda Insights](Lambda-Insights-extension-versions.md).
```
import lambda = require('@aws-cdk/aws-lambda');
const layerArn = 'arn:aws:lambda:us-west-1:111122223333:layer:LambdaInsightsExtension:53';
const layer = lambda.LayerVersion.fromLayerVersionArn(this, 'LayerFromArn', layerArn);
```
## Usar Framework Sem Servidor para atualizar a extensão do Lambda Insights em uma ou mais funções
Siga estas etapas para usar Framework Sem Servidor para atualizar a versão da extensão do Lambda Insights em uma função existente do Lambda. Para obter mais informações sobre Framework Sem Servidor, acesse a [documentação de Framework Sem Servidor](https://serverless.com).
Esse método usa um plug-in do Lambda Insights para Sem Servidor. Para obter mais informações, consulte [serverless-plugin-lambda-insights](https://www.npmjs.com/package/serverless-plugin-lambda-insights).
Se você ainda não tem a versão mais recente da interface de linha de comando de tecnologia sem servidor instalada, é necessário primeiro instalá-la ou atualizá-la. Para obter mais informações, consulte [Setting Up Serverless Framework With AWS](https://www.serverless.com/framework/docs/getting-started/).
**Para atualizar usando o console do Lambda**
1. Atualize o Lambda Insights. Caso ainda não tenha atualizado, adicione uma seção `custom` no final do arquivo e especifique a versão do Lambda Insights dentro de uma propriedade `lambdaInsightsVersion`.
```
custom:
lambdaInsights:
lambdaInsightsVersion: 53 #specify the Layer Version
```
1. Implante novamente o serviço sem servidor inserindo o comando a seguir.
```
serverless deploy
```
## Atualizar a versão da extensão do Lambda Insights em uma implantação de imagem de contêiner do Lambda
Para atualizar o Lambda Insights em uma imagem de contêiner do Lambda, siga as etapas em [Habilitar o Lambda Insights em uma implantação de imagem de contêiner do Lambda](Lambda-Insights-Getting-Started-docker.md) para recriar a imagem com a versão mais recente do Lambda Insights. Em seguida, use a AWS CLI para [atualizar o código da função](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/update-function-code.html) e fornecer um URI de imagem de contêiner como o valor para o parâmetro `--image-uri`.