Application Real-Time Monitoring Service:Instalar o agente ARMS para uma aplicação Java no Function Compute

Runtimes compatíveis e requisitos

Para criar uma função com runtime personalizado, consulte Criar uma função.

Etapa 1: Obter uma chave de licença

Chame a operação de API DescribeTraceLicenseKey no OpenAPI Explorer para recuperar sua chave de licença do ARMS. Salve essa chave para usá-la na Etapa 3.

Etapa 2: Adicionar a camada do agente ARMS

O Function Compute fornece camadas comuns oficiais que incluem o agente ARMS para cada versão compatível do Java.

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

Para adicionar a camada no 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 depois em Modify.

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

Etapa 3: Configurar variáveis de ambiente

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

Para definir essas variáveis no 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 depois em Modify.

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

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

Etapa 4: Criar um script bootstrap

O agente ARMS anexa-se ao processo Java por meio de 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 necessários da JVM:

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: Verificar a integração

Após a implantação, invoque a função pelo menos uma vez para acionar a coleta de dados e confirme se 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 appName do seu script bootstrap. O padrão é FC:{FunctionName}.

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

Para obter 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 de dois serviços: