Application Real-Time Monitoring Service:Troubleshoot ARMS agent manual installation failures

ps -ef | grep java | grep javaagent

Sintoma

O erro LicenseKey is invalid aparece nos logs no diretório ArmsAgent/log/.

Causa

O pacote de instalação do agente ARMS é específico por região e contém as informações de endpoint do ARMS encapsuladas. Se você baixe o pacote de uma região diferente daquela onde a aplicação está em execução, o agente não conseguirá se conectar ao endpoint correto do ARMS.

Solução

1. Verifique em qual região sua aplicação está sendo executada.

2. Baixe o pacote de instalação do agente ARMS correspondente a essa região. Para obter os links de download, consulte Instale manualmente um agente ARMS.

3. Substitua o diretório do agente existente pelo novo pacote baixado.

4. Reinicie a aplicação.

Sintoma

O erro LicenseKey is invalid é exibido nos logs do agente no diretório ArmsAgent/log/.

Causa

A chave de licença especificada no comando de inicialização não corresponde à chave atribuída à aplicação no console do ARMS.

Solução

1. Faça login no console do ARMS.

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

3. Na página Applications, clique em nome da aplicação e localize a chave de licença.

4. Compare a chave de licença exibida no console com o valor do parâmetro -Darms.licenseKey no comando de inicialização. Garanta que ambos sejam idênticos.

5. Caso os valores sejam diferentes, atualize o comando de inicialização com a chave de licença correta e reinicie a aplicação.

Sintoma

O agente ARMS falha ao iniciar ou deixa de reportar dados após a inicialização da aplicação.

Causa

Algumas versões iniciais do JDK 1.8, especificamente a 1.8.0_25 e a 1.8.0_31, apresentam problemas conhecidos de compatibilidade que impedem o funcionamento adequado do agente ARMS.

Solução

1. Verifique a versão do JDK:

   java -version

2. Se a saída indicar a versão 1.8.0_25 ou 1.8.0_31, faça upgrade para uma versão mais recente do JDK.

3. Para consultar a lista completa de versões do JDK e frameworks suportados, veja Componentes e frameworks Java suportados pelo ARMS.

Sintoma

Após a inicialização da aplicação, o subdiretório logs não existe no diretório ArmsAgent.

Causa

A JVM não carregou o arquivo aliyun-java-agent.jar. Isso geralmente ocorre quando o diretório ArmsAgent possui permissões de arquivo incorretas ou quando o parâmetro -javaagent no comando de inicialização aponta para um caminho errado.

Solução

1. Confirme se o parâmetro -javaagent no comando de inicialização aponta para o arquivo JAR correto:

   # Example: check the actual process command line
   ps -ef | grep java | grep javaagent

2. Valide se o diretório ArmsAgent e seu conteúdo têm permissão de leitura para o usuário que executa a aplicação:

   ls -la /path/to/ArmsAgent/

3. Caso as permissões estejam incorretas, corrija-as:

   chmod -R 755 /path/to/ArmsAgent/

4. Reinicie a aplicação e verifique se o subdiretório logs foi criado no diretório ArmsAgent.