在 Lambda 上啟用應用程式

設定專案結構

建立 Lambda 函式的目錄

mkdir java-appsignals-container-lambda && \
cd java-appsignals-container-lambda

建立 Maven 專案結構

mkdir -p src/main/java/com/example/java/lambda
mkdir -p src/main/resources

建立 Dockerfile

下載支援 Application Signals 的 OpenTelemetry Layer，並直接將其整合到您的 Lambda 容器映像中。此時，系統會建立 Dockerfile 檔案。

FROM public.ecr.aws/lambda/java:21

# Install utilities
RUN dnf install -y unzip wget maven

# Download the OpenTelemetry Layer with AppSignals Support
RUN wget https://github.com/aws-observability/aws-otel-java-instrumentation/releases/latest/download/layer.zip -O /tmp/layer.zip

# Extract and include Lambda layer contents
RUN mkdir -p /opt && \
    unzip /tmp/layer.zip -d /opt/ && \
    chmod -R 755 /opt/ && \
    rm /tmp/layer.zip

# Copy and build function code
COPY pom.xml ${LAMBDA_TASK_ROOT}
COPY src ${LAMBDA_TASK_ROOT}/src
RUN mvn clean package -DskipTests

# Copy the JAR file to the Lambda runtime directory (from inside the container)
RUN mkdir -p ${LAMBDA_TASK_ROOT}/lib/
RUN cp ${LAMBDA_TASK_ROOT}/target/function.jar ${LAMBDA_TASK_ROOT}/lib/

# Set the handler
CMD ["com.example.java.lambda.App::handleRequest"]

Lambda 函式程式碼：在 src/main/java/com/example/lambda/App.java: 為您的 Lambda 處理常式建立 Java 檔案

您的專案應看起來如下所示：

.
├── Dockerfile
├── pom.xml
└── src
    └── main
        ├── java
        │   └── com
        │       └── example
        │           └── java
        │               └── lambda
        │                   └── App.java
        └── resources

建置並部署容器映像

設定環境變數

AWS_ACCOUNT_ID=$(aws sts get-caller-identity --query Account --output text) 
AWS_REGION=$(aws configure get region)

# For fish shell users:
# set AWS_ACCOUNT_ID (aws sts get-caller-identity --query Account --output text) 
# set AWS_REGION (aws configure get region)

使用 ECR 進行身分驗證

先使用公有 ECR (適用於基礎映像)：

aws ecr-public get-login-password --region us-east-1 | docker login --username AWS --password-stdin public.ecr.aws

再使用私有 ECR：

aws ecr get-login-password --region $AWS_REGION | docker login --username AWS --password-stdin $AWS_ACCOUNT_ID.dkr.ecr.$AWS_REGION.amazonaws.com

建置、標記並推送映像

# Build the Docker image
docker build -t lambda-appsignals-demo .

# Tag the image
docker tag lambda-appsignals-demo:latest $AWS_ACCOUNT_ID.dkr.ecr.$AWS_REGION.amazonaws.com/lambda-appsignals-demo:latest

# Push the image
docker push $AWS_ACCOUNT_ID.dkr.ecr.$AWS_REGION.amazonaws.com/lambda-appsignals-demo:latest

建立並設定 Lambda 函式

使用 Lambda 主控台建立新函式。

選取容器映像作為部署選項。

選擇瀏覽映像以選取 Amazon ECR 映像。

測試和驗證 – 使用簡單的事件測試 Lambda。如果圖層整合成功，您的 Lambda 會出現在 Application Signals 服務地圖下。

可以在 CloudWatch 主控台中看到 Lambda 函式的追蹤和指標。

設定專案結構

建立 Lambda 函式容器映像的目錄

mkdir dotnet-appsignals-container-lambda && \
cd dotnet-appsignals-container-lambda

建立 Dockerfile

下載支援 Application Signals 的 OpenTelemetry Layer，並直接將其整合到您的 Lambda 容器映像中。此時，系統會建立 Dockerfile 檔案。

FROM public.ecr.aws/lambda/dotnet:8

# Install utilities
RUN dnf install -y unzip wget dotnet-sdk-8.0 which

