自定义运行时支持ARMS应用监控扩展

背景信息

函数计算无缝对接ARMS应用监控平台后，您可以通过ARMS应用监控平台对目标函数进行监控追踪，获取相关信息，例如实例级别的可观测性、链路追踪信息、Java虚拟机指标、代码级别的剖析（Profiling）信息和应用安全信息等。更多信息，请参见什么是应用实时监控服务ARMS？。

自定义运行时接入ARMS

ARMS应用监控是一种内部扩展。自定义运行时接入ARMS应用监控时，主要包括以下三部分。

使用公共层获取ARMS Agent程序

函数计算平台以公共层的形式，提供了支持Java 8、Java 11和Java 17三种Java版本的ARMS Agent。

使用Bootstrap脚本作为启动命令

#!/bin/bash
set -eo pipefail

# 1. 设置ARMS应用名称
appName="FC:Custom_Java_Arms_Demo"
if [ -n "${FC_FUNCTION_NAME}" ]; then
    appName="FC:${FC_FUNCTION_NAME}"
fi

echo "appName: ${appName}"
params=" "

# 2. 添加ARMS参数
if [[ -n "${FC_EXTENSIONS_ARMS_LICENSE_KEY}" ]]; then
    echo "FC_EXTENSIONS_ARMS_LICENSE_KEY: ${FC_EXTENSIONS_ARMS_LICENSE_KEY}"
    params+="-Dfc.instanceId=$HOSTNAME@`hostname -i` "
    # 使用公共层的ARMS程序路径
    params+="-javaagent:/opt/ArmsAgent/arms-bootstrap-1.7.0-SNAPSHOT.jar "
    params+="-Darms.licenseKey=${FC_EXTENSIONS_ARMS_LICENSE_KEY} "
    params+="-Darms.appName=${appName} "
else
    echo "The environment FC_EXTENSIONS_ARMS_LICENSE_KEY does not exist, please set the FC_EXTENSIONS_ARMS_LICENSE_KEY environment!"
    exit 1
fi

# 3. 启动应用程序
echo "params: ${params}"
exec java $params \
    -Dserver.port=9000 \
    -jar /code/target/demo-0.0.1-SNAPSHOT.jar

设置环境变量

• 设置环境变量FC_EXTENSIONS_ARMS_LICENSE_KEY=xxxx，值为License Key。获取License Key信息的具体步骤，请参见获取License Key。

• 设置环境变量FC_EXTENSION_ARMS=true。

  添加该环境变量后，在一次函数调用结束时，不会立刻冻结函数实例，会等待10s再冻结函数实例，以确保ARMS Agent扩展成功上报日志。

  重要

  函数计算在调用结束至冻结前的等待时长会产生费用，收费策略与实例调用阶段的计费逻辑相同。具体信息，请参见产品计费。

前提条件

• 已创建自定义运行时函数，具体运行环境为Java 8、Java 11或Java 17。具体操作，请参见创建函数。

• 已开通ARMS服务。具体操作，请参见开通ARMS。

操作步骤

1. 登录函数计算控制台，在左侧导航栏，单击函数。

2. 在顶部菜单栏，选择地域，然后在函数页面，单击目标函数。

3. 在函数配置页面，选择配置页签。

4. 选择左侧层页签，单击编辑，然后在编辑函数层面板选择+添加层 > 添加官方公共层，添加与所选Java语言兼容的ArmsAgent层。

5. 在左侧导航栏，选择环境变量页签，单击编辑，添加环境变量FC_EXTENSION_ARMS=true和FC_EXTENSIONS_ARMS_LICENSE_KEY=xxxx。

   具体操作，请参见设置环境变量。

6. 在函数代码页面的WebIDE中，创建Bootstrap文件，然后单击部署代码。

   具体操作，请参见使用Bootstrap脚本作为启动命令。

   成功更新配置并部署代码后，您的函数将被添加到ARMS应用监控进行高性能管理。同时，ARMS监控将对您的服务进行计费。更多信息，请参见计费概述。

结果验证

当您成功将函数接入ARMS应用监控平台后，您可以在ARMS控制台查看接入的函数。