Te ofrecemos esta traducción automática para facilitar la lectura.
En caso de que haya discrepancias entre la versión en inglés y la versión traducida, se entiende que prevalece la versión en inglés. Visita esta página para obtener más información.
Este documento describe cómo pasar el argumento -javaagent a la JVM de su framework. Este paso de instalación garantiza que el agente esté incluido en su aplicación. Para todos los servidores de aplicaciones, asegúrese de pasar la ruta completa al archivo newrelic.jar .
Este documento es simplemente una referencia sobre cómo pasar el argumento. Para conocer los procedimientos de instalación detallados, consulte agente de instalación de Java.
ColdFusion
Para pasar el argumento -javaagent en ColdFusion:
Inicie su servidor ColdFusion y navegue hasta su consola de administración de ColdFusion.
En el menú de la izquierda, seleccione SERVER SETTINGS > Java and JVM.
Si utiliza la API del agente: especifique la ruta a newrelic-api.jar en el campo ColdFusion Class Path .
En el campo JVM Arguments , agregue el argumento -javaagent :
-javaagent:/full/path/to/newrelic.jar
Seleccione Submit Changes y luego reinicie su servidor ColdFusion.
Geronimo
Para pasar el argumento -javaagent en Geronimo, consulte el archivo jar del agente New Relic en la variable de entorno JAVA_OPTS cuando ejecute el comando de inicio:
bash
$
exportJAVA_OPTS="$JAVA_OPTS -javaagent:/full/path/to/newrelic.jar"&& geronimo run
Glassfish
Para pasar el argumento -javaagent en Glassfish:
Desde la consola Glassfish, seleccione Application Server > JVM Settings > JVM options.
En la página de opciones de JVM, seleccione Add JVM option.
Agregue una entrada para el argumento -javaagent :
-javaagent:/full/path/to/newrelic.jar
Guarde y reinicie Glassfish.
Si Glassfish no se inicia, es posible que el argumento -javaagent no se haya configurado correctamente. Puede cambiar los argumentos de la JVM del servidor editando el archivo domain.xml .
Importante
Un error en Glassfish 2.1 impide que las clases en el cargador de clases arrancar (el agente New Relic) utilicen la API de registro de Java. Esto parece solucionarse en versiones 2.1.1 o superiores.
El sistema de módulos introducido en Java 9 puede provocar la excepción NoClassDefFoundError: java/sql/SQLException si la propiedad -javaagent se agrega a los archivos conf/resin.conf o conf/resin.xml . Si está utilizando Java 9 o superior, asegúrese de que la propiedad -javaagent no esté incluida en esos archivos.
Resin se puede ejecutar en Java 9 o superior, con el agente de Java usando una de las siguientes opciones:
Opción 1: agregue el argumento javaagent a través de la propiedad jvmargs en el archivo resin.properties del servidor:
jvm_args:-javaagent:/full/path/to/newrelic.jar
Luego, el servidor Resin se puede ejecutar con ./bin/resin.sh start.
Opción 2: ejecutar resin jar con la propiedad -javaagent en la línea de comando:
Cuando ejecute Solr en un application server, siga las instrucciones de ese servidor de aplicaciones para agregar la bandera -javaagent . Asegúrese también de que JMX esté habilitado para el servidor de aplicaciones. Si no ve datos en la página Solr de la UI de APM, siga los procedimientos de resolución de problemas para datos Solr.
Bota de primavera
Para pasar el argumento -javaagent en Spring Boot, agréguelo a la línea de comando en la que inicia su aplicación. Asegúrate de agregarlo antes del argumento -jar :
Para pasar el argumento -javaagent en Tanuki Wrapper, agregue una opción de contenedor wrapper.conf. En la línea siguiente, sustituya XXX por un número no utilizado en este archivo:
En los sistemas Linux, no se requieren comillas al establecer este valor. Este comportamiento puede variar en otros sistemas operativos.
Tomcat
Para pasar el argumento -javaagent en Tomcat:
Cree un script CATALINA_BASE/bin/setenv.sh si aún no existe ninguno. Configure su script setenv.sh para usar el agente New Relic usando la variable de entorno CATALINA_OPTS:
Cree un script CATALINA_BASE/bin/setenv.bat si aún no existe ninguno. Configure su script setenv.bat para usar el agente New Relic usando la variable de entorno CATALINA_OPTS:
Le recomendamos que no establezca ninguna variable en este script. En su lugar, colóquelos en una script setenv.sh en CATALINA_BASE/bin para mantener sus personalizaciones separadas.
Configure su archivo catalina.sh para usar el agente New Relic usando la variable de entorno JAVA_OPTS :
Le recomendamos que no establezca ninguna variable en este script. En su lugar, colóquelos en una script setenv.bat en CATALINA_BASE/bin para mantener sus personalizaciones separadas.
Si usa catalina.bat para iniciar Tomcat, configure la variable JAVA_OPTS cerca de la parte superior del archivo:
En el cuadro de texto Java Options , ingrese el argumento. Utilice barras diagonales / para el separador de ruta. Para Tomcat 6, agregue un salto de línea después del argumento -javaagent .
-javaagent:/full/path/to/newrelic.jar
Seleccione Apply y luego reinicie Tomcat.
La versión del daemon Apache Commons (jsvc) incluida con Tomcat 6 no admite el argumento -javaagent utilizado por New Relic. Sin embargo, una compilación del daemon jsvc desde la fuente troncal admitirá el argumento -javaagent a través del prefijo -X. Vea el error de Apache que rastrea el problema.
Hay una solución en el repositorio de código fuente de Apache Commons. Para más información:
Para la instancia del servidor de administración, siga las instrucciones de Linux/macOS o Windows. No puede utilizar la consola de administración para instalar la instancia del servidor de administración.
Para instancias de servidor administrado, use la consola de administración:
Desde la consola de administración, navegue hasta Environments > Servers > (select a server) > Server Start > Arguments.
Desde Arguments, agregue:
-javaagent:/full/path/to/newrelic.jar
Guarde la página y luego reinicie la instancia de su servidor.
WebSphere
Para pasar el argumento -javaagent en WebSphere:
Desde la consola de administración, seleccione Servers > Application servers > (select a server) > Configuration > Service Infrastructure > Java and Process Management.
Seleccione Process Definition > Additional Properties y luego seleccione Java Virtual Machine.
En el campo Generic JVM arguments , agregue el argumento -javaagent para su archivo newrelic.jar :
Para pasar el argumento -javaagent en WebSphere Community Edition, consulte el archivo jar del agente New Relic en la variable de entorno JAVA_OPTS cuando ejecute el comando de inicio:
El agente de Java New Relic funciona en cualquier servidor de aplicaciones compatible. Si su servidor de aplicaciones no aparece en este documento, siga los procedimientos estándar para que su servidor de aplicaciones pase este argumento a la JVM antes del archivo jar de la aplicación: