监控 AWS Lambda Python 函数
编辑监控 AWS Lambda Python 函数编辑
Python APM 代理可与 AWS Lambda 一起使用，以监控 AWS Lambda 函数的执行。
Note: The Centralized Agent Configuration on the Elasticsearch APM currently does NOT support AWS Lambda.
先决条件编辑
您需要一个 APM 服务器来发送 APM 数据。如果您尚未设置，请按照 APM 快速入门 操作。为了获得最佳性能，我们建议在与您的 AWS Lambda 函数相同的 AWS 区域的 Elastic Cloud 上设置 APM。
步骤 1：选择 AWS 区域和架构编辑
从 此版本表 中选择适用于 APM Lambda 扩展层的正确 ARN。
此外，从 此版本表 中选择适用于 APM 代理层的正确 ARN。
选择的AWS 区域和架构必须与 AWS Lambda 函数的 AWS 区域和架构匹配！
步骤 2：将 APM 层添加到您的 Lambda 函数编辑
Elastic APM AWS Lambda 扩展和 Python APM 代理都作为 AWS Lambda 层 添加到您的 Lambda 函数。因此，您需要将相应的层 ARN（标识符）添加到您的 Lambda 函数。
要通过 AWS 管理控制台将层添加到您的 Lambda 函数
- 在 AWS 管理控制台中导航到您的函数
- 滚动到“层”部分，然后单击“添加层”按钮
- 选择“指定 ARN”单选按钮
- 将 Elastic APM AWS Lambda 扩展层和 APM 代理层的以下 ARN 复制并粘贴到“指定 ARN”文本输入框中
APM 扩展层
EXTENSION_ARN
APM 代理层
AGENT_ARN
- 单击“添加”按钮
要通过 AWS 命令行界面添加 Elastic APM AWS Lambda 扩展和 APM 代理的层 ARN，请执行以下命令
aws lambda update-function-configuration --function-name yourLambdaFunctionName \ --layers EXTENSION_ARN \ AGENT_ARN
在您的 SAM template.yml 文件中，将 Elastic APM AWS Lambda 扩展和 APM 代理的层 ARN 添加如下
...
Resources:
yourLambdaFunction:
Type: AWS::Serverless::Function
Properties:
...
Layers:
- EXTENSION_ARN
- AGENT_ARN
...
在您的 serverless.yml 文件中，将 Elastic APM AWS Lambda 扩展和 APM 代理的层 ARN 添加到您的函数，如下所示
...
functions:
yourLambdaFunction:
handler: ...
layers:
- EXTENSION_ARN
- AGENT_ARN
...
要将 Elastic APM AWS Lambda 扩展和 APM 代理添加到您的函数，请将 ARN 添加到 Terraform 文件中的 layers 属性
...
resource "aws_lambda_function" "your_lambda_function" {
...
layers = ["EXTENSION_ARN", "AGENT_ARN"]
}
...
要将 Elastic APM AWS Lambda 扩展和 APM 代理添加到基于容器的函数，请扩展函数镜像的 Dockerfile，如下所示
FROM docker.elastic.co/observability/apm-lambda-extension-IMAGE_ARCH:latest AS lambda-extension AGENT_IMPORT # FROM ... <-- this is the base image of your Lambda function COPY --from=lambda-extension /opt/elastic-apm-extension /opt/extensions/elastic-apm-extension AGENT_COPY # ...
步骤 3：在 AWS Lambda 上配置 APM编辑
Elastic APM AWS Lambda 扩展和 APM Python 代理是通过 AWS Lambda 函数上的环境变量配置的。
对于最小配置，您将需要APM 服务器 URL 来设置 APM 数据的目标，以及一个APM 密钥令牌。如果您希望使用 APM API 密钥 而不是 APM 密钥令牌，请在以下配置中使用 ELASTIC_APM_API_KEY 环境变量而不是 ELASTIC_APM_SECRET_TOKEN。
对于生产环境，我们建议 使用 AWS Secrets Manager 来存储您的 APM 身份验证密钥，而不是在环境变量中以纯文本形式提供密钥值。
要通过 AWS 管理控制台配置 APM
- 在 AWS 管理控制台中导航到您的函数
- 单击“配置”选项卡
- 单击“环境变量”
- 添加以下必需变量
AWS_LAMBDA_EXEC_WRAPPER = /opt/python/bin/elasticapm-lambda # use this exact fixed value ELASTIC_APM_LAMBDA_APM_SERVER = <YOUR-APM-SERVER-URL> # this is your APM Server URL ELASTIC_APM_SECRET_TOKEN = <YOUR-APM-SECRET-TOKEN> # this is your APM secret token ELASTIC_APM_SEND_STRATEGY = background
要通过 AWS 命令行界面配置 APM，请执行以下命令
aws lambda update-function-configuration --function-name yourLambdaFunctionName \
--environment "Variables={AWS_LAMBDA_EXEC_WRAPPER=/opt/python/bin/elasticapm-lambda,ELASTIC_APM_LAMBDA_APM_SERVER=<YOUR-APM-SERVER-URL>,ELASTIC_APM_SECRET_TOKEN=<YOUR-APM-SECRET-TOKEN>,ELASTIC_APM_SEND_STRATEGY=background}"
在您的 SAM template.yml 文件中，配置以下环境变量
...
Resources:
yourLambdaFunction:
Type: AWS::Serverless::Function
Properties:
...
Environment:
Variables:
AWS_LAMBDA_EXEC_WRAPPER: /opt/python/bin/elasticapm-lambda
ELASTIC_APM_LAMBDA_APM_SERVER: <YOUR-APM-SERVER-URL>
ELASTIC_APM_SECRET_TOKEN: <YOUR-APM-SECRET-TOKEN>
ELASTIC_APM_SEND_STRATEGY: background
...
在您的 serverless.yml 文件中，配置以下环境变量
在您的 Terraform 文件中，配置以下环境变量
...
resource "aws_lambda_function" "your_lambda_function" {
...
environment {
variables = {
AWS_LAMBDA_EXEC_WRAPPER = /opt/python/bin/elasticapm-lambda
ELASTIC_APM_LAMBDA_APM_SERVER = "<YOUR-APM-SERVER-URL>"
ELASTIC_APM_SECRET_TOKEN = "<YOUR-APM-SECRET-TOKEN>"
ELASTIC_APM_SEND_STRATEGY = "background"
}
}
}
...
为 AWS Lambda 函数配置的环境变量将传递到运行 lambda 函数的容器。您可以使用其他选项之一（通过 AWS Web 控制台、AWS CLI 等）来配置以下环境变量
|
|
您可以选择 微调 Python 代理 或 Elastic APM AWS Lambda 扩展的配置。
就是这样。按照上述步骤操作后，您就可以开始了！从现在开始，您的 Lambda 函数调用将被跟踪。将捕获对 支持的技术 的跨度。您还可以使用 capture_span 来捕获自定义跨度，并且可以使用 get_client 来检索用于捕获异常/消息的 Client 对象。