CA Unified Infrastructure Management

Transcription

1 CA Unified Infrastructure Management Probe Guide for WebSphere MQ Monitoring websphere_mq v2.0 series

2 Copyright Notice This online help system (the "System") is for your informational purposes only and is subject to change or withdrawal by CA at any time. This System may not be copied, transferred, reproduced, disclosed, modified or duplicated, in whole or in part, without the prior written consent of CA. This System is confidential and proprietary information of CA and protected by the copyright laws of the United States and international treaties. This System may not be disclosed by you or used for any purpose other than as may be permitted in a separate agreement between you and CA governing your use of the CA software to which the System relates (the CA Software ). Such agreement is not modified in any way by the terms of this notice. Notwithstanding the foregoing, if you are a licensed user of the CA Software you may make one copy of the System for internal use by you and your employees, provided that all CA copyright notices and legends are affixed to the reproduced copy. The right to make a copy of the System is limited to the period during which the license for the CA Software remains in full force and effect. Should the license terminate for any reason, it shall be your responsibility to certify in writing to CA that all copies and partial copies of the System have been destroyed. TO THE EXTENT PERMITTED BY APPLICABLE LAW, CA PROVIDES THIS SYSTEM AS IS WITHOUT WARRANTY OF ANY KIND, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NONINFRINGEMENT. IN NO EVENT WILL CA BE LIABLE TO YOU OR ANY THIRD PARTY FOR ANY LOSS OR DAMAGE, DIRECT OR INDIRECT, FROM THE USE OF THIS SYSTEM, INCLUDING WITHOUT LIMITATION, LOST PROFITS, LOST INVESTMENT, BUSINESS INTERRUPTION, GOODWILL, OR LOST DATA, EVEN IF CA IS EXPRESSLY ADVISED IN ADVANCE OF THE POSSIBILITY OF SUCH LOSS OR DAMAGE. The manufacturer of this System is CA. Provided with Restricted Rights. Use, duplication or disclosure by the United States Government is subject to the restrictions set forth in FAR Sections , , and (c)(1) - (2) and DFARS Section (b)(3), as applicable, or their successors. Copyright 2014 CA. All rights reserved. All trademarks, trade names, service marks, and logos referenced herein belong to their respective companies. Legal information on third-party and public domain software used in this product is documented in the Third-Party Licenses and Terms of Use (

3 Contact CA Contact CA Support For your convenience, CA Technologies provides one site where you can access the information that you need for your Home Office, Small Business, and Enterprise CA Technologies products. At you can access the following resources: Online and telephone contact information for technical assistance and customer services Information about user communities and forums Product and documentation downloads CA Support policies and guidelines Other helpful resources appropriate for your product Providing Feedback about Product Documentation Send comments or questions about CA Technologies product documentation to To provide feedback about general CA Technologies product documentation, complete our short customer survey which is available on the support website at

4

5 Contents Chapter 1: WebSphere MQ Monitoring (websphere_mq) Overview v2.0 7 About This Guide... 8 New Features... 8 Related Documentation... 8 Verify Prerequisites... 9 Supported Platforms... 9 Enable the Queue Monitors... 9 Root User Authorization for MQI Calls Chapter 2: WebSphere MQ Monitoring (websphere_mq) Upgrades and Migrations v Chapter 3: WebSphere MQ Monitoring (websphere_mq) Configuration v websphere_mq Node QueueManager Node ClusterQueueManager Start Monitoring How to Configure Alarm Thresholds Activate QoS Data for Monitors Stop Receiving Alarms for Deleted Components Manage System Channels Monitoring Monitor Multi-Instance WebSphere MQ Chapter 4: WebSphere MQ Monitoring (websphere_mq) QoS Metrics 27 Contents 5

6 Documentation Changes This table describes the version history for this document. Version Date What's New? 2.0 December 2014 Updated the Verify Prerequisites and Supported Platforms topics. 2.0 September June 2014 Initial Release Updated the websphere_mq QoS Metrics and <Product name> Node topics. Added the New Features, Upgrades and Migrations, Subscription Node, Topic Node, ClusterQueueManager, and Monitor Multi-Instance WebSphere MQ topics. Removed the Known Issues topic. 6 Probe Guide for WebSphere MQ Monitoring

7 Chapter 1: WebSphere MQ Monitoring (websphere_mq) Overview v2.0 IBM WebSphere MQ is messaging middleware that allows you to share data and messages asynchronously between applications across multiple platforms. WebSphere MQ allows independent and potentially non-concurrent applications on a distributed system to communicate with each other. Applications can put or get data through WebSphere MQ messaging queues. IBM WebSphere MQ defines logical containers that are named Queue Managers (QMs) for managing the storage and recovery of data. QMs coordinate with the applications that are updating messages on the queues, and perform queue isolation and locking functions to maintain consistency. WebSphere MQ messaging queues are used either to store messages from programs or are pointers to other queues. Channels are defined as a logical communication link between QMs. WebSphere MQ supports the message exchange in both point-to-point and publish/subscribe mode. The WebSphere MQ Monitoring (websphere_mq) probe is installed locally on a system with the IBM WebSphere MQ. The probe discovers the available QMs and the corresponding messaging queues, channels, topics, and subscriptions. You can monitor and generate alarms for: Queue Managers Queues Channels Topics Subscriptions This section contains the following topics: About This Guide (see page 8) New Features (see page 8) Related Documentation (see page 8) Verify Prerequisites (see page 9) Chapter 1: WebSphere MQ Monitoring (websphere_mq) Overview v2.0 7

8 About This Guide About This Guide This guide helps the CA Unified Infrastructure Management Administrator understand the configuration of the WebSphere MQ Monitoring probe and provides the following information: Overview of the WebSphere MQ Monitoring probe and other related documentation. Configuration details of the probe. Field information and common procedures for configuring the probe. Important! Description for the intuitive GUI fields is not included in the document. New Features The probe has the following new features in this release: Topics monitoring Subscriptions monitoring Multi-Instance Queue Manager monitoring Queue Manager Cluster monitoring Remote, Alias, Model, and Cluster Queue monitoring Additional Channel and Queue metric Support for Windows Server 2012 R2 and Solaris 11 operating systems Related Documentation Related Documentation Documentation for other versions of the websphere_mq probe The Release Notes for the websphere_mq probe User documentation for the Admin Console Monitor Metrics Reference Information for CA Unified Infrastructure Management Probes ( 8 Probe Guide for WebSphere MQ Monitoring

9 Verify Prerequisites Verify Prerequisites The preconfiguration requirements of the WebSphere MQ Monitoring probe are as follows: IBM WebSphere MQ is installed on the system, where the probe is deployed. Note: The probe supports only 7.5.X (tested on ) and 7.0.X (tested on ) versions of IBM WebSphere MQ. Install the appropriate MQSeries Java on the host system, if the probe is deployed on Linux or Solaris operating systems. For example, the MQSeriesJava-U x86_64.rpm is required for monitoring version of WebSphere MQ and the MQSeriesJava x86_64.rpm is required for monitoring version of WebSphere MQ. In case of multiple installations of WebSphere MQ, install the highest version of MQSeries Java. Add hostname of the system, where the probe and IBM WebSphere MQ is installed, in the /etc/hosts file when the probe is deployed on Linux or Solaris operating systems. You can use the vi /etc/hosts command for this purpose. Ensure that command Server of the Queue Manager is up and running. Supported Platforms The WebSphere MQ Monitoring probe supports RHEL version 5.x and 6.x, Solaris 11, and Windows Server 2012 R2. Refer to the Compatibility Support Matrix for the latest information about supported platforms. See also the Support Matrix for Probes for more information about the websphere_mq probe. Enable the Queue Monitors The default configuration of IBM WebSphere MQ does not expose all monitoring data of the Message Queues to an external application. Therefore, when the WebSphere MQ Monitoring (websphere_mq) probe runs a command through to fetch monitoring data, WebSphere MQ does not return any value for the following monitors: Oldest Message Age On Queue Time Time Since Last Put Time Since Last Get Chapter 1: WebSphere MQ Monitoring (websphere_mq) Overview v2.0 9

10 Verify Prerequisites Set the MONQ property value of the message queue to LOW, MEDIUM, or HIGH for fetching the monitoring data. The recommended value is HIGH. Follow these steps: 1. Open the Linux or Solaris terminal. 2. Go to the installation directory of WebSphere MQ. The default location is /opt/mqm/bin on Linux. 3. Go to the Queue Manager of the target message queue, you want to monitor. For example, if your Queue Manager name is QM1, you can execute the following command:./runmqsc QM1 4. Execute the DISPLAY ALL command and verify if the MONQ property value is OFF. 5. Execute the ALTER QMGR MONQ(HIGH) command and change the MONQ property value to HIGH for all message queues. Alternatively, execute the ALTER QLOCAL(MYQUEUE.Q) MONQ(HIGH) for changing the MONQ property value to HIGH for the given message queue. The QLOCAL is the queue type and MYQUEUE is the queue name. The MONQ property value is changed to HIGH, therefore, allowing the probe to collect monitoring data about the message queues in the subsequent interval. Note: Use the WebSphere MQ Explorer on Windows for updating the MONQ property value. Root User Authorization for MQI Calls The Message Queue Interface (MQI) calls are used for accessing QMs and its related components of WebSphere MQ installation. Any user of the mqm user group has rights for executing these MQI calls. However, the WebSphere MQ Monitoring probe has the root user rights in Linux environments. This root user is not added to the mqm user group, by default. Therefore, the probe requires the root user to be added in the mqm user group, for monitoring WebSphere MQ. In case, it is not possible in your environment for adding the root user due to security concerns, you can use an alternative option. This option uses the setmqauth command for authorizing the root user to execute the MQI calls for each QM. 10 Probe Guide for WebSphere MQ Monitoring

11 Verify Prerequisites The WebSphere MQ Monitoring probe is shipped with a script file, setmqprobe_auth.sh, which uses the setmqauth command for authorizing the root user to execute the MQI calls. This option does not require you to add the root user to the mqm user group. Follow these steps: 1. Open the Linux or Solaris terminal. 2. Go to the probe installation directory. The default location is /opt/nimsoft/probes/application/websphere_mq. 3. Set the execution rights for the script by executing the chmod +x setmqprobe_auth.sh command. 4. Log in as mqm user by executing the su - mqm command. You get logged in as mqm user and moved to the mqm home directory. 5. Go to the probe installation directory, again. 6. Execute the setmqprobe_auth.sh script using the following command:./setmqprobe_auth.sh <QM Name> <All> QM Name: identifies the actual QM name, for which you want to authorize the root user for executing the MI calls. All: discovers all QMs of WebSphere MQ installation and authorize the root user for executing the MQI calls on all QMs. Note: You can use only one of the given parameters and without brackets. Recommendation is to use the All parameter when probe is deployed for the first time and later the QM Name. The script prompts you to give the WebSphere MQ installation path where the bin folder exists. 7. Define the path and press Enter. The script uses the default path /opt/mqm/bin. The probe reads WebSphere MQ configuration and updates the root user access for given QMs. The probe is now ready to fetch the monitoring data of WebSphere MQ. Important! In case, a QM is not activated the script throws the "AMQ7028: The queue manager is not available for use" error. You can restart QM and then execute the script again. Similarly, run the script again for newly discovered QMs also. Chapter 1: WebSphere MQ Monitoring (websphere_mq) Overview v2.0 11

12

13 Chapter 2: WebSphere MQ Monitoring (websphere_mq) Upgrades and Migrations v2.0 In case, you are upgrading the probe from a previous version to 2.00 consider the following points: For viewing the new metrics that are introduced in websphere_mq probe version 2.00 on the Unified Service Management (USM) portlet of the UMP, you can perform any one of the following actions: Upgrade your NMS 7.6 to CA UIM 8.0 Install the ci_defn_pack probe version 1.00 and restart the nis_server probe. The Queue metrics generated by an earlier version of the probe will display at the LocalQueue level on the USM in version However, the existing metrics already displaying at Queue level remain as is on the USM. The Queue monitors, which are activated on earlier version of the probe will move to the Detached Configuration node after upgrade. You have to activate monitors for each queue again from the LocalQueue node. The earlier version of the probe uses IP address of the system as QoS and alarm source while the 2.00 uses the hostname as the default source. After migration, you can update the Source Override field value at websphere_mq node to IP address else two views will be displayed on the USM for the same metric. The QMs and their corresponding components which are the part of a cluster will start displaying under ClusterQueueManager node and their activated monitors will move to the Detached Configuration node. Earlier, all QMs are displayed under the QueueManager node. Chapter 2: WebSphere MQ Monitoring (websphere_mq) Upgrades and Migrations v2.0 13

14

15 Chapter 3: WebSphere MQ Monitoring (websphere_mq) Configuration v2.0 The WebSphere MQ Monitoring probe is configured for setting up the monitoring parameters of the QMs, channels, queues, topics, and subscriptions. The probe automatically discovers the available QMs and other components of WebSphere MQ. Note: Ensure that preconfiguration requirements are fulfilled before configuring the probe. This section explains each node of the probe GUI with their corresponding field descriptions and standard procedures of the probe. This section contains the following topics: websphere_mq Node (see page 15) Start Monitoring (see page 22) How to Configure Alarm Thresholds (see page 23) Activate QoS Data for Monitors (see page 23) Stop Receiving Alarms for Deleted Components (see page 24) Manage System Channels Monitoring (see page 25) Monitor Multi-Instance WebSphere MQ (see page 26) websphere_mq Node The websphere_mq node lets you view the probe information and configure auto discovery properties of the probe. Navigation: websphere_mq Set or modify the following values as required: websphere_mq > Probe Information This section provides information about the probe name, probe version, probe start time, and the probe vendor. websphere_mq > General Configuration This section is used to configure log level of the probe. Log Level: specifies the detail level of the log file. Default: 3- Info Chapter 3: WebSphere MQ Monitoring (websphere_mq) Configuration v2.0 15

16 websphere_mq Node websphere_mq > WebSphere MQ Auto Configuration This section is used to configure the automatic discovery and configuration properties of the probe. These properties are applied to all the QMs, which the probe discovers. Auto Discovery Interval (minutes): defines the time interval for fetching the updated configuration of WebSphere MQ. For example, if you have defined a new Queue Manager (QM), it reflects on the probe GUI after this interval. Default: 60 minutes Default Interval (seconds): specifies the default time interval after which the probe queries WebSphere MQ for fetching the monitoring data. The probe also updates the QM definitions after this interval. For example, probe displays the updated queue details on the probe GUI after this interval. Default: 300 seconds Activate All QMs: activates all the QMs for monitoring as soon as the probe discovers them. This option does not activate QoS for the QMs. Activating the QMs displays the corresponding queues on the probe GUI. Note: This functionality works only for the QMs, which are discovered after first deployment of the probe. Activate the QM monitoring manually that is discovered in any subsequent interval. Channel Status Coding Scheme: specifies the channel status coding scheme for displaying the channel status as provided by IBM or as configured in the probe. The following table describes both coding schemes: Channel Status IBM MQ Native Coding Scheme CA UIM Coding Scheme Stopped 6 0 Paused 8 1 Inactive -1 2 Stopping 4 3 Initializing 13 4 Starting 2 5 Switching Channel 14 6 Retrying 5 7 Requesting 7 8 Binding 1 9 Running Probe Guide for WebSphere MQ Monitoring

17 websphere_mq Node The CA UIM Coding Scheme is defined in increasing order of channel health status for configuring thresholds on the Channel Status metric. Note: The probe returns the most positive channel status when multiple instances of the same channel exist. The highest CA UIM Coding scheme code defines the most positive status. Source Override: specifies the source of alarm and QoS messages, which the probe generates. You can use hostname, IP address, or QM name as the source. Default: Hostname Important! Recommendation is not to change the Source Override field value after the initial configuration. If the QoS source is changed later, multiple graphs display on the Unified Service Management (USM) Metric view (one for every QoS source value). Topics - Include Subscription: specifies the subscription type for calculating the metric value of the topics. You can select All Subscriptions, Durable Subscriptions, and Non Durable subscriptions. Default: All Subscriptions The value of this field impacts the following topic metric values: Number of Messages Time Since Resume Time Since Last Message websphere_mq > WebSphere MQ Configuration This section lets you configure WebSphere MQ properties for allowing the probe to connect and query WebSphere MQ. WebSphere MQ Installation Path: defines the WebSphere MQ installation path where the bin folder exists. In case, you have multiple installations of WebSphere MQ on the same system, give path for the highest version. Notes: Do not include bin in the path. For example, if your WebSphere MQ installation is at /opt/mqm/bin, then your path would be /opt/mqm. Use the Verify Path option of the Actions drop-down list for validating the path. Use the Discover QM Changes option of the Actions drop-down list and update QM changes on the probe GUI manually before the Auto Discovery Interval. Chapter 3: WebSphere MQ Monitoring (websphere_mq) Configuration v2.0 17

18 websphere_mq Node QueueManager Node <Queue Manager Name> Node The QueueManager node is used for displaying all QMs, which are available on the system for monitoring and are not a part of any Queue Manager Cluster. This node does not contain any section or field for configuration. The queue manager name node represents the actual QM name and lets you activate the QM monitors. Navigation: websphere_mq > Queue Manager > queue manager name Set or modify the following values as required: queue manager name > Resource Setup This section lets you configure properties of the QM for getting the monitoring data. Interval (secs): specifies the time interval after which the probe queries the QM for fetching the monitoring data. The probe also updates the QM definitions, for example, updates the queue information, after this interval. Activate: activates monitoring of the QM. The probe loads QM definitions on the probe GUI after selecting and saving this option. Alarm Message: specifies the alarm message when the QM is down or not reachable. Select one of the following options: ResourceCritical: generates the alarm message with the Critical alarm severity. ResourceError: generates the alarm message with the Error alarm severity. Default: ResourceCritical Instance Name: identifies the WebSphere MQ installation name in which the QM is available, because a single system can have multiple instances of WebSphere MQ. If the WebSphere MQ version is 7.0x, this field remains blank. Cluster Name: identifies the Queue Manager Cluster name to which the QM belongs. This field is visible only when the QM is a part of Queue Manager Cluster. queue manager name > Monitors This section lets you select a particular monitor from a list and activate the QoS data and alarms. Refer Activate QoS Data for Monitors section for the detailed process. Note: The Queue Manager Uptime monitor value is always NULL when monitoring WebSphere MQ Probe Guide for WebSphere MQ Monitoring

19 websphere_mq Node Channel Node <Channel Type> Node The Channel node is a container for various channel type nodes. The probe supports monitoring for the following types of channel: Server Sender Receiver Requester Server Connection Cluster Sender Cluster Receiver Select any of the available channel type node for monitoring. <Channel Name> Node The channel type node contains a channel name node for each channel that is detected by the probe. The channel name node represents the actual channel name and becomes visible when the QM monitoring is activated for monitoring in the Queue Manager node. Navigation: websphere_mq > Queue Manager > queue manager name > Channel > channel type > channel name Set or modify the following values as required: channel name > Monitors This section lets you select a channel monitor from a list and activate the QoS data and alarms. Refer to the Activate QoS Data for Monitors section for the detailed process. Queue Node The Queue node is a container for all queue type nodes, which are detected by the probe. Chapter 3: WebSphere MQ Monitoring (websphere_mq) Configuration v2.0 19

20 websphere_mq Node <Queue Type> Node The queue type node is a container for the queue name nodes, which are available on the QM for monitoring. The probe monitors the following queue types: Local Remote Alias Model Cluster Local Cluster Remote Cluster Alias The monitors for queue are not applicable for each queue type. The following table helps you understand the supported monitors on each queue: Monitor Name Local Remote Alias Mode l Cluster Local Cluster Remote Cluster Alias Current Depth Yes No No Yes Yes No No Open Input Open Output Uncommitted Message Yes No No No Yes No No Yes No No No Yes No No Yes No No No Yes No No On Queue Time Yes No No No Yes No No Oldest Message Age Yes No No No Yes No No Utilization Yes No No No Yes No No Time Since Last Get Time Since Last Put Yes No No No Yes No No Yes No No No Yes No No Inhibit Get Status Yes No Yes Yes Yes No Yes <Queue Name> Node Inhibit Put Status Yes Yes Yes Yes Yes Yes Yes 20 Probe Guide for WebSphere MQ Monitoring

21 websphere_mq Node Subscription Node <Subscription Name> Node Topic Node The queue name node represents the actual message queue name and becomes visible when the QM monitoring is activated for monitoring. Navigation: websphere_mq > Queue Manager > queue manager name > Queue > queue type > queue name Set or modify the following values as required: queue name > Monitors This section lets you select a queue monitor from a list and activate the QoS data and alarms. Refer to the Activate QoS Data for Monitors section for the detailed process. The Subscription node is container for all subscription name nodes which are detected by the probe. You can select any subscription name node for monitoring. The subscription name node represents the actual subscription name and becomes visible when the QM monitoring is activated for monitoring in the Queue Manager node. Navigation: websphere_mq > Queue Manager > queue manager name > Subscription > subscription name Set or modify the following values as required: subscription name > Monitors This section lets you select a subscription monitor from a list and activate the QoS data and alarms. Refer to the Activate QoS Data for Monitors section for the detailed process. The Topic node is container for all topic name nodes which are detected by the probe. You can select any topic name node for monitoring. Chapter 3: WebSphere MQ Monitoring (websphere_mq) Configuration v2.0 21

22 Start Monitoring <Topic Name> Node The topic name node represents the actual topic name and becomes visible when the QM monitoring is activated for monitoring in the Queue Manager node. Navigation: websphere_mq > Queue Manager > queue manager name > Topic > topic type > topic name Set or modify the following values as required: topic name > Monitors This section lets you select a topic monitor from a list and activate the QoS data and alarms. Refer to the Activate QoS Data for Monitors section for the detailed process. ClusterQueueManager The ClusterQueueManager node is a container for all queue manager name nodes, which are a part of the Queue Manager Cluster and available for monitoring. This node also displays the corresponding Channels, Queues, Subscriptions, and Topics under each queue manager name node. Note: The probe also displays the cluster name as a field on the probe configuration GUI, when a QM is part of cluster. In case, a cluster QM is down during initial QM discovery process of the probe, the QM is displayed under the QueueManager node. Once the QM is up, it displays under the ClusterQueueManager node. Start Monitoring After deploying the probe for the first-time it displays only the websphere_mq node in the navigation pane. The probe requires initial configuration for discovering WebSphere MQ installation and to start monitoring. Follow these steps: 1. Click the websphere_mq node. 2. Configure the following fields of the WebSphere MQ Auto Configuration section: Auto Discovery Interval (minutes) Default Interval (seconds) Activate All QMs Channel Status Coding Scheme 22 Probe Guide for WebSphere MQ Monitoring

23 How to Configure Alarm Thresholds 3. Configure the WebSphere MQ Installation Path field of the WebSphere MQ Configuration section for connecting and querying WebSphere MQ. Note: Refer the websphere_mq Node topic for the field description. 4. Select the Verify Path option from the Actions drop-down list of the WebSphere MQ Configuration section. The probe displays a success message after connecting to WebSphere MQ else an error message is displayed. 5. Click Save. The probe saves the updated configuration, queries WebSphere MQ, and loads WebSphere MQ details on the probe GUI. In case, the process takes some time the PPM-023 error is displayed stating that the probe configuration cannot be loaded. 6. Click Retry on the error dialog until WebSphere MQ details are displayed on the probe GUI. The list of all QMs is displayed under the QueueManager and ClusterQueueManager nodes in the navigation pane of the probe GUI. The queues, channels, topics, and subscriptions of the QM are displayed after one measurement interval on the GUI. How to Configure Alarm Thresholds Some Quality of Service measurement probes allow you to set different types of alarm thresholds. These threshold options allow you to more broadly control when alarm messages are sent for each QoS probe. For more information about the different alarm thresholds and their configuration requirements, refer to the General Probe Configuration section of the Admin Console Help. Activate QoS Data for Monitors After loading WebSphere MQ details on the probe GUI you can activate QoS data for various monitors of QM, channels, queues and so on. The QoS data helps you understand the trend for the specific monitor. The process of activating QoS is identical for QM, channels, queues, subscriptions, and topics. Follow these steps: 1. Navigate to the appropriate queue manager name node in the navigation pane. The list of available monitors is displayed on the probe GUI. 2. Select the appropriate monitor from the Monitors section of the probe GUI. Chapter 3: WebSphere MQ Monitoring (websphere_mq) Configuration v2.0 23

24 Stop Receiving Alarms for Deleted Components 3. Select the Publish Data check box for generating QoS data for the monitor for which you want to generate the QoS data. Refer the How to Configure Thresholds in websphere_mq topic for configuring dynamic and static thresholds for generating alarms. 4. Click Save. The probe saves the updated configuration and generates QoS data for the configured monitor of the QM. Note: Avoid saving the configuration frequently because the probe takes considerable time after saving and reloading the configuration. The recommendation is to configure all necessary monitors at once and then save the configuration. Stop Receiving Alarms for Deleted Components Use this procedure for stop getting alerts for any WebSphere MQ component you delete. For example, you are monitoring a local queue, which is deleted from the queue manager before deactivating its monitoring. The probe is not able to query the queue details and generates the false alerts because the queue is deleted from WebSphere MQ configuration. The probe keeps sending false alarms for the queue because the probe is not able query the queue details. Since the queue is deleted from WebSphere MQ configuration, the probe does not display the queue in the navigation pane of the probe GUI. Modify the detach configuration parameter of the probe for stop receiving false alerts. Follow these steps: 1. Open the Raw Configure GUI of the probe. 2. Add the show_detached_configuration key under the setup section and set the key value to yes. 3. Click Apply to close the Raw Configure GUI for restarting the probe and applying changes. The navigation pane of the probe GUI shows a new node Detached Configuration. This node contains the components which are deleted from WebSphere MQ but still selected for monitoring in the probe. 4. Click the Options icon next to the component name you want to stop receiving alerts and select Delete. 5. Click Save. The probe stops sending false alerts for the deleted components. 24 Probe Guide for WebSphere MQ Monitoring

25 Manage System Channels Monitoring Manage System Channels Monitoring IBM WebSphere MQ consists of ten system channels, which define the WebSphere MQ channel schema for transferring messages between applications. The default configuration of the probe lets you monitor only three system channels out of 10, which are as follows: SYSTEM.AUTO.RECEIVER* SYSTEM.AUTO.SVRCONN* SYSTEM.DEF.CLUSRCVR SYSTEM.DEF.CLUSSDR SYSTEM.DEF.RECEIVER SYSTEM.DEF.REQUESTER SYSTEM.DEF.SENDER SYSTEM.DEF.SERVER SYSTEM.DEF.SVRCONN* SYSTEM.DEF.CLNTCONN Note: The channel names, which are marked with an asterisk (*) are available for monitoring, by default. The other channels are unmonitored, by default, as they do not provide any valid monitoring data. You can manage (add or remove) your system channels list as required for your WebSphere MQ monitoring: Follow these steps: 1. Open the Raw Configure GUI of the probe. 2. Go to the disabledsystemchannellist key under the setup section. 3. Edit the key value by providing the system channel names in a comma-separated format. For example, use Channel1,Channel2 for excluding Channel1 and Channel2 monitoring. 4. Click Apply. The Raw Configure GUI closes and the probe restarts for applying the changes. The system channels, which are configured in the disabledsystemchannellist key are excluded from the probe GUI. Chapter 3: WebSphere MQ Monitoring (websphere_mq) Configuration v2.0 25

26 Monitor Multi-Instance WebSphere MQ Monitor Multi-Instance WebSphere MQ IBM WebSphere MQ lets you run your more than one instance of Queue Managers in high availability (HA) mode. The HA mode ensures uninterrupted messaging between applications during hardware or software failures with minimum downtime. As an application administrator, you can monitor the HA status of QM when configured with WebSphere MQ multi-instance QMs. Follow these steps: 1. Install the WebSphere MQ Monitoring probe on all the systems where WebSphere MQ is running. 2. Fulfill the preconfiguration requirements of the probe. 3. Configure General Properties and the WebSphere MQ Installation path for loading WebSphere MQ installation details on the probe GUI. Refer to the Start Monitoring the WebSphere MQ topic for detailed steps. 4. Go to the appropriate queue manager name node. Note: The queue manager name node represents the actual QM name, which is visible in navigation pane of the probe GUI. 5. Select the Multi-Instance QM Status monitor from the Monitors section. 6. Select the Publish Data option for generating QoS for the monitor and click Save. Note: Repeat steps 2-6 on all instances of the probe. After configuring the Multi-Instance QM Status monitor for the QMs you can observe value of this monitor, which returns one of following values: 0: QM is working in high availability mode and currently is in active state. 1: QM is working in high availability mode and currently is in standby state. You cannot activate QoS on channels, queues, subscriptions, and topics when the QM is not in active state. 2: QM is not working in high availability mode and the state is always standalone. In case, the active QM goes down it starts appearing in the Detached Configuration node on the probe GUI. Further, the Multi-Instance QM Status monitor value changes from 0 to 1. Important! The probe does not monitor those Queue Manager clusters which are configured with any third-party high availability manager, for example, HACMP and MSCS. 26 Probe Guide for WebSphere MQ Monitoring

27 Chapter 4: WebSphere MQ Monitoring (websphere_mq) QoS Metrics This section contains the QoS metrics for the websphere_mq probe. QoS Name Metric Name Unit Description Queue Manager (Resource) QOS_QUEUE_MANAGER_CON NECTION_COUNT QOS_QUEUE_MANAGER_CHA NNEL_INITIATOR_STATUS QOS_QUEUE_MANAGER_CO MMAND_SERVER_STATUS QOS_QUEUE_MANAGER_UP_ TIME QOS_QUEUE_MANAGER_MUL TI_INSTANCE_QM_STATUS Channel Connectio n Channel Initiator Status Command Server Status State State Current number of connections to the queue manager. Status of the channel initiator, which can be one of the following: 0: Not running 1: Initializing 2: Initialized and running 3: Stopping Status of the command server, which can be one of the following: 0: Down 1: Up Up Time Hours Queue manager up time. This value is always NULL for WebSphere MQ Multi Instance QM Status State Multi-instance status of the QM, which can be one of the following: 0: Active 1: Standby 2: Standalone Chapter 4: WebSphere MQ Monitoring (websphere_mq) QoS Metrics 27

28 Monitor Multi-Instance WebSphere MQ QoS Name Metric Name Unit Description QOS_CHANNEL_BATCH_COUN T Batch Number of batches completed. This QoS is not applicable for Server Connection Channel. QOS_CHANNEL_BUFFERS_REC EIVED Buffers Received Number of buffers received. QOS_CHANNEL_BUFFERS_SEN T Buffers Sent Number of buffers sent. QOS_CHANNEL_BYTES_RECEIV ED Bytes Received Bytes Number of bytes received. QOS_CHANNEL_BYTES_SENT Bytes Sent Bytes Number of bytes sent. QOS_CHANNEL_MESSAGE_CO UNT Message Number of messages sent or received. *QOS_CHANNEL_COMPRESSI ON_RATE Compressi on Rate Percent Compression rate achieved to the nearest percentage. *QOS_CHANNEL_COMPRESSI ON_TIME Compressi on Time Microsec onds Time spent per message during compression or decompression. *QOS_CHANNEL_EXIT_TIME_P ER_MESSAGE Exit Time Per Message Microsec onds Indicator of the time taken for executing user exits per message. *QOS_CHANNEL_LONG_RETRI ES_LEFT Long Retires Left Number of long retries remaining. *QOS_CHANNEL_MCA_STATU S MCA Status State Status of Message Channel Agent (MCA), which can be one of following: 0: Stopped 3: Running *QOS_CHANNEL_SHORT_RETR IES_LEFT Short Retries Left Number of short retries remaining. *QOS_CHANNEL_CHANNEL_S UB_STATE Channel Sub State State Current action being performed by the channel. *QOS_CHANNEL_TRANSMISSI ON_QUEUE_TIME_INDICATOR Transmissi on Queue Time Indicator Microsec onds Time for which messages remained on the transmission queue before retrieving. 28 Probe Guide for WebSphere MQ Monitoring

29 Monitor Multi-Instance WebSphere MQ QoS Name Metric Name Unit Description *QOS_CHANNEL_IN-DOUBT_S TATUS QOS_CHANNEL_TIME_SINCE_ LAST_MESSAGE In-Doubt Status Time Since Last Message State Hours Indicates the in doubt status of the channel. A channel is in doubt state after sending the acknowledgment request of batch messages status and before the acknowledgment is received. This QoS returns one of the following values: 0: Channel is not in doubt. 1: Channel is in doubt. Time since last message sent or MQI call handled. QOS_CHANNEL_UP_TIME Up Time Minutes Channel up time. QOS_CHANNEL_CHANNEL_ST ATUS #QOS_CHANNEL_AVERAGE_C OMPRESSION_RATE #QOS_CHANNEL_AVERAGE_C OMPRESSION_TIME #QOS_CHANNEL_AVERAGE_E XIT_TIME_PER_MESSAGE Queue QOS_QUEUE_CURRENT_DEPT H QOS_QUEUE_OPEN_INPUT_C OUNT QOS_QUEUE_OPEN_OUTPUT_ COUNT Channel Status Average Compressi on Rate Average Compressi on Time Average Exit Time Per Message Current Depth Open Input Open Output State Percent Microsec onds Microsec onds Status of the channel. Average compression rate achieved to the nearest percentage. Average time spent per message during compression or decompression. Indicator of the average time taken for executing user exits per message. Number of messages in the queue. Number of applications that are currently connected to the queue to put messages on the queue. Number of applications that are currently connected to the queue to get messages on the queue. Chapter 4: WebSphere MQ Monitoring (websphere_mq) QoS Metrics 29

30 Monitor Multi-Instance WebSphere MQ QoS Name Metric Name Unit Description QOS_QUEUE_UNCOMMITTED _MESSAGE_COUNT QOS_QUEUE_ON_QUEUE_TIM E QOS_QUEUE_OLDEST_MESSA GE_AGE Uncommitt ed Message On Queue Time Oldest Message Age Microsec onds Seconds Number of uncommitted changes (puts and gets) pending for the queue. Time duration for which a message is in the queue. Age of the oldest message in the queue. QOS_QUEUE_UTILIZATION Utilization Percent Capacity utilization of the queue which is calculated as (Current Depth/Maximum Depth ) * 100. QOS_QUEUE_TIME_SINCE_LA ST_GET QOS_QUEUE_TIME_SINCE_LA ST_PUT QOS_QUEUE_INHIBIT_GET_ST ATUS QOS_QUEUE_INHIBIT_PUT_ST ATUS Topic QOS_TOPIC_TIME_SINCE_LAS T_ALTERATION Time Since Last Get Time Since Last Put Inhibit Get Status Inhibit Put Status Time Since Last Alteration Seconds Seconds State State Minutes Time since the last message is successfully get to the queue. Time since the last message is successfully put to the queue. Indicates if the Get operations are allowed or inhibited on the queue. This QoS returns one of the following values: 0: Allowed 1: Inhibited Indicates if the Put operations are allowed or inhibited on the queue. This QoS returns one of the following values: 0: Allowed 1: Inhibited Difference between current time and time when the information is last altered. 30 Probe Guide for WebSphere MQ Monitoring

31 Monitor Multi-Instance WebSphere MQ QoS Name Metric Name Unit Description QOS_TOPIC_PUBLICATIONS_S TATUS Publication s Inhibited State Indicates if the publishing of the topics is allowed or inhibited. This QoS returns one of the following values: 0: Allowed 1: Inhibited QOS_TOPIC_SUBSCRIPTIONS_ STATUS Subscriptio ns Inhibited State Indicates if the subscription of the topics is allowed or inhibited. This QoS returns one of the following values: 0: Allowed 1: Inhibited QOS_TOPIC_PUBLISH_COUNT Publish Number of applications, which are currently publishing messages to the topic. QOS_TOPIC_SUBSCRIPTION_C OUNT Subscriptio n Number of topic subscribers including durable subscribers, which are currently not connected. QOS_TOPIC_NUMBER_OF_PU BLISHES Number of Publishes Number of publishes made by this publisher. QOS_TOPIC_TIME_SINCE_LAS T_PUBLISH Time Since Last Publish Minutes Difference between current time and time when this publisher sent the last message. QOS_TOPIC_NUMBER_OF_ME SSAGES Number of Messages Number of messages put to the specified subscriber destination QOS_TOPIC_TIME_SINCE_LAS T_MESSAGE Time Since Last Message Minutes Difference between current time and time at which the MQPUT call sent the last message to the subscription. The Queue Manager updates the last time stamp. Chapter 4: WebSphere MQ Monitoring (websphere_mq) QoS Metrics 31

32 Monitor Multi-Instance WebSphere MQ QoS Name Metric Name Unit Description QOS_TOPIC_TIME_SINCE_RES UME Subscription QOS_SUBSCRIPTION_TIME_SI NCE_CREATION QOS_SUBSCRIPTION_TIME_SI NCE_LAST_ALTERATION QOS_SUBSCRIPTION_TIME_SI NCE_LAST_PUBLISH QOS_SUBSCRIPTION_TIME_SI NCE_RESUME QOS_SUBSCRIPTION_NUMBER _OF_MESSAGES Time Since Resume Minutes Minutes Minutes Minutes Minutes Time Since Creation Time Since Last Alteration Time Since Last Publish Time Since Resume Number of Messages Difference between current time and time at which the MQSUB call registers the most recent application subscriber to the topic. Difference between current time and the creation time of the subscription Difference between current time and time when the subscription properties are last modified by using the MQSUB or Change Subscription command. Difference between current time and time when the last message is sent to the subscription destination. Difference between current time and time at which the last MQSUB API call that connected to the subscription. Number of messages put to the subscriber destination. Note: The QoS names marked with an asterisk (*) are not applicable for Requester, Receiver, Server Connection, and Cluster Receiver channels. The QoS names marked with a hash (#) are only applicable for Requester, Receiver, Server Connection, and Cluster Receiver channels. 32 Probe Guide for WebSphere MQ Monitoring