Com o agente Java da New Relic, você pode rastrear tudo, desde problemas de desempenho até pequenos erros em seu código. A cada minuto, o agente publica métricas de fração de tempo e dados de eventos na interface do usuário do New Relic, onde o proprietário desses dados pode fazer login e usar os dados para ver o desempenho de seu site.
Use o agente Java da New Relic para resolver problemas de desempenho do seu aplicativo com nosso tutorial Meu aplicativo está lento.
instalação
Para usar o agente Java:
- Certifique-se de que seu sistema atenda à compatibilidade e aos requisitos do agente Java.
- Cadastre-se para obter sua conta gratuita, caso ainda não o tenha feito.
- Instale o agente Java usando nosso inicializador ou seguindo a documentação de instalação.
Para visualizar o desempenho do seu aplicativo na interface New Relic , vá para one.newrelic.com > All capabilities > APM & services > (select an app) > Summary. A interface do usuário do APM inclui uma páginaJVM metrics dedicada, detalhes de transação e erro , uma ferramenta profiler de thread para amostrar threads Java e relatar rastreamento de pilha e muito mais.
Você também pode estender sua instrumentação de agente e explorar seus dados com outros recursos do New Relic, incluindo nossa métrica e explorador de eventos e dashboard.
Configuração de inicialização
O agente Java lê a configuração de inicialização do arquivo newrelic.yml , que deve estar no mesmo diretório que newrelic.jar. Você também pode substituir configurações usando as propriedades do sistema Java.
O agente precisa das configurações license_key e app_name na inicialização (bootstrap). Você pode personalizar o local do arquivo de log e outras configurações no arquivo newrelic.yml . Além disso, você pode ajustar a configuração de nomenclatura se o seu servidor de aplicativos executar vários aplicativos na mesma JVM.
Opções de configuração
Você pode configurar relatórios do aplicativo na interface da web do New Relic usando configuração no lado do servidor. As alterações serão aplicadas a todos os relatórios de agente do seu aplicativo quando a JVM for reiniciada. No entanto, se você usar a configuração no lado do servidor, ainda deverá manter as configurações necessárias (license_key e app_name) no arquivo de configuração local.
Tanto o rastreamento da transação quanto os instantâneos de erro podem opcionalmente registrar parâmetros HTTP. Às vezes, os parâmetros HTTP contêm informações confidenciais, como número de cartão de crédito. O agente possui diversas opções de configuração para garantir a segurança dos dados, como coletar parâmetros HTTP, mas excluir determinados parâmetros nomeados.
Visualize o log do seu APM e dados de infraestrutura
Você também pode reunir os dados do seu log e da aplicação para tornar a resolução de problemas mais fácil e rápida. Com os logs contextualizados, você pode ver a mensagem do log relacionada aos seus erros e rastrear diretamente na interface do seu aplicativo. Você também pode ver o logs contextualizados dos dados da sua infraestrutura, como cluster do Kubernetes. Não há necessidade de mudar para outra página de interface.
Instrumentação adicional
Depois de instalar o agente Java, use qualquer um destes métodos para estender sua instrumentação:
instrumentação personalizada: Implementar instrumentação Java personalizada via anotação ou XML.
Habilite distributed tracing: veja os caminhos de suas solicitações à medida que elas se espalham por uma arquitetura distribuída de vários serviços.
Coletar atributo personalizado: Coletar atributo personalizado via API ou arquivo XML.
API do agente Java: use a API para controlar, customizar ou estender a funcionalidade do agente Java.
Instrumentação do browser: integre o agente Java ao
para obter visibilidade da atividade do usuário final.
circuit breaker para instrumentação Java personalizada: Use um circuit breaker para proteger o aplicativo contra excesso de instrumentação.
Instrumentação JMX customizada por YAML: Visualize métrica JMX customizada com um arquivo de instrumentação personalizada YAML.
Página métrica JVM: Colete métricas dos servidores de aplicativos mais comuns por meio do JMX.
Telemetria de código aberto: Oferecemos uma variedade de ferramentas, como Kamon Reporter, OpenTelemetry exporter, Micrometer métrica Registry e Java telemetria SDK.
Quando reiniciar sua JVM
Ao fazer uma alteração em sua configuração ou em seu XML customizado, em quase todos os casos você deverá reiniciar sua JVM. Existem apenas quatro situações em que não é necessário reiniciar:
JVM restart is not required for... | Comments |
|---|---|
alterações no nível de log ou no modo de auditoria | Se você estiver simplesmente alterando |
Arquivo XML de instrumentação personalizada | A reinicialização da JVM depende da versão do seu agente Java:
|
mudanças circuit breaker | Caso você esteja trocando o circuit breaker para instrumentação Java personalizada, não é necessário reiniciar a JVM. |
Ignorado ou erro esperado | Se você estiver ignorando ou esperando erros ao configurar o arquivo
|
Todas as outras alterações exigem a reinicialização do agente, o que significa reiniciar a JVM.
Conformidade com JSR 163
O agente Java da New Relic monitora transações da web, recebendo informações sobre elas e comunicando essas informações à interface do usuário da New Relic com fortes medidas de segurança de dados em vigor. O agente é empacotado como um javaagent compatível com JSR 163 que é ativado pela JVM por meio de modificações no lançamento da JVM. Uma vez ativado, o agente se insere no fluxo de carregamento da classe e nos métodos da classe instrumento usando instrumentação de código de bytes (bci).
Projetadas para causar impacto mínimo em seu aplicativo Web, todas as classes estão no namespace do pacote newrelic para que não colidam com suas próprias classes. O agente usa o mecanismo ASM bci para inserir sondas de software.
O agente recebe informações básicas sobre seu ambiente host, como sistema operacional, versão Java, propriedades do sistema e seu arquivo de configuração do New Relic. O agente também pesquisa dados da JVM e do JMX.
procedimentos de resolução de problemas
Se você tiver problemas, consulte Nenhum dado aparece e outros documentos sobre resolução de problemas nessa seção.