La plataforma Java SE incluye Java Management Extensions (JMX). JMX es una forma de monitor y administrar aplicaciones, dispositivos y servicios. Generalmente, los servidores de aplicaciones tienen JMX métrica incorporado que puedes monitor.
El agente de Java de New Relic ofrece la capacidad de monitor métricas específicas de MBeans y atributos en su aplicación sin modificar el código mediante el uso de un archivo YAML de instrumentación personalizada. El agente de Java leerá el archivo YAML al inicio y registrará la métrica específica.
Sugerencia
También puede monitor JMX con la integración de infraestructura JMX.
Requisitos y acceso
El agente de Java solo ve métricas de MBeans en su JVM actual. Si se accede a los MBeans de forma remota o existen en una JVM separada, no estarán disponibles para el agente de Java de New Relic.
Los datos JMX personalizados no se mostrarán en nuestros gráficos , pero puede consultar los datos y crear gráficos personalizados con ellos.
Esta integración informa solo valores numéricos simples. Si desea informar otros tipos de valores, es posible que desee utilizar la integración de infraestructura JMX.
Reglas de estructura de archivos
El fichero de instrumentación personalizada debe estar en formato YAML. Utilice un validador YAML para asegurarse de que la sintaxis sea precisa antes de usar el archivo con el agente de Java de New Relic y siga estas reglas:
- Los archivos YAML distinguen entre mayúsculas y minúsculas.
- Todas las sangrías están en incrementos de dos caracteres. Los datos en las mismas secciones del archivo deben usar el mismo nivel de sangría. Sangra las subsecciones con dos espacios adicionales.
- Debe reiniciar su proceso de host JVM para que los cambios surtan efecto.
Propiedades disponibles
A continuación se muestra un resumen de cada propiedad en el archivo JMX. Para obtener más información, consulte Ejemplos personalizados de JMX YAML.
Value | Definition |
|---|---|
| El nombre descriptivo principal que identifica su archivo de instrumentación personalizada YAML. Incluya un espacio antes de la propiedad |
| La versión del archivo de extensión. Si dos extensiones tienen el mismo nombre, solo se utilizará la extensión con la versión más alta. Asegúrese de que la propiedad de versión esté en una línea separada de |
| Si |
| Ningún valor sigue a la propiedad |
| Coincide con el objeto del MBean específico. Si está utilizando JDK versión 1.6 o superior, el |
| Disponible con el agente de Java de New Relic versión 3.7.0 o superior. Una propiedad opcional que brinda la posibilidad de nombrar la métrica utilizada en New Relic. Para utilizar valores de propiedad |
| No hay ningún valor en la línea métrica. Incluya cuatro espacios antes de métrica. |
| Una lista separada por comas del atributo del MBean. El nombre del atributo debe coincidir exactamente. Incluya 6 espacios antes del guión y un espacio entre el guión y la palabra clave |
|
|
Ubicación del archivo YAML
El agente de Java lee el archivo YAML al iniciar el proceso. Hay dos formas de especificar la ubicación del archivo YAML:
Advertencia
La métrica personalizada no funcionará si hay más de un archivo YAML en la misma carpeta que el agente. Mueva las copias de seguridad y las copias a otra carpeta al personalizar.
Verificar que el archivo fue leído
Para verificar que el agente leyó el archivo YAML:
Abra el archivo de configuración
newrelic.yml.Cambie la propiedad nivel de logs a
log_level: finer.Inicie la aplicación.
Verifique que el archivo
logs/newrelic_agent.logincluya una declaración que indique que el archivo se leyó en:Reading custom extension file /path/to/file/file.ymlSi no puede encontrar esta declaración, verifique la ubicación del archivo YAML. También asegúrese de que el proceso tenga acceso de lectura al archivo.
Verifique que el archivo incluya esta declaración:
Adding extension with name NAME_FROM_YAML and version VERSION_FROM_YAMLSi no puede encontrar esta declaración, verifique que el documento se haya analizado correctamente. También verifique si hay otro archivo de extensión con el mismo nombre y un número de versión superior.
Consultar y graficar datos JMX
Puede realizar una consulta de sus datos JMX y utilizarlos para crear gráficos personalizados. Para conocer más sobre cómo consultar este tipo de datos, consulte consulta APM métrica.
A continuación se explica cómo buscar JMX o la ruta directa al contador tal como se establece en su archivo YAML.
Para obtener más información sobre cómo se nombran y almacenan las métricas, consulte Ejemplos personalizados de JMX YAML.