Cartridge for IBM WebSphere MQ Server User and Reference Guide

Transcription

1 Foglight Cartridge for IBM WebSphere MQ Server User and Reference Guide

2 2012 Quest Software, Inc. ALL RIGHTS RESERVED. This guide contains proprietary information protected by copyright. The software described in this guide is furnished under a software license or nondisclosure agreement. This software may be used or copied only in accordance with the terms of the applicable agreement. No part of this guide may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying and recording for any purpose other than the purchaser s personal use without the written permission of Quest Software, Inc. The information in this document is provided in connection with Quest products. No license, express or implied, by estoppel or otherwise, to any intellectual property right is granted by this document or in connection with the sale of Quest products. EXCEPT AS SET FORTH IN QUEST'S TERMS AND CONDITIONS AS SPECIFIED IN THE LICENSE AGREEMENT FOR THIS PRODUCT, QUEST ASSUMES NO LIABILITY WHATSOEVER AND DISCLAIMS ANY EXPRESS, IMPLIED OR STATUTORY WARRANTY RELATING TO ITS PRODUCTS INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. IN NO EVENT SHALL QUEST BE LIABLE FOR ANY DIRECT, INDIRECT, CONSEQUENTIAL, PUNITIVE, SPECIAL OR INCIDENTAL DAMAGES (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF PROFITS, BUSINESS INTERRUPTION OR LOSS OF INFORMATION) ARISING OUT OF THE USE OR INABILITY TO USE THIS DOCUMENT, EVEN IF QUEST HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Quest makes no representations or warranties with respect to the accuracy or completeness of the contents of this document and reserves the right to make changes to specifications and product descriptions at any time without notice. Quest does not make any commitment to update the information contained in this document. If you have any questions regarding your potential use of this material, contact: Quest Software World Headquarters LEGAL Dept 5 Polaris Way Aliso Viejo, CA legal@quest.com Refer to our Web site for regional and international office information. Trademarks Quest, Quest Software, the Quest Software logo, Foglight, IntelliProfile, PerformaSure, Spotlight, StealthCollect, TOAD, Tag and Follow, Vintela Single Sign-on for Java, and vfoglight are trademarks and registered trademarks of Quest Software, Inc in the United s of America and other countries. For a complete list of Quest Software s trademarks, please see Other trademarks and registered trademarks are property of their respective owners. Third Party Contributions Foglight contains some third party components. For a complete list, see the License Credits page in Foglight online help. User and Reference Guide February 2012 Cartridge Version

3 Foglight Cartridge for IBM WebSphere MQ Server User and Reference Guide 3 Table of Contents Introduction to this Guide...5 About Quest Software, Inc Contacting Quest Software... 5 Contacting Quest Support... 6 Using the Foglight Cartridge for IBM WebSphere MQ Server...7 Exploring the MQ Dashboards... 7 Viewing an MQ Group... 8 Monitoring Queue Managers... 9 Monitoring MQ Clusters Using Action Reference...14 Views Alarms Tab View Channel Details View Channels Tab View Detail Properties View Events Tab View Listeners Tab View MQ Cluster Overview Tab MQ Server Application View MQ Server Infrastructure View Queue Details View Queue Managers Group View Queue Status View Queues Tab View Remote Queue Status View Rules Channel Startup Error Rule Channel Stopped Rule Channel Transmission Problem Rule Channel TransmissionQ Error Rule Check Authority Events Rule Check Channel Auto-Def Events Rule... 41

4 Foglight Cartridge for IBM WebSphere MQ Server User and Reference Guide 4 Table of Contents Check Inhibit Events Rule Check Local Events Rule Check Performance Events Rule Check Remote Events Rule Check Start Stop Events Rule...44 Cluster Command Queue Error Rule Cluster Repository Queue Error Rule Cluster Transmission Queue Error Rule Command Queue Error Rule Dead Letter Queue Not Empty Rule Dequeue Rate Rule Enqueue Rate Rule Init Queue Error Rule Listener Not Running Rule MQ Agents Observe Same Queue Manager Rule MQ DeadLetterQueue Exists Rule MQ Statistics Interval Rule Queue Depth Warning Rule Queue Filling Rule Queue is Disabled Rule Queue Manager Not Available Rule Queue Monitoring Rule Queue Not Being Read Rule Queue Triggering Rule Receiver Channel Stopped Rule Shared Monitoring Configuration Rule Slow Message Rule Data MQAgent Channel Table MQAgent Listener Table MQAgent Local Queue Table MQAgent LU62 Listener Table...57 MQAgent NETBIOS Listener Table MQAgent Queue Manager Table MQAgent Reference Queue Table MQAgent SPX Listener Table MQAgent TCP Listener Table MQAgent Transmission Queue Table Index... 63

5 Introduction to this Guide Welcome to the Foglight Cartridge for IBM WebSphere MQ Server Systems User and Reference Guide. This guide provides agent configuration instructions and information on investigating IBM WebSphere MQ application performance. It describes the dashboards included with the Cartridge for IBM WebSphere MQ Server and contains instructions for configuring the MQAgent, used by the cartridge to monitor the entire distributed-messaging environment. Additionally, this guide provides information about the rules and data tables that are available for your monitored IBM WebSphere MQ Server infrastructure. This guide is intended for any user who wants to know more about the MQAgent properties and the dashboards included with the cartridge. It is also meant for those users that want to learn about the rules that are included with the cartridge, and the data collected by the MQAgent. About Quest Software, Inc. Quest Software (Nasdaq: QSFT) simplifies and reduces the cost of managing IT for more than 100,000 customers worldwide. Our innovative solutions make solving the toughest IT management problems easier, enabling customers to save time and money across physical, virtual and cloud environments. For more information about Quest solutions for administration and automation, data protection, development and optimization, identity and access management, migration and consolidation, and performance monitoring, go to Contacting Quest Software Mail Web site Quest Software, Inc. World Headquarters 5 Polaris Way Aliso Viejo, CA USA Refer to our Web site for regional and international office information.

6 Foglight Cartridge for IBM WebSphere MQ Server User and Reference Guide 6 Introduction to this Guide Contacting Quest Support Quest Support is available to customers who have a trial version of a Quest product or who have purchased a Quest product and have a valid maintenance contract. Quest Support provides unlimited 24x7 access to our support portal. Visit our support portal at support. From our support portal, you can do the following: Retrieve thousands of solutions from our Knowledge Base Download the latest releases and service packs Create, update, and review Support cases View the Global Support Guide for a detailed explanation of support programs, online services, contact information, policies, and procedures. The guide is available at: support.

7 1 Using the Foglight Cartridge for IBM WebSphere MQ Server The Cartridge for IBM WebSphere MQ Server enables Foglight to monitor a distributed IBM WebSphere MQ infrastructure. You can achieve better management of services when you are alerted of infrastructure problems before end users are affected. This enables you to ensure consistent application performance at established service levels. The Foglight Cartridge for IBM WebSphere MQ Server monitors the health of the messaging system by tracking MQ objects, such as queue managers, queues, channels, and listener processes. The Cartridge for IBM WebSphere MQ Server contains two major components: MQ dashboards provide at-a-glance views of your IBM WebSphere MQ performance. The top-level dashboard is a visual representation of the status of the major components of the MQAgent instances. It allows you to ensure consistent application performance. For more information, see Exploring the MQ Dashboards on page 7. MQAgents monitor IBM WebSphere MQ objects such as queue managers, queues, channels, and listener processes. The agents collect information from the monitored hosts and sends it to the Management Server. Exploring the MQ Dashboards When you deploy the Cartridge for IBM WebSphere MQ Server, the monitoring dashboards enable you to view your IBM WebSphere MQ performance. The dashboards are a visual representation of the status of the major components of the MQAgent instances that allow you to ensure consistent application performance. You can drill down for details, from looking at highlevel information about each queue manager, to viewing its specifics: such as the queue depth, the number of messages in the queue, or the number of bytes sent using a particular channel. In addition to the MQ dashboards, MQ objects also appear in the Application Tier, which allows you to monitor them using the Foglight Service Operations Console. Use this dashboard to customize a service to include specific MQ objects. For example, a banking application can use a specific DB2 database and a specific MQ queue. These two components can be grouped into a service that causes the alarms related to all the objects included in the service to be grouped together in the Service Operations Console. For more information about the Service Operations

8 Foglight Cartridge for IBM WebSphere MQ Server User and Reference Guide 8 Chapter 1 Using the Foglight Cartridge for IBM WebSphere MQ Server Console, see the Foglight User Guide. For details about object groups and tiers, see the Foglight Administration and Configuration Guide. From the MQ Queue Manager dashboard you can see detailed information about the queues, channels, alarms, events, and listeners associated with a specific queue manager, and from the MQ Cluster dashboard, you can view the server infrastructure and user-created object status. To access the MQ dashboards: On the navigation panel, under Homes, click either MQ Cluster or MQ Queue Manager. The selected dashboard appears in the display area. In addition, a navigation tree appears on the navigation panel, as shown below. Expand the MQGroup node in the navigation tree to view a list of the monitored MQ Queue Managers or Clusters. You can use this tree as an alternative to navigate to the related dashboard. Select the MQGroup in the navigation tree to view all queue managers in that group. The top part of the group view contains a table listing the available queue managers, while the bottom part shows information about the selected queue manager, including: event status, dead letter queue depth, the connection count, and more information. Viewing an MQ Group The MQ Group view gives you an at-a-glance view of the monitored queue managers. It shows the current and historical health of individual queue managers, along with historical queue capacities for the purposes of monitoring and planning. It contains two parts: 1 Queue Manager Table lists the queue managers in one of three ways: monitored, unmonitored, or all queue managers. For each queue manager, the table includes its name, any alarms associated with it, the name of the computer hosting the queue manager, its availability, and the names of any related clusters. 2 Detail Properties contains status and metric information for the selected queue manager.

9 Foglight Cartridge for IBM WebSphere MQ Server User and Reference Guide 9 Chapter 1 Using the Foglight Cartridge for IBM WebSphere MQ Server Select a queue manager in the table to populate the Detail Properties view with metrics, such as the status of events associated with the queue manager, the names of its dead-letter and command queues, the depth of the dead-letter queue (DLQ) plotted over time, and the number of connections to the queue manager, also plotted over time. For detailed information about the views appearing on this dashboard, see Chapter 2, Views on page 14. Monitoring Queue Managers A queue is an object used to store messages. MQ applications use queues to store and retrieve messages. Each queue is managed by a queue manager. A queue manager provides queuing services to applications, and manages the queues that belong to it. Channels enable the communication between queue managers. They are used in distributed message queuing to move messages from one queue manager to another. Listeners accept incoming network requests from remote queue managers, or client applications. Important After establishing a connection to the queue manager, if the listener is stopped, the agent associated with the queue manager continues to maintain its connection to the listener port and to collect data. MQ events provide information about errors, warnings, or similar occurrences that are associated with queue managers, channels, or applications. For each queue manager, Foglight collects diagnostic information about its message queues, channels, listeners, and events, and generates alarms when predefined thresholds are reached. These thresholds are initially defined by the rules that are included with the cartridge.

10 Foglight Cartridge for IBM WebSphere MQ Server User and Reference Guide 10 Chapter 1 Using the Foglight Cartridge for IBM WebSphere MQ Server The MQ Queue Manager dashboard displays performance metrics for the selected queue manager, including information about queues, channels, alarms, events, and listeners. It gives you detailed information about your MQ environment and its health. To view the MQ Queue Manager dashboard: On the navigation panel, under Homes, click MQ Queue Manager. or Select a queue manager from the MQ Group Infrastructure list in the navigation tree on the navigation panel. Use the Queues tab to view details about individual queues, clustered queues, or non-clustered queues. For example, to see the volume of the incoming data flow for a queue, select it on the Queue tab, and view the contents of the Queue Status view below. The Open Input metric shows the number of applications that are currently connected to the queue and are removing messages from it. Use the Channels tab to view either active channels, or all channels, and their associated details and related queue status. The Alarms, Events, and Listeners tabs list the alarms, events, and listeners associated with the selected queue manager. Use these views to quickly see the state of these entities. For detailed information about the views appearing on this dashboard, see the Chapter 2, Views on page 14. Monitoring MQ Clusters The MQ Clusters dashboard provides an overview of key metrics for clustered queue managers. Use this dashboard to quickly review the status and health of the queue managers, their repository type (Full or Partial), and key metrics such as infrastructure and application message rates, queue

11 Foglight Cartridge for IBM WebSphere MQ Server User and Reference Guide 11 Chapter 1 Using the Foglight Cartridge for IBM WebSphere MQ Server depth, dead-letter queue depth, and connection counts over time. This dashboard also lists alarms for the entire cluster, grouped by queue manager. To view the MQ Cluster dashboard: On the navigation panel, under Homes, click MQ Cluster. or Select a cluster from the MQ Clusters list in the navigation tree on the navigation panel. To change which cluster you are viewing, click the Cluster Name link (located at the top left corner of the dashboard, just below the dashboard name). Select a cluster from the drop-down list. If the Overview tab indicates that a cluster is performing poorly, use the MQ Server Infrastructure tab to investigate latency, blocks, or other configuration issues. For example, if your MQ cluster is distributed across a large geographic distance, this can result in high latency between queue managers. The MQ Server Infrastructure tab displays performance details for the auto-created sender and receiver channels and infrastructure queues, while the MQ Server Application tab displays the user-created MQ objects. Select any individual queue manager on any tab of this dashboard to examine that queue manager s details in the Queue Managers Group View. For detailed information about the views appearing on this dashboard, see the Chapter 2, Views on page 14.

12 Foglight Cartridge for IBM WebSphere MQ Server User and Reference Guide 12 Chapter 1 Using the Foglight Cartridge for IBM WebSphere MQ Server Using Action This section describes how to use the registry variable (mail.alias.mq) for sending MQrelated alerts. When an alert is fired by an MQ Object (for example, MQQueue, a queue in the MQ system), the registry values at different scope levels are checked in the following order: 1 Current (for example, MQQueue) 2 Current s parent (MQQueueManager) 3 Parent s parent (MQGroup) 4 Global value The first defined value found is used as the effective registry value. For example, if there is no value defined for MQQueue, and there is a value defined for MQQueueManager, then the value of MQQueueManager is used as the registry value. If no lower-level scope values are found, the global value (if defined) is used. You can define different values for the various scope levels in Foglight. This allows you to specify values relevant to the different queue levels. For example, if one administrator manages the MQQueueManager, while another administrator manages only the MQQueue, you can differentiate between the two by defining different scope level values so that the correct administrator is notified by from the correct MQ Object alert. To define a global value: 1 On the navigation panel, under Dashboards, click Administration > Rules & Notifications > Manage Registry Variable. 2 Locate the mail.alias.mq registry variable entry and click the variable name. Tip To locate the variable quickly, type mail in the Filter by Variable Name box. The Edit Registry Variables view loads. 3 In the Global Default area, type a valid address in the box. Note Foglight does not validate the address. 4 Click Save.

