DataBot Metric Reference

From NovaOrdis Knowledge Base
Jump to navigation Jump to search

Internal

Overview

Metric definition fundamentals are available in:

events-api Metric Definitions

Metric source fundamentals are available in:

events-api Metric Sources

Platform Metrics

events OS Metrics

JMX Metrics

TODO

The order in which the key/value pairs are specified in the JMX ObjectName is not relevant.

JBoss CLI Metrics

TODO REVIEW

DataBot can be configured to read CLI metrics from JBoss controllers. The controller is identified by its host, port and username controller components. If none of these are explicitly specified, the localhost:9999 and local authentication are assumed, which means the DataBot process has to be collocated with the JBoss controller on the same host. Support for password externalization will be implemented in the future.

Syntax:

jboss:[[username:password@]host[:port]]/path-element-1/path-element-2/attribute-name

Example:

jboss:/subsystem=infinispan/cache-container=clustered/distributed-cache=web/number-of-entries
jboss:localhost/subsystem=infinispan/cache-container=clustered/distributed-cache=web/number-of-entries
jboss:localhost:9999/subsystem=infinispan/cache-container=clustered/distributed-cache=web/number-of-entries
jboss:test:test123@localhost:9999/subsystem=infinispan/cache-container=clustered/distributed-cache=web/number-of-entries

Types

JBoss CLI attributes are typed, the controller knows and sends the correct type back. DataBot uses the type to build typed Property instances.

Classpath

The JBoss CLI client requires specific libraries added to the DataBot classpath, and instead of shipping those libraries with the installation bundle, DataBot must be configured to detect and use the libraries from a JBoss instance it has access to. In order to enable DataBot to build the classpath fragment, jboss_home must be specified in the configuration file. Example:

...
jboss_home=/usr/jboss
...