Exemplos JMX YAML personalizados

Cada linha no YAML começando com - object_name representa um MBean. Por exemplo, as linhas a seguir descrevem as informações a serem extraídas do primeiro MBean:

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

A própria propriedade object_name pode corresponder a um ou mais MBeans. Por exemplo, a linha abaixo corresponde apenas a um MBean:

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

A linha a seguir pode corresponder a vários MBeans:

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

O curinga asterisco (*) só pode ser usado com JDK 1.6 e superior.

Os três MBeans listados no exemplo acima possuem os seguintes nomes de objetos:

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

O exemplo JMX recupera seis atributos diferentes dos três MBeans. O agente Java da New Relic extrai estes atributos do primeiro MBean:

• accessCount

• cacheSize

• hitsCount

  O agente extrai estes atributos do segundo MBean:

• bufferSize

• maxHeaderCount

  O agente extrai um atributo (Count) do terceiro MBean.

Para type, use simple ou monotonically_increasing. Quando type não é especificado no arquivo JMX YAML, o padrão é monotonically_increasing.

No exemplo acima, o atributo accessCount, cacheSize e hitsCount serão relatados como simple. O atributo bufferSize, maxHeaderCount e Count serão relatados como monotonically_increasing.

• Se o valor do atributo hitsCount for sempre 5, a New Relic reportará um 5 a cada minuto.
• Se o valor do atributo Count for sempre 5, a New Relic reportará um 0 para o valor a cada minuto.
• Se o valor do atributo Count mudar de 5 para 7, a New Relic reportará um 2 para esse minuto.

Ao selecionar a métrica personalizada do dashboard e não utilizar a propriedade root_metric_name, utilize o seguinte formato para todas as métricas JMX customizadas:

JMX/beginning_of_object_name/type/any_properties_in_object_name/attribute_name

O arquivo de configuração não utiliza root_metric_name, então será criada a seguinte 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

Se você estiver usando a propriedade root_metric_name, a métrica será o nome da métrica raiz prefixado com JMX e seguido pelo nome do atributo. Você pode usar valores de nome de objeto especificando a chave do nome do objeto em root_metric_name entre colchetes {}. Por exemplo:

Parte de um arquivo de configuração:

- 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

Nomes métricos:

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

Se um atributo não existir realmente no MBean, a métrica nunca aparecerá no New Relic.