13 Foglight Cartridge for IBM WebSphere MQ Server User and Reference Guide 13 Chapter 1 Using the Foglight Cartridge for IBM WebSphere MQ Server To add a value to a non-global scope: 1 On the Edit Registry Variable page, click Add Registry Value at the bottom of the page. The Create Registry Value for mail.alias.mq -- Step 1: Select Topology and Default Value view appears. Tip For more information about specifying registry variables, see the Foglight User Help. 2 Select the Topology Type from the list. For example: MQGroup. 3 In the Default Value box, enter a valid address for the scope. 4 Click Add. The Add Performance Calendars view appears. 5 Optional Add a performance calendar. If you want the default value to change over time, add one or more schedules to the performance calendar and specify the value for each schedule. For more information, see the Foglight User Help. 6 Click Done. The Edit Registry Variable view refreshes. The scope value you created appears in the Registry Values box at the bottom of the view.

14 2 Reference This chapter contains reference information about Views, Rules, and Data tables that are included with the cartridge. Read this chapter to find out details about these components. Views Foglight displays monitoring data in views that group, format, and display data. The main types are described below. Dashboards are top-level views that contain lower-level views. The dashboards supplied with Foglight, as well as those created by users, are accessible from the navigation panel. Lower-level views in Foglight can be added to dashboards or can be accessed by drilling down from a dashboard. They receive and display data directly from the Foglight Management Server or from other views. Some views filter or select data that appears in other views in the same dashboard. Some are tree views with expandable nodes for selecting servers, applications, or data. The Cartridge for IBM WebSphere MQ Server ships with two dashboards, the MQ Queue Manager and MQ Cluster, which help you monitor your MQ environment. Each of these dashboards contains a number of views. The views are described in this section. For more information about the MQ dashboards, see Chapter 1, Exploring the MQ Dashboards on page 7. This cartridge includes the following views: Alarms Tab View Channel Details View Channels Tab View Detail Properties View Events Tab View Listeners Tab View LU6.2 Listener Details View NetBIOS Listener Details View MQ Cluster Overview Tab MQ Server Application View

15 Foglight Cartridge for IBM WebSphere MQ Server User and Reference Guide 15 MQ Server Infrastructure View Queue Details View Queue Managers Group View Queue Status View Queues Tab View SPX Listener Details View TCP Listener Details View Remote Queue Status View Alarms Tab View How to Get Here From the Queue Managers Group View, drill down on a queue manager and click the Alarms tab. The alarm information allows for quick diagnostics. Description of the View Data displayed Long Name. Contains the name and type of the object instance against which the alarms is raised. Hovering over this field shows a dwell with additional information about this object instance. Health. Indicates the object health, based one the highest severity alarm. Hovering over this field shows a dwell listing the most recent alarms for this queue. Alarms. Indicates the numbers of fatal, critical, and warning alarms for each object instance. Hovering over a severity column opens a dwell containing a list of the alarms of that severity, raised against this queue manager. For more information about alarms, see the Foglight User Guide. Health History. Indicates the object health, based on the highest severity alarm. Hovering over this field opens a dwell containing information about the most recent alarm for this object instance.

16 Foglight Cartridge for IBM WebSphere MQ Server User and Reference Guide 16 Description of the View Where to go next Drill down on any Long Name to opens a dwell with detailed views about the selected object instance, links to those views, and any additional information about the selected object instance. For example, clicking an MQQueueManager object opens a dwell containing a link that drills down to the Queues Tab View, the event status for the queue manager, and a graph view showing the depths of the DLQ and connection count for the selected queue manager. Drill down on any Health icon to open a dwell listing the alarm sources for the selected object instance, and links to views that show all alarm sources, the alarms raised against that object, and all outstanding alarms. Drill down on any Alarms count to open the Outstanding Alarms dialog box, containing a list of outstanding alarms associated with this queue manager. Channel Details View How to Get Here On the MQ Queue Manager dashboard, click the Channels tab, then select a channel entry in the table. Alternatively, on the MQ Cluster dashboard, click the MQ Server Application tab, then click the Application Channels tab and select a channel. This view shows the message count for the selected queue over time, along with the data flow to and from the transmission channel. The flow fields in this view provide color-coded real-time health status. Description of the View Data displayed Count Per Second. Contains the number of messages per second, sent and received on the WebSphere MQ client link over the connection to a specific client. Buffers Received. Contains the number of buffers received on the channel per second. Buffers Sent. Contains the number of buffers sent on the channel per second.

