このコンテンツは選択した言語では利用できません。
3.9. JMX - Server
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
Name | Query |
---|---|
java | process|basename|match=^java.* |
Connection Properties
Name | Description | Required | Internal Name |
---|---|---|---|
Type | The EMS connection type for this JMX Server | yes | type |
Connector Address | The connection url in the form of a JMXServiceURL - this should only be set if the JVM has JMX Remoting enabled | no | connectorAddress |
Install URI | The installation path for the selected server type which will be used to find client libraries (if appropriate) | no | installURI |
Principal | The login principal/username | no | principal |
Credentials | The login credentials/password | no | credentials |
Additional Class Path Entries | Comma-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 Line | the 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
Description: | |
Singleton: | yes |
Plugin: | JMX |
Child Resource Types
none
Connection Properties
Name | Description | Required | Internal 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
Name | Type | Description | Internal Name |
---|---|---|---|
Free Physical Memory | measurement | The amount of free physical memory for the OS | FreePhysicalMemorySize |
Free Swap Memory | measurement | The amount of free swap space for the OS | FreeSwapSpaceSize |
Process CPU Time | measurement | The cpu time used by this process | ProcessCpuTime |
Process CPU Time per Minute | measurement | The cpu time used by this process | ProcessCpuTime |
Committed Virtual Memory | measurement | Size of virtual memory used by this process | CommittedVirtualMemorySize |
Open Files | measurement | The 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