Monitoring Agent for WebSphere MQ Version 7.3.0.11 Reference IBM Monitoring Agent for WebSphere MQ Version 7.3.0.11 Reference IBM Note Before using this information and the product it supports, read the information in “Notices” on page 319. This edition applies to version 7.3.0.11 of the Monitoring Agent for WebSphere MQ and to all subsequent releases and modifications until otherwise indicated in new editions. © Copyright IBM Corporation 1996, 2018. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Chapter 1. Monitoring Agent for Message Summary data set........ 189 WebSphere MQ ........... 1 MQ Action Log data set ......... 199 MQ Channel Statistics data set ...... 203 Chapter 2. Dashboards ........ 3 MQ Queue Statistics data set ....... 208 MQI Call Statistics Details data set ..... 218 Default dashboards ............ 3 MQI Message Statistics Details data set.... 222 Widgets for the Default dashboards....... 4 MQI Statistics data set ......... 224 Custom views ............. 15 MQSeries Events data set ........ 234 Namelist data set ........... 237 Chapter 3. Thresholds ........ 17 Object Attribute Details data set ...... 238 Predefined thresholds ........... 17 Publish Subscribe Status data set ...... 240 Customized thresholds .......... 23 Queue Accounting data set ........ 240 Queue Data data set .......... 249 Chapter 4. Attributes ......... 25 Queue Definition Details data set...... 254 Data sets for the monitoring agent....... 26 Queue Definitions data set ........ 261 Attribute descriptions ........... 29 Queue Handle Status data set ....... 265 Application Accounting data set ...... 29 Queue Long-Term History data set ..... 269 Application Connections data set ...... 38 Queue Short Term History data set ..... 276 Channel Data data set .......... 43 Queue Statistics data set......... 284 Channel Definition Details data set ..... 46 Queue Status data set ......... 291 Channel Definitions data set........ 52 Service Status data set ......... 294 Channel Long-Term History data set ..... 55 Subscription Definitions data set ...... 296 Channel Short-Term History data set ..... 64 Subscription Status data set ....... 300 Channel Statistics data set ........ 72 Telemetry Channels data set ....... 302 Channel Status data set ......... 81 Topic Definitions data set ........ 304 Channel Summary data set ........ 91 Topic Publishers data set ........ 308 Connection Objects data set ........ 98 Topic Status data set .......... 309 Current Events data set ......... 100 Topic Subscribers data set ........ 313 Current Queue Manager Status data set ... 104 Error Log data set ........... 109 Accessibility features ........ 317 Event Archive data set ......... 111 Event Details data set ......... 115 Notices .............. 319 Event History data set ......... 132 Trademarks .............. 321 Listener Status data set ......... 136 Terms and conditions for product documentation 321 Manager Definition Details data set ..... 139 IBM Online Privacy Statement........ 322 Managers data set ........... 154 Message Data data set ......... 169 Index ............... 323 Message Details data set......... 175 Message Statistics data set ........ 185 © Copyright IBM Corp. 1996, 2018 iii iv Monitoring Agent for WebSphere MQ Reference Chapter 1. Monitoring Agent for WebSphere MQ The Monitoring Agent for WebSphere MQ offers a central point of management for your IBM MQ environment or application. The software provides a comprehensive means for gathering the information that is required to detect problems early and to prevent them. Information is standardized across the system. You can monitor multiple servers from a single console. By using the WebSphere MQ agent you can easily collect and analyze IBM MQ specific information. Installing and configuring the agent Install the monitoring agent on the system where the application that you want to monitor is located. For more information, see the agent installation and configuration topics in IBM Knowledge Center: v IBM Cloud Application Performance Management v IBM Cloud Application Performance Management, Private For supported operating systems, see System Requirements in the APM Developer Center. © Copyright IBM Corp. 1996, 2018 1 2 Monitoring Agent for WebSphere MQ Reference Chapter 2. Dashboards Open the Application Performance Dashboard in the Cloud APM console to see a status summary of all your applications. As you drill down to dashboards for specific applications and their supporting elements, more details are available about the selected item. Use the WebSphere MQ agent dashboards to proactively monitor your IBM MQ deployment. Each dashboard page contains views with key performance indicators. When an application that includes IBM MQ managed resources is selected, the navigator and the Status Overview tab show IBM MQ in the Components group: v Click Components to see a single IBM MQ group widget that is displayed along with a group widget for every other data source type in the application. v Click the IBM MQ subgroup to see a group widget for each managed resource in the application. v Click inside a IBM MQ group widget or click a IBM MQ managed resource from the navigator Instances section to open a dashboard with KPIs from the selected managed resource. For more information about the KPIs, click in the view or click in the dashboard banner. Default dashboards WebSphere MQ Use the Summary dashboard to get the summary information about the current queue manager. Channels Status Details Use the Channels Status Details dashboard to get the status information about channels and queues. Listeners Status Details Use the Listeners Status Details dashboard to get the detailed information about the listeners. MQ Errors Details Use the MQ Errors Details dashboard to get the information about all error messages in the error log of a monitored queue manager. MQ Summary Dashboard Use the MQ Summary dashboard to identify high-level status of WebSphere MQ. Queue Manager Events Details Use the Queue Manager Events Details dashboard to get the detailed information about the queue manager events. Queues Status Details Use the Queues Status Details dashboard to detailed information about the queues. Transmission Queues Details Use the Transmission Queues Details dashboard to get the detailed information about the transmission queues. Additional group widgets These pop-up group widgets are displayed after you click a group widget for more details. Some group widgets have links to more granular information in a popup widget, described here. © Copyright IBM Corp. 1996, 2018 3 Widgets for the Default dashboards WebSphere MQ Use the Summary dashboard to get the summary information about the current queue manager. The following widgets are available in this dashboard: Message Volume The Message Volume widget displays a summary of transaction performance across all queue managers. For data is available in this widget, you must first enable transaction tracking for the agent on the Agent Configuration page. The following KPIs for the widget are derived from the attributes as described: v Failed requests: Shows the number of failed transactions for each monitoring interval in red; that is, the number of transactions that did not complete correctly, or reported an error during the monitoring interval. v Good requests: Shows the number of good transactions for each monitoring interval in green; that is, the number of transactions that completed successfully. v Slow requests: Shows the number of slow transactions for each monitoring interval in yellow. v Timestamp: The time of collection of the data. MQ Status Provides summary information for the current queue manager. The following KPIs for the widget are derived from the attributes as described: v Channel initiator status: The status of the channel initiator reading. This data is derived from the Channel Initiator Status attribute in the Current Queue Manager Status data set. v Channels not running: Channels that are not running. v Command server status: The status of the command server. This data is derived from the Command Server Status attribute in the Current Queue Manager Status data set. v Critical MQ errors: The identifier of the message in the error log of the queue manager. This data is derived from the Message ID attribute in the Error Log data set. v Dead letter queue messages: The current depth of the dead letter queue. This data is derived from the DLQ Depth attribute in the Current Queue Manager Status data set. v Indoubt channels: Channels that are in doubt. v Listeners not running: All listeners that are stopped, being stopping, or unavailable. v Queue manager connections: Indicates the current number of connection to the queue manager. The valid format is an integer. This data is derived from the Connection Count attribute in the Current Queue Manager Status data set. v Queue manager events not reset: Current events on the queue manager that are not being handled. v Queue manager hostname: The name of the system on which this queue manager is running. The valid format is an alphanumeric string of up to 48 case-sensitive characters. This data is derived from the Host Name attribute in the Current Queue Manager Status data set. v Queue manager status: The current execution status of the queue manager. This data is derived from the MQ Manager Status attribute in the Current Queue Manager Status data set. v Queues not being read: Queues that have messages but not opened