17 Foglight Cartridge for IBM WebSphere MQ Server User and Reference Guide 17 Description of the View Bytes Received. Contains the number of bytes received on the channel per second. Bytes Sent. Contains the number of bytes sent on the channel per second. Note For channels with more than one instance, these metrics are summed in this view. Channels Tab View How to Get Here On the MQ Queue Manager dashboard, click the Channels tab. This tab lists the channels that the selected queue manager uses for communication with other queue managers. A channel can have one of the following states: Initializing, Binding, Starting, Running, Stopping, Stopped, Retrying, or Requesting. By default, the Channels tab lists all channels. To list only the active channels, click Active Channels. To return to the default list, click All Channels. Description of the View Data displayed Channels Health. The channel health, based on the highest severity alarm. Hover over the icon to open a dwell listing the most recent alarms for this queue. Name. The channel name. Type. The channel type. A channel can be of one of the following types: Cluster-receiver. Receives information about the cluster. Cluster-sender. Sends cluster information to a queue manager. Receiver. Places the messages into the destination queue. Requester. Starts the channel. Sender. Starts the channel so that it can send messages to the other system. The sender requests the receiver at the other end of the channel to start, and sends messages from its transmission queue to the receiver. Server. Sends messages to the requester from the transmission queue defined in its channel definition. Server-connection. A bidirectional channel that connects an MQ client to a server, on the server-side.

18 Foglight Cartridge for IBM WebSphere MQ Server User and Reference Guide 18 Description of the View Status. The status of the channel associated with this queue. It can have one of the following values: Binding. Channel is performing channel negotiation and is not yet ready to transfer messages. Initializing. The channel initiator is attempting to start a channel. Indoubt (Yes). The sending MCA is waiting for a confirmation that a batch of messages that it has sent has been successfully received. Paused. The channel is paused. Starting. A request has been made to start the channel but the channel has not yet begun processing. A channel is in this state if it is waiting to become active. Stopped. The channel is stopped manually. Stopping. Channel is stopping or a close request has been received. Requesting. A local requester channel is requesting services from a remote message channel agent (MCA). Retrying. A previous attempt to establish a connection has failed. The connection is attempted after the specified time interval. Running. The channel is either transferring messages at this moment, or is waiting for messages to arrive on the transmission queue so that they can be transferred. Unavailable. No status is available for this channel. The channel is not operating. Messages Current. The number of messages on the channel in the current batch. Count/Sec.The rate (count per second) of messages travelling on this channel during the sample period. Session Total. The number of messages on the channel during the channel active period. Note For channels with more than one instance, these metrics are summed in this view. Sent Buffers. The number of buffers sent on the channel. Bytes. The number of bytes sent on the channel. Note For channels with more than one instance, these metrics are summed in this view. Received Buffers. The number of buffers received on the channel. Bytes. The number of bytes received on the channel. Note For channels with more than one instance, these metrics are summed in this view. Clusters Name. The names of any clusters that this channel is a part of.

19 Foglight Cartridge for IBM WebSphere MQ Server User and Reference Guide 19 Detail Properties View How to Get Here You can find this view in the bottom portion of the MQ Group Browser. To navigate to this dashboard, from the navigation panel, under Homes, click MQ Queue Manager. In the navigation tree that appears at the bottom of the navigation panel, select an MQGroup. This composite view contains additional details about the selected queue manager. This view contains the following embedded views: Events Status View Queue Manager More Info View Dead Letter Queue Depth View Connection Count View Events Status View Description Data displayed This view indicates which important event types are enabled from the monitored queue manager. For optimal monitoring, all of these event types should be enabled. Performance. The availability of performance events (Enabled or Disabled). Performance events are generated when the queue manager detects a change that is likely to impact the performance of an application. For example, when a queue depth limit is reached, the queue manager generates a performance event message. Start/Stop. The availability of start and stop events (Enabled or Disabled). Start and stop events are generated when a queue manager is started or is requested to stop. Inhibit. The availability of inhibit type of events (Enabled or Disabled). These types of events are generated when a read or write operation has been attempted against a queue that is inhibited for those types of operations. Local. The availability of local events (Enabled or Disabled). Local events are generated when a local queue or object is not accessible.

20 Foglight Cartridge for IBM WebSphere MQ Server User and Reference Guide 20 Events Status View Authority. The availability of authority events (Enabled or Disabled). Authority events are generated to report an authorization related to queue-related activities, for example, when an application attempts to open a queue. Remote. The availability of remote events (Enabled or Disabled). Remote events are generated when an application or the queue manager cannot access a remote queue on another queue manager. Auto-Definition. The availability of auto-definition events (Enabled or Disabled). Auto-definition events are generated when a channel is automatically generated for a queue manager. Queue Manager More Info View Description Data displayed This view lists the names of the command and dead-letter queues (DLQ) associated with the selected queue manager. Command Queue. The name of the system command queue. This queue receives system commands that are executed by the queue manager. Dead Letter Queue. The name of the dead-letter queue. This queue contains undeliverable messages. Dead Letter Queue Depth View Description Data displayed This graph shows the depth of the dead-letter queue (DLQ). This queue contains undeliverable messages. Dead Letter Queue Depth. The number of messages in the DLQ, plotted over time. Connection Count View Description Data displayed This graph shows the number of connections for the queue manager. Connection Count. The number of connections to the queue manager, plotted over time. Events Tab View How to Get Here On the MQ Queue Manager dashboard, click the Events tab. MQ events provide information about errors, warnings, or similar occurrences that are associated with queue managers, channels, or applications. The Events tab contains detailed information about each type of event: queue manager, channel, and performance events. MQ systems can generate different types of events. Each event type belongs to a particular event collection, such as queue manager, performance, and channel event collections. When an event

21 Foglight Cartridge for IBM WebSphere MQ Server User and Reference Guide 21 type is disabled in the queue manager, the queue manager does not generate that type of event and therefore they are not monitored. The following table lists the available event types and indicates the event collection they belong to: Event Collection Queue manager events Event Type Authority (Windows, HP OpenVMS, and UNIX systems only) Inhibit Local Remote Start and stop (z/os supports only start events) Performance events Channel events Performance Channel Channel auto definition SSL N/A Logger Each event can have a unique set of fields that may not appear in the Events view. To find out more about the information associated with an event, use the Metric Analyzer. To access it, on the navigation panel, under Dashboards, click Configuration > Data and, in the data tree, navigate to the event using the following path: WebSphere MQ > All MQ Groups > MQ Group > queuemanagers > Queue Manager > events > Event.

22 Foglight Cartridge for IBM WebSphere MQ Server User and Reference Guide 22 Description of Embedded Views This view is made up of the following embedded views: Queue Manager Events View Channel Events View Performance Events View Queue Manager Events View Description Data displayed Queue manager events are reported by queue managers as a result of conditions detected during their operation: for example, when a queue manager is stopped. Time (GMT). The time (GMT) at which the queue manager event occurred. Queue Name. The name of the queue associated with the queue manager. Event Type. The event type. The MQAgent properties can be used to configure the type of events that are collected by the agent. For a complete list of event types, see your IBM WebSphere MQ documentation. Description. A brief description of the queue manager event. If the description exceeds the column description and only a part of it is visible, hover over this field to see the entire description in a tool-tip. Application Name. The name of the application associated with the MQ event. Application Type. The type of the application associated with the MQ event. For a complete list of application types, see your WebSphere MQ documentation. Channel Events View Description Data displayed Channel events are reported by channels as a result of conditions detected during their operation: for example, when a channel instance is stopped. Time (GMT). The time (GMT) at which the channel event occurred. Channel Name. The name of the channel. Event Type. The event type. The MQAgent properties can be used to configure the type of events that are collected by the agent. For a complete list of event types, see your IBM WebSphere MQ documentation. Description. A brief description of the channel event. If the description exceeds the column description and only a part of it is visible, hover over this field to see the entire description in a tool-tip. Queue Manager Name. The name of the queue manager associated with the channel event. Transmission Queue Name. The name of the transmission queue used by sender channels. Connection Name. The name of the channel connection.

23 Foglight Cartridge for IBM WebSphere MQ Server User and Reference Guide 23 Performance Events View Description Data displayed Performance events are notifications that occur when a resource reaches a threshold condition. For example, when a queue depth limit is reached or when the queue is not serviced within a predefined time limit. Time (GMT). The time (GMT) at which the performance event occurred. Queue Name. The name of the queue. Event Type. The performance event type. For a complete list of event types, see your IBM WebSphere MQ documentation. Description. A brief description of the performance event. If the description exceeds the column description and only a part of it is visible, hover over this field to see the entire description in a tool-tip. Queue Manager Name. The name of the queue manager associated with the performance event. High Depth. The highest number of messages in the queue for the collection period. Enqueues. The number of messages put in the queue since the queue statistics were last reset. Dequeues. the number of messages removed from the queue since the queue statistics were last reset. Listeners Tab View How to Get Here On the MQ Queue Manager dashboard, click the Listeners tab. Listeners accept incoming network requests from remote queue managers or from client applications. Once accepted, a listener starts the associated receiver or server connection channels to enable the queue manager to receive messages. There are four types of listeners, one for each supported network protocol: TCP, NetBIOS, SPX, and LU6.2. This tab lists the available listeners and their status. The bottom half of the Listeners tab provides a detail view for the selected listener.

24 Foglight Cartridge for IBM WebSphere MQ Server User and Reference Guide 24 Description of the View Data displayed Where to go next Health. The listener health, based one the highest severity alarm. Hovering over this field opens a dwell listing the most recent alarms for this listener. Name. The name and type of the listener. Start Date/Time. The date and time at which the listener was started. Start Mode. The start mode for the listener: Queue Manager or Manual. Status. The listener status (for example, Started, Running, or Stopped). Type. The network protocol used by the listener: TCP, LU6.2, NetBIOS, or SPX. Description. Additional information about the listener. Drill down on the listener Name to view the LU6.2 Listener Details View, NetBIOS Listener Details View, SPX Listener Details View, or TCP Listener Details View. LU6.2 Listener Details View How to Get Here In the Listeners Tab View, select an LU6.2 listener entry in the table. This view lists the listeners that accept incoming requests from sources using the LU 6.2 network protocol. Description of the View Data displayed TP Name. The transaction program (TP) name to start on the remote site, as defined on the monitored system. NetBIOS Listener Details View How to Get Here In the Listeners Tab View, select a NetBIOS listener entry in the table. This view lists the listeners that accept incoming requests from sources using the NetBIOS network protocol. Description of the View Data displayed Name. The name of the NetBIOS listener. Adapter. The number of the LAN adapter. The default is zero 0. NetBIOS Names. The number of names to allocate. Sessions. The number of sessions to allocate. Commands. The number of commands to allocate.

25 Foglight Cartridge for IBM WebSphere MQ Server User and Reference Guide 25 SPX Listener Details View How to Get Here In the Listeners Tab View, select an SPX listener entry in the table. This view lists the listeners that accept incoming requests from sources using the SPX network protocol. Description of the View Data displayed Socket. The SPX socket number in hexadecimal notation. Back Log. The number of outstanding requests for the SPX listener. TCP Listener Details View How to Get Here In the Listeners Tab View, select a TCP listener entry in the table. This view lists the listeners that accept incoming requests from sources using the TCP network protocol. Description of the View Data displayed IP Address. The IP address used by the listener, as defined on the monitored system. Port. The port number used by the listener. Back Log. The number of outstanding requests for the TCP listener. MQ Cluster Overview Tab How to Get Here On the navigation panel, under Homes, click MQ Cluster. If it is not already selected, click the Overview tab. This tab provides an overview of alarms and key metrics for a selected queue manager in a cluster.

26 Foglight Cartridge for IBM WebSphere MQ Server User and Reference Guide 26 The overview table lists the queue managers. You can filter this list by clicking Monitored Queue Managers, Unmonitored Queue Managers, or All Queue Managers. Selecting the option button in a row containing a queue manager populates the graphs of key metrics. At the bottom of the view is a table of alarms for the cluster. Queue Managers Table Description of the View Data displayed Queue Manager Name. Contains the name of the queue manager. Alarms. The numbers of fatal, critical, and warning alarms for this queue manager. Hovering over a severity column opens a dwell containing a list of the alarms of that severity, raised against this queue manager. For more information about alarms, see the Foglight User Guide. Host Name. The name of the computer that is hosting the queue manager. If your monitoring environment includes the Cartridge for Infrastructure, you can click the host name to drill down to the host health details. Hovering over this field shows a dwell listing the Health, Alarms, CPU, Memory, Disk, and Network metrics for this host. This allows you to quickly determine if the alarm is related to the OS, or another source on the host. Repository Type. The type of repository: full or partial. For definitions and setup information, see the IBM WebSphere MQ Server documentation.

27 Foglight Cartridge for IBM WebSphere MQ Server User and Reference Guide 27 Description of the View Status. The running state of the queue manager. Click an entry to open a dwell with a graph view, representing the queue manager s availability over time. Zero 0 indicates that the queue manager is unavailable, and one 1 indicates that the queue manager is available. Where to go next Drill down on any Queue Manager Name to open the MQ Queue Manager dashboard. For more information, see Monitoring Queue Managers on page 9. Drill down on any Alarms field to open the Outstanding Alarms dialog box, containing a list of outstanding alarms associated with this queue manager. This allows you to browse through the alarms, which are sorted according to severity. Drill down on any Host Name to open the Host Monitor dashboard. This dashboard provides a real-time overview of how a host is functioning. For more information about this dashboard, see the Foglight User Guide. Graphs of Key Metrics Description of the View Data displayed Infrastructure Overall Message Rate Graph. The enqueue and dequeue rates of messages for the selected cluster infrastructure, plotted over time. Application Overall Message Rate Graph. The enqueue and dequeue rates of messages for the selected cluster application (user-created), plotted over time. Overall Queue Depth. The queue depth for both application and infrastructure objects, plotted over time. Dead Letter Queue Depth Graph. The depth of the dead letter (undeliverable message) queue; either zero or one, where one indicates the presence of dead letters in the queue, plotted over time.

28 Foglight Cartridge for IBM WebSphere MQ Server User and Reference Guide 28 Description of the View Where to go next Connection Count Graph. The number of connections to the queue manager, plotted over time. Alarms Under ClusterName. This table lists the Long Name, Health, Alarms, and Health History for queue managers, grouped into clusters. In the Alarms Under ClusterName table: Drill down on any Long Name to open a dwell with detailed views for the selected object instance, links to those views, and any additional information about the selected object instance. For example, clicking an MQQueueManager object opens a dwell containing a link that drills down to the Queues Tab View, the event status for the queue manager, and a graph view showing the depths of the dead letter queue and connection count for the selected queue manager. Drill down on the Health icon to open a dwell with alarm source information and links to more details. Drill down on any Alarm value to open the Outstanding Alarms dialog box. Drill down on the Health History to open a popup that allows you to examine the health status over time. MQ Server Application View How to Get Here On the MQ Cluster dashboard, click the MQ Server Application tab. This tab allows you to monitor the MQ server application objects; that is, the user-created objects on the MQ queue manager. The top portion of this view, the Queue Managers Table, is common to all tabs on the MQ Cluster dashboard. This view contains two embedded views: Application Queues and Application Channels.

