Se dados de monitoramento de interface, monitoramento de pool ou chamadas lentas e erros estiverem ausentes no console do Application Real-Time Monitoring Service (ARMS), utilize este guia para identificar e resolver a causa raiz.
Fluxo dos dados de monitoramento do ARMS
Os dados de monitoramento do ARMS percorrem o seguinte pipeline. Uma interrupção em qualquer estágio resulta em dados ausentes no console:
Your application --> ARMS agent (probe) --> ARMS backend --> Console dashboardCausas comuns de dados ausentes:
O agente do ARMS não está em execução ou não consegue se conectar ao backend.
O framework ou componente monitorado não é suportado.
A versão do agente é muito antiga para o recurso desejado.
A aplicação não possui tráfego correspondente.
Para restringir o problema, verifique se os dados de JVM monitoring aparecem na página Application Details. O resultado determina qual seção seguir:
|
Sintoma |
Acesse |
|
Nenhum dado em nenhuma aba, incluindo monitoramento de JVM |
Todos os dados de monitoramento ausentes |
|
Dados da JVM aparecem, mas dados de interface não |
Dados de monitoramento de interface ausentes |
|
A aba de monitoramento de pool não exibe dados |
Dados de monitoramento de pool ausentes |
|
Nenhum registro de chamada lenta ou erro |
Dados de chamadas lentas e erros ausentes |
Todos os dados de monitoramento ausentes
A ausência de dados de monitoramento da JVM indica que o agente do ARMS está desconectado ou desativado. Siga estas verificações em ordem.
Etapa 1: Verificar se a coleta de dados está ativada
Faça login no console do ARMS.
No painel de navegação à esquerda, escolha Application Monitoring > Application List.
No canto superior direito, escolha Settings > Application Start/Stop Settings.
Confirme se a coleta de dados não está desativada para a aplicação.
Etapa 2: Verificar se o interruptor mestre do probe está ligado
Na página Application List, clique em a aplicação alvo.
Na página Application Settings, clique em a aba Custom Configuration.
Confirme se o Probe Master Switch está ativado.
Etapa 3: Verificar a conectividade de rede
Caso ambas as configurações acima estejam corretas, o agente pode estar impossibilitado de alcançar o backend do ARMS.
Acesse a instância onde a aplicação está em execução.
Teste a conectividade de rede com o backend do ARMS. Para mais detalhes, consulte Como testar a conectividade de rede?
Se a rede estiver estável, revise o processo de integração da aplicação para confirmar se o agente foi anexado corretamente.
Etapa 4: Verificar a versão do JDK e o framework
O ARMS oferece suporte limitado para certas versões do JDK e frameworks de aplicação. Envie um ticket se alguma das condições abaixo se aplicar:
A aplicação executa no JDK 7 ou JDK 17.
A aplicação não foi desenvolvida com Spring Boot.
Etapa 5: Coletar logs do agente (versão do agente anterior a 2.7.3.5)
Para versões do agente do ARMS anteriores a 2.7.3.5, colete os logs do agente antes de contatar o suporte. Os logs ficam armazenados no seguinte diretório:
/home/admin/.opt/ArmsAgent/logsInclua esses logs ao enviar um ticket.
Dados de monitoramento de interface ausentes
Quando os dados de monitoramento da JVM aparecem, mas os de monitoramento de interface não, significa que o agente está conectado ao backend do ARMS. Nesse caso, o problema está relacionado a tráfego ou compatibilidade de framework.
Verificar tráfego de entrada
O monitoramento de interface captura dados apenas quando a aplicação recebe requisições. Certifique-se de que a aplicação tenha tráfego de entrada durante o intervalo de tempo selecionado no console.
Verificar compatibilidade de framework
O ARMS monitora um conjunto específico de componentes e frameworks Java. Caso sua aplicação utilize um framework não suportado, as chamadas de interface não serão capturadas.
Consulte a lista de componentes e frameworks Java suportados pelo ARMS.
Se o seu framework não estiver listado, envie um ticket para solicitar suporte.
Dados de monitoramento de pool ausentes
O ARMS fornece monitoramento de pool para os seguintes componentes:
|
Componente |
Tipo |
|
Pools de threads personalizados |
Pool de threads |
|
Dubbo |
Framework RPC |
|
Apache Tomcat |
Servidor web |
|
OkHttp |
Cliente HTTP |
|
Apache HttpClient |
Cliente HTTP |
|
Druid |
Pool de conexões |
|
HikariCP |
Pool de conexões |
O monitoramento de pool exige a versão 2.8.3 ou posterior do agente do ARMS. Caso utilize uma versão anterior à 2.8.3, atualize o agente.
Para verificar e atualizar o agente, consulte as Notas de versão do agente do ARMS para Java.
Dados de chamadas lentas e erros ausentes
O ARMS captura chamadas lentas e erros somente quando o tráfego da aplicação atende a condições específicas.
Chamadas lentas
Uma chamada é registrada como lenta pelo ARMS quando seu tempo de resposta ultrapassa 500 milissegundos. Se nenhuma chamada exceder esse limiar, nenhum dado de chamada lenta será exibido.
Erros
Dois tipos de erros são capturados pelo ARMS:
Respostas HTTP com código de status superior a 400
Exceções de chamada de interface que se propagam até a camada mais externa
Nenhum dado de erro será registrado se nenhuma dessas condições ocorrer no tráfego da sua aplicação.