Ejemplos personalizados de JMX YAML

Este es un ejemplo de un archivo JMX YAML personalizado para el agente de Java de New Relic, que incluye valor y definición, MBean, atributo, tipo y nombres para métrica, objetos y atributo. Para obtener más información, incluido un vídeo, consulte Monitoreo JMX personalizado por YAML.

Ejemplo de YAML

A continuación se muestra un ejemplo de un archivo JMX YAML personalizado. Los archivos YAML sensibles al espacio.

name: TomcatCustom
version: 1.0
enabled: true
jmx:
  - object_name: Catalina:type=Cache,host=localhost,path=/examples
    metrics:
      - attributes: accessCount, cacheSize, hitsCount
        type: simple
  - object_name: Catalina:type=Connector,port=8009
    metrics:
      - attributes: bufferSize, maxHeaderCount
  - object_name: java.nio:type=BufferPool,name=*
    metrics:
      - attributes: Count
        type: monotonically_increasing

Explicación de ejemplo

Value	Definition
`name`	Un nombre descriptivo que identifica su archivo de instrumentación personalizada YAML, usando un espacio antes del nombre de la propiedad. En el ejemplo anterior, el nombre es `TomcatCustom`.
`version`	La versión del archivo de extensión. Utilice un doble. Si dos extensiones tienen el mismo nombre, solo se utilizará la extensión con la versión más alta. Utilice un espacio antes de la versión de la propiedad. En el ejemplo anterior, la versión es `1.0`.
`enabled`	Si `true`, el agente de Java leerá la extensión. Si `false`, el agente de Java ignorará la extensión. Utilice un espacio antes de la propiedad habilitada. El ejemplo anterior está habilitado.

Cada línea en YAML que comienza con - object_name representa un MBean. Por ejemplo, las siguientes líneas describen la información que se extraerá del primer MBean:

- object_name: Catalina:type=Cache,host=localhost,path=/examples
  metrics:
    - attributes: accessCount, cacheSize, hitsCount
      type: simple

La propia propiedad object_name puede coincidir con uno o más MBeans. Por ejemplo, la línea siguiente solo coincide con un MBean:

- object_name: Catalina:type=Cache,host=localhost,path=/examples

La siguiente línea podría coincidir con varios MBeans:

- object_name: java.nio:type=BufferPool,name=*

El comodín asterisco (*) solo se puede utilizar con JDK 1.6 y superior.

Los tres MBeans enumerados en el ejemplo anterior tienen los siguientes nombres de objeto:

Catalina:type=Cache,host=localhost,path=/examples
Catalina:type=Connector,port=8009
java.nio:type=BufferPool,name=*

Para type, utilice simple o monotonically_increasing. Cuando no se especifica type en el archivo JMX YAML, el valor predeterminado es monotonically_increasing.

Valor	Definición
`simple`	El valor exacto del atributo se informará a New Relic cada minuto.
`monotonically_increasing`	La diferencia positiva se informará a New Relic cada minuto.

En el ejemplo anterior, el atributo accessCount, cacheSize y hitsCount se informará como simple. El atributo bufferSize, maxHeaderCount y Count se informará como monotonically_increasing.

Si el valor del atributo hitsCount es siempre 5, New Relic informará un 5 cada minuto.
Si el valor del atributo Count es siempre 5, New Relic informará un 0 para el valor cada minuto.
Si el valor del atributo Count cambia de 5 a 7, New Relic informará un 2 para ese minuto.

Al seleccionar el tablero personalizado métrica y no usar la propiedad root_metric_name, use el siguiente formato para todas las métricas JMX personalizadas:

JMX/beginning_of_object_name/type/any_properties_in_object_name/attribute_name

Sugerencia

Algunos nombres de objetos no incluyen un tipo. En ese caso, habrá un valor nulo en el nombre de la métrica.

El archivo de configuración no utiliza root_metric_name, por lo que se creará la siguiente métrica:

JMX/Catalina/Cache/localhost/examples/accessCount
JMX/Catalina/Cache/localhost/examples/cacheSize
JMX/Catalina/Cache/localhost/examples/hitsCount
JMX/Catalina/Connector/8009/bufferSize
JMX/Catalina/Connector/8009/maxHeaderCount
JMX/java.nio/BufferPool/direct/Count
JMX/java.nio/BufferPool/mapped/Count

Si está utilizando la propiedad root_metric_name, la métrica será el nombre de la métrica raíz con el prefijo JMX y seguido del nombre del atributo. Puede utilizar valores de nombre de objeto especificando la clave de nombre de objeto en root_metric_name entre corchetes {}. Por ejemplo:

Parte de un archivo de configuración:

- object_name: Catalina:type=Cache,host=localhost,path=/examples
  root_metric_name: Tomcat/{host}
  metrics:
    - attributes: accessCount, cacheSize, hitsCount
      type: simple
- object_name: mbean:type=Sample,host=localhost,path=*
  root_metric_name: SampleMBean
  metrics:
    - attributes: attOne, attTwo
      type: simple

Nombres métricos:

JMX/Tomcat/localhost/accessCount
JMX/Tomcat/localhost/cacheSize
JMX/Tomcat/localhost/hitsCount
JMX/SampleMBean/attOne
JMX/SampleMBean/attTwo

Si un atributo no existe realmente en el MBean, la métrica nunca aparecerá en New Relic.

Encontrar nombres de objetos y atributos

La forma más sencilla de encontrar MBeans disponibles y sus atributos asociados es utilizar las instrucciones de JConsole para JDK 1.6.

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

Ejemplo de YAML

Explicación de ejemplo

Propiedades

MBeans

Atributo

Tipo

Nombres métricos

Sugerencia

Encontrar nombres de objetos y atributos

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

Ejemplos personalizados de JMX YAML

Ejemplo de YAML.css-21sua1{background:none;border:none;width:0;padding:0;}

Explicación de ejemplo

MBeans

Atributo

Tipo

Nombres métricos

Encontrar nombres de objetos y atributos

Ejemplo de YAML