Alert list custom widget

The installation and integration of IBM Cognos® Analytics is available only for technology preview, and is not for production usage.  The installation and integration of IBM Cognos® Analytics is available only for technology preview, and is not for production usage.

The Cloud Pak for AIOps Alert list custom widget can use data selection events from IBM Cognos Analytics visualizations. For example, a bar chart visualization represents severity data. If a high severity bar is selected in the visualization, the Alert list custom widget corresponds and shows high severity alerts only. The assumption is that the related data source column and Alerts property names are matched. Configure the column mapping if that is not the case.

Procedure

  1. Download the IBM Cloud Pak for AIOps widgets and other artifacts that are needed from: github.com: aiops-cognos-analytics/widgets.

  2. Create a zipped file out of the entire widgets folder.

    On macOS: right-click the widgets folder and select Compress "widgets".

    On Windows: right-click the widgets folder and select Send to > Compressed (zipped) folder.

  3. Log in to IBM Cognos Analytics. The base URL is https://<CLUSTER_NAME>/cognosanalytics/aiops/bi/?perspective=home.

  4. From the main navigation menu, click Manage > Customization > Extension.

    Click the Upload extension icon Upload extension icon and navigate to your compressed file.

    The Cloud Pak for AIOps Alert list custom widget is now available to use in new dashboards.

  5. From the main navigation menu, click New > Dashboard > Create.

  6. Click Custom widgets Custom widgets.

  7. Select the AIOps Alert list and drag it onto the canvas.

  8. Click Properties to configure the Cloud Pak for AIOps Alert list in the properties side panel:

    • Filter: Sets the default Filter.

    • View: Sets the default View.

    • Show toolbar: Enables or disables the Alert list toolbar.

    • Show details: Enables or disables the Alert list details side panel.

    • Column mapping: Allows mapping of IBM Cognos Analytics data source columns to Alert properties. The mapping is defined through JSON format, for example:

      {"SEVERITY": "severity"}

      The value on the left represents the IBM Cognos Analytics data source column. The value on the right represents the Alert properties.

      Note: Identifier strings for data source columns in IBM Cognos Analytics cannot consist entirely of a reserved keyword. Therefore, some identifiers are appended with an underscore ("_") which must be added to the column name for mapping to work. For example, the mapping of the STATE column would be as shown:

      {"STATE_":"state"}