Red Hat Training
A Red Hat training course is available for Red Hat JBoss Operations Network
3.3. Red Hat JBoss Enterprise Application Platform 6.x (EAP 6) and JBoss Application Server 7.x Plugin
Table 3.247. Basic Details
| Internal Name: | JBossAS7 |
| Description: | provides monitoring and management of JBossAS 7.x and JBoss EAP/JDG 6.x |
| Version: | 4.4.0 |
Top-Level Resource Types
3.3.1. JBossAS7 - Standalone Server
Overview
Table 3.248. Overview
| Description: | Standalone AS7 server |
| Singleton: | no |
| Plugin: | JBossAS7 |
Note
The server can be started, restarted, or stopped via the Start, Restart, and Shutdown operations. The Start and Restart operations start the server by executing the server start script, typically standalone.sh on UNIX or standalone.bat on Windows. The following connection settings can be used to configure the start script execution: * Start Script - the absolute path of the start script (e.g. "/opt/jboss-as-7.1.1.Final/bin/standalone.sh") * Start Script Prefix - a prefix command line to be prepended to the start script command line (e.g. "nohup sudo -u jboss -g jboss") * Start Script Arguments - arguments to be passed to the start script (e.g. "--server-config=standalone-full-ha.xml") * Start Script Environment - environment variables to be set in the start script's environment (e.g. "JAVA_HOME=/usr/java/jdk1.6.0_30") These settings are automatically initialized by the JBossAS7 plugin discovery code to match the currently running server process' command line and environment. The settings are not used by the Stop operation, since it stops the server via the management interface, not via a script. For more detailed descriptions of the settings, see the Connection Settings section below.
Child Resource Types
Autodiscovery Process Scans
Table 3.249. Metrics
| Name | Query |
|---|---|
| StandaloneAS | process|basename|match=^java.*,arg|org.jboss.as.standalone|match=.* |
Connection Properties
Table 3.250.
| Name | Description | Required | Internal Name |
|---|---|---|---|
| Start Script Path | The path to the script that the Start and Restart operations should use to start the server. If the path is not absolute, it is resolved relative to the server home directory (e.g. "bin/standalone.sh", "bin/domain.sh"). | no | startScript |
| Start Script Prefix | A prefix command line that should be prepended to the start script command line by the Start and Restart operations; the prefix command must be an absolute path (e.g. "/usr/bin/sudo"). This property is most commonly used to run the AS7 process as a different user than the RHQ Agent (e.g. "sudo -u jboss -g jboss" could be used to run AS7 as user "jboss" and group "jboss". It is also possible to chain prefix commands (e.g. "nohup sudo -u jboss" could be used to make AS7 ignore HUP signals and to run as user "jboss"). | no | startScriptPrefix |
| Start Script Environment Variables | The variables that the Start and Restart operations will add to the environment of the server start script. Each name=value pair should be on a new line. Variable values should *not* be enclosed in quotes (e.g. PATH=/usr/bin:/bin). On UNIX systems, the typical minimum set of environment variables is: PATH=/usr/bin:/bin . And on Windows the typical minimum set is: PATH=C:\Windows\System32;C:\Windows , OS=Windows_NT , SYSTEMROOT=C:\Windows . In addition, it is good practice to set JAVA_HOME to the absolute path of the install directory of the JRE or JDK you wish to use to run the AS7 instance. However, if JAVA_HOME is not specified, the start script will attempt to find java in the PATH. There is currently a 2000 character limit for this value. | no | startScriptEnv |
| Start Script Arguments | The arguments that the Start and Restart operations will pass to the server start script. Each argument should be on a new line - for example: --server-config=standalone-ha-full.xml. As an exception, the value of a space-delimited option can optionally be on the same line as the option - for example: -c standalone-ha-full.xml. There is currently a 2000 character limit for this value. | no | startScriptArgs |
| Additional JAVA_OPTS | Property used to make persistent changes to JAVA_OPTS. !!!WARNING!!! Feature available only if standard configuration file is used (standalone.conf or standalone.conf.bat). Please do not update the configuration file manually after setting this property. If value not set then configuration specific values are used. Value not set does not imply that configuration file does not set JAVA_OPTS, it simply means that the value was not set via RHQ. !!!WARNING!!! Value will be persisted to standalone.conf or standalone.conf.bat config file (OS dependent). Use this option to make the JAVA_OPTS configuration available for restarts outside of RHQ. The value (e.g.: -Xms512M -Xmx1024M) will be persisted in the configuration file. To remove any modifications done to the config file unset this property. The server requires restart for these changes to take effect. | no | javaOptsAdditional |
| Native Host | Native management API host | yes | nativeHost |
| Native Port | Native management API port | yes | nativePort |
| Native Local Authentication | Specifies if the local authentication should be used to interact with the EAP CLI (this includes bundle:handover feature, EAP patching and CLI operations). If this is set to "Yes", User and Password supplied above are NOT going to be passed to jboss-cli binary and plugin relies on local authentication. | no | nativeLocalAuth |
| Log Event Sources | yes | logEventSources | |
| Trust Strategy | Defines the trust strategy to use when reading the server certificate:
| yes | trustStrategy |
| Hostname Verification | Defines the hostname verification logic:
| yes | hostnameVerification |
| Truststore | Path to a truststore file. If undefined, the JVM default truststore is used. | no | truststore |
| Truststore Type | Truststore file format (required when the Truststore property is set). All certified JVMs support jks (Java KeyStore) or pkcs12 formats. | no | truststoreType |
| Truststore Password | Password protecting the truststore file. | no | truststorePassword |
| Client Certificate Authentication | yes | clientcertAuthentication | |
| Keystore | Path to a keystore file. Required when Client Certificate Authentication is on. | no | keystore |
| Keystore Type | Keystore file format (required when the Keystore property is set). All certified JVMs support jks (Java KeyStore) or pkcs12 formats. | no | keystoreType |
| Keystore Password | Password protecting the keystore file. | no | keystorePassword |
| Key Password | Password protecting the secret key in the keystore file. | no | keyPassword |
| Hostname | yes | hostname | |
| Port | yes | port | |
| Secure | Encrypted transport indicator | yes | secure |
| User | Management user for a secured AS | no | user |
| Password | Password for the management user | no | password |
| Management Connection Timeout | Maximum time in milliseconds to keep alive an idle management connection. Zero and negative values will disable connection persistence. Defaults to 5000 ms. | no | managementConnectionTimeout |
| Home Directory | Root directory of the server installation | no | homeDir |
| Base Directory | Base directory for server content | no | baseDir |
| Configuration Directory | Base configuration directory | no | configDir |
| Log Directory | the directory where log files will be written for this server | no | logDir |
| Product Type | Server product type (e.g. AS or EAP) | no | productType |
| Supports Patching | Whether this EAP server supports patching. This should be automatically deduced by the agent. It is highly recommended to leave this with the discovered value. However, you will need to manually update this value if you manually upgrade your server from a version that does not support patching to a version that does. | yes | supportsPatching |
Note
You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions.
Metrics
Table 3.251. Metrics
| Name | Type | Description | Internal Name |
|---|---|---|---|
| Number of management requests | measurement | Number of requests sent to the controller | _internal:mgmtRequests |
| Number of management requests per Minute | measurement | Number of requests sent to the controller | _internal:mgmtRequests |
| Time used for management requests | measurement | Total time for requests | _internal:requestTime |
| Time used for management requests per Minute | measurement | Total time for requests | _internal:requestTime |
| Maximum request time | measurement | Max time for a request since last metric get | _internal:maxTime |
| Server State | trait | Detailed server state | server-state |
| Server Code Name | trait | Server Code Name | _skm:release-codename |
| Server Version | trait | Server Version | _skm:release-version |
| Product Name | trait | Product Name | _skm:product-name |
| Product Version | trait | Product Version | _skm:product-version |
| Server Start Time | trait | Server Start Time | startTime |
| JGroups Multicast Address | trait | the host and port used by JGroups for multicast | multicastAddress |
| Server Config File | trait | The name of the server configuration file this server is using | config-file |
| Deploy Directory | trait | The deployment directory for file based bundles (usually 'standalone/deployments') | deployDir |
| Temporary Directory | trait | The temporary directory (usually 'standalone/tmp'). May serve as deployment directory for handover only bundles' | temp-dir |
| Active Patches | trait | The comma-separated list of patches that are currently applied to the server. The first entry is always the cumulative patch, followed by 0 or more one-off patches. | active-patches |
Note
You must use the internal name to reference Traits in Dynamic Group Definition expressions.
Configuration Properties
Table 3.252.
| Name | Description | Required | Internal Name |
|---|---|---|---|
| Properties | no | *2 | |
| Path | The standard paths provided by the system include: jboss.home - the root directory of the JBoss AS distribution; user.home - user's home directory; user.dir - user's current working directory; java.home - java installation directory; jboss.server.base.dir - root directory for an individual server instance; jboss.server.data.dir - directory the server will use for persistent data file storage; jboss.server.log.dir - directory the server will use for log file storage; jboss.server.tmp.dir - directory the server will use for temporary file storage; jboss.domain.servers.dir - directory under which a host controller will create the working area for individual server instances | no | *3 |
| Installed extensions | no | *1 | |
| Base Dir | The base directory for JBoss Application Server. | yes | base-dir |
| Config Dir | The directory where the configurations are stored. | yes | config-dir |
| Config File | The configuration file used to launch JBoss Application Server. | yes | config-file |
| Content Dir | The directory where user content (e.g. deployments) that is managed by the server is stored. | yes | content-dir |
| Data Dir | The data directory. | yes | data-dir |
| Deploy Dir | Deprecated variant of 'content-dir'. | yes | deploy-dir |
| Ext Dirs | A list of ext directories. | yes | ext-dirs |
| Home Dir | The home directory for JBoss Application Server. | yes | home-dir |
| Host Name | The host name. | yes | host-name |
| Initial Running Mode | The current running mode of the server. Either LIVE (normal operations) or ADMIN_ONLY. An ADMIN_ONLY server will start any configured management interfaces and accept management requests, but will not start services used for handling end user requests. | yes | initial-running-mode |
| Launch Type | The type of the running server. | yes | launch-type |
| Log Dir | The directory where log files are sent. | yes | log-dir |
| Modules Dir | The directory where modules are found. | yes | modules-dir |
| Node Name | The name of the server node. | yes | node-name |
| Qualified Host Name | The qualified host name. | yes | qualified-host-name |
| Server Name | The name of the server. | yes | server-name |
| Temp Dir | The temporary directory. | yes | temp-dir |
Note
You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions.
Operations
Table 3.253. Metrics
| Name | Description |
|---|---|
| Reload | Make the server re-load the (changed) configuration. To load a different startup config use 'restart' |
| Start | Start the server by invoking its start script |
| Restart | Restart the server by shutting it down and invoking its start script |
| Shutdown | Shut down the server. |
| Install RHQ user | Installs a user in the server for management |
| Execute CLI commands | Executes command via jboss-cli |
| Execute CLI script | Executes script via jboss-cli |
| Setup CLI | Setup jboss-cli.xml configuration file based on pluginConfiguration properties. Note that jboss-cli.xml was introduced in EAP 6.2 and this operation will fail for previous versions. |
Package Types
none
3.3.1.1. JBossAS7 - ModCluster Standalone Service
Overview
Table 3.254. Overview
| Description: | Mod_cluster support |
| Singleton: | yes |
| Plugin: | JBossAS7 |
Child Resource Types
Connection Properties
Table 3.255.
| Name | Description | Required | Internal Name |
|---|---|---|---|
| Path | yes | path |
Note
You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions.
Metrics
none
Configuration Properties
none
Operations
Table 3.256. Metrics
| Name | Description |
|---|---|
| Add Proxy | Add the proxy to the list of httpd connected to the node. |
| List Proxies | Read the list of httpd connected to the node. |
| Read Proxies Configuration | Send a DUMP to httpd and display the result. |
| Read Proxies Info | Send a INFO to httpd and display the result. |
| Refresh | Refresh the node sending a new CONFIG message to Apache httpd. |
| Remove Proxy | Remove the proxy to the list of httpd connected to the node. |
| Reset | Reset the node connection to Apache httpd. |
Package Types
none
3.3.1.1.1. JBossAS7 - Service Configuration Service
Overview
Table 3.257. Overview
| Description: | |
| Singleton: | no |
| Plugin: | JBossAS7 |
Child Resource Types
Connection Properties
Table 3.258.
| Name | Description | Required | Internal Name |
|---|---|---|---|
| Path | yes | path |
Note
You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions.
Metrics
none
Configuration Properties
Table 3.259.
| Name | Description | Required | Internal Name |
|---|---|---|---|
| Proxy List | List of proxies, Format (hostname:port) separated with commas. | no | proxy-list |
| Proxy Url | Base URL for MCMP requests. | no | proxy-url |
| Advertise Socket | Name of Socket binding to use for the Advertise socket. | no | advertise-socket |
| Advertise | Use Advertise logic or not. | no | advertise |
| Advertise Security Key | String containing the security key for the Advertise logic. | no | advertise-security-key |
| Balancer | The balancer name. | no | balancer |
| Connector | Name of the web connector used to communicate with the load balancer. | yes | connector |
| Load Balancing Group | loadBalancingGroup name. | no | load-balancing-group |
| Excluded Contexts | List of contexts mod_cluster should ignore, Format String separated with commas. | no | excluded-contexts |
| Auto Enable Contexts | Enable contexts even if disabled in mod_cluster_manger (httpd). | no | auto-enable-contexts |
| Sticky Session | Use sticky sessions for requests. | no | sticky-session |
| Sticky Session Remove | Remove session information on failover. | no | sticky-session-remove |
| Sticky Session Force | Don't failover a request with session information. | no | sticky-session-force |
| Worker Timeout | Timeout to wait in httpd for an available worker to process the requests. | no | worker-timeout |
| Max Attempts | Max attempts to process an idempotent request. | no | max-attempts |
| Flush Packets | Enables/disables packet flushing in httpd. | no | flush-packets |
| Flush Wait | Time to wait before flushing packets in httpd. | no | flush-wait |
| Ping | Time (in seconds) in which to wait for a pong answer to a ping. | no | ping |
| Smax | Soft maximum idle connection count in httpd | no | smax |
| Ttl | Time to live (in seconds) for idle connections above smax | no | ttl |
| Node Timeout | Timeout (in seconds) for proxy connections to a node. | no | node-timeout |
| Stop Context Timeout | Max time to wait for context to process pending requests. | no | stop-context-timeout |
| Socket Timeout | Timeout to wait for httpd to answer a MCMP message. | no | socket-timeout |
Note
You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions.
Operations
Table 3.260. Metrics
| Name | Description |
|---|---|
| Add Custom Metric | Add new custom metric to the load balancer provider. |
| Add Metric | Add new metric to the load balancer provider. |
| Remove Custom Metric | Remove a custom metric from the load balancer provider. |
| Remove Metric | Add new metric to the load balancer provider. |
Package Types
none
3.3.1.1.1.1. JBossAS7 - Dynamic Load Provider Service
Table 3.261. Overview
| Description: | |
| Singleton: | no |
| Plugin: | JBossAS7 |
Table 3.262.
| Name | Description | Required | Internal Name |
|---|---|---|---|
| Path | yes | path |
Note
You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions.
none
Table 3.263.
| Name | Description | Required | Internal Name |
|---|---|---|---|
| Decay | Decay. The default value is 2. | no | decay |
| History | History. The default value is 9. | no | history |
Note
You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions.
none
none
3.3.1.1.1.1.1. JBossAS7 - Custom Load Metric Service
Table 3.264. Overview
| Description: | |
| Singleton: | no |
| Plugin: | JBossAS7 |
none
Table 3.265.
| Name | Description | Required | Internal Name |
|---|---|---|---|
| Path | yes | path |
Note
You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions.
none
Table 3.266.
| Name | Description | Required | Internal Name |
|---|---|---|---|
| Capacity | Capacity of the metric. The default value is 1 | no | capacity |
| Class | Class name of the custom metric. | yes | class |
| Weight | Weight of the metric. The default value is 1. | no | weight |
Note
You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions.
none
none
3.3.1.1.1.1.2. JBossAS7 - Load Metric Service
Table 3.267. Overview
| Description: | |
| Singleton: | no |
| Plugin: | JBossAS7 |
none
Table 3.268.
| Name | Description | Required | Internal Name |
|---|---|---|---|
| Path | yes | path |
Note
You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions.
none
Table 3.269.
| Name | Description | Required | Internal Name |
|---|---|---|---|
| Capacity | Capacity of the metric. The default value is 1. | no | capacity |
| Type | Type of the metric | yes | type |
| Weight | Weight of the metric. The default value is 1. | no | weight |
Note
You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions.
none
none
3.3.1.1.1.2. JBossAS7 - Ssl Service
Table 3.270. Overview
| Description: | |
| Singleton: | no |
| Plugin: | JBossAS7 |
none
Table 3.271.
| Name | Description | Required | Internal Name |
|---|---|---|---|
| Path | yes | path |
Note
You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions.
none
Table 3.272.
| Name | Description | Required | Internal Name |
|---|---|---|---|
| Ca Certificate File | Certificate authority. | no | ca-certificate-file |
| Ca Revocation Ur | Certificate authority revocation list. | no | ca-revocation-ur |
| Certificate Key File | Key file for the certificate. | no | certificate-key-file |
| Cipher Suite | The allowed cipher suite. | no | cipher-suite |
| Key Alias | The key alias. | no | key-alias |
| Password | Password. | no | password |
| Protocol | The SSL protocols that are enabled. | no | protocol |
Note
You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions.
none
none
3.3.1.2. JBossAS7 - JVM Service
Overview
Table 3.273. Overview
| Description: | Information about the underlying JVM |
| Singleton: | yes |
| Plugin: | JBossAS7 |
Child Resource Types
Connection Properties
Table 3.274.
| Name | Description | Required | Internal Name |
|---|---|---|---|
| Path | yes | path |
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.3.1.2.1. JBossAS7 - Operating System Service
Overview
Table 3.275. Overview
| Description: | |
| Singleton: | yes |
| Plugin: | JBossAS7 |
Child Resource Types
none
Connection Properties
Table 3.276.
| Name | Description | Required | Internal Name |
|---|---|---|---|
| Path | yes | path |
Note
You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions.
Metrics
Table 3.277. Metrics
| Name | Type | Description | Internal Name |
|---|---|---|---|
| Available Processors | measurement | The number of processors available to the Java virtual machine. | available-processors |
| System Load Average | measurement | The system load average for the last minute. The load average may not be available on some platforms; if the load average is not available, a negative value is returned. | system-load-average |
Note
You must use the internal name to reference Traits in Dynamic Group Definition expressions.
Configuration Properties
none
Operations
none
Package Types
none
3.3.1.2.2. JBossAS7 - Memory Service
Overview
Table 3.278. Overview
| Description: | |
| Singleton: | yes |
| Plugin: | JBossAS7 |
Child Resource Types
none
Connection Properties
Table 3.279.
| Name | Description | Required | Internal Name |
|---|---|---|---|
| Path | yes | path |
Note
You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions.
Metrics
Table 3.280. Metrics
| Name | Type | Description | Internal Name |
|---|---|---|---|
| Object Pending Finalization Count | measurement | The approximate number of objects for which finalization is pending. | object-pending-finalization-count |
| Initial heap usage | measurement | The amount of memory in bytes that the Java virtual machine initially requests from the operating system for memory management. | heap-memory-usage:init |
| Used heap | measurement | The amount of used memory in bytes. | heap-memory-usage:used |
| Committed heap | measurement | The amount of memory in bytes that is committed for the Java virtual machine to use. | heap-memory-usage:committed |
| Maximum heap usage | measurement | The maximum amount of memory in bytes that can be used for memory management. | heap-memory-usage:max |
| Initial non-heap usage | measurement | The amount of memory in bytes that the Java virtual machine initially requests from the operating system for memory management. | non-heap-memory-usage:init |
| Used non-heap memory | measurement | The amount of used memory in bytes. | non-heap-memory-usage:used |
| Committed non-heap memory | measurement | The amount of memory in bytes that is committed for the Java virtual machine to use. | non-heap-memory-usage:committed |
| Maximum non-heap usage | measurement | The maximum amount of memory in bytes that can be used for memory management. | non-heap-memory-usage:max |
Note
You must use the internal name to reference Traits in Dynamic Group Definition expressions.
Configuration Properties
none
Operations
Table 3.281. Metrics
| Name | Description |
|---|---|
| Trigger GC | Runs the garbage collector. |
Package Types
none
3.3.1.2.3. JBossAS7 - Runtime Service
Overview
Table 3.282. Overview
| Description: | |
| Singleton: | yes |
| Plugin: | JBossAS7 |
Child Resource Types
none
Connection Properties
Table 3.283.
| Name | Description | Required | Internal Name |
|---|---|---|---|
| Path | yes | path |
Note
You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions.
Metrics
Table 3.284. Metrics
| Name | Type | Description | Internal Name |
|---|---|---|---|
| Uptime | measurement | The uptime of the Java virtual machine in milliseconds. | uptime |
Note
You must use the internal name to reference Traits in Dynamic Group Definition expressions.
Configuration Properties
none
Operations
none
Package Types
none
3.3.1.2.4. JBossAS7 - Threading Service
Overview
Table 3.285. Overview
| Description: | |
| Singleton: | no |
| Plugin: | JBossAS7 |
Child Resource Types
none
Connection Properties
Table 3.286.
| Name | Description | Required | Internal Name |
|---|---|---|---|
| Path | yes | path |
Note
You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions.
Metrics
Table 3.287. Metrics
| Name | Type | Description | Internal Name |
|---|---|---|---|
| Thread Count | measurement | The current number of live threads including both daemon and non-daemon threads. | thread-count |
| Peak Thread Count | measurement | The peak live thread count since the Java virtual machine started or peak was reset. | peak-thread-count |
| Total Started Thread Count | measurement | The total number of threads created and also started since the Java virtual machine started. | total-started-thread-count |
| Daemon Thread Count | measurement | The current number of live daemon threads. | daemon-thread-count |
| Current Thread Cpu Time | measurement | The total CPU time for the current thread in nanoseconds, or -1 if 'thread-cpu-time-enabled' is 'false'. A Java virtual machine implementation may not support CPU time measurement. If 'thread-cpu-time-supported', is 'false' undefined. | current-thread-cpu-time |
| Current Thread User Time | measurement | The CPU time that the current thread has executed in user mode in nanoseconds, or -1 if 'thread-cpu-time-enabled' is 'false'. A Java virtual machine implementation may not support CPU time measurement. If 'thread-cpu-time-supported', is 'false' the result will be undefined | current-thread-user-time |
Note
You must use the internal name to reference Traits in Dynamic Group Definition expressions.
Configuration Properties
Table 3.288.
| Name | Description | Required | Internal Name |
|---|---|---|---|
| Thread Contention Monitoring Enabled | Whether thread contention monitoring is enabled. | no | thread-contention-monitoring-enabled |
| Thread Cpu Time Enabled | Whether thread CPU time measurement is enabled. | no | thread-cpu-time-enabled |
| Thread Contention Monitoring Supported | Whether the Java virtual machine supports thread contention monitoring. | no | thread-contention-monitoring-supported |
| Thread Cpu Time Supported | Whether the Java virtual machine implementation supports CPU time measurement for any thread. | no | thread-cpu-time-supported |
| Current Thread Cpu Time Supported | Whether the Java virtual machine supports CPU time measurement for the current thread. | no | current-thread-cpu-time-supported |
| Object Monitor Usage Supported | Whether the Java virtual machine supports monitoring of object monitor usage. | no | object-monitor-usage-supported |
| Synchronizer Usage Supported | Whether the Java virtual machine supports monitoring of ownable synchronizer usage. | no | synchronizer-usage-supported |
Note
You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions.
Operations
Table 3.289. Metrics
| Name | Description |
|---|---|
| Dump All Threads | Returns the thread info for all live threads with stack trace and synchronization information. |
| Find Deadlocked Threads | Finds cycles of threads that are in deadlock waiting to acquire object monitors or ownable synchronizers. |
| Find Monitor Deadlocked Threads | Finds cycles of threads that are in deadlock waiting to acquire object monitors. |
| Get Thread Cpu Time | Returns the total CPU time for a thread of the specified ID in nanoseconds. |
| Get Thread Info | Returns the thread info for a thread of the specified id. The stack trace, locked monitors, and locked synchronizers in the returned reply object will be empty. |
| Get Thread Infos | Returns the thread info for each thread whose ID is in the input list. |
| Get Thread User Time | Returns the CPU time that a thread of the specified ID has executed in user mode in nanoseconds. |
| Reset Peak Thread Count | Resets the peak thread count to the current number of live threads. |
| Get All thread ids | Get all live thread IDs. If a security manager is installed and the caller does not have ManagementPermission('monitor'), the result will be undefined. |
Package Types
none
3.3.1.2.5. JBossAS7 - Garbage Collector Service
Overview
Table 3.290. Overview
| Description: | Parent resource for the resources providing the management interface for the garbage collection of the Java virtual machine. |
| Singleton: | yes |
| Plugin: | JBossAS7 |
Child Resource Types
Connection Properties
Table 3.291.
| Name | Description | Required | Internal Name |
|---|---|---|---|
| Path | yes | path |
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.3.1.2.5.1. JBossAS7 - Garbage Collector Resource Service
Table 3.292. Overview
| Description: | The management interface for one of the garbage collectors in the Java virtual machine. |
| Singleton: | no |
| Plugin: | JBossAS7 |
none
Table 3.293.
| Name | Description | Required | Internal Name |
|---|---|---|---|
| Path | yes | path | |
| Include Runtime | yes | includeRuntime |
Note
You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions.
Table 3.294. Metrics
| Name | Type | Description | Internal Name |
|---|---|---|---|
| Collection Count | measurement | The total number of collections that have occurred. | collection-count |
| Collection Count per Minute | measurement | The total number of collections that have occurred. | collection-count |
| Collection Time | measurement | The approximate accumulated collection elapsed time in milliseconds. | collection-time |
| Collection Time per Minute | measurement | The approximate accumulated collection elapsed time in milliseconds. | collection-time |
| Name | trait | The name representing this garbage collector | name |
| Valid | trait | Whether this this memory manager is valid in the Java virtual machine. | valid |
Note
You must use the internal name to reference Traits in Dynamic Group Definition expressions.
Table 3.295.
| Name | Description | Required | Internal Name |
|---|---|---|---|
| Memory Pool Names | The name of memory pools that this garbage collector manages. | yes | memory-pool-names |
Note
You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions.
none
none
3.3.1.2.6. JBossAS7 - Memory Pool Service
Overview
Table 3.296. Overview
| Description: | Parent resource for the resources providing the management interface for the Java virtual machine's memory pools. |
| Singleton: | yes |
| Plugin: | JBossAS7 |
Child Resource Types
Connection Properties
Table 3.297.
| Name | Description | Required | Internal Name |
|---|---|---|---|
| Path | yes | path |
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.3.1.2.6.1. JBossAS7 - Memory Pool Resource Service
Table 3.298. Overview
| Description: | The management interface for a memory pool. A memory pool represents the memory resource managed by the Java virtual machine and is managed by one or more memory managers. |
| Singleton: | no |
| Plugin: | JBossAS7 |
none
Table 3.299.
| Name | Description | Required | Internal Name |
|---|---|---|---|
| Path | yes | path | |
| Include Runtime | yes | includeRuntime |
Note
You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions.
Table 3.300. Metrics
| Name | Type | Description | Internal Name |
|---|---|---|---|
| Collection Usage - Init | measurement | The amount of memory in bytes that the Java virtual machine initially requests from the operating system for memory management. | collection-usage:init |
| Collection Usage - Used | measurement | The amount of used memory in bytes. | collection-usage:used |
| Collection Usage - Committed | measurement | The amount of memory in bytes that is committed for the Java virtual machine to use. | collection-usage:committed |
| Collection Usage - Max | measurement | The maximum amount of memory in bytes that can be used for memory management. | collection-usage:max |
| Collection Usage Threshold Count | measurement | The number of times that the Java virtual machine has detected that the memory usage has reached or exceeded the collection usage threshold. A memory pool may not support a collection usage threshold. If 'collection-usage-threshold-supported', is 'false' trying to read this attribute via the 'read-attribute' operation will result in failure, and the value of this attribute in the result of a 'read-resource' operation will be 'undefined'. | collection-usage-threshold-count |
| Collection Usage Threshold Exceeded | trait | Whether the memory usage of this memory pool after the most recent collection on which the Java virtual machine has expended effort has reached or exceeded its collection usage threshold. A memory pool may not support a collection usage threshold. If 'collection-usage-threshold-supported', is 'false' trying to read this attribute via the 'read-attribute' operation will result in failure, and the value of this attribute in the result of a 'read-resource' operation will be 'undefined'. | collection-usage-threshold-exceeded |
| Collection Usage Threshold Supported | trait | Whether this memory pool supports a collection usage threshold. | collection-usage-threshold-supported |
| Name | trait | The name representing this memory pool. | name |
| Peak Usage - Init | measurement | The amount of memory in bytes that the Java virtual machine initially requests from the operating system for memory management. | peak-usage:init |
| Peak Usage - Used | measurement | The amount of used memory in bytes. | peak-usage:used |
| Peak Usage - Committed | measurement | The amount of memory in bytes that is committed for the Java virtual machine to use. | peak-usage:committed |
| Peak Usage - Max | measurement | The maximum amount of memory in bytes that can be used for memory management. | peak-usage:max |
| Type | trait | The type of this memory pool. | type |
| Usage - Init | measurement | The amount of memory in bytes that the Java virtual machine initially requests from the operating system for memory management. | usage:init |
| Usage - Used | measurement | The amount of used memory in bytes. | usage:used |
| Usage - Committed | measurement | The amount of memory in bytes that is committed for the Java virtual machine to use. | usage:committed |
| Usage - Max | measurement | The maximum amount of memory in bytes that can be used for memory management. | usage:max |
| Usage Threshold Count | measurement | The number of times that the memory usage has crossed the usage threshold. A memory pool may not support a usage threshold. If 'usage-threshold-supported', is 'false' trying to read this attribute via the 'read-attribute' operation will result in failure, and the value of this attribute in the result of a 'read-resource' operation will be 'undefined'. | usage-threshold-count |
| Usage Threshold Exceeded | trait | Whether the memory usage of this memory pool reaches or exceeds its usage threshold value. A memory pool may not support a usage threshold. If 'usage-threshold-supported', is 'false' trying to read this attribute via the 'read-attribute' operation will result in failure, and the value of this attribute in the result of a 'read-resource' operation will be 'undefined'. | usage-threshold-exceeded |
| Usage Threshold Supported | trait | Whether this memory pool supports usage threshold. | usage-threshold-supported |
| Valid | trait | Whether this memory pool is valid in the Java virtual machine. A memory pool becomes invalid once the Java virtual machine removes it from the memory system. | valid |
Note
You must use the internal name to reference Traits in Dynamic Group Definition expressions.
Table 3.301.
| Name | Description | Required | Internal Name |
|---|---|---|---|
| Collection Usage Threshold | The collection usage threshold value of this memory pool in bytes. A memory pool may not support a collection usage threshold. If 'collection-usage-threshold-supported', is 'false' trying to read this attribute via the 'read-attribute' operation will result in failure, and the value of this attribute in the result of a 'read-resource' operation will be 'undefined'. | no | collection-usage-threshold |
| Memory Manager Names | The names of the memory managers that manage this memory pool. | yes | memory-manager-names |
| Usage Threshold | The usage threshold value of this memory pool in bytes. A memory pool may not support a usage threshold. If 'usage-threshold-supported', is 'false' trying to read this attribute via the 'read-attribute' operation will result in failure, and the value of this attribute in the result of a 'read-resource' operation will be 'undefined'. | no | usage-threshold |
Note
You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions.
Table 3.302. Metrics
| Name | Description |
|---|---|
| Reset Peak Usage | Resets the peak memory usage statistic of this memory pool to the current memory usage. |
none
3.3.1.3. JBossAS7 - JBossWeb Service
Overview
Table 3.303. Overview
| Description: | |
| Singleton: | yes |
| Plugin: | JBossAS7 |
Child Resource Types
Connection Properties
Table 3.304.
| Name | Description | Required | Internal Name |
|---|---|---|---|
| Path | yes | path |
Note
You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions.
Metrics
none
Configuration Properties
Table 3.305.
| Name | Description | Required | Internal Name |
|---|---|---|---|
| Disabled: 0 | Enable the default Servlet mapping. The default value is false. | no | disabled:0 |
| File Encoding | Force a file encoding. | no | file-encoding |
| Listings | Enable folder listings. The default value is false. | no | listings |
| Max Depth | Maximum recursion for PROPFIND. The default value is 3. | no | max-depth |
| Read Only | Allow write HTTP methods (PUT, DELETE). The default value is true. | no | read-only |
| Sendfile | Enable sendfile if possible, for files bigger than the specified byte size. The default value is 49152. | no | sendfile |
| Secret | Secret for WebDAV locking operations. | no | secret |
| Webdav | Enable WebDAV functionality. The default value is false. | no | webdav |
| Check Interval | Check interval for JSP updates using a background thread. The default value is 0. | no | check-interval |
| Development | Enable the development mode, which gives more information when an error occurs. The default value is false. | no | development |
| Disabled: 1 | Enable the JSP container. The default value is false. | no | disabled:1 |
| Display Source Fragment | When a runtime error occurs, attempts to display corresponding JSP source fragment. The default value is true. | no | display-source-fragment |
| Dump Smap | Write SMAP data to a file. The default value is false. | no | dump-smap |
| Error On Use Bean Invalid Class Attribute | Enable errors when using a bad class in useBean. The default value is false. | no | error-on-use-bean-invalid-class-attribute |
| Generate Strings As Char Arrays | Generate String constants as char arrays. The default value is false. | no | generate-strings-as-char-arrays |
| Java Encoding | Specify the encoding used for Java sources. The default value is UTF8. | no | java-encoding |
| Keep Generated | Keep the generated Servlets. The default value is true. | no | keep-generated |
| Mapped File | Map to the JSP source. The default value is true. | no | mapped-file |
| Modification Test Interval | Minimum amount of time between two tests for updates, in seconds. The default value is 4. | no | modification-test-interval |
| Recompile On Fail | Retry failed JSP compilations on each request. The default value is false. | no | recompile-on-fail |
| Scratch Dir | Specify a different work directory. | no | scratch-dir |
| Smap | Enable SMAP. The default value is true. | no | smap |
| Source Vm | Source VM level for compilation. The default value is 1.5. | no | source-vm |
| Tag Pooling | Enable tag pooling. The default value is true. | no | tag-pooling |
| Target Vm | Target VM level for compilation. The default value is 1.5. | no | target-vm |
| Trim Spaces | Trim some spaces from the generated Servlet. The default value is false. | no | trim-spaces |
| X Powered By | Enable advertising the JSP engine in x-powered-by. The default value is true. | no | x-powered-by |
| Welcome File | A welcome file declaration. | no | welcome-file |
| Default Virtual Server | The web container's default virtual server. The default value is default-host. | yes | default-virtual-server |
| Instance Id | The identifier for this server instance. | no | instance-id |
| Native | Add the native initialization listener to the web container. The default value is true. | no | native |
Note
You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions.
Operations
none
Package Types
none
3.3.1.3.1. JBossAS7 - Connector Service
Overview
Table 3.306. Overview
| Description: | |
| Singleton: | no |
| Plugin: | JBossAS7 |
Child Resource Types
none
Connection Properties
Table 3.307.
| Name | Description | Required | Internal Name |
|---|---|---|---|
| Path | yes | path |
Note
You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions.
Metrics
Table 3.308. Metrics
| Name | Type | Description | Internal Name |
|---|---|---|---|
| Bytes Sent | measurement | Number of byte sent by the connector. | bytesSent |
| Bytes Sent per Minute | measurement | Number of byte sent by the connector. | bytesSent |
| Bytes Received | measurement | Number of byte received by the connector (POST data). | bytesReceived |
| Bytes Received per Minute | measurement | Number of byte received by the connector (POST data). | bytesReceived |
| Processing Time | measurement | Processing time used by the connector. Im milli-seconds. | processingTime |
| Processing Time per Minute | measurement | Processing time used by the connector. Im milli-seconds. | processingTime |
| Error Count | measurement | Number of error that occurs when processing requests by the connector. | errorCount |
| Error Count per Minute | measurement | Number of error that occurs when processing requests by the connector. | errorCount |
| Max Time | measurement | Max time spent to process a requests. | maxTime |
| Request Count | measurement | Number of the request processed by the connector. | requestCount |
| Request Count per Minute | measurement | Number of the request processed by the connector. | requestCount |
| Max connections | measurement | Number of max connections this connector can handle (see configuration to set it) | _expr:max-connections |
Note
You must use the internal name to reference Traits in Dynamic Group Definition expressions.
Configuration Properties
Table 3.309.
| Name | Description | Required | Internal Name |
|---|---|---|---|
| Configuration | no | *Configuration+ | |
| Scheme | The web connector scheme. | yes | scheme |
| Socket Binding | The web connector socket-binding reference, this connector should be bound to. | yes | socket-binding |
| Enabled | Defines whether the connector should be started on startup. The default value is true. | no | enabled |
| Enable Lookups | Enable DNS lookups for Servlet API. The default value is false. | no | enable-lookups |
| Executor | The name of the executor that should be used for the processing threads of this connector. If undefined defaults to using an internal pool. | no | executor |
| Max connections | Amount of concurrent connections that can be processed by the connector with optimum performance. The default value depends on the connector used. | no | max-connections:expr |
| Max Post Size | Maximum size in bytes of a POST request that can be parsed by the container. The default value is 2097152. | no | max-post-size |
| Max Save Post Size | Maximum size in bytes of a POST request that will be saved during certain authentication schemes. The default value is 4096. | no | max-save-post-size |
| Name | A unique name for the connector. | no | name |
| Protocol | The web connector protocol. (e.g. 'HTTP/1.1' or 'AJP' or a name of a class implementing ProtocolHandler and MBeanRegistration ) | yes | protocol |
| Proxy Name | The host name that will be used when sending a redirect. The default value is null. | no | proxy-name |
| Proxy Port | The port that will be used when sending a redirect. | no | proxy-port |
| Redirect Port | The port for redirection to a secure connector. The default value is 8433. | no | redirect-port:expr |
| Secure | Indicates if content sent or received by the connector is secured from the user perspective. The default value is false. | no | secure |
| Virtual Server | The list of virtual servers that can be accessed through this connector. The default is to allow all virtual servers. | no | virtual-server |
Note
You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions.
Operations
none
Package Types
none
3.3.1.3.2. JBossAS7 - VHost Service
Overview
Table 3.310. Overview
| Description: | |
| Singleton: | no |
| Plugin: | JBossAS7 |