• /
  • EnglishEspañol日本語한국어Português
  • Inicia sesiónComenzar ahora

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.

Crea una propuesta

Agente de Java: Instrumentación JMX personalizada por YAML

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

name

El nombre descriptivo principal que identifica su archivo de instrumentación personalizada YAML. Incluya un espacio antes de la propiedad name .

version

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 name. Incluya un espacio antes de la propiedad de versión.

enabled

Si true, el agente de Java leerá la extensión. Si false, el agente de Java ignorará la extensión. Incluya un espacio antes de la propiedad enabled .

jmx

Ningún valor sigue a la propiedad jmx. Utilice cero espacios antes de la propiedad.

object_name

Coincide con el objeto del MBean específico. Si está utilizando JDK versión 1.6 o superior, el object_name puede incluir asteriscos (*). Incluya dos espacios antes del guión y un espacio entre el guión y object_name.

root_metric_name

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 object_name , especifique la clave de propiedad entre paréntesis ({}). New Relic prefijará automáticamente el root_metric_name especificado con JMX y agregará el nombre del atributo al final de la métrica. Incluya cuatro espacios antes de root_metric_name.

metrics

No hay ningún valor en la línea métrica. Incluya cuatro espacios antes de métrica.

attributes

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 attributes .

type

  • Si es simple, cada valor se informará al recolector de New Relic.
  • Si es monotonically_increasing (predeterminado), la diferencia positiva se informará al recolector de New Relic.

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:

  1. Abra el archivo de configuración newrelic.yml .

  2. Cambie la propiedad nivel de logs a log_level: finer.

  3. Inicie la aplicación.

  4. Verifique que el archivo logs/newrelic_agent.log incluya una declaración que indique que el archivo se leyó en:

    Reading custom extension file /path/to/file/file.yml
  5. Si 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.

  6. Verifique que el archivo incluya esta declaración:

    Adding extension with name NAME_FROM_YAML and version VERSION_FROM_YAML
  7. Si 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.

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.