Incluir el agente de Java con un argumento JVM

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

$export JAVA_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.

Grails

Para pasar el argumento -javaagent en Grails:

En su aplicación Grails, abra este archivo con su editor de texto:
```
grails-app/conf/BuildConfig.groovy
```

Agregue o edite la línea de argumentos de JVM:

grails.tomcat.jvmArgs = ["-javaagent:/full/path/to/newrelic.jar"]

JBoss

Para pasar el argumento -javaagent en JBoss:

Utilice el modo de dominio para las versiones 6.x EAP y 7.0 AS o superiores de JBoss:

Edite las propiedades de JVM para su grupo de servidores, ubicado en:
```
domain/configuration/domain.xml
```
Modifique las propiedades para incluir el argumento -javaagent :
```
<server-group name="main-server-group" profile="full">
  <jvm name="default">
    <jvm-options>
      <option value="-javaagent:/full/path/to/newrelic.jar"/>
    </jvm-options>
  </jvm>
  ...
</server-group>
```
Advertencia
Un error de JBoss en 7.0.2.Final y 7.1.0.Alpha1 no permite configurar opciones de JVM en domain.xml. Si encuentra este problema, actualice su servidor de aplicaciones JBoss.

Utilice el modo independiente para otras plataformas y versiones:

Plataforma	Direcciones
Unix/macOS con 6.x EAP o 7.0.x AS y superiores	En la parte inferior de `bin/standalone.conf`, agregue: `JAVA_OPTS="$JAVA_OPTS -javaagent:/full/path/to/newrelic.jar"`
Windows con 6.x EAP o 7.0.x AS o superior	En `bin/standalone.bat`, antes de la línea: `set JBOSS_ENDORSED_DIRS=%JBOSS_HOME%\lib\endorsed` Agregar: `set "JAVA_OPTS=-javaagent:C:/full/path/to/newrelic.jar %JAVA_OPTS%"`
Unix/macOS con 6.x o anterior	En la parte inferior de `bin/run.conf`, agregue esto: `JAVA_OPTS="$JAVA_OPTS -javaagent:/full/path/to/newrelic.jar"`
Windows con 6.x o anterior	En `bin/run.bat`, antes de la línea: `set JBOSS_CLASSPATH=%RUN_CLASSPATH%` Agregar: `set "JAVA_OPTS=-javaagent:C:/full/path/to/newrelic.jar %JAVA_OPTS%"`

Jetty

Para pasar el argumento -javaagent en Jetty:

Play

Para pasar el argumento -javaagent en Play:

Comience con una distribución unzipped que contenga el script start :
bash
```
$play clean dist && unzip dist/*.zip
```

Añade el argumento -javaagent al iniciar tu aplicación Play:

bash

$cd unzipped/folder; chmod a+x start; ./start -javaagent:/full/path/to/newrelic.jar

Comience con una distribución unzipped que contenga el script start :
bash
```
$play clean dist && unzip target/directory/universal/*.zip
```
Añade el argumento -J-javaagent al iniciar tu aplicación Play:
bash
```
$cd unzipped/folder; ./bin/scriptname -J-javaagent:/full/path/to/newrelic.jar
```
Sugerencia
Para habilitar el tiempo de carga de la página, consulte Manual de instrumentación con Play 2.2.

Comience con una distribución unzipped que contenga el script start :
bash
```
$activator clean dist && unzip target/directory/universal/*.zip
```

Añade el argumento -J-javaagent al iniciar tu aplicación Play:

bash

$cd unzipped/folder; ./bin/scriptname -J-javaagent:/full/path/to/newrelic.jar

Si usa Typesafe Activator con Play 2.4, agregue esta línea a su build.sbt:
```
javaOptions ++= Seq("-javaagent:/full/path/to/newrelic.jar")
```

Resin

