Using Bluemix Product Insights to view IBM Integration Bus Startup and Usage

IBM Knowledge Center

Learn how to use the Product Insights service on Bluemix to get a centralized view of IBM Integration Bus Startup and Usage.

Import an example Application which will generate load on IBM Integration Bus

When you click Import, the PrimeNumbers application, which contains a message flow of the same name, will be created in your workspace.

Later in this tutorial, you will send an HTTP request message into this message flow using the Flow Exerciser, and the same data will be immediately echoed back to you. However, the flow will continue to execute a while loop in the Compute node after this reply has been sent. This logic will search for all the prime numbers between 0 and 100000, just as an easy means of making the message flow use CPU on your machine for a few minutes. This will create some data which will make the graphs shown in the Product Insights service dashboard a bit more interesting!

Create an instance of the IBM Cloud Product Insights Service in Bluemix

  1. Log in to Bluemix and go to the Catalog section
  2. In the Integrate section, click the Cloud Product Insights tile. The service details page is displayed, showing details of the free service. Default names are supplied, which you can change if you want to.
  3. Click Create and your service is now available.
  4. Click the Service Credentials tab. The list of credentials for your products is displayed.
  5. Click View Credentials for your new service, to show the API host and the API key that will be used for the connection to your IBM Integration Bus integration servers.

Configure your IBM Integration Bus integration server

  1. Open the IBM Integration Console window and type the following commands:
    1. mqsistop TESTNODE_userid where TESTNODE_userid is the IIB node name
    2. mqsichangebluemixreporting TESTNODE_userid -e default -c active -j https://productinsights-api.ng.bluemix.net -m 10 -k ag282f6-6jki-4984-8892-7356e196k0l7
      where
      default is the name of your integration server
      https://productinsights-api.ng.bluemix.net is the API host taken from the credentials section of the service
      10 is the interval in minutes between submissions to Bluemix
      ag282f6-6jki-4984-8892-7356e196k0l7 is the API key taken from the credentials section of the service
    3. mqsistart TESTNODE_userid where TESTNODE_userid is the IIB node name

Follow these steps to complete the tutorial

Follow the instruction to register IBM Integration Bus with Product Insights service.

  1. Open the PrimeNumbers message flow and click the Flow Exerciser icon to start testing the flow. If your Toolkit is connected to multiple servers, you may be asked which one you would like to use. Select an Integration Server under the node which you prepared with the mqsichangebluemixreporting command earlier.
  2. Click the Send Message icon , and choose the provided ExampleInput and click Send.
  3. You should receive an HTTP reply immediately, but the flow will continue to work for a few minutes (you will see this if you check the CPU being used on your machine).
  4. IBM Integration Bus has been configured to send usage data to Product Insights every 10 minutes, so you will need to wait a while for data to appear in the service.
  5. From a web browser logon to your IBM Bluemix account, navigate to the Product Insights service which you created and select the Manage section.
  6. In the dashboard, select the IBM Integration Bus.
  7. If you registered your server in a group then your integration node will be dispayed as a member of that group, which you should expand now.
  8. Select your integration node in the left column and in the center column select your integration server. The right column will show the usage data for the selected integration server.
  9. You can select the Usage section and the chart can be used to show one of three measurements. CPU time shows the CPU usage time by the selected server (in milli-seconds). Number of active CPUs shows the number of active CPUs available for use. Resident set size shows the maximum recorded memory usage.

This tutorial has shown how to register and monitor the usage of IBM Integration Bus with the Product Insights service in Bluemix.