Create

The Create report page displays the following options in the upper-right corner.

Perform the steps below to create a Device Groups report variable.

1. In the Name field, provide a name for the report variable. Leave the field as-is to use the default name.
2. Enable Multiple selection to allow one or more device groups to be selected at a time when applying this report variable. When disabled, only one device group from the list can be selected when applying this report variable. When a device group is selected, by default, it selects all devices that belong to it.
   Important: Please refer to Multiple selection example for details on its functionality and usage.
3. Enable Clear selection to remove all selected device groups by clicking . When disabled, you can remove the selected device groups one at a time by clicking . When Multiple selection is disabled, you are in single selection mode and only one device group can be selected. Click to remove the selected device group.
4. Enable Select all to select all device groups and newly added device groups (if any). If enabled, you cannot deselect the device group(s).
5. Click Datasource drop-down and select a data source for the report variable.
6. Select the Resource Type from the drop-down. This option is available only when Select all is disabled.
   1. Device group
      • Select one or more device groups from the drop-down list and it will select all devices that belong to it.
7. Click Add to save the report variable.

Perform the steps below to create a Device Metadata report variable.

1. In the Name field, provide a name for the report variable. Leave the field as-is to use the default name.
2. Enable Clear selection to remove all selected device metadata by clicking . When disabled, you can remove the selected device metadata one at a time by clicking .
3. Click Datasource drop-down and select a data source for the report variable.
4. Select a Namespace from the drop-down list. For example, SevOne.
5. The Attribute field is available only after a namespace is chosen. The drop-down list contains attributes for the chosen namespace. Choose an attribute.
6. Click Add to save the report variable.

Perform the steps below to create an Objects report variable.

1. In the Name field, provide a name for the report variable. Leave the field as-is to use the default name.

2. Enable Multiple selection to allow one or more objects to be selected at a time when applying this report variable. When disabled, only one object from the list can be selected when applying this report variable.

   Important: Please refer to Multiple selection example for details on its functionality and usage.

3. Enable Clear selection to remove all selected objects by clicking . When disabled, you can remove the selected objects one at a time by clicking . When Multiple selection is disabled, you are in single selection mode and only one object can be selected. Click to remove the selected object.

4. Enable Select all to select all objects and newly added objects (if any). If enabled, you cannot deselect the object(s).
5. Click Datasource drop-down and select a data source for the report variable.
6. Select the Resource Type from the drop-down. This option is available only when Select all is disabled.
   • Select one or more object types from the drop-down list. If object types are not selected, by default, all object types get selected.
     Note: As a result, all objects belonging to the selected object types get selected. To select some and not all objects belonging to the selected object types, please configure the objects under (Optional) Resource Type (Object) option to select one or more objects.
   • Device
     • Select one or more devices from the drop-down list. If devices are not selected, by default, all devices get selected.
       Note: As a result, all objects belonging to the selected object types get selected. To select some and not all objects belonging to the selected object types, please configure the objects under (Optional) Resource Type (Object) option to select one or more objects.
       Resource Type, Object, allows you to search on object description, device display name, and plugin.ObjectName. You must enter a string in double-quotes. Search can also be performed on a word. You may enter one or more strings/words in Resource Type > Object.
       Example# 1
       

       If you enter "IP of device" echo CPU196640, these are 3 key terms to search on. All objects containing IP of device, echo, and CPU196640 will be available to choose from.

       
       

       IP of device is in double-quotes as the search is on all words with space in between. A string can have one or more spaces in it.

       
       Example# 2
       

       If you enter IP of device echo CPU196640, these are 5 key terms to search on. All objects containing IP, of, device, echo, and CPU196640 will be available to choose from.

       
       Example# 3
       

       If you enter CPU, all objects containing CPU will be available to choose from. It can return objects such as CPU196640, CPU196632, etc.

   • Device group
     • Select one or more device groups from the drop-down list. If device groups are not selected, by default, all device groups get selected.
       Note: As a result, all objects belonging to the selected device groups get selected. To select some and not all objects belonging to the selected device groups, please configure the objects under (Optional) Resource Type (Device, Device group, Object group, Object Type) options to select one or more objects.
   • Object group
     • Select one or more object groups from the drop-down list. If object groups are not selected, by default, all object groups get selected.
       Note: As a result, all objects belonging to the selected object groups get selected. To select some and not all objects belonging to the selected object groups, please configure the objects under (Optional) Resource Type (Object, Object Type) options to select one or more objects.
   • Object Type

Perform the steps below to create a Object Groups report variable.

1. In the Name field, provide a name for the report variable. Leave the field as-is to use the default name.
2. Enable Multiple selection to allow one or more object groups to be selected at a time when applying this report variable. When disabled, only one object group from the list can be selected when applying this report variable. When a object group is selected, by default, it selects all objects that belong to it.
   Important: Please refer to Multiple selection example for details on its functionality and usage.
3. Enable Clear selection to remove all selected object groups by clicking . When disabled, you can remove the selected object groups one at a time by clicking . When Multiple selection is disabled, you are in single selection mode and only one object group can be selected. Click to remove the selected object group.
4. Enable Select all to select all object groups and newly added object groups (if any). If enabled, you cannot deselect the objects group(s).
5. Click Datasource drop-down and select a data source for the report variable.
6. Select the Resource Type from the drop-down. This option is available only when Select all is disabled.
   • Object group
     • Select one or more object groups from the drop-down list and it will select all objects that belong to it.
7. Click Add to save the report variable.

Perform the steps below to create a Object Metadata report variable.

1. In the Name field, provide a name for the report variable. Leave the field as-is to use the default name.
2. Enable Clear selection to remove the selected object metadata for the Attribute selected by clicking . Multiple selection is not allowed.
3. Click Datasource drop-down and select a data source for the report variable.
4. Select a Namespace from the drop-down list.
5. The Attribute field is available only after a namespace is chosen. The drop-down list contains attributes for the chosen namespace. Choose an attribute.
6. Click Add to save the report variable.

1. In the Name field, provide a name for the report variable. Leave the field as-is to use the default name.
2. Enable Multiple selection to allow one or more devices or device groups to be selected at a time when applying this report variable. When disabled, only one device or device group from the list can be selected when applying this report variable.
   Important: Please refer to Multiple selection example for details on its functionality and usage.
3. Enable Clear selection to remove all selected indicators by clicking . When disabled, you can remove the selected indicators one at a time by clicking . When Multiple selection is disabled, you are in single selection mode and only one indicator can be selected. Click to remove the selected indicator.
4. Enable Select all to select all devices and newly added devices (if any). If enabled, you cannot deselect device(s).
5. Click Datasource drop-down and select a data source for the report variable.
6. Select the Resource Type from the drop-down. This option is available only when Select all is disabled.
   • Device
     • Select one or more devices from the drop-down list. If devices are not selected, by default, all devices get selected.
   • Device group
     • Select one or more device groups from the drop-down list. If device groups are not selected, by default, all device groups get selected.
       Note: As a result, all devices belonging to the selected device groups get selected. To select some and not all devices belonging to the selected device groups, please configure the devices under (Optional) Resource Type (Device) option to select one or more devices.
7. Click Add to save the report variable.
   Note: After adding the report variable, you may select the devices, objects, and its indicators to apply on the report.
   Example
   

1. In the Name field, provide a name for the report variable. Leave the field as-is to use the default name.
2. Enable Multiple selection to allow one or more flow interfaces to be selected at a time when applying this report variable. When disabled, only one flow interface from the list can be selected when applying this report variable. When a flow interface is selected, by default, it selects all sources that belong to it.
   Important: Please refer to Multiple selection example for details on its functionality and usage.
3. Enable Clear selection to remove all selected flow interfaces by clicking . When disabled, you can remove the selected flow interfaces one at a time by clicking . When Multiple selection is disabled, you are in single selection mode and only one flow interface can be selected. Click to remove the selected flow interface.
4. Enable Select all to select all flow interfaces and newly added flow interfaces (if any). If enabled, you cannot deselect the flow source(s).
5. Click Datasource drop-down and select a data source for the report variable.
6. Select the Resource Type from the drop-down. This option is available only when Select all is disabled.
   • Flow Source
     • Select one or more flow sources from the drop-down list. If flow sources are not selected, by default, all flow sources/interfaces get selected.
   
   
   Important: Resource Type, Flow Source, allows you to search on flow version, name, and IP address. You must enter a string in double-quotes. Search can also be performed on a word. You may enter one or more strings/words in Resource Type > Flow Source.
   Example# 1
   If you enter "NBARDevice 1" dp-flow, these are 2 key terms to search on. All flow sources containing NBARDevice 1 and dp-flow will be available to choose from.
   NBARDevice 1 is in double-quotes as the search is on all words with space in between. A string can have one or more spaces in it.
   Example# 2
   If you enter NBARDevice 1 dp-flow, these are 3 key terms to search on. All flow sources containing NBARDevice, 1, and dp-flow will be available to choose from.
   Example# 3
   If you enter flow, all flow sources containing flow will be available to choose from. It can return flow sources such as dp-flow, flow2, etc.
7. Click Add to save the report variable.

1. In the Name field, provide a name for the report variable. Leave the field as-is to use the default name.
2. Enable Clear selection to remove the selected flow view by clicking . Multiple selection is not allowed.
3. Enable Select all to select all flow views and newly added flow views (if any). If enabled, you cannot deselect the flow views(s).
4. To use the aggregated data points, Aggregated data must be enabled.
5. Click Datasource drop-down and select a data source for the report variable.
6. Select one or more Flow Views from the drop-down list. If flow views are not selected, by default, all flow views get selected.
7. Click Add to save the report variable.

Perform the steps below to create a Flow Directions report variable.

1. In the Name field, provide a name for the report variable. Leave the field as-is to use the default name.
2. Click Add to save the report variable.
   Note: After adding the report variable, you may select flow directions (All Directions, Incoming, or Outgoing) to apply on the report.
   Example
   

Perform the steps below to create Flow App Profiles report variable.

1. In the Name field, provide a name for the report variable. Leave the field as-is to use the default name.
2. Click Datasources drop-down to choose a list from the list of datasources available.
3. Click Add to save the report variable.
   Note: After adding the report variable, you may select one or more flow app profiles to apply on the report.
   Example
   

Perform the steps below to create a TopN Views report variable.

1. In the Name field, provide a name for the report variable. Leave the field as-is to use the default name.
2. Enable Clear selection to remove the selected TopN view by clicking . Multiple selection is not allowed.
3. Enable Select all to select all TopN views and newly added TopN views (if any). If enabled, you cannot deselect the TopN views(s).
4. Click Datasource drop-down and select a data source for the report variable.
5. Select one or more TopN Views from the drop-down list. If TopN views are not selected, by default, all TopN Views get selected. Or, you may populate TopN Views variable via Regex. Can select one or more TopN Views from any views matched by the Regex.
6. Click Add to save the report variable.

Click in to select the time based on which the widgets in the report will refresh.

Click in to select the time based on which the widgets in the report will rotate.

Click to add a widget to the report. For details on how to add/create a particular widget, please refer to section Widgets.

Click to save the report. If you are trying to save a new report, you will see the following pop-up.

• Report Name - enter a unique name for the report. If the report name already exists, you will get an error message that the name already exists.
• Description - enter a description for the report. This field is optional.
• User Access - choose an option from the drop-down list. Options are Private, Public, Restricted, Multi-tenant, or Multi-team. Based on the option chosen, access is provided accordingly.
• Read Only - select the check box to make the report read-only.
• Mark as template - select the check box to mark the report as a template.
  Note: Report templates do not contain any specific resources. Instead, they inherit resources from the parent in a Report Linking relationship. Report templates must have at least one device or object filter. Saving a report as a template will place the report in the All Templates folder.
• Click Save to save the report. Otherwise, click Cancel.
• After saving the report, if you want to make any updates, click to edit the report. After making the updates, click drop-down and you will get options Save, Save as, or PDF.
  • Save - saves the report with the same name given to the report that has been updated.
  • Save as - you will get the following pop-up.
    
    • Report title - give your report a recognizable title / unique report name.
    • Annotate changes below - annotate the changes for future reference.
    • Mark as template - select the check box to mark the report as a template.
      Note: Report templates do not contain any specific resources. Instead, they inherit resources from the parent in a Report Linking relationship. Report templates must have at least one device or object filter. Saving a report as a template will place the report in the All Templates folder.
    • Click Save to save the report. Otherwise, click to Cancel.
  • PDF - allows you to print the report in Landscape or Portrait format.

Note: is only available when variable reportVersionsEnabled is set to true in /opt/SevOne/chartconfs/di_custom.yaml file.

• When a report is updated, you can view the historical record of the changes by clicking .

Delete option is only available after the report has been saved or if you are on a report that has already been created. Click to delete the report you are on. If you click Yes, delete report in the Warning pop-up, the report will get deleted. This action cannot be undone.

Click to enter in View mode. This will allow you to only view the report. Click to enter in Edit mode.

Perform the following steps to start creating a report or a report template. In the left navigation bar, click Create or click Add widget in the upper-right corner to access the list of widget types.

1. On the panel Select a Widget, select one of the following widgets. You can add multiple widgets to a single report section. Please click on the links below to view configuration steps for each available widget.
   Note: Adding more than twenty widgets to a report section can cause performance problems.

   Widget Name	Description
   Alert Details Widget	Provides information regarding alert severity, occurrences with time, and message output.
   Alert Summary Widget	Provides summary of alerts by severity or resource, aggregated by number of alerts or occurrences.
   Flow Widget	Can view, analyze, and interact with flow data such as NetFlow, sFlow, JFlow, IPFIX, and more.
   Group Metrics Widget	Aggregates statistics by device or object group to see a group's average, min, max or total values.
   IPSLA Heatmap Matrix Widget	Can configure and view heatmaps based on IPSLA performance data with various aggregations.
   Logs Widget	Incorporates data from log sources into reports.
   Maps Widget	Can leverage geospatial or custom image backgrounds to display network layout with alert status.
   Metadata Widget	Provides sortable table view of custom data attributes derived from metadata sortable with alert status.
   Performance Metrics Widget	Can view, analyze, and interact with time series data leveraging various chart visualizations.
   Text Widget	Can explain and document reports with formatted text and images.
   TopN Widget	Can quickly identify the highest or lowest performing metrics across a set of resources.
   Topology Widget	Can visualize device physical connections and logical relationships derived from various protocols.
   URL Widget	Embeds external web sites and content into your SevOne Data Insight reports as widgets. For example, IBM SevOne Network Performance Management webpage from https://www.ibm.com/products/sevone-network-performance-management into SevOne Data Insight.

2. Click Save to save the widget to your report.
3. In the upper-left corner of the page, click the Untitled Report text field and replace the existing text with your report name.
4. On the tab below that, click the Untitled Section text field and enter a name for the report section.
5. To add a new report section, click .
6. To remove a report section, hover over the section name and click x.
7. Report sections appear from left to right in the order that you create them. To change the order of report sections, click on the left side of a report section and drag it to the desired location.

When creating or editing a widget, you need to select your Datasource and Resource Type(s).

1. Select a widget from the list. You are now in Widget Settings.
2. On the Data tab, click the Datasource drop-down and select the SevOne NMS cluster or appliance.
3. Click the Resource Type drop-down to select a resource type as a starting point for the different resource type paths.
   Example
   
   Note: After generating a report Replace Untitled Report name with an appropriate report name. For example, Alert Details Report.
   
   Replace Untitled Section name with an appropriate name. For example, Alert Details.
   Important: The following widgets support Resource Type, Shortcut, which allows you to save resource selection as shortcuts to be reused across widgets in SevOne Data Insight without having to create groups in SevOne NMS.
   

   • Alert Details
   • Alert Summary
   • Flow
   • Group Metrics
   • Metadata
   • Performance Metrics
   • TopN
   Important: Run button is available only when a Datasource and Resource Type(s) are selected.
   
   For additional widget configuration, please refer to the widget directly.

The resource type selector allows you to create dynamic and powerful data queries to view data quickly and in a more flexible manner. The resource type path designs are described below. To ensure better user experience, it is recommended to always use a Device Group selection to narrow the device list.

The icons below appear in widgets and perform the following actions.

ICON

Click the icon to chain the results to another widget from the drop-down list. The report title of the widget chained to will always contain the parent widget name. The report title will read as parent widget name > child widget name.

ICON

Click to duplicate the widget.

ICON

Click to view widget results in maximized screen mode. Click to restore to its original size.

ICON

Click to refresh the widget.

ICON

Click to refresh the widget.

ICON

Click to export data to a CSV and/or JSON file.

ICON

Click to edit the widget settings.

ICON

Click to remove the widget from the report.

To change the size of widget pop-up, click in the lower-right corner of the widget pop-up and move inward to make the widget smaller or outward to make the widget larger.