IT Operations Management (ITOM)
Showing results for 
Search instead for 
Do you mean 

Business Value Dashboard: Data integration (part 1)

HaraldPfaender ‎02-22-2016 01:08 AM - edited ‎02-22-2016 02:02 PM

The Business Values Dashboard is a brand new product release part of the IT Operations Bridge. It helps you to visualize complex data and displays the status of your IT at a glance. Creating your own dashboard is simple and easy which lets your IT shine in a new light.



In my last blog, I wrote about the basics of Business Value Dashboard (BVD), how to install it and how to get started: Business-Value-Dashboard-Get-started-now

Now it’s time for more details regarding the integration capabilities of BVD. In this blog, I will explain how to connect your Operations Manager i (OMi) Events and KPI (Key Performance Indicators) with BVD. This will enable you to see Event and KPI data on any BVD Dashboard.

Let's get started!

Time to start with the data integration. First of all, sending data to BVD is really simple. BVD has an API which accepts data in JavaScript Object Notation (JSON). All data you send to BVD is grouped in so-called Data Channels. These Data Channels make it easy to find your data and connect it to the widgets on the Dashboard. This likely requires you to do some data conversion, but with this format, BVD is very flexible with getting connected to any kind of system or product.

Hint: If you want to learn more about the JSON format, you can find a very detailed explanation in the BVD help section. Just search for: Sending JSON Data to BVD.

For OMi, this data conversion is pretty easy since there are already two scripts available:

  • Event integration for Operations Manager i (OMi)
  • KPI integration for OMi

Please download the Event and KPI integration scripts from BVD: Administration -> Download Tools and Samples -> OMi 10.x Tools

Hint: There are also tools available which can be used with OMi 9.x: Administration -> Download Tools and Samples -> OMi 09.x Tools

I recommend you unzip the OMi 10.x Tools into your OMi <OMi> folder. Afterwards, you can find tools for Event and KPI integrations in the bin directory (e.g. for Linux: /opt/HP/BSM/opr/bin):

  • Event integration:
  • KPI integration:

Hint: On Linux you need to set the +x bit to make the scripts executable:
chmod 755
chmod 755

The next step is to connect the script to your BVD instance. Please do so by modifying the configuration file. You can find it here (I recommend you make a copy of the original file before you edit them): Linux: /opt/HP/BSM/opr/examples/bvd/bvdconf-sample.json Windows: <OMi>\opr\examples\bvd\bvdconf-sample.json

For now it is sufficient to edit the values for "url": "url": "<BVD_URL>/api/submit/<YourApiKey>bvd_b2.png

Replace the values for <BVD_URL> and <YourApiKey>. The API Key can be found in BVD -> Administration -> System Settings. The <BVD_URL> is the receiver url which you configured during the BVD configuration.

Hint: In case you are using a proxy, also change the proxy settings according to your network setup.

Event integration:

The event integration scripts forwards all OMi events which are part of an OMi Dashboard (please be careful since I am talking about the OMi Operator dashboard now).

The OMi Operator Dashboard names can found in OMi: Administration -> Operations Console -> Monitoring Dashboards:

If you have not created one, it is time to do so. For a test, you can also reuse one of the example dashboards part of OMi, e.g.: Example: Operations Manager Overview. In my case, I have created a new one called: OMi Dashboard Harald. So my script call looks like this
./ -dn "OMi Dashboard Harald" -username harald ‑password geheim
Please use the -dc /opt/HP/BSM/opr/examples/bvd/bvdconf.json parameter in case you get the following error:
ERROR: The environment variable "OvDataDir" cannot be read.

When the script is running you will see an INFO: message that your data is sent to BVD.
INFO: Sending data

To see which data is sent to BVD, you can use the ‑verbose switch. This will display what kind of data the script is exporting from OMi. In addition, you can see the JSON generated format:

       "omiSystem": "",
       "type": "STACK",
       "label": "Unresolved > 3 hours",
       "mdb": "OMi Dashboard Harald",
       "filterName": "Unresolved for more than 3 hours",
       "@type": "severityWidgetStatus_type",
       "filterStatus": "FILTER_OK",
       "id": "daa043b5-f0bd-4ccc-8e77-cfecf1d7763f",
       "mostCritical": "CRITICAL",
       "numberOfCritical": 24,
       "numberOfMajor": 4,
       "numberOfMinor": 9,
       "numberOfNormal": 344,
       "numberOfUnknown": 2,
       "numberOfWarning": 27

About the Author


June 6 - 8, 2017
Las Vegas, Nevada
Discover 2017 Las Vegas
Join us for HPE Discover 2017 in Las Vegas. The event will be held at the Venetian | Palazzo from June 6-8, 2017.
Read more
Apr 18, 2017
Houston, TX
HPE Tech Days - 2017
Follow a group of tech bloggers for a new HPE Tech Day, a full day of sessions about how to create a hybrid IT, from hyperconverged to Composable Infr...
Read more
View all
//Add this to "OnDomLoad" event