Red Hat Training

A Red Hat training course is available for Red Hat JBoss Operations Network

3.9. JMX - Server

Overview

Table 3.2210. Overview

Description:Generic JMX Server
Singleton: no
Plugin:JMX

Note

In order to monitor your Java applications via JMX, you need to expose their MBeans to remote JMX clients. In order to do this, you must pass in some system properties when starting your application's Java virtual machine. To run a JVM with JMX remoting enabled without authentication, you must pass in the following system properties: * -Dcom.sun.management.jmxremote.port=19988 * -Dcom.sun.management.jmxremote.ssl=false * -Dcom.sun.management.jmxremote.authenticate=false You can require your remote JMX endpoint to demand authentication for clients to be able to connect to it. To run a JVM with JMX remoting enabled with password authentication: * -Dcom.sun.management.jmxremote.port=19988 * -Dcom.sun.management.jmxremote.ssl=false * -Dcom.sun.management.jmxremote.authenticate=true * -Dcom.sun.management.jmxremote.password.file=/some/directory/jmxremote.password Note that "jmxremote.password" must be read-only. On Windows, you must use "cacls" command to do this: {code}cacls /some/directory/jmxremote.password /P username:R{code} A password file template is located at $JRE_HOME/lib/management/jmxremote.password.template. There is also an auth file that you can use to define other roles. For more information on setting this up and setting up SSL, see [Monitoring and Management Using JMX|http://java.sun.com/j2se/1.5.0/docs/guide/management/agent.html]. If you wish to expose your JBossAS 4 application server's MBeans over this remote JMX mechanism, you must pass in these extra properties, in addition to the properties specified above: * -Djboss.platform.mbeanserver * -Djavax.management.builder.initial=org.jboss.system.server.jmx.MBeanServerBuilderImpl

Child Resource Types

Autodiscovery Process Scans

Table 3.2211. Metrics

NameQuery
javaprocess|basename|match=^java.*

Connection Properties

Table 3.2212. 

NameDescriptionRequiredInternal Name
TypeThe EMS connection type for this JMX Server yes type
Connector AddressThe connection url in the form of a JMXServiceURL - this should only be set if the JVM has JMX Remoting enabled no connectorAddress
Install URIThe installation path for the selected server type which will be used to find client libraries (if appropriate) no installURI
PrincipalThe login principal/username no principal
CredentialsThe login credentials/password no credentials
Additional Class Path EntriesComma-separated list of directories and filenames that contain resources and classes needed to communicate with the JMX Server and its MBeans. If you specify 'some/directory/*.jar', all jars found in the given directory will be added. no additionalClassPathEntries
Command Linethe command line of the JVM at the time it was discovered - only used by JVMs with type Local; if the command line of the JVM changes, this property's value will need to be updated accordingly in order for RHQ to connect to the JVM no commandLine

Note

You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions.

Metrics

none

Configuration Properties

none

Operations

none

Package Types

none

3.9.1. JMX - Operating System Service

Overview

Table 3.2213. Overview

Description: 
Singleton: yes
Plugin:JMX

Child Resource Types

none

Connection Properties

Table 3.2214. 

NameDescriptionRequiredInternal Name
Object Name  yes objectName
Name Template  yes nameTemplate
Description Template  yes descriptionTemplate

Note

You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions.

Metrics

Table 3.2215. Metrics

NameTypeDescriptionInternal Name
Free Physical MemorymeasurementThe amount of free physical memory for the OSFreePhysicalMemorySize
Free Swap MemorymeasurementThe amount of free swap space for the OSFreeSwapSpaceSize
Process CPU TimemeasurementThe cpu time used by this processProcessCpuTime
Process CPU Time per MinutemeasurementThe cpu time used by this processProcessCpuTime
Committed Virtual MemorymeasurementSize of virtual memory used by this processCommittedVirtualMemorySize
Open FilesmeasurementThe number of files opened by this process. Note that this metric is not supported on Windows.OpenFileDescriptorCount

Note

You must use the internal name to reference Traits in Dynamic Group Definition expressions.

Configuration Properties

none

Operations

none

Package Types

none