Icon

Comments have been closed on this page. Please use AppMon & UEM Open Q & A forum for questions about this plugin.

Overview

 

The Websphere Message Broker Plugin is a monitor that uses SSH, based on the GE Plugin, to execute 'mqsi' commands remotely. It pulls back data on the following items:

  • Broker status
  • Execution Group status
  • Message Flow status
  • MQ connection status
  • ODBC connection status
  • Report Trace status

Name and Version

WebSphere Message Broker monitor plugin

Version: 1.1.3

Compatible with

Tested on Dynatrace version 6.1, 6.2 and 6.3

Tested on WMB version 7 and 8

Author

Shaun Gautz (shaun.gautz@dynatrace.com)

License

dynaTrace BSD

Support Level

Not Supported

Download

com.dynatrace.diagnostics.plugin.extended.WebsphereMessageBroker_1.1.7.jar

Message Broker Health Dashboard.dashboard.xml

Description

The WMB plugin is a monitor that uses SSH to remotely execute 'mqsi' commands, analyze the data, and return measurements. See details below.

More information can be found about the 'mqsi' commands here:

http://www-01.ibm.com/support/knowledgecenter/SSKM8N_7.0.0/com.ibm.etools.mft.doc/an07060_.htm

Release History

2015-11-24 Initial Release

2015-11-25 Bug fixes

2015-11-30 Updated logging

  • FINE - Will log the command used and output from that command
  • FINER - Detailed logging

2015-12-2 Allow for multiple Broker instances with the same name

2015-9-13 Added second command option for Broker status. Fixed 'null' issue with the ODBC connection

Dashboard

Here is an example of a dashboard you can create using this plugin. Download it above.

Configuration

Permissions needed

  • SSH access to the WMB server
  • Access to execute the 'mqsi' commands listed below

Authentication method

  • Password
  • Key file

Execute command

  • Use either "." or "source" to remotely execute the commands

MQSI file location

  • Location of where the 'mqsi' commands are located

Detailed Message

  • The remote command that was executed will be displayed in the "Detailed message" of the monitor

Multiple Brokers/Process Owner

  • If you have more than one Broker on the server using the same name, than you can track them individually by identifying the username who owns each process. With the 'ps aux' command, it is the first column in the output.

Usage

These are the following metrics you can collect:

  1. Broker Status
    1. Uses the 'ps' command. Returns a 1 if the broker is running.
    2. Sample command
      1. ps aux | grep "bipbroker BrokerName"
      2. ps aux | grep "bipbroker BrokerName" | grep "root"
      3. ps -fea | grep "bipbroker BrokerName"
    3. Sample output
      1. Broker Status: 1.0
  2. Execution Group Status
    1. Uses the 'mqsilist' command. Splits on each Execution group and returns a 1 if the EG is "running".
    2. Sample command
      1. . /opt/IBM/mqsi/7.0/bin/mqsiprofile; mqsilist BrokerName | grep "Execution group"
    3. Sample output
      1. Execution Group Status (Execution Group,ExecutionGroupName01): 1.0
        Execution Group Status (Execution Group,ExecutionGroupName02): 0.0


  3. Message Flow Status
    1. Uses the 'mqsilist' command. Splits on each Message Flow and returns a 1 if the MF is "running".
    2. Sample command
      1. . /opt/IBM/mqsi/7.0/bin/mqsiprofile; mqsilist BrokerName -e ExecutionGroupName01 | grep "Message flow"
    3. Sample output
      1. Message Flow Status (Message Flow,com.abc.customer.main.Outage): 1.0
        Message Flow Status (Message Flow,com.abc.customer.main.Service): 0.0

  4. MQ Status
    1. Uses the 'mqsicvp' command. Returns a 1 if the WebSphere MQ verification for component 'BrokerName' has finished successfully.
    2. Sample command
      1. . /opt/IBM/mqsi/7.0/bin/mqsiprofile; mqsicvp BrokerName | grep "WebSphere MQ verification"
    3. Sample output
      1. MQ Status: 1.0

  5. ODBC Status
    1. Uses the 'mqsicvp' command. Returns a 1 if the Verification passed for User Datasource 'XYZ'.
    2. Sample command
      1. . /opt/IBM/mqsi/7.0/bin/mqsiprofile; mqsicvp BrokerName | grep "Datasource" | grep "Verification"
    3. Sample output
      1. ODBC Status (ODBC Connection,XYZ): 1.0
        ODBC Status (ODBC Connection,ABC): 0.0


  6. Report Trace Status
    1. Uses the 'mqsireporttrace' command. Returns a 1 if the Trace nodes are either 'on' or 'off' for each message flow.
    2. Sample command
      1. . /opt/IBM/mqsi/7.0/bin/mqsiprofile; mqsireporttrace BrokerName -n -e ExecutionGroupName01 | grep "for execution group"
    3. Sample output
      1. Report Trace Status (Report Trace, com.abc.customer.main.Outage. ): 1.0
        Report Trace Status (Report Trace, com.abc.customer.main.Service. ): 0.0

 

  • No labels
  1. Anonymous (login to see details)

    Anyone tested this on IIB Version 10 (latest version/renaming of Message Broker) ?  

    The following links shows that they still use the same MQSI commands to pull the data - https://www.ibm.com/support/knowledgecenter/SSMKHH_10.0.0/com.ibm.etools.mft.doc/an07060_.htm

     

    1. Anonymous (login to see details)

      Hi Mike,

      Did you ever find out the answer to this or test it out? 

      Thanks

      Luis

  2. Anonymous (login to see details)

    Hi folks!

    Do I need to configure one monitor for each one of the monitoring options available to populate the whole Dashboard?

    e.g.:

    To get the memory consumed on each Execution Group do I need to configure a "Execution Group Status monitor" ? Or the "Broker Monitor" should get these metrics too?


    Thanks in advance

  3. Anonymous (login to see details)

    You will need to configure one monitor for each of the items you want to collect data from. Also, not everything in the dashboard above is collected from this plugin. For example, this plugin does not collect memory statistics.

    Shaun

  4. Anonymous (login to see details)

    Hi Shaun Gautz

    The dashboard that show is a combination of the plugin and the agent "Message broker"

    Regards..!

  5. Anonymous (login to see details)

    Hi Everyone,

    In the plugin configuration, there is a place to indicate the host. How can I use this for multiple hosts?

    Thanks!

    Phill

    1. Anonymous (login to see details)

      Let me look into this and I will update you when I know more.

      Shaun

      1. Anonymous (login to see details)

        Phill,

        Send me an email directly at shaun.gautz@dynatrace.com. I have a version I would like for you to test.

        Shaun