# Add dotnet command to docker container's PATH
ENV PATH="/usr/lib64/dotnet:${PATH}"

# Download the OpenTelemetry Layer with AppSignals Support
RUN wget https://github.com/aws-observability/aws-otel-dotnet-instrumentation/releases/latest/download/layer.zip -O /tmp/layer.zip

# Extract and include Lambda layer contents
RUN mkdir -p /opt && \
    unzip /tmp/layer.zip -d /opt/ && \
    chmod -R 755 /opt/ && \
    rm /tmp/layer.zip

WORKDIR ${LAMBDA_TASK_ROOT}

# Copy the project files
COPY dotnet-lambda-function/src/dotnet-lambda-function/*.csproj ${LAMBDA_TASK_ROOT}/
COPY dotnet-lambda-function/src/dotnet-lambda-function/Function.cs ${LAMBDA_TASK_ROOT}/
COPY dotnet-lambda-function/src/dotnet-lambda-function/aws-lambda-tools-defaults.json ${LAMBDA_TASK_ROOT}/

# Install dependencies and build the application
RUN dotnet restore

# Use specific runtime identifier and disable ReadyToRun optimization
RUN dotnet publish -c Release -o out --self-contained false /p:PublishReadyToRun=false

# Copy the published files to the Lambda runtime directory
RUN cp -r out/* ${LAMBDA_TASK_ROOT}/

CMD ["dotnet-lambda-function::dotnet_lambda_function.Function::FunctionHandler"]

Lambda 函式程式碼 – 使用 AWS Lambda .NET 範本初始化 Lambda 專案：

# Install the Lambda templates if you haven't already
dotnet new -i Amazon.Lambda.Templates

# Create a new Lambda project
dotnet new lambda.EmptyFunction -n dotnet-lambda-function

您的專案應看起來如下所示：

.
├── Dockerfile
└── dotnet-lambda-function
    ├── src
    │   └── dotnet-lambda-function
    │       ├── Function.cs
    │       ├── Readme.md
    │       ├── aws-lambda-tools-defaults.json
    │       └── dotnet-lambda-function.csproj
    └── test
        └── dotnet-lambda-function.Tests
            ├── FunctionTest.cs
            └── dotnet-lambda-function.Tests.csproj

建置並部署容器映像

設定環境變數

AWS_ACCOUNT_ID=$(aws sts get-caller-identity --query Account --output text) 
AWS_REGION=$(aws configure get region)

# For fish shell users:
# set AWS_ACCOUNT_ID (aws sts get-caller-identity --query Account --output text) 
# set AWS_REGION (aws configure get region)

將 Function.cs 程式碼更新為：

將 dotnet-lambda-function.csproj 程式碼更新為：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net8.0>/TargetFramework>
   <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
    <GenerateRuntimeConfigurationFiles>true</GenerateRuntimeConfigurationFiles>
    <AWSProjectType>Lambda</AWSProjectType>
    
    <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies>
    
    <PublishReadyToRun>true</PublishReadyToRun>
 </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="Amazon.Lambda.Core" Version="2.5.0" />
    <PackageReference Include="Amazon.Lambda.Serialization.SystemTextJson" Version="2.4.4" />
    <PackageReference Include="AWSSDK.S3" Version="3.7.305.23" />
  </ItemGroup>
</Project>

建置並部署容器映像

設定環境變數

AWS_ACCOUNT_ID=$(aws sts get-caller-identity --query Account --output text) 
AWS_REGION=$(aws configure get region)

# For fish shell users:
# set AWS_ACCOUNT_ID (aws sts get-caller-identity --query Account --output text) 
# set AWS_REGION (aws configure get region)

使用公有 Amazon ECR 驗證

aws ecr-public get-login-password --region us-east-1 | docker login --username AWS --password-stdin public.ecr.aws

使用私有 Amazon ECR 驗證

aws ecr get-login-password --region $AWS_REGION | docker login --username AWS --password-stdin $AWS_ACCOUNT_ID.dkr.ecr.$AWS_REGION.amazonaws.com

建立 Amazon ECR 儲存庫 (如需要)

aws ecr create-repository \
    --repository-name lambda-appsignals-demo \
    --region $AWS_REGION

建置、標記並推送映像

# Build the Docker image
docker build -t lambda-appsignals-demo .

# Tag the image
docker tag lambda-appsignals-demo:latest $AWS_ACCOUNT_ID.dkr.ecr.$AWS_REGION.amazonaws.com/lambda-appsignals-demo:latest

# Push the image
docker push $AWS_ACCOUNT_ID.dkr.ecr.$AWS_REGION.amazonaws.com/lambda-appsignals-demo:latest

5. Create and Configure the Lambda Function

建立並設定 Lambda 函式

使用 Lambda 主控台建立新函式。

選取容器映像作為部署選項。

選擇瀏覽映像以選取 Amazon ECR 映像。

測試和驗證 – 使用簡單的事件測試 Lambda。如果圖層整合成功，您的 Lambda 會出現在 Application Signals 服務地圖下。

可以在 CloudWatch 主控台中看到 Lambda 函式的追蹤和指標。

設定專案結構

建立 Lambda 函式容器映像的目錄

mkdir nodejs-appsignals-container-lambda &&\
cd nodejs-appsignals-container-lambda

建立 Dockerfile

下載支援 Application Signals 的 OpenTelemetry Layer，並直接將其整合到您的 Lambda 容器映像中。此時，系統會建立 Dockerfile 檔案。

# Dockerfile
FROM public.ecr.aws/lambda/nodejs:22

# Install utilities
RUN dnf install -y unzip wget

# Download the OpenTelemetry Layer with AppSignals Support
RUN wget https://github.com/aws-observability/aws-otel-js-instrumentation/releases/latest/download/layer.zip -O /tmp/layer.zip

# Extract and include Lambda layer contents
RUN mkdir -p /opt && \
    unzip /tmp/layer.zip -d /opt/ && \
    chmod -R 755 /opt/ && \
    rm /tmp/layer.zip

# Install npm dependencies
RUN npm init -y
RUN npm install

# Copy function code
COPY *.js ${LAMBDA_TASK_ROOT}/

# Set the CMD to your handler
CMD [ "index.handler" ]

Lambda 函式程式碼

使用下列內容建立 index.js 檔案：

const { S3Client, ListBucketsCommand } = require('@aws-sdk/client-s3');

// Initialize S3 client
const s3Client = new S3Client({ region: process.env.AWS_REGION });

exports.handler = async function(event, context) {
  console.log('Received event:', JSON.stringify(event, null, 2));
  console.log('Handler initializing:', exports.handler.name);
  
  const response = {
    statusCode: 200,
    body: {}
  };
  
  try {
    // List S3 buckets
    const command = new ListBucketsCommand({});
    const data = await s3Client.send(command);
    
    // Extract bucket names
    const bucketNames = data.Buckets.map(bucket => bucket.Name);
    
    response.body = {
      message: 'Successfully retrieved buckets',
      buckets: bucketNames
    };
    
  } catch (error) {
    console.error('Error listing buckets:', error);
    
    response.statusCode = 500;
    response.body = {
      message: `Error listing buckets: ${error.message}`
    };
  }
  
  return response;
};

您的專案結構應看起來如下所示：

.
├── Dockerfile
└── index.js

建置並部署容器映像

設定環境變數

AWS_ACCOUNT_ID=$(aws sts get-caller-identity --query Account --output text) 
AWS_REGION=$(aws configure get region)

# For fish shell users:
# set AWS_ACCOUNT_ID (aws sts get-caller-identity --query Account --output text) 
# set AWS_REGION (aws configure get region)

使用公有 Amazon ECR 驗證

aws ecr-public get-login-password --region us-east-1 | docker login --username AWS --password-stdin public.ecr.aws

使用私有 Amazon ECR 驗證

aws ecr get-login-password --region $AWS_REGION | docker login --username AWS --password-stdin $AWS_ACCOUNT_ID.dkr.ecr.$AWS_REGION.amazonaws.com

建立 Amazon ECR 儲存庫 (如需要)

aws ecr create-repository \
    --repository-name lambda-appsignals-demo \
    --region $AWS_REGION

建置、標記並推送映像

# Build the Docker image
docker build -t lambda-appsignals-demo .

# Tag the image
docker tag lambda-appsignals-demo:latest $AWS_ACCOUNT_ID.dkr.ecr.$AWS_REGION.amazonaws.com/lambda-appsignals-demo:latest

# Push the image
docker push $AWS_ACCOUNT_ID.dkr.ecr.$AWS_REGION.amazonaws.com/lambda-appsignals-demo:latest

5. Create and Configure the Lambda Function

建立並設定 Lambda 函式

使用 Lambda 主控台建立新函式。

選取容器映像作為部署選項。

選擇瀏覽映像以選取 Amazon ECR 映像。

測試和驗證 – 使用簡單的事件測試 Lambda。如果圖層整合成功，您的 Lambda 會出現在 Application Signals 服務地圖下。

可以在 CloudWatch 主控台中看到 Lambda 函式的追蹤和指標。

設定專案結構

建立 Lambda 函式容器映像的目錄

mkdir python-appsignals-container-lambda &&\
cd python-appsignals-container-lambda

建立 Dockerfile

下載支援 Application Signals 的 OpenTelemetry Layer，並直接將其整合到您的 Lambda 容器映像中。此時，系統會建立 Dockerfile 檔案。

Lambda 函式程式碼

在 app.py 檔案中建立 Lambda 函式：

import json
import boto3

def lambda_handler(event, context):
    """
    Sample Lambda function that can be used in a container image.

    Parameters:
    -----------
    event: dict
        Input event data
    context: LambdaContext
        Lambda runtime information

    Returns:
    __
    dict
        Response object
    """
    print("Received event:", json.dumps(event, indent=2))

    # Create S3 client
    s3 = boto3.client('s3')

    try:
        # List buckets
        response = s3.list_buckets()

        # Extract bucket names
        buckets = [bucket['Name'] for bucket in response['Buckets']]

        return {
            'statusCode': 200,
            'body': json.dumps({
                'message': 'Successfully retrieved buckets',
                'buckets': buckets
            })
        }
    except Exception as e:
        print(f"Error listing buckets: {str(e)}")
        return {
            'statusCode': 500,
            'body': json.dumps({
                'message': f'Error listing buckets: {str(e)}'
            })
        }

您的專案結構應看起來如下所示：

.
├── Dockerfile
├── app.py
└── instructions.md

建置並部署容器映像

設定環境變數

AWS_ACCOUNT_ID=$(aws sts get-caller-identity --query Account --output text) 
AWS_REGION=$(aws configure get region)

# For fish shell users:
# set AWS_ACCOUNT_ID (aws sts get-caller-identity --query Account --output text) 
# set AWS_REGION (aws configure get region)

使用公有 Amazon ECR 驗證

aws ecr-public get-login-password --region us-east-1 | docker login --username AWS --password-stdin public.ecr.aws

使用私有 Amazon ECR 驗證

aws ecr get-login-password --region $AWS_REGION | docker login --username AWS --password-stdin $AWS_ACCOUNT_ID.dkr.ecr.$AWS_REGION.amazonaws.com

建立 Amazon ECR 儲存庫 (如需要)

aws ecr create-repository \
    --repository-name lambda-appsignals-demo \
    --region $AWS_REGION

建置、標記並推送映像

# Build the Docker image
docker build -t lambda-appsignals-demo .

# Tag the image
docker tag lambda-appsignals-demo:latest $AWS_ACCOUNT_ID.dkr.ecr.$AWS_REGION.amazonaws.com/lambda-appsignals-demo:latest

# Push the image
docker push $AWS_ACCOUNT_ID.dkr.ecr.$AWS_REGION.amazonaws.com/lambda-appsignals-demo:latest

5. Create and Configure the Lambda Function

建立並設定 Lambda 函式

使用 Lambda 主控台建立新函式。

選取容器映像作為部署選項。

選擇瀏覽映像以選取 Amazon ECR 映像。

測試和驗證 – 使用簡單的事件測試 Lambda。如果圖層整合成功，您的 Lambda 會出現在 Application Signals 服務地圖下。

可以在 CloudWatch 主控台中看到 Lambda 函式的追蹤和指標。