

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 更新函式上的 Lambda Insights 延伸模組版本
<a name="Lambda-Insights-Update-Extension"></a>

最佳實務是，建議您始終將 Lambda Insights 延伸模組更新至最新版本。此頁面中的主題說明如何執行此操作。

**注意**  
此頁面說明如何更新已使用 Lambda Insights 的函式所使用的延伸模組版本。如需如何開始使用 Lambda Insights 的詳細資訊，請參閱[開始使用 Lambda Insights](Lambda-Insights-Getting-Started.md)。

## 使用 Lambda 主控台更新 Lambda Insights 延伸模組版本
<a name="Lambda-Insights-Update-Extension-console"></a>

依循下列步驟，使用 Lambda 主控台更新 Lambda Insights 延伸模組版本。

**使用 Lambda 主控台更新**

1. 在 https：//[https://console.aws.amazon.com/lambda/](https://console.aws.amazon.com/lambda/) 開啟 AWS Lambda 主控台。

1. 選擇 函數的名稱。

1. 在**圖層**區段中，選擇**編輯**。

1. 在圖層清單中，搜尋 **LambdaInsightsExtension**，然後將圖層版本變更為 [Lambda Insights 延伸的可用版本](Lambda-Insights-extension-versions.md) 中所列的最新版本。

1. 選擇**儲存**。

## 使用 AWS CLI 更新 Lambda Insights 延伸模組版本
<a name="Lambda-Insights-Update-Extension-CLI"></a>

若要使用 AWS CLI 更新 Lambda Insights 延伸版本，請輸入下列命令。將圖層參數的 ARN 值替換為與您的區域和您要使用的延伸模組版本相符的 ARN。如需 Lambda Insights 延伸模組圖層的最新發行版本相關資訊，請參閱 [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}}"
```

## 使用 AWS SAM CLI 更新一或多個函數上的 Lambda Insights 延伸
<a name="Lambda-Insights-Update-Extension-SAM-CLI"></a>

若要更新所有 Lambda 函數的 Lambda Insights 延伸版本，請使用 Lambda Insights 層的 ARN 更新無 AWS 伺服器應用程式模型 (SAM) 範本 `Globals`區段中的 `Layers` 屬性。如需 Lambda Insights 延伸模組圖層的最新發行版本相關資訊，請參閱 [Lambda Insights 延伸的可用版本](Lambda-Insights-extension-versions.md)。

下列程式碼用於更新所有 Lambda 函式。

```
Globals:
  Function:
    Layers:
       - !Sub "arn:aws:lambda:${AWS::Region}:{{111122223333}}:layer:LambdaInsightsExtension:{{53}}"
```

下列程式碼只會更新一個函式。

```
Resources:
  {{MyFunction}}:
    Type: AWS::Serverless::Function
    Properties:
      Layers:
        - !Sub "arn:aws:lambda:${AWS::Region}:{{111122223333}}:layer:LambdaInsightsExtension:{{53}}"
```

## CloudFormation 使用 在一或多個函數上更新 Lambda Insights 延伸模組
<a name="Lambda-Insights-Update-Extension-CloudFormation"></a>

若要使用 更新 Lambda Insights 延伸模組版本 CloudFormation，請在函數 CloudFormation 資源的 `Layers` 屬性中更新延伸模組層，如下列範例所示。如需 Lambda Insights 延伸模組圖層的最新發行版本相關資訊，請參閱 [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}}"
```

## 使用 AWS CDK 在一或多個函數上更新 Lambda Insights 延伸
<a name="Lambda-Insights-Update-Extension-CDK"></a>

您可以將 `layerArn` 參數的 ARN 值替換為與您的區域和要使用的延伸模組相符的 ARN，以更新 Lambda 函式的延伸模組版本。如需 Lambda Insights 延伸模組圖層的最新發行版本相關資訊，請參閱 [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);
```

## 使用 Serverless Framework 更新一個或多個函式的 Lambda Insights 延伸模組
<a name="Lambda-Insights-Update-Extension-Serverless"></a>

請依循以下步驟，使用 Serverless Framework 在現有的 Lambda 函式上更新 Lambda Insights 延伸模組版本。如需 Serverless Framework 的詳細資訊，請參閱 [Serverless Framework 文件](https://serverless.com)。

此方法使用適用於 Serverless 的 Lambda Insights 外掛程式。如需詳細資訊，請參閱 [serverless-plugin-lambda-insights](https://www.npmjs.com/package/serverless-plugin-lambda-insights)。

如果您尚未安裝最新版本的 Serverless 命令列介面，必須先安裝或升級。如需詳細資訊，請參閱[使用 AWS 設定 Serverless Framework](https://www.serverless.com/framework/docs/getting-started/)。

**使用 Lambda 主控台更新**

1. 更新 Lambda Insights。如果您尚未這麼做，請在檔案結尾新增 `custom` 區段，並在 `lambdaInsightsVersion` 屬性內指定 Lambda Insights 版本。

   ```
   custom:
       lambdaInsights:
           lambdaInsightsVersion: {{53}} #specify the Layer Version
   ```

1. 輸入下列命令，重新部署 Serverless 服務。

   ```
   serverless deploy
   ```

## 在 Lambda 容器映像部署上更新 Lambda Insights 延伸模組版本
<a name="Lambda-Insights-Update-Extension-container"></a>

若要在 Lambda 容器映像上更新 Lambda Insights，請依循[在 Lambda 容器映像部署上啟用 Lambda Insights](Lambda-Insights-Getting-Started-docker.md)中的步驟，使用最新版本的 Lambda Insights 重建映像。然後，使用 AWS CLI [更新函數程式碼](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/update-function-code.html)，並提供容器映像 URI 做為 `--image-uri` 參數的值。