JMX Monitoring (Sun Identity Manager 8.1 Resources Reference)

Sun Identity Manager 8.1 Resources Reference

JMX Monitoring

The JMS Listener adapter provides multiple attributes and operations that can be monitored with Java Management Extensions (JMX). For detailed information about configuring JMX on an Identity Manager server, refer to the Configuration chapter in Business Administrator's Guide.

On the server running the Active Sync process, (which also contains the authoritative mbean), statistics are computed based on a specified window of time. The setWindowMillis operation sets the duration of the window. Each time the statistics are computed, the actual duration of the statistics window is recorded as the ActualWindowTime attribute.

For example, the setWindowMillis operation could be set to 10000 (10 seconds), but the ActualWindowTime could contain a value of 10005, indicating the actual window was 10.005 seconds. Other attributes, such as MsgCountInWindow, use the actual window to measure or count statistics. If MsgCountInWindow contained a value of 63, then 63 messages were retrieved from JMS in 10.005 seconds.

The following tables list the attributes and operations the adapter makes available to JMX. The attributes and operations can be viewed from the JMX console under IDM/Cluster/ Synchronization/Active Sync/JMS Listener/SyncStats:DestinationName. The value for DestinationName is generated by concatenating the values of the Destination Type and JNDI name of Destination resource parameters.

JMX Attributes

Attribute	Description
`ActualWindowTime`	Indicates the actual time, in milliseconds, of the most recent window.
`Attributes`	Lists the values for the adapter’s resource parameters.
`Authoritative`	Indicates whether the server is the one running the Active Sync process.
`AvgMsgWaitTime`	Indicates the average time, in milliseconds, spent waiting for messages.
`AvgProcessTime`	Indicates the average time, in milliseconds, spent processing messages.
`CurrentMsgWaitStart`	Indicates the date and time when the wait for the current message wait started, or null if no wait is pending.
`CurrentMsgWaitTime`	Indicates the number of milliseconds spent waiting for a message.
`CurrentPollStart`	Indicates the date and time when Active Sync last started, if Active Sync is currently running.
`CurrentProcessStart`	Indicates the date and time when processing started for the message currently being processed.
`CurrentProcessTime`	Indicates the total number of milliseconds spent processing the current message. A value of 0 indicates no message is being processed.
`LastCalculatedPollTime`	Indicates the total number of milliseconds in the poll loop, including current poll, as of the last time it was calculated.
`MaxMsgWaitTime`	Indicates the maximum number of milliseconds spent waiting for a single message.
`MaxPollTime`	Indicates the maximum milliseconds for one poll cycle.
`MaxProcessTime`	Indicates the maximum number of milliseconds spent processing a single message.
`MsgCountInWindow`	Indicates the number of messages recieved durring the last window of time.
`MsgPerUnittime`	Indicates the number of messages processed during the specified window.
`PollMsgWaitPercent`	Indicates the percentage of time spent waiting for messages.
`PollOtherPercent`	Indicates the percentage of time spent as overhead.
`PollProcessPercent`	Indicates the percentage of time spent processing messages.
`PollStatistics`	Indicates the actual time of the most recent window.
`TotMsgCount`	Indicates the total number of messages received.
`TotMsgWaitTime`	Indicates the total number of milliseconds spent waiting for messages.
`TotProcessTime`	Indicates the total milliseconds spent processing messages.

JMX Operations

Operation	Description
`getWindowMillis`	Gets the duration of the statistics window, in milliseconds. This operation is available only if the authoritative attribute is true.
`refreshAttributes`	Returns the latest values of the resource attributes.
`resetStatistics`	Resets the statistics of the adapter. This operation is available only if the authoritative attribute is true.
`setWindowMillis`	Sets the duration, in milliseconds, of the statistics window. This operation is available only if the authoritative attribute is true.