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 third-party systems.
This blog is the third series of three blog posts:
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):
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:
And do not forget to enable data forwarding:
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:
Afterwards you will find this chart under your favorites.
From here you can enable data forwarding to BVD by clicking on the arrow button (do not forget to click on Save).
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
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
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
Here you need to define the receiver url of the BVD system. This is the setting taken from my system:
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>
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.
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:
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:
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
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!