Con el agente de Java de New Relic, puede realizar un seguimiento de todo, desde problemas de rendimiento hasta pequeños errores dentro de su código. Cada minuto, el agente publica datos de intervalo de tiempo de métrica y eventos en la interfaz de usuario de New Relic, donde el propietario de esos datos puede iniciar sesión y utilizarlos para ver el rendimiento de su sitio web.
Utilice el agente de Java New Relic para resolver los problemas de rendimiento de su aplicación con nuestro tutorial Mi aplicación es lenta.
Instalacion
Para utilizar el agente de Java:
- Asegúrese de que su sistema cumpla con la compatibilidad y los requisitos del agente de Java.
- Regístrese para obtener su cuenta gratuita si aún no lo ha hecho.
- Instale el agente de Java usando nuestro iniciador o siguiendo los procedimientos de instalación estándar. Dependiendo de sus herramientas y marco, consulte los procedimientos de instalación adicionales para instalar o configurar el agente de Java.
Para ver el rendimiento de su aplicación en la UIde New Relic, vaya a one.newrelic.com > All capabilities > APM & services > (select an app) > Summary. La interfaz de usuario de APM incluye una páginaJVM metrics dedicada, detalles de transacciones y errores , una herramienta generadora de perfiles de subprocesos para muestrear subprocesos de Java e informar el rastreo de la pila, y más.
También puede ampliar su instrumentación del agente y explorar sus datos con otras características de New Relic, incluido nuestro explorador y panel de métricas y eventos .
Configuración de inicio
El agente de Java lee la configuración de inicio del archivo newrelic.yml
, que debe estar en el mismo directorio que newrelic.jar
. También puede anular la configuración utilizando las propiedades del sistema Java.
El agente necesita las configuraciones license_key
y app_name
al inicio (arrancar). Puede personalizar la ubicación del archivo de registro y otras configuraciones en su archivo newrelic.yml
. Además, puede ajustar la configuración de nombres si su servidor de aplicaciones ejecuta varias aplicaciones en la misma JVM.
Opciones de configuración
Puede configurar los informes de la aplicación desde la interfaz web de New Relic mediante la configuración del lado del servidor. Los cambios se aplicarán a todos los informes de agentes para su aplicación cuando se reinicie la JVM. Sin embargo, si utiliza la configuración del lado del servidor, aún debe mantener la configuración requerida (license_key
y app_name
) en el archivo de configuración local.
Tanto la traza de la transacción como las instantáneas de error pueden registrar opcionalmente el parámetro HTTP. A veces, los parámetros HTTP contienen información confidencial, como un número de tarjeta de crédito. El agente tiene varias opciones de configuración para garantizar la seguridad de los datos, como recopilar parámetros HTTP pero excluir ciertos parámetros con nombre.
Ver el registro de sus datos de infraestructura y APM
También puede reunir los datos de su registro y de la aplicación para que la resolución de problemas sea más fácil y rápida. Con el contexto de inicio de sesión, puede ver el mensaje de registro relacionado con sus errores y la traza directamente en UI de su aplicación. También puede ver el inicio de sesión en el contexto de los datos de su infraestructura, como el clúster de Kubernetes. No es necesario cambiar a otra página de UI.
Instrumentación adicional
Después de instalar el agente de Java, utilice cualquiera de estos métodos para ampliar su instrumentación:
instrumentación personalizada: Implementar instrumentación personalizada de Java mediante anotación o XML.
Habilite rastreo distribuido: vea las rutas de sus solicitudes a medida que se distribuyen en una arquitectura distribuida de múltiples servicios.
Recopilar atributo personalizado: Recopilar atributo personalizado mediante API o archivo XML.
API de agente de Java: utilice la API para controlar, personalizar o ampliar la funcionalidad del agente de Java.
Instrumentación del navegador: integre el agente de Java con
para obtener visibilidad de la actividad del usuario final.
interruptor para instrumentación personalizada de Java: utilice un interruptor para proteger la aplicación de la sobreinstrumentación.
Instrumentación JMX personalizada por YAML: vea la métrica JMX personalizada con un archivo de instrumentación personalizada YAML.
Página JVM métrica: Recoge métricas de los servidores de aplicaciones más comunes a través de JMX.
Telemetría de código abierto: Ofrecemos una variedad de herramientas, como Kamon Reporter, exportador OpenTelemetry, registro Micrometer métrica y SDK de telemetría Java.
Cuándo reiniciar tu JVM
Cuando realiza un cambio en su configuración o en su XML personalizado, en casi todos los casos debe reiniciar su JVM. Sólo hay cuatro situaciones en las que no es necesario reiniciar:
JVM restart is not required for... | Comments |
---|---|
nivel de registros o cambios de modo de auditoría | Si simplemente está cambiando |
Archivo XML de instrumentación personalizada | El reinicio de JVM depende de la versión de su agente de Java:
|
Cambios de cortacircuitos | Si está cambiando el interruptor para la instrumentación personalizada de Java, no es necesario reiniciar la JVM. |
Ignorado o error esperado | Si ignora o espera errores al configurar el archivo
|
Todos los demás cambios requieren reiniciar el agente, lo que significa reiniciar la JVM.
Cumplimiento de JSR 163
El agente de Java de New Relic monitorea las transacciones web, recibe información sobre ellas y comunica esa información a la interfaz de usuario de New Relic con fuertes medidas de seguridad de los datos implementadas. El agente está empaquetado como un javaagent
compatible con JSR 163 que la JVM activa mediante modificaciones en el lanzamiento de la JVM. Una vez activado, el agente se inserta en el flujo de carga de clases e instrumenta los métodos de clase utilizando instrumentación de código de bytes (bci).
Diseñadas para tener un impacto mínimo en su aplicación web, todas las clases están en el namespace del paquete newrelic
para que no choquen con sus propias clases. El agente utiliza el motor ASM bci para insertar sondas de software.
El agente recibe información básica sobre su entorno host, como el sistema operativo, la versión de Java, las propiedades del sistema y su archivo de configuración de New Relic. El agente también sondea datos de JVM y JMX.
procedimientos de resolución de problemas
Si tiene problemas, consulte No aparecen datos y otros documentos de resolución de problemas en esa sección.