Este documento descreve como passar o argumento -javaagent para a JVM da sua framework. Esta etapa de instalação garante que o agente seja incluído no seu aplicativo. Para todos os servidores de aplicativos, certifique-se de transmitir o caminho completo para o arquivo newrelic.jar .
Este documento é simplesmente uma referência de como passar o argumento. Para obter procedimentos de instalação detalhados, consulte Instalação do agente Java.
ColdFusion
Para passar o argumento -javaagent no ColdFusion:
Inicie o servidor ColdFusion e navegue até o console de administração do ColdFusion.
No menu esquerdo, selecione SERVER SETTINGS > Java and JVM.
Se estiver usando a API do agente: especifique o caminho para newrelic-api.jar no campo ColdFusion Class Path .
No campo JVM Arguments , adicione o argumento -javaagent :
-javaagent:/full/path/to/newrelic.jar
Selecione Submit Changes e reinicie o servidor ColdFusion.
Geronimo
Para transmitir o argumento -javaagent no Geronimo, consulte o jar do agente New Relic na variável de ambiente JAVA_OPTS ao executar o comando de inicialização:
bash
$
exportJAVA_OPTS="$JAVA_OPTS -javaagent:/full/path/to/newrelic.jar"&& geronimo run
Glassfish
Para passar o argumento -javaagent no Glassfish:
No console do Glassfish, selecione Application Server > JVM Settings > JVM options.
Na página de opções da JVM, selecione Add JVM option.
Adicione uma entrada para o argumento -javaagent :
-javaagent:/full/path/to/newrelic.jar
Salve e reinicie o Glassfish.
Se o Glassfish não iniciar, o argumento -javaagent pode não ter sido definido corretamente. É possível alterar os argumentos da JVM do servidor editando o arquivo domain.xml .
Importante
Um bug no Glassfish 2.1 impede que classes no carregador de classes de inicialização (o agente New Relic) usem a API de log Java. Isso parece ter sido corrigido nas versões 2.1.1 ou superiores.
Um bug do JBoss em 7.0.2.Final e 7.1.0.Alpha1 não permite que opções de JVM sejam definidas em domain.xml. Se você encontrar esse problema, atualize seu servidor do aplicativo JBoss.
Use o modo autônomo para outras plataformas e versões:
Plataforma
Instruções
Unix ou macOS com 6.x EAP ou 7.0.x AS e acima
Na parte inferior de bin/standalone.conf, adicione:
O sistema de módulos introduzido no Java 9 pode levar à exceção NoClassDefFoundError: java/sql/SQLException se a propriedade -javaagent for adicionada aos arquivos conf/resin.conf ou conf/resin.xml . Se você estiver usando Java 9 ou superior, certifique-se de que a propriedade -javaagent não esteja incluída nesses arquivos.
O Resin pode ser executado em Java 9 ou superior, com o agente Java usando uma das seguintes opções:
Opção 1: adicione o argumento javaagent por meio da propriedade jvmargs no arquivo resin.properties do servidor:
jvm_args:-javaagent:/full/path/to/newrelic.jar
O servidor Resin pode então ser executado com ./bin/resin.sh start.
Opção 2: execute o jar de Resin com a propriedade -javaagent na linha de comando:
Ao executar o Solr em um application server, siga as instruções desse servidor de aplicativo para adicionar o sinalizador -javaagent . Certifique-se também de que o JMX esteja ativado para o servidor do aplicativo. Se você não visualizar dados na página Solr da interface APM, siga os procedimentos de resolução de problemas para dados Solr.
Bota Primavera
Para transmitir o argumento -javaagent no Spring Boot, adicione-o à linha de comando na qual você inicia seu aplicativo. Certifique-se de adicioná-lo antes do argumento -jar :
Para passar o argumento -javaagent no Tanuki Wrapper, adicione uma opção de wrapper wrapper.conf. Na linha abaixo, substitua XXX por um número não utilizado neste arquivo:
Em sistemas Linux, não são necessárias aspas ao configurar esse valor. Este comportamento pode variar em outros sistemas operacionais.
Tomcat
Para passar o argumento -javaagent no Tomcat:
Crie um script CATALINA_BASE/bin/setenv.sh se ainda não existir. Configure seu script setenv.sh para usar o agente New Relic usando a variável de ambiente CATALINA_OPTS :
Crie um script CATALINA_BASE/bin/setenv.bat se ainda não existir. Configure seu script setenv.bat para usar o agente New Relic usando a variável de ambiente CATALINA_OPTS :
Recomendamos que você não defina nenhuma variável neste script. Em vez disso, coloque-os em um script setenv.sh em CATALINA_BASE/bin para manter suas personalizações separadas.
Configure seu arquivo catalina.sh para usar o agente New Relic usando a variável de ambiente JAVA_OPTS :
Recomendamos que você não defina nenhuma variável neste script. Em vez disso, coloque-os em um script setenv.bat em CATALINA_BASE/bin para manter suas personalizações separadas.
Se você usar catalina.bat para lançar o Tomcat, defina a variável JAVA_OPTS próximo ao topo do arquivo:
Na caixa de texto Java Options , insira o argumento. Use barras / para o separador de caminho. Para o Tomcat 6, adicione uma quebra de linha após o argumento -javaagent .
-javaagent:/full/path/to/newrelic.jar
Selecione Apply e reinicie o Tomcat.
A versão do daemon Apache Commons (jsvc) incluída no Tomcat 6 não suporta o argumento -javaagent usado pelo New Relic. No entanto, uma construção do daemon jsvc a partir da origem do tronco suportará o argumento -javaagent por meio do prefixo -X . Veja o bug do Apache rastreando o problema.
Há uma correção no repositório de origem do Apache Commons. Para maiores informações:
Para instância do servidor de administração, siga as instruções do Linux/macOS ou Windows. Você não pode usar o console de administração para instalar a instância do servidor de administração.
Para instância de servidor gerenciado, utilize o console de administração:
No console de administração, navegue até Environments > Servers > (select a server) > Server Start > Arguments.
De Arguments, adicione:
-javaagent:/full/path/to/newrelic.jar
Salve a página e reinicie a instância do servidor.
WebSphere
Para transmitir o argumento -javaagent no WebSphere:
No console de administração, selecione Servers > Application servers > (select a server) > Configuration > Service Infrastructure > Java and Process Management.
Selecione Process Definition > Additional Properties e depois selecione Java Virtual Machine.
No campo Generic JVM arguments , adicione o argumento -javaagent para seu arquivo newrelic.jar :
Para transmitir o argumento -javaagent no WebSphere Community Edition, consulte o jar do agente New Relic na variável de ambiente JAVA_OPTS ao executar o comando de inicialização:
O agente Java da New Relic funciona em qualquer servidor de aplicativos compatível. Se o seu servidor de aplicativos não estiver listado neste documento, siga os procedimentos padrão para que seu servidor de aplicativos passe esse argumento para a JVM antes do jar do aplicativo: