Parameters

Parameters

Configuration file (--conf)

[CONF]
user = < user >
password = < password > 
jmx_url = < URL of the primary JMX environment. MBeans in this environment will be detected and metrics for the selected MBeans will be monitored for all configured instances >
module_prefix = < prefix for modules >
agent_prefix = < prefix for agents >
agents_group_name = <group name for the agent>
interval = < agent creation interval >
threads = < number of threads >
temporal = < temporary directory path >
transfer_mode = < transfer mode >
tentacle_ip = < tentacle path >
tentacle_port = < tentacle port >
tentacle_opts = < tentacle options >
data_dir = < .data file path >
allow_regexp = < Regexp pattern. Metrics that match the pattern will be monitored >
deny_regexp = < Regexp pattern. Metrics that match the pattern will be discarded >
jmx_mbeans= < list with the names of the Mbeans to be monitored, separated by commas >

[MODULE_NAMES]
< Name of the metric to be renamed in the module name | desired module name for that metric >

Example

[CONF]
user = controlRole
password = myPassword
jmx_url = service:jmx:rmi:///jndi/rmi://172.17.0.2:9010/jmxrmi
module_prefix = tomcat. 
agent_prefix = tomcat.
agents_group_name = jmx
interval = 300
threads = 4
temporal = /tmp
transfer_mode = tentacle
tentacle_client = tentacle_client
tentacle_ip =172.42.42.101
tentacle_port =41121
tentacle_opts =
data_dir = /var/spool/pandora/data_in/
allow_regexp = ^Catalina:.*
deny_regexp = 
jmx_mbeans=["Catalina:type=Service","java.lang:type=ClassLoading","Catalina:type=Deployer,host=localhost","java.lang:name=CodeHeap 'non-nmethods',type=MemoryPool"]

[MODULE_NAMES]
java.lang:name=CodeHeap 'non-nmethods',type=MemoryPool/PeakUsage/max | Memory.usage.max
Catalina:type=Service/name | Catalina.service.name

Instance file (--target_instances)

Specify in each line the connection url to the Java instance.

Example

service:jmx:rmi:///jndi/rmi://172.17.0.1:9090/jmxrmi
service:jmx:rmi:///jndi/rmi://172.12.0.23:9090/jmxrmi
service:jmx:rmi:///jndi/rmi://172.11.0.1:9090/jmxrmi

Metrics file (--target_metrics)

Specify metrics line by line. 

For each line in the configuration file an attribute must be added and this will create a module with that statistic in Pandora. If it is necessary to configure thresholds, they must be specified to the right of the attribute, separating each threshold by |. Example:

Metric without threshold 

java.lang:type=Threading/ThreadCount

Metric with threshold

java.lang:type=Threading/TotalStartedThreadCount|min_warning 30|min_critical 45

Example

java.lang:type=Threading/TotalThreadAllocatedBytes 
java.lang:type=Threading/CurrentThreadAllocatedBytes
java.lang:type=Threading/ThreadAllocatedMemoryEnabled
java.lang:type=Threading/ThreadAllocatedMemorySupported
java.lang:type=Threading/ThreadCount
java.lang:type=Threading/TotalStartedThreadCount|min_warning 30|min_critical 45
java.lang:type=Threading/AllThreadIds
java.lang:type=Threading/CurrentThreadCpuTime
java.lang:type=Threading/CurrentThreadUserTime
java.lang:type=Threading/ThreadCpuTimeSupported
java.lang:type=Threading/ThreadCpuTimeEnabled
java.lang:type=Threading/ThreadContentionMonitoringEnabled
java.lang:type=Threading/ThreadContentionMonitoringSupported
java.lang:type=Threading/CurrentThreadCpuTimeSupported
java.lang:type=Threading/ObjectMonitorUsageSupported
java.lang:type=Threading/SynchronizerUsageSupported
java.lang:type=Threading/PeakThreadCount
java.lang:type=Threading/DaemonThreadCount
java.lang:type=Threading/ObjectName