IT Operations Management (ITOM)
cancel
Showing results for 
Search instead for 
Did you mean: 

Business Value Dashboard: Data integration (Part 2)

Business Value Dashboard: Data integration (Part 2)

HaraldPfaender

Business Value Dashboard helps you to visualize complex data in an easy and fast way. It is part of HPE’s Operations Bridge Suite and already includes out-of-the-box integrations with other HPE products. In this blog post, I will show you how to connect the Operations Manager i Performance Dashboard and the BSM Connector Framework with BVD.

The BSM Connector Framework is a component from Operations Manager I, which enables you to integrate data from other enterprise management systems. This could be products from the HPE portfolio (e.g. Network Node Manager) or from 3rd party systems.

This blog is the third series of three blog posts: 

 Performance Dashboard integration:

The Operations Manager i (OMi) Performance Dashboard component allows you to visualize any kind of performance metrics and create an operator dashboard. These performance metrics are collected either from the Operations Agent (e.g. CPU utilization or Memory Utilization) or from agent-less sources (e.g. Sitescope). In addition, metrics can be retrieved from the Application Performance Management (APM/BSM) system. So there is lots of data available that’s just waiting to be displayed on a dashboard. Now the BVD integration allows you to forward all of these data in just two steps:

  • Configure the connection to BVD
  • Enable data forwarding for metrics

Configure the connection to BVD

The Performance dashboard connection to BVD requires a configuration file that contains the connection details in JSON format. This includes information about your BVD system url, API Key and proxy information. Probably you remember this file from my previous blog posts. The file name must be bvdconf.json and has to to be put on the Gateway Server.

Start by copying the configuration file to the Performance Dashboard location. It requires that you have download and copied the OMi integration from BVD (as mentioned in the previous blog post):

# mkdir /var/opt/OV/shared/server/conf/opr/
# cp /opt/HP/BSM/opr/examples/bvd/bvdconf-sample.json /var/opt/OV/shared/server/conf/opr/bvdconf.json

Edit the bvdconf.json and add an entry like this:
   "name": "bvd_forward",
   "url": "http://<bvdsystem>:<port>/api/submit/<apikey>",
   "tags": "",
   "proxyHost": "",
   "proxyPort": "0",
   "proxyUser": "",
   "proxyPassword": ""

The name attribute bvd_forward is the Endpoint name that we need later on when enabling forwarding. For the url attribute in the second line please replace <bvdsystem> and the <apikey> according to your installation. If you are using a secure connection, do not forget to change http to https. In case your network requires a proxy, also change the network settings accordingly.

Next we need to enable data forwarding for the Performance Dashboard. Therefore, go into Administration -> Setup and Maintenance -> Infrastructure Settings and add the Endpoint Name to the Performance Dashboard section:

bvd_c1.png

And do not forget to enable data forwarding:

bvd_c2.png

This enables the Performance Dashboard in OMi to connect with BVD. You are done with the first step.

Enable data forwarding for specific metrics:

Forwarding specific metrics from Performance Dashboard to BVD is controlled via Charts. In Omi, go to the Performance Perspective and create one Chart or use an existing one. Ensure it is saved as your favorite. Do this by clicking on the chart title and save/add it as your favorite:

bvd_c3.png

bvd_c4.png

Afterwards you will find this chart under your favorites.

bvd_c5.png

From here you can enable data forwarding to BVD by clicking on the arrow button (do not forget to click on Save).

bvd_c6.png

Now the OMi Performance Perspective starts to send data to BVD. You should be able to see a new Data Channel in BVD. BVD -> Administration -> Manage Dashboards: Click on Data Channel

bvd_c7.png

Now you are done and you can start embedding the data into your dashboard.

Hint: The Performance Dashboard creates the following Data Channel metricName<>instanceName<>dSName<>systemName<>className

Troubleshooting

In case you do not see the Data Channel created in BVD, please verify the following:

  • Ensure the bvdconf.json has the correct syntax, network settings and is at the correct location
  • In case you are using https as receiver url ensure you have exported the BVD certificate and imported it into OMi
  • Review the logfile from OMi Performance Dashboard and watch for any errors:
    /opt/HP/BSM/log/pmi/bvd.log

BSM Connector Framework integration

Data forwarding in BSMC is configured using a policy of type Data Forwarding. In this policy, you define the BVD server to forward data to and the data which should be forwarded. In the BSMC click on New -> Forwarding -> Data Forwarding

bvd_c8.png

Target Tab:

Here you need to define the receiver url of the BVD system. This is the setting taken from my system:

bvd_url_bsmc.png

It is important to specific the correct url (do not forget to use http or https and also the port of the listener). The dims depend on the data. I am sending metric data which contain a relatedCi and a metricClass, therefore I am using these as parameters. In addition I am using bsmc and cat05 as tags (static parameters to identify the data source and the name of BSMC system). This ensures I will find the Data Channel easily in BVD.

Hint: In case you are using SSL import the BVD certificate into BSMC. Therefore download the BVD certificate and import it into BSMC:
ovcert –importtrusted –file <certificate_file>

Metric Tab:

This defines what kind of metrics you want to forward. I am forwarding all metrics from the "RapidData" Data Domain, which I have added as a condition.

bvd_c9.png

Hint: The Data Domain can be listed on the BSMC system:
# ovcodautil -showds

NumDataSources = 3
SCOPE
CODA
RapidData

SCOPE and CODA are internal datasource which are not forwarded.

Please do not forget to select the forwarding target in the Targets Tab:

bvd_c10.png

Hint: For this blog I have configured the BSMC Connector (BSMC) to write sample metrics to the data store using a demo generator. The demo generator for BSMC is a free to use tool for download. It can be found in the HP Live Network: https://hpln.hpe.com/contentoffering/rapid-demo-generator-bsm-connector

When you are done, click on Save and BSMC will immediately start forwarding your data to BVD. To see the Data Channel in BVD go to BVD -> Administration -> Manage Dashboards: Click on Data Channel:

bvd_c11.png

Troubleshooting

Did things go wrong? Do not worry; here is a list of troubleshooting hints:

  • Verify the Data Forwarding policy has the correct connection settings (url, port, http/https), that forwarding is selected and the policy is enabled
  • In case you are using SSL/https ensure you can contact the BVD receiver:
    bbcutil -ping https://<bvdreceiver>:12225
    eServiceError means bbcutil can connect. eNoRouteToHost or eSSLError means either the port is wrong or you have not imported the BVD certificate into BSMC. You can import the certificate using the following command:
    ovcert –importtrusted –file <certificate_file>
  • Verify the BSMC log file for error messages:
    /var/opt/OV/log/System.txt

Summary:

BVD provides a lot of out-of-the-box integration with HPE products that will make your life much easier. Both Performance Dashboard integration and BSM Connector Framework, which I have explained in this blog, provide powerful methods to forward metrics data and external data to your dashboard. Together with the data integration possibilities from my previous blog, you have a lot of data sources waiting to be placed on your dashboard. Therefore, I hope you are motivated to test it on your own. So if you have not done it already, start today, download and install BVD and become your own dashboard designer!

Download it now:

http://hp.com/go/omi (click on download and select the BVD 10.10 package)

What do you think about BVD? Please share your thoughts and comments.

 

  • operations bridge
About the Author

HaraldPfaender

//Add this to "OnDomLoad" event