telegraf/plugins/inputs/jolokia/README.md

# Telegraf plugin: Jolokia

#### Configuration

```toml
[[inputs.jolokia]]
  ## This is the context root used to compose the jolokia url
  context = "/jolokia"

  # This specifies the mode used
  # mode = "proxy"
  #
  # When in proxy mode this section is used to specify further proxy address configurations.
  # Remember to change servers addresses
  # [inputs.jolokia.proxy]
  # host = "127.0.0.1"
  # port = "8080"

  # List of servers exposing jolokia read service
  [[inputs.jolokia.servers]]
    name = "as-server-01"
    host = "127.0.0.1"
    port = "8080"
    # username = "myuser"
    # password = "mypassword"

  ## List of metrics collected on above servers
  ## Each metric consists in a name, a jmx path and either
  ## a pass or drop slice attribute.
  ## This collect all heap memory usage metrics.
  [[inputs.jolokia.metrics]]
    name = "heap_memory_usage"
    mbean  = "java.lang:type=Memory"
    attribute = "HeapMemoryUsage"

  ## This collect thread counts metrics.
  [[inputs.jolokia.metrics]]
    name = "thread_count"
    mbean  = "java.lang:type=Threading"
		attribute = "TotalStartedThreadCount,ThreadCount,DaemonThreadCount,PeakThreadCount"

  ## This collect number of class loaded/unloaded counts metrics.
  [[inputs.jolokia.metrics]]
    name = "class_count"
    mbean  = "java.lang:type=ClassLoading"
		attribute = "LoadedClassCount,UnloadedClassCount,TotalLoadedClassCount"
```

#### Description

The Jolokia plugin collects JVM metrics exposed as MBean's attributes through jolokia REST endpoint. All metrics
are collected for each server configured.

See: https://jolokia.org/

# Measurements:
Jolokia plugin produces one measure for each metric configured, adding Server's `server_name`, `server_host` and `server_port` as tags.