Java 8

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
```
Opción 2: especifique el argumento -javaagent agregándolo a la sección <jvm-args> de su archivo conf/resin.conf o conf/resin.xml :
```
<jvm-arg>-javaagent:/full/path/to/newrelic.jar</jvm-arg>
```

Java 9 or higher

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:
```
java -javaagent:/path/to/newrelic.jar -jar lib/resin.jar start
```

Importante

El agente no funcionará con Resin en Windows cuando se utilice Java 9 o superior.

Solr

Para pasar el argumento -javaagent en 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 :

bash

$java -javaagent:/full/path/to/newrelic.jar -jar app.jar

Envoltorio Tanuki

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:

wrapper.java.additional.XXX=-javaagent:/full/path/to/newrelic.jar

Sugerencia

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:

bash

$export CATALINA_OPTS="$CATALINA_OPTS -javaagent:/full/path/to/newrelic.jar"

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:

SET "CATALINA_OPTS=%CATALINA_OPTS% -javaagent:/full/path/to/newrelic.jar"

Sugerencia

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 :

bash

$export JAVA_OPTS="$JAVA_OPTS -javaagent:/full/path/to/newrelic.jar"

Sugerencia

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:

SET JAVA_OPTS=%JAVA_OPTS% -javaagent:/full/path/to/newrelic.jar

Seleccione Start > Apache Tomcat X.Y.Z. > Configure Tomcat > Java.
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:

Consulte la documentación del repositorio fuente de Apache.
Vaya directamente al repositorio de fuentes SVN.

WebLogic

Para pasar el argumento -javaagent en WebLogic:

Edite su archivo startWebLogic.sh , ubicado en el directorio bin del dominio.

Cerca del comienzo del archivo, agregue:

bash

$export JAVA_OPTIONS="$JAVA_OPTIONS -javaagent:/full/path/to/newrelic.jar"

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 :
```
-javaagent:/full/path/to/newrelic.jar
```
Seleccione Apply y luego seleccione Save.
Reinicie su servidor.

Para obtener más información, consulte la documentación sobre la recopilación de WebSphere PMI métrica.

Comunidad WebSphere

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:

bash

$export JAVA_OPTS="$JAVA_OPTS -javaagent:/full/path/to/newrelic.jar" && startup

Perfil de WebSphere Liberty

Para pasar el argumento -javaagent en WebSphere Liberty Profile:

Editar ${server.config.dir}/jvm.options.
Agregue el argumento -javaagent para apuntar a su archivo newrelic.jar :
```
-javaagent:/full/path/to/newrelic.jar
```
Reinicie su servidor.

Wildfly

Para pasar el argumento -javaagent en Wildfly (si usa Wildfly 11 o superior, consulte las instrucciones de instalación adicionales):

Edite las propiedades de JVM para su grupo de servidores, ubicado en:
```
domain/configuration/domain.xml
```

Modifique las propiedades para incluir el argumento -javaagent :

<server-group name="main-server-group" profile="full">
  <jvm name="default">
    <jvm-options>
      <option value="-javaagent:/full/path/to/newrelic.jar"/>
    </jvm-options>
  </jvm>
  ...
</server-group>

Plataforma	Direcciones
Unix o macOS	En la parte inferior de `bin/standalone.conf`, agregue: `JAVA_OPTS="$JAVA_OPTS -javaagent:/full/path/to/newrelic.jar"`
Windows	En `bin/standalone.bat`, busque esta línea: `rem Setup JBoss specific properties` Luego añade: `set "JAVA_OPTS=-javaagent:C:/full/path/to/newrelic.jar %JAVA_OPTS%"`

Plataforma

Direcciones

Unix o macOS

En la parte inferior de bin/standalone.conf, agregue:

JAVA_OPTS="$JAVA_OPTS -javaagent:/full/path/to/newrelic.jar"

Windows

En bin/standalone.bat, busque esta línea:

rem Setup JBoss specific properties

Luego añade:

set "JAVA_OPTS=-javaagent:C:/full/path/to/newrelic.jar %JAVA_OPTS%"

Otros servidores de aplicaciones

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:

-javaagent:/full/path/to/newrelic.jar

Te ofrecemos esta traducción automática para facilitar la lectura.

Incluir el agente de Java con un argumento JVM

ColdFusion .css-21sua1{background:none;border:none;width:0;padding:0;}

Geronimo

Glassfish

Importante

Grails

Pasar con run-war

JBoss

Configurado con modo de dominio (6.x EAP y 7.0 AS)

Conjunto con modo autónomo (otras versiones)

Jetty

Si configura exec en jetty.sh

Si configura exec en start.ini

Play

Play 1.2.4

Play 2.0

Play 2.2

Play 2.3, 2.4 y 2.5

Resin

Importante

Solr

Solr independiente 5.x o superior

Solr independiente 4.x o inferior

Servidor de aplicaciones Solr

Bota de primavera

Envoltorio Tanuki

Sugerencia

Tomcat

Con setenv.sh

Con setenv.bat

Con catalina.sh (NO RECOMENDADO)

Con catalina.bat (NO RECOMENDADO)

Con Windows

Con daemonApache Commons

WebLogic

Servidores de administración en Linux o macOS

Servidores de administración en Windows

Instancia de servidor administrado

WebSphere

Comunidad WebSphere

Perfil de WebSphere Liberty

Wildfly

Establecer con modo de dominio

Configurar con modo independiente

Otros servidores de aplicaciones

ColdFusion

Si configura exec en `jetty.sh`

Si configura exec en `start.ini`