SevOne NMS to SevOne Data Insight Drillback URL Configuration Tutorial

As of SevOne Data Insight 3.14, flag FF_UI_REDIRECT has been added to provide the capability to redirect the user interface using the redirect option in the URL.

With the new URL redirector API (i.e., flag FF_UI_REDIRECT), you can easily create, view, and understand webhook drillback URLs. By default, this flag is set to false. In order to use the FF_UI_REDIRECT flag, you must set it to true.

1. SSH into your SevOne Data Insight machine and log in as sevone and at the Password prompt, enter sevone.

   $ ssh sevone@<virtual machine IP address or hostname>

2. Using a text editor of your choice, edit /opt/SevOne/chartconfs/di_custom.yaml file to set flag, FF_UI_REDIRECT, and then, save it.
   If /opt/SevOne/chartconfs/di_custom.yaml file does not exist, please create one and add the following to it.

   ui:
     env:
       FF_UI_REDIRECT: true

3. Apply the change made to /opt/SevOne/chartconfs/di_custom.yaml file.

   $ sevone-cli playbook up --tags apps

Before configuring a webhook containing drillback URL, a SevOne Data Insight report must exist; this will be the destination for the drillback and ideally, this report will be shared with all the users. This will ensure that all users who will click the link in the webhook, will be able to access the desired report.

The webhook URL sends the resources to the report. These resources are intended to provide context from the generating alert to the report to place a user, in context, within the report. It is highly recommended that the chosen report has variables configured for the report to accept these resources. From SevOne Data Insight, a report can be prepared for the resources that will be passed from the webhook URL. Using a web browser of your choice, enter your SevOne Data Insight IP address or hostname of the machine to which you want to add the report variables. Please refer to SevOne Data Insight User Guide > section Create > Report Options > Variables for details.

Example

Any SevOne NMS sending out webhooks containing drillback URLs must already be configured as a datasource on an instance of SevOne Data Insight. Administrators creating Webhook Definitions must already know the IP address / hostname or the URL of SevOne Data Insight instance and the names of any SevOne Data Insight reports which will be referenced in the drillback URL.

This feature is designed such that SevOne NMS clusters must have the same name as their SevOne Data Insight datasource name in multi-datasource use-cases.

To create a webhook definition, please refer to SevOne NMS User Guide > section Webhook Definition Manager > subsection Add Webhook Definition for details. In addition to this, you will also find details on how to configure Slack channel.

SevOne Data Insight drillback URLs are configured inside Webhook Definitions as part of the message body. Administrators can build their own definitions or reference the starter template for Slack message.

To create a SevOne Data Insight drillback URL inside Webhook Definition, the following is required.

1. address of SevOne Data Insight instance which the URL will reference
2. name of SevOne Data Insight report the user will be navigated to
3. resources that will be referenced from the alert dynamically as variable $DIDataResources. This variable contains alert-specific information about the threshold violating the following.
   1. Datasource / Cluster Name
   2. Plugin Name
   3. Object Types
   4. Device Name
   5. Object Name(s)
   6. Indicator Type(s)
   7. Relative Timespan

Once you have created a valid SevOne Data Insight drillback URL, it will send the webhook's parameters to the Data Insight instance running at localhost. When this instance of Data Insight receives the URL, it will open Alert Details Report and automatically fill out the variables with the values provided by the webhook.