为基于.NET 或.NET Core 的 AWS Lambda 函数设置本地跟踪

要启用.NET 或.NET Core Lambda 函数的跟踪功能，请在 AWS Lambda UI 中完成以下步骤：

1. 如以下步骤所示，将 Instana Lambda 层添加到函数中：

   1. 在 Lambda 函数的 " 配置 "选项卡中，单击 " 层 ">" 添加层 "。

      

   2. 在 "添加图层 "窗口中，选择 " 指定 ARN "。

   3. 在 " 指定 ARN "字段中复制并粘贴与您所在地区相匹配的 Instana Lambda 层的 Amazon 资源名称 (ARN)。 您可以在 Instana Lambda 层部分找到 Instana Lambda 层的正确 ARN。 然后点击 " 验证 "。

   4. 单击添加。

2. 配置以下环境变量，以连接 Instana 后台：

   环境变量	值
   CORECLR_ENABLE_PROFILING	1
   CORECLR_PROFILER	{cf0d821e-299b-5307-a3d8-b283c03916dd}
   CORECLR_PROFILER_PATH	/opt/instana_tracing/CoreProfiler.co
   DOTNET_STARTUP_HOOKS	/opt/Instana.Tracing.Core.dll
   INSTANA_AGENT_KEY	<your_instana_agent_key>
   INSTANA_ENDPOINT_URL	<serverless_instana_endpoint>
   INSTANA_AWS_ACCOUNT_ID	<your_aws_account_id>
   LAMBDA_HANDLER	<Assembly::Namespace.ClassName::MethodName>

   请确保您使用的是以 https://serverless- 开头的正确的 Instana 端点 URL。 有关详细信息，请参阅 无服务器监控的端点。

   注意： 如果您的默认处理程序不使用 Assembly::Namespace.ClassName::MethodName 格式，那么请将默认处理程序设置为 LAMBDA_HANDLER 格式。 否则，就不要设置变量或将其留空。 如果 Instana UI 中缺少显示跟踪和基础架构实体之间联系的关联数据，请使用 LAMBDA_HANDLER 设置正确的格式。

   您也可以从 Instana UI 获取这些环境变量的正确值。 要获取这些环境变量的正确值，请在 Instana UI 中单击更多 > 代理 > 安装代理 > 平台： AWS > 技术： AWS Lambda。

如果想自动将 Instana 整合到 AWS Lambdas 中，请参阅以下 AWS CLI 命令示例：

# Do not copy and paste this verbatim!
# It will overwrite any previously defined collection of layers and
# environment variables.
aws --region $YOUR_REGION lambda update-function-configuration \
   --function-name $YOUR_LAMBDA_FUNCTION_NAME \
   --layers $INSTANA_LAYER_ARN \
   --environment "Variables={CORECLR_ENABLE_PROFILING=1, CORECLR_PROFILER=\"{cf0d821e-299b-5307-a3d8-b283c03916dd}\", CORECLR_PROFILER_PATH=/opt/instana_tracing/CoreProfiler.so, DOTNET_STARTUP_HOOKS=/opt/Instana.Tracing.Core.dll, INSTANA_ENDPOINT_URL=... , INSTANA_AGENT_KEY=... , ...}"

AWS Lambda layers for.NET 最新版本的 ARN 根据地区划分如下：

例如，ARN 模式为 arn:aws:lambda:${region}:410797082306:layer:instana-dotnetcore:${layer-version}。 AWS 中国各地区的 ARN 模式为 arn:aws-cn:lambda:${region}:107998019096:layer:instana-dotnetcore:${layer-version}。