An indicator is a card that you can add to an analysis view to display a summary statistic, such as the current number of critical alerts for a particular collection. Indicators can be configured to include icons to help provide visual context. To add an indicator to an analysis view, complete the following steps:
- Access edit mode for the analysis view to which you want to add an indicator.
- Click Add element > Indicator.
The Select dataview dialog box appears with a list of dataviews.
- Click Create dataview or proceed to step 9 to use an existing dataview.
The Create dataview dialog box appears.
- Provide a name for the dataview in the Name text box.
- Optionally, provide a description for the dataview in the Description text box.
- Use the expression builder to choose the type of data that you want to display in the indicator.
For example, to build an expression that contains the number of open critical alerts for all components, do the following:
- Click Resource and choose Alerts.
- Next to Alerts, click Where.
The where clause appears under Alerts.
- Click the Select a field drop-down arrow and choose Status.
- Leave the operator set to is.
- Click the Select drop-down arrow and choose Critical.
Tip:
To provide a custom value, click Source type: Choose value and click Enter value.
- Under Alerts, click Rule.
The clause appears under Alerts.
- Click the Select a field drop-down arrow and choose Closed at.
- Click the operator drop-down arrow and choose never.
- Optionally, click Test to test the expression.
Data that matches the expression appears on the tabs next to the expression.
- Click Create dataview.
The dataview appears in the Dataviews list and is automatically selected.
Tip:
To duplicate a dataview and use it as a template for similar types of data, click More options and click Duplicate . To edit a dataview, click More options and click Edit . To delete a dataview, click More options and click Delete .
- Choose an expression from the list and click Select.
The Indicator dialog box appears.
- Optionally, click Filter to create a query to filter the data returned by the dataview.
- Click the Statistic type drop-down arrow and choose the type of statistic that you want to show.
For example, to show the total number of items returned by the expression, choose Count.
Tip:
Click the tabs under the indicator's preview to view the data returned by the data expression.
- Click the Statistic field drop-down arrow and choose the field that contains the data that you want to evaluate using the chosen Statistic type setting.
For example, to show a count of the total number of items returned by the data expression, choose ID.
- Optionally, click Date filter and choose a date field from the Date filter field drop-down menu to allow the chart to be filtered by the analysis view's time range options.
Note:
If the field you chose for Statistic field is a datetime field, date filtering is automatically enabled.
Tip:
To turn off date filtering, click Remove .
- Click Indicator on the side of the dialog box.
The Indicator tab appears.
- Choose the type of the statistic you want to show next to Value format.
The indicator preview is updated to match the chosen indicator options.
- Optionally, provide a prefix for the value in the Prefix text box.
- Optionally, provide a suffix for the value in the Suffix text box.
- Optionally, turn on the Symbology toggle button to add a symbol to the indicator.
- Choose where you want the icon to be positioned next to Icon position.
- Choose an icon for the indicator.
- Click General on the side of the dialog box.
The General tab appears.
- Optionally, provide a title for the indicator in the Title text box.
- Optionally, provide a description for the indicator in the Description text box.
- Click Done.
The indicator appears in the analysis view.
- Hover over the indicator and use the buttons to perform the following actions:
- Drag Move to move the indicator to a new location in the analysis view.
- Click Configure to edit the indicator.
- Click Duplicate to duplicate the indicator.
- Click Delete to delete the indicator.
- Drag Resize to change the size of the indicator.
- When you're finished adding elements to the analysis view, click Save.
Tip:
You can also click the Save drop-down arrow and click Save as to save the analysis view with a new name and description.