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

Runtimes compatíveis e requisitos

Para crie uma função com runtime customizado, consulte Create a function.

Etapa 1: Obtenha uma chave de licença

Chame a operação de API DescribeTraceLicenseKey no OpenAPI Explorer para recuperar sua chave de licença do ARMS. Guarde essa chave para uso na Etapa 3.

Etapa 2: Adicione a layer do agente ARMS

O Function Compute disponibiliza layers comuns oficiais que incluem o agente ARMS para cada versão Java compatível.

Substitua {region} pelo ID da região da função, como cn-hangzhou.

Para adicionar a layer pelo console do Function Compute:

1. Faça login no console do Function Compute. No painel de navegação à esquerda, clique em Functions.

2. Na barra de navegação superior, selecione uma região. Na página Functions, clique na função desejada.

3. Na página de detalhes da função, clique na aba Configurations.

4. No painel de navegação à esquerda, clique em Layers e, em seguida, em Modify.

5. No painel Layers, escolha + Add Layer > Add Official Common Layer e selecione a layer do agente ARMS correspondente à sua versão Java.

Etapa 3: Configure as variáveis de ambiente

Defina as seguintes variáveis de ambiente para sua função:

Para defina essas variáveis pelo console do Function Compute:

1. Na página de detalhes da função, clique na aba Configurations.

2. No painel de navegação à esquerda, clique em Environment Variables e, em seguida, em Modify.

3. Adicione FC_EXTENSION_ARMS=true e FC_EXTENSIONS_ARMS_LICENSE_KEY=<your-license-key>.

Para mais detalhes, consulte Configurar variáveis de ambiente.

Etapa 4: Crie um script bootstrap

O agente ARMS se conecta ao processo Java por meio dos parâmetros de inicialização da JVM. Crie um arquivo bootstrap para passar esses parâmetros quando a função for iniciada.

A tabela a seguir descreve os parâmetros de JVM obrigatórios:

Exemplo de script bootstrap:

#!/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

Substitua /code/target/demo-0.0.1-SNAPSHOT.jar pelo caminho do arquivo JAR da sua aplicação.

Etapa 5: Verifique a integração

Após a implantação, invoque a função pelo menos uma vez para acionar a coleta de dados e confirme que o ARMS está recebendo as informações:

1. Faça login no console do ARMS.

2. No painel de navegação à esquerda, escolha Application Monitoring > Applications.

3. Localize a aplicação cujo nome corresponde ao valor de appName definido no script bootstrap. O padrão é FC:{FunctionName}.

4. Clique no nome da aplicação para visualize traces, métricas de JVM e outros dados de monitoramento.

Para detalhes sobre o painel de monitoramento, consulte Visão geral da aplicação.

Faturamento

A integração do ARMS com o Function Compute gera cobranças em dois serviços: