Function Compute:Custom runtimes support the ARMS Application Monitoring extension

Step 1: Add the ARMS agent layer

Function Compute provides public layers with ARMS agents for each supported Java version.

Replace {region} with your function's region ID (for example, cn-hangzhou).

1. Log on to the Function Compute console. In the left-side navigation pane, click Functions.

2. In the top navigation bar, select the region where your function resides. On the Functions page, click the function you want to configure.

3. On the function details page, click the Configurations tab.

4. Click Modify next to Advanced Settings. In the Advanced Settings panel, expand Layers and click + Add Layer > Add Public Layer.

5. Select the layer that matches your Java version and click OK.

Step 2: Set environment variables

In the Advanced Settings panel, expand Environment Variables and set the following:

Step 3: Create a bootstrap script

Create a file named bootstrap in your function's code directory using WebIDE, then make it executable by running chmod +x bootstrap in the terminal.

The following script shows a complete example. All ARMS agent parameters are injected as JVM arguments when the environment variable FC_EXTENSIONS_ARMS_LICENSE_KEY is present.

#!/bin/bash
set -eo pipefail

# 1. Set the ARMS application name. Defaults to FC:{FunctionName}.
appName="FC:Custom_Java_Arms_Demo"
if [ -n "${FC_FUNCTION_NAME}" ]; then
    appName="FC:${FC_FUNCTION_NAME}"
fi

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

# 2. Inject ARMS agent parameters if the license key is configured.
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` "
    # Path to the ARMS agent JAR in the public layer
    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. Start the application with the ARMS parameters.
echo "params: ${params}"
exec java $params \
    -Dserver.port=9000 \
    -jar /code/target/demo-0.0.1-SNAPSHOT.jar

The script passes three JVM arguments required by ARMS:

Step 4: Deploy

Click Deploy in WebIDE to apply the code changes. After the function restarts, the ARMS agent starts collecting monitoring data.