Application Real-Time Monitoring Service:Install the ARMS agent for a Java application in Function Compute

Runtimes compatibles y requisitos

Para crear una función con un runtime personalizado, consulte Create a function.

Paso 1: Obtener una clave de licencia

Llame a la operación de API DescribeTraceLicenseKey en OpenAPI Explorer para recuperar su clave de licencia de ARMS. Guarde esta clave para usarla en el Paso 3.

Paso 2: Agregar la capa del agente de ARMS

Function Compute proporciona capas comunes oficiales que incluyen el agente de ARMS para cada versión de Java compatible.

Reemplace {region} con el identificador de la región de su función, por ejemplo, cn-hangzhou.

Para agregar la capa en la consola de Function Compute, siga estos pasos:

1. Inicie sesión en la consola de Function Compute. En el panel de navegación izquierdo, haga clic en Functions.

2. En la barra de navegación superior, seleccione una región. En la página Functions, haga clic en la función deseada.

3. En la página de detalles de la función, haga clic en la pestaña Configurations.

4. En el panel de navegación izquierdo, haga clic en Layers y luego en Modify.

5. En el panel Layers, elija + Add Layer > Add Official Common Layer y seleccione la capa del agente de ARMS correspondiente a su versión de Java.

Paso 3: Configurar las variables de entorno

Establezca las siguientes variables de entorno para su función:

Para configurar estas variables en la consola de Function Compute, siga estos pasos:

1. En la página de detalles de la función, haga clic en la pestaña Configurations.

2. En el panel de navegación izquierdo, haga clic en Environment Variables y luego en Modify.

3. Agregue FC_EXTENSION_ARMS=true y FC_EXTENSIONS_ARMS_LICENSE_KEY=<your-license-key>.

Para más información, consulte Configuración de variables de entorno.

Paso 4: Crear un script de arranque

El agente de ARMS se asocia a su proceso Java mediante parámetros de inicio de la JVM. Cree un archivo bootstrap para pasar estos parámetros cuando inicie la función.

La siguiente tabla describe los parámetros de la JVM obligatorios:

Ejemplo de script de arranque:

#!/bin/bash
set -eo pipefail

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

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

# Build the ARMS JVM parameters.
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` "
    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

# Launch the application. Replace the JAR path with your own.
echo "params: ${params}"
exec java $params \
    -Dserver.port=9000 \
    -jar /code/target/demo-0.0.1-SNAPSHOT.jar

Reemplace /code/target/demo-0.0.1-SNAPSHOT.jar con la ruta del archivo JAR de su aplicación.

Paso 5: Comprobar la integración

Después del despliegue, invoque la función como mínimo una vez para activar la recopilación de datos. Luego, confirme que ARMS está recibiendo la información:

1. Inicie sesión en la consola de ARMS.

2. En el panel de navegación izquierdo, elija Application Monitoring > Applications.

3. Busque la aplicación cuyo nombre coincida con el valor appName de su script de arranque. El valor predeterminado es FC:{FunctionName}.

4. Haga clic en el nombre de la aplicación para consultar los rastros, las métricas de la JVM y otros datos de monitoreo.

Para obtener detalles sobre el panel de monitoreo, consulte Descripción general de la aplicación.

Facturación

La integración de ARMS con Function Compute genera cargos en dos servicios: