Icon

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

Overview

 

TIBCO BW monitoring made possible through JMX (only for projects deployed on TIBCO Administrator). Current TIBCO specific metrics gathered from MBeans are:

1) getStatus
2) GetProcessCount
3) GetMemoryUsage
4) GetExecInfo
5) GetActiveProcessCount
6) GetProcessDefinitions
7) ListDbConnections

The plugin also give you the ability to gather JVM specific information. Please see JVM Monitoring Plugin for more details.

Plug-In Files

com.dynatrace.diagnostics.plugins.jmx.tibcobw_1.0.0.jar

Tibco.Environment.-.Overview.dashboard.xml

Tibco.Project.-.Overview.dashboard.xml

Author

Todd Ellis

Versions

Dynatrace 6.0+, Tibco BusinessWorks 5.7+

(Not tested in Tibco BusinessWorks 6)

License

dynaTrace BSD

Support Level

Not Supported

Release History

05/XX/15 - v1.0.0 Initial Release


Collector Configuration:

You need to ensure the collector host is not marked as unknown. If it is, when running the plugin, you will get a local host related error. To resolve the issue for Linux:

  1. Type hostname (on the collector box in order to get the host name)
  2. In /ect/hosts define the hostname from above command)

On Windows, the host file is located: c:\windows\system32\drivers\etc\hosts

Installation and Configuration

Setup for Tibco BW

  1. Edit the bwengine.tra file for each project.

    Jmx.Enabled=true
    java.property.com.sun.management.jmxremote=true
    java.property.com.sun.management.jmxremote.port=<port_number>
    java.property.com.sun.management.jmxremote.authenticate=false
    java.property.com.sun.management.jmxremote.ssl=false

  2. Restart the project.

Setup for Dynatrace Application Monitoring

  1. Import the Plugin into the dynaTrace Server via the dynaTrace Server Settings menu -> Plugins -> Install Plugin. For details how to do this please refer to the dynaTrace documentation: Plugin Management - Dynatrace Community
  2. Navigate to the appropriate System Profile Preferences and create a new Tibco BW Monitor.
  3. i. Enter the name for the monitor (eg. environment name).
    ii. Fill out the Settings



    1. Environment - Name of the Environment

    2. Instance Name - Name of the Instance

    3. JVM Server:Port - Enter the server and port. <server>:<port>

    4. Password - Enter username and password. <username>:<password> If there is no username/password, enter "-" (without quotes).

    5. Monitor Tibco - Enable/disable Tibco data (GetStatus, getProcessCount, GetMemoryUsage, GetExecInfo, GetActiveProcessCount, and GetProcessDefinitions)

    6. Ignore Process Definition - List the processes you do not want to monitor (separate with newline).
    7. JVM Monitor - Enable/disable JVM data

    8. MBeans - List of MBeans to monitor (separate with newline)

    9. Attributes - List of Attributes to monitor (separate with newline)

  4. Add a host for the monitor (Tibco BW Server DNS or IP)
  5. Under the Schedule tab, configure the monitoring interval and dynaTrace Collector
  6. Under the Measures tab, configure the Thresholds. NOTE: For Dynamic Thresholds (different thresholds per server), refer to the Extended EMail Action Plugin.
  7. Confirm data collection by right clicking the server name under Monitors, then navigating to details.

Updating the Plugin

NOTE: The following steps should be taken to ensure that the Collector is running the correct plugin revision. A restart of the Collector is highly recommended.

  1. Open the System Profile Preferences
    1. Navigate to the Monitors tab in the left pane. 
    2. Select the plugin Monitor and click on the Suspend button. 
    3. Click OK to confirm the changes.
  2. Open the dynatrace Server Settings
    1. Navigate to the Plugins tab in the left pane. 
    2. Select the old version of the plugin under Installed Plugins and click on the Delete button.
    3. Click on the Install Plugin... button and upload the new revision of the plugin. Click Open, then Apply.
    4. Navigate to the Collectors tab in the left pane.
    5. Select the Collector executing the plugin and click on the Restart button.
    6. Click OK to confirm the changes.
  3. Open the System Profile Preferences
    1. Navigate to the Monitors tab in the left pane. 
    2. Select the plugin Monitor and click on the Resume button. 
    3. Click OK to confirm the changes.

Usage

Two dashboard templates are attached with the Tibco BW Monitoring Plugin.

The Tibco BW Environment Overview dashboard (below) provides the general health of the whole environment. The CPU Usage chart, Web Requests, Database, and Transaction Flow are metrics collected from the Dynatrace Agents. The Web Services traffic lights are based off of the Tibco BW Monitoring Plugin metrics that have defined thresholds. The traffic light charts have Dashboard Links to their respective Tibco BW Project Overview dashboard to provide further details (second dashboard template).

Note: Dashboard Links can be created by accessing Dashlet Properties > Dashlet Links.


The Tibco BW Project Overview dashboard (below) provides detailed metrics of a single project. This dashboard is accessed by drilling down from the Tibco BW Environment Overview dashboard above.

  1. Anonymous (login to see details)

    Where is the code for this? Should the code be available here: https://github.com/dynaTrace/Dynatrace-Tibco-BW-Monitoring-Plugin ?

    Does this work for BW projects deployed in ActiveMatrix (aka AMX)?

    Does this need to have Hawk (or other config other than the jmx) for this to work?

  2. Anonymous (login to see details)

    Hi,

    Inside the plugin you will find the source code. You should be able to download the plugin and import it into eclipse. Yes, the plugin works with TIBCO BW ActiveMatrix although I have not tested it on version 6. The projects need to be deployed through the Administrator for us to monitor them through JMX and you will need a hawk agent deployed as this is how the measures are made available to JMX.

    If you have any other questions, please let me know.

    Thanks,
    Todd

  3. Anonymous (login to see details)

    Hi,

    I have configured the BW plugins for our ESB setup.

    I would like to replicate this dashboards in our setup. For this I understood which metrics to choose for all dashlets except for the followings:

    1. Traffic signal used for 'Monitoring status' and 'web service' in TIBCO Environment Overview dashboard.
    2. Traffic signal used for 'Monitoring Status' and 'Execution status' in TIBCO Project Overview dashboard.

    It would be helpful if someone can help me on this.

     

    1. Anonymous (login to see details)

      Hi,

      For example, on the <Project Name> Overview:

      The Monitoring status is looking at:

      Verifying we can connect to the JVM, how long it took to monitor and how long the JVM has been running.

      And the Execution status is looking at:

      This status can be Active, Suspended, Standby or Stopping.

      I am using 0 as Active and 1 for everything else.

       

      Tibco Environment Overview:

      For the Web Service, you can use any of these metrics (pick one that will give you an idea as to how you are performing) For example, you could choose Most Recent Execution Time and do an average over a time frame:

      And for the Monitoring Status (so you don't have to look all the Tibco Project Overview pages) uses all the monitoring status from all the Tibco Project Overview pages.

      The dashboards really are just a starting point for everyone. Feel free to modify to meet your monitoring needs. If you come up with a great design, please share.

      Hope this helps. If not, let me know and I can go into more detail.

      Thanks,
      Todd 

       

      1. Anonymous (login to see details)

        Thanks for help.

  4. Anonymous (login to see details)

    Hi,

    I have done configuration of 12 BW instances running on 5 servers. Out of which I am getting data for 9 BW instances whereas in remaining 3 BW instances I am getting data as NULL only.

    All this 3 BW instances are hosted on one single server.

    I had confirmed that required JMX arguments are added correctly and post that BW has restarted.

    Also the hawk is running on this server.

    and I am also able to do telnet from my collector machine to JMX port of BW server. So there is no firewall blocking issue.

     

    But still I am getting all parameters value as NULL. Is there any thing I have missed  to configure? Kindly suggest.

    1. Anonymous (login to see details)

      Hi,

      On the 3 BW instances, are the projects deployed through the TIBCO Administrator? Also could you validate, using Jconsole, if you are seeing any TIBCO MBeans?

      Feel free to email me at todd.ellis@dynatrace.com. If needed, we can setup a WebEx to troubleshoot.

      Thanks,

      Todd

  5. Anonymous (login to see details)

    Dear Team,

    Can you help me in finding the significance of below JVM parameters captured by this BW plugin: 

    Available Processors
    Daemon Thread Count
    Free Swap Space Size
    JVM DATA
    JVM Uptime
    Old Collection Count
    Old Collection Time
    Old Total Compacts
    Peak Thread Count
    Process Cpu Time
    Process Cpu Time By NS
    Processing Capacity
    System Load Average
    Thread Count
    Total Started ThreadCount
    Total Swap Space Size
    Young Collection Count
    Young Collection Time
    Young Total Compacts

     

     

    1. Anonymous (login to see details)

      Hi,

      The measures below are related to the threading of the JVM:

      Daemon Thread Count

      Peak Thread Count

      Thread Count

      Total Started ThreadCount

       

      The measure below is how many processors you have available:

      Available Processors

       

      The measures below are related to the CPU Time (how much you are consuming) for the project:

      Process Cpu Time
      Process Cpu Time By NS

       

      The measure below is an average of the computer’s load over several periods of time. This allows you to see how much work your computer has been performing.  

      System Load Average

       

      The below measure referrers to the ability and speed of a processor, and how many operations it can carry out in a given amount of time. These kinds of measurements are critical for those who analyze hardware systems and measure their overall capacity and capabilities.

      Processing Capacity

       

      The measures below are related to the swap you are/can use:

      Free Swap Space Size

      Total Swap Space Size

       

      The below measure is how long the JVM has been running.

      JVM Uptime

       

      The below is a catch all. Meaning all metrics collected, that are not configured in the plugin, will go here.

      JVM DATA

       

      The below is related to the JVM your BW project is running in. It is collection counts (how many times), collection time (how long it took) and total compacts (how many compacts were needed - fragmentation of memory).

      Old Collection Count
      Old Collection Time
      Old Total Compacts
      Young Collection Count
      Young Collection Time
      Young Total Compacts

       

      Hope the above helps.

      Thanks,
      Todd

      1. Anonymous (login to see details)

        Below measures will provide data for current time or total sum since from BW engine got started?


        Old Collection Count

        Old Collection Time
        Old Total Compacts
        Young Collection Count
        Young Collection Time
        Young Total Compacts

        1. Anonymous (login to see details)

          Hi,

          The JVM metrics are since the project was started. Each project runs in its own JVM.

          Thanks,
          Todd

  6. Anonymous (login to see details)

    Todd,

    How to get the <port_number> for the below properties

    Jmx.Enabled=true
    java.property.com.sun.management.jmxremote=true
    java.property.com.sun.management.jmxremote.port=<port_number>
    java.property.com.sun.management.jmxremote.authenticate=false
    java.property.com.sun.management.jmxremote.ssl=false

    1. Anonymous (login to see details)

      Hi,

      When you edit the bwengine.tra, for each project, you decide what the port number should be.Just be careful the port you choose is not already in use by another process.

      Thanks,
      Todd

  7. Anonymous (login to see details)

    Thansk Todd.

  8. Anonymous (login to see details)

    Todd,

    I have installed the TIBCO BW Plug in and added the above mentioened properties. 

    Can you please let me know how to create the above dashlet with Project Wise and Environment overview?

    Thanks,
    Gopala 

  9. Anonymous (login to see details)

    Hi,

    You can download the TIBCO Project and Environment dashboards above (in the plugin files section). Then you can open them in your DT client. You will need to change the Dashboard property for Source (match where you installed the plugin) and also adjust the individual dashlet properties (series tab) to match the measure names on your system. I would start with the Project Overview Dashboard. Once you define what you want to alert on, then I would get the Environment Overview dashboard working.

    Hope that helps.
    Todd

  10. Anonymous (login to see details)

    Thanks for the response Todd. 

    I already downloaded those XMLs, Can you please let me know how to install these Dashlet XMLs. 

    Please give me steps to do that.

    Thanks,

    Gopala

    1. Anonymous (login to see details)

      Hi,

      In your DT client, choose (top left) Dashboard -> open. In the new window that opens, choose my computer and navigate to where you downloaded the dashboards. Just select the Dashboard and choose Open Dashboard (bottom right). When you save the Dashboards, you can save as. This will allow you to save it on the DT server and also give it a different name.

      Thanks,

      Todd

  11. Anonymous (login to see details)

    Thansk Todd,

    I am able to download the Dashlets in my DT client. 

    But the data capturing from my Application is not showing up at Tibco Overview dashlet, but can see in the transaction Flow and i have followed all steps mentioned above. 

    Can you please let me know why this not showing up ?

    Thanks,

    Gopala Janjanam

  12. Anonymous (login to see details)

    Hi,

    If you can send me an email (todd.ellis@dynatrace.com) I will work with you on the setup.

    Thanks,

    Todd

  13. Anonymous (login to see details)

    Hi Todd Ellis,

                         I have imported TIBCO Project and Environment dashboards (provided above n the plugin section. I have also added the required properties in bwengine.tra. But still the data related to the service is not showing in the dashlet. The traffic signal status is also not showing.

     

    Please help me to sort this out.

                                   

     

     

    Thanks,

    Debkiran

    1. Anonymous (login to see details)

      Hi Debkiran,

      unfortunately Todd Ellis is not with Dynatrace anymore. I have provided the source code of the plugin in the GitHub repo: https://github.com/Dynatrace/Dynatrace-Tibco-BW-Monitoring-Plugin. Hopefully someone else from the community is soon taking care of this plugin.

      Remember: this plugin is NOT supported by Dynatrace. It's only supported through the community.

      Ingo