29 Foglight Cartridge for IBM WebSphere MQ Server User and Reference Guide 29 Application Queues This tab lists the detailed information for any application (user-created) queues on the selected queue manager. The information presented changes depending on the type of queue selected (for example, local, remote, or transmission). The views at the bottom of the tab show the data flow to and from the selected queue, and its depth. The appearance of these views depends on the selected queue type. Application Queues Table Description of the View Data displayed Where to go next Health. The health status icon for the queue. Name. The name of the queue. Type. The type of queue; for example, transmission, local, remote, or alias. Queue Manager Name. The name of the queue manager that manages this queue. Queue Depth. Statistical information about the depth of the queue. Current. The current depth of the queue. History. The historical depth of the queue plotted over time. Period Max. The maximum depth of the queue for the selected period. High Limit (%). The Max Depth. The all-time maximum depth of the queue. Drill down on a Queue Name or the Queue Manager Name to view the queue details in the Queues Tab View. Select a Local queue in the Application Queues Table to view the Queue Status View. Select a Transmission queue to view the Queue Details View. Select a Remote queue to view the Remote Queue Status View. Application Channels This tab lists the detailed information for any application (user-created) channels on the selected queue manager. The information presented changes depending on the type of channel selected (for example, sender or receiver). Channels Table Description of the View Data displayed Health. The health status icon for the queue. Name. The name of the channel. Type. The type of channel; for example, sender or receiver. Status. The availability status of the channel.

30 Foglight Cartridge for IBM WebSphere MQ Server User and Reference Guide 30 Description of the View Where to go next Queue Manager Name. The name of the queue manager that manages this queue. Messages Current. The current number of messages in the channel. Count/Sec. The number of messages per second in the channel. Session Total. The total number of messages in the channel for the current session. Sent Buffers. The number of buffers sent on the channel per second. Bytes. The size of the sent messages (in bytes) in the channel. Received Buffers. The number of buffers received on the channel per second. Bytes. The size of the received messages (in bytes) in the channel. Drill down on any Channel Name to view the channel details in the Channels Tab View. Drill down on the Queue Manager Name to view the queue manager details in the Queues Tab View. Below the Channels Table is the Channel Details View. MQ Server Infrastructure View How to Get Here On the MQ Cluster dashboard, click the MQ Server Infrastructure tab. This tab allows you to monitor the MQ server infrastructure objects; that is, the objects that are automatically created on the MQ queue manager when it is included in a cluster.

31 Foglight Cartridge for IBM WebSphere MQ Server User and Reference Guide 31 This tab contains three embedded tab views: Cluster Sender Channel, Cluster Receiver Channel, and Infrastructure Queues. Cluster Sender Channel Use this view to see the status of sender channels for the cluster. Select a queue manager in the Queue Managers Table to populate the Cluster Sender Channel view. If more than one sender channel is available, you can select the channel to view from the drop-down list. The flow fields and disk objects in this view provide color-coded real-time health status. Click the Filter button to use regular expressions to filter the list of channels. Cluster Receiver Channel Use this view to see the status of receiver channels for the cluster. Select a queue manager in the Queue Managers Table to populate the Cluster Receiver Channel view. If more than one receiver channel is available, you can select the channel to view from the drop-down list. The flow fields and disk objects in this view provide color-coded real-time health status. Click the Filter button to use regular expressions to filter the list of channels. Infrastructure Queues This view lists details of the infrastructure queues for the selected cluster. The information provided here is the same as in the Application Queues Table. Drill down on a Queue Name or a Queue Manager Name to view the queue in the Queues Tab View. Queue Details View How to Get Here From the Queue Managers Group View, drill down on a queue manager and click the Queues tab, then click a remote or a transmission queue in the table. Alternatively, on the MQ Cluster dashboard, click the MQ Server Application tab, and select a Transmission queue from the Queue table on the Application Queues tab. This view shows the message count for the selected queue over time, along with a list of remote queues.

32 Foglight Cartridge for IBM WebSphere MQ Server User and Reference Guide 32 Description of the View Data displayed Where to go next Sender Channel. The name of the sender channel for this queue. Status. The status of the sender channel associated for this queue: Initializing. The channel initiator is attempting to start a channel. Binding. Channel is performing channel negotiation and is not yet ready to transfer messages. Paused. The channel is paused. Starting. A request has been made to start the channel but the channel has not yet begun processing. A channel is in this state if it is waiting to become active. Running. The channel is either transferring messages at this moment, or is waiting for messages to arrive on the transmission queue so that they can be transferred. Stopping. Channel is stopping or a close request has been received. Stopped. The channel is stopped manually. Retrying. A previous attempt to establish a connection has failed. The connection is attempted after the specified time interval. Requesting. A local requester channel is requesting services from a remote message channel agent (MCA). Indoubt (Yes). The sending MCA is waiting for a confirmation that a batch of messages that it has sent has been successfully received. Unavailable. The channel is disconnected. Message Count. The number of messages processed since the last re-start of the channel. Remote Queues. A list of the remote queues that depend on this channel. A service problem on this channel impacts each of these queues. Message Count Graph. The message count plotted over time. Drill down on any Remote Queues field. Links to a set of Queue Status View and Queue Details View views, showing the information for the selected remote queue.