FAQ sobre instalação do agente ARMS - Application Real-Time Monitoring Service: Central de Documentação do Alibaba Cloud

Como localizar os logs do agente ARMS?

Por padrão, os logs ficam em ${agent root directory}/logs/${pid}_${ip}.log.

O diretório raiz do agente varia conforme o método de instalação:

Método de instalação	Diretório raiz do agente
Contêiner ou Enterprise Distributed Application Service (EDAS)	`/home/admin/.opt/ArmsAgent/` ou `/home/admin/.opt/AliyunJavaAgent`
Instalação manual	Diretório onde você baixou e descompactou o pacote do agente

Se não souber como o agente foi instalado, execute o comando abaixo para localizar o parâmetro -javaagent no comando de inicialização do processo:

ps -ef | grep java

Por exemplo, se a saída contiver -javaagent:/home/zhangsan/agent/arms-bootstrap-1.7.0-SNAPSHOT.jar, o diretório raiz do agente será /home/zhangsan/agent.

Nota

Se você definir o parâmetro de inicialização -DJM.LOG.PATH=xxx, os logs estarão em ${JM.LOG.PATH}/${pid}_${ip}.log.

Por que o agente ARMS não está relatando dados?

Siga as etapas abaixo para identificar a causa.

Etapa 1: Verifique se o agente iniciou

Verifique nos logs de saída padrão uma das seguintes mensagens de inicialização:

Versão do agente	Mensagem de log esperada
v3.x	`(AliyunJavaAgentBootstrap) arms agent start cost`
v4.x	`Aliyun Java Agent start cost`

Se nenhuma mensagem aparecer, houve falha na montagem do agente ou na verificação prévia. Consulte os logs para obter detalhes. Por exemplo, Aliyun Java Agent requires minimal memory of 200M indica memória insuficiente.
Caso surja a exceção java.security.NoSuchAlgorithmException: DES KeyGenerator not available, atualize para o agente ARMS v4.x.
Para outras exceções, envie um ticket.

Nota

Para saber a localização dos arquivos de log, consulte Como localizar os logs do agente ARMS?.

Etapa 2: Verifique a região e a rede

Se o agente iniciou com sucesso:

Região: Pesquise regionId nos logs do agente. Confirme se corresponde à região selecionada no console do Application Real-Time Monitoring Service (ARMS).
Rede: Procure erros de conectividade de rede nos logs do agente. Se houver erros, consulte Configurações de rede necessárias para o agente ARMS para Java.
Tráfego: Confirme se a aplicação está recebendo solicitações. O agente relata dados apenas quando há tráfego.

Etapa 3: Entre em contato com o suporte

Se o problema persistir, envie um ticket.

É possível definir uma versão uniforme do agente para todo o cluster Kubernetes?

Sim. Em vez de especificar uma versão por Deployment, envie um ticket ou entre em contato com o suporte técnico para configurar uma versão do agente para todo o cluster.

Por que o agente ARMS não gera dados quando o agente Pinpoint também está montado?

O comportamento depende da versão do agente ARMS:

Versão do agente	Compatibilidade com Pinpoint
v3.x	Baseado no Pinpoint Agent. Os dois são mutuamente exclusivos — apenas um pode ser montado por vez.
v4.x	Baseado no agente OpenTelemetry Java. Pode coexistir com o agente Pinpoint, embora a compatibilidade não seja garantida.

Solução: Atualize para o agente v4.x ou remova o agente Pinpoint.

Como corrigir `java.lang.NoSuchMethodError: org.springframework.http.HttpStatus`?

Versões afetadas: Agente ARMS anterior à v3.2.0

Condições: Ambas as condições a seguir devem ser verdadeiras:

Você instalou o agente por meio do Enterprise Distributed Application Service (EDAS).
O recurso -Dedas.scg.enable está ativado.

Causa: O filtro com.navercorp.pinpoint.plugin.reactive.filter.AccessLogFilte é adicionado automaticamente à cadeia de filtros e é incompatível com Spring Boot 3.x.

Solução: Atualize o agente ARMS para a versão v3.2.0 ou posterior.

O que significa "logContent rate limit count" nos logs do agente?

O agente está limitando sua própria saída de logs para proteger o desempenho da aplicação. Esse é um comportamento esperado, não um erro. Nenhuma ação é necessária.