From the main menu, choose Health Insights > Manage KPI Profiles. The Manage KPI Profiles window opens.

Click the . The Create New Profile window opens.

In the text fields provided, enter a unique Profile Name, a short Description. The Profile Name can contain a maximum of 32 alphanumeric characters, plus underscores ("_"). No other special characters are allowed.

Add KPI to the profile, using the following filter options:

1. All KPIs: By default, this option is selected and the list of all KPIs are displayed in the list. You can select the required KPI by checking the relevant checkbox.

2. Recommended KPIs: You may also select KPIs based on the KPI recommendation for a specific device. Click Recommended KPIs and the device list is displayed. You may filter the device list by entering relevant values in the Name and State fields, or filter by tags. using tags. Select a device from the list and the recommended KPI list is displayed on the right side. Select the required KPI by checking the relevant checkbox.

   Note	Selecting KPIs from the recommended KPI list of a selected device does not automatically enable the KPI Profile in the selected device. The KPI Profile can be enabled after it is created. For more information, see Enable KPI Profile on Devices

Click Save save the new KPI Profile and display the Manage KPI Profiles window.

In the KPI Profiles area on the left side, choose the KPI Profile that you created, and the individual KPI details are displayed on the right side.

You can leave the KPI parameters at the default or choose a different value. To edit the KPI parameters, click Edit Details, and the KPI Details window is displayed. Edit the parameter values as appropriate for the purpose of your KPI. The common parameters are:

• Alert: This is an on/off toggle switch for alerting. Based on the Alert parameter value, the corresponding alerting logic is deployed. Alerting can be enabled even after the KPI Profile has been applied to the devices.

  Note	Any KPI using the composite alerting logic need to have the alerting flag set to ON.

• Cadence (sec): Set the frequency of sensor data. Set the frequency (in seconds) in which the KPI will gather sensor data from the devices on which the KPI Profile is enabled.
• Alerting Down Sample Rate: Alert frequency rate. It determines how often KPI data will be evaluated for any alert conditions, and is relative to the Cadence. For example, if Cadence is 60 seconds and you want to do an alerting evaluation every 300 sec, then specify Alerting Down Sample Rate as "5".

You can also edit the alert logic parameters of the selected KPI. To learn more about a parameter, hover your mouse cursor over the shown next to the parameter name.

When you are finished making changes, click Save to save the new KPI Profile. Health Insights validates your input parameters and displays the Manage KPI Profiles window.

(Optional) You can also create alert groups for a KPI Profile. Alert groups use boolean logic (cascaded OR and AND) to combine alert outputs from primary KPIs in your KPI profile and create a composite logic query. To create an alert group, click + Alert Group. The Create Alert Group window is displayed.

Provide a relevant entry in the Name field. Summary and Details are optional fields.

The Alert Group Conditions area on the right side lets you select a logic gate (AND/OR) and add a KPI on which the logic is applied. Your alert group can be based on the alert criteria of a single KPI, or it can be a combination of mutliple KPI outputs. Click the desired logic (AND gate is selected by default), and click the + ADD dropdown list to add an Item or a Group.

Choose the desired KPI from the Select KPI dropdown, and select the desired level(s) for which the alerts need to be set for the chosen KPI. The alert levels are CRITICAL, MAJOR, MINOR, WARNING and INFO. Based on the logic gate and alert criteria you select, the output of the KPIs are evaluated and the alert is generated.

In the example shown above, the alert is set based on the output of two logic gates. The first logic gate is the output of an OR operation between the Memory Utilization and Interface Bandwidth monitor KPIs. If the set alert levels are met for either of the KPIs, the output of the first logic gate is set as true. This output is considered as the input for the second logic gate, which is an AND operation with the CPU Utilization KPI. If the alert levels of both the KPIs are met, the output of the second logic gate is set as true.

Click Save to save the new alert group and display the Manage KPI Profiles window. Click Edit Details or to edit or delete an existing alert group respectively.

From the main menu, choose Health Insights > Enable-Disable KPI Profiles. The Enable-Disable KPI Profiles window is displayed.

Select the devices for which you want to enable KPI Profiles. You can click the Devices or Device Tags buttons above the table on the left to toggle between selecting the devices by name or by tagged device group membership. Depending on your selection, the device list or the device tag list is displayed on the left.

Click Enable KPI Profiles to continue. Health Insights detects the selected devices, their types and models, and retrieves and analyzes their running configurations. The KPI Profiles window presents the KPI Profiles available for your selected devices.

Choose the KPI Profiles you want to enable by clicking the check box next to the KPI Profile name. :

When you are finished, click Next. The Verify Details window appears, listing all the KPI Profiles you have chosen to be enabled on the selected devices, as shown in the following figure.

(Optional) To get information about the KPIs included in the KPI Profile. Click the KPI Profile in the Selected Profile(s) table, and the content of the selected KPI Profile is displayed on the right side. Click View More Details to view the parameters of a specific KPI. A popup window provides the details of the KPI. Click the to close the popup window.

To enable the selected KPI Profiles on the selected devices, click Enable. Health Insights schedules the KPI Profile(s) as a series of job sets.

From the main menu, choose Health Insights > Job History to watch the progress of each job set, as shown below. You should see job sets completing with a status of "Success". If job sets complete with a "Partial" or "Failed" status, be sure to read the job completion messages, and check that the selected devices are still reachable.

When the job sets complete successfully, the KPIs are now associated to the devices and the platform begins the process of enabling the relevant collection procedures for those network elements. In making these changes, you are automating the configuration of both the platform and the devices themselves to collect only the information required.

From the main menu, choose Health Insights > Alert Dashboard. The dashboard shows the alert status for the devices on which you have enabled KPI monitoring.

From the main menu, choose Health Insights > Alert Dashboard. The Health Insights dashboard opens.

Make sure that the Device Alerts view is displayed (select the Device Alerts toggle, if needed). Then scroll down below the Total Alerts panel and click on the All Impacted Devices tab. The dashboard displays a list of devices with alerts.

Click on the Device Name for the device whose details you want to see. Health Insights displays the device's basicOverview information, Total Alerts, a Topology map, and the list of the device's currently Enabled KPIs.

To see detailed KPI data, scroll down to the Enabled KPIs panel at the bottom of the window and click on one of the enabled KPIs in the list at left. A graphical representation of that KPIs data, along with a list of alert messages and other information, is displayed on the right.

In the example shown below, the Interface rate counters KPI was selected, so the accompanying information includes a list of the interfaces at the right of the graphic time-series data.

Item	Description
1	Click on the KPI name in the list to display its data on the right.
2	Graphical time-series data for the selected KPI appears here. In the example shown, the KPI graphic shows real-time data that has been collected on the interfaces and the points at which the sensor detected an alert event. To have the graphic display data for a single interface instead of all interfaces, click on the interface name in the list at right. To zoom in on a period within the time series graph, click and drag within the graph.
3	Hover the mouse cursor over any data point in the KPI graphic to see additional popup information for that data point. A red line or tag represents a point at which the KPI was triggered. This can occur on any subscribed statistic the KPI is monitoring. Health Insights collects and identifies the time points and frequency, which help determine when these events become an operational concern.
4	Below the KPI timeline, the alerts panel shows each KPI alert that was generated on the device. It also shows which link or interface was affected and when the alert occurred. The blue color indicates that the alert has cleared and is informational only. Red signifies a critical alert. Search for alert messages in the list below by severity, any part of the message text, the alert ID, or by time and date.
5	View additional information by clicking the Summary and Raw graph pages in the View widget.
6	Click the empty square icon to use the whole page to display the Enabled KPIs panel only. If you choose to enlarge the Enabled KPIs panel, a blue < icon appears next to the list of KPIs. Click the icon to hide the list. Click the inverted versions of these icons to restore the KPI list and return the Enabled KPIs panel to its normal size.

From the main menu, choose Health Insights > Manage KPIs. The Manage KPIs window opens.

Click the . The Create KPI window opens.

In the text fields provided, enter a unique KPI Name, a short KPI Summary description, and KPI details. The KPI Group is preset to User Created.

The Cadence field sets the number of times per minute the KPI will gather sensor data from the devices on which the KPI is enabled. Leave it at the default or use the numerical selector to choose a different value.

In the Select YANG Paths area, choose one module and one or more sensor leaf paths from which to stream data:

1. Use Filter Modules to filter and choose the desired Cisco IOS XR YANG module.

2. Use Filter Paths to filter and choose the desired sensor path. When you choose a path, the leaf node gets resolved to the base encoding path. If the YANG module is hierarchical, the field names are concatenated down from the base path. Note that only one gather path is supported for user-created KPIs.

3. Click Next to display the Select Alert Templates window.

Choose the alert template you want to use with your new KPI: No Alert, Standard Deviation, Two-Level Threshold or Rate Change. Then click Next to display the Alert Parameters window appropriate for the type of alert template you chose.

Edit the alert template parameter values as appropriate for the template and the purpose of your KPI, as follows:

• Use the Basic and Advanced Parameters dropdowns to view and edit the parameter sets you need.
• Change alert parameter numerical values using the selectors or by editing the field contents
• Change alert parameters with discrete choices using parameter field dropdowns and select each choice as needed.
• Learn more about an alert parameter: Hover your mouse cursor over the shown next to the parameter name.
• Click the View Tick Script link to view the tick script code you are generating with your changes. The tick script code updates as you make your edits. At any time, click the Hide Tick Script to close the tick script code window.

When you are finished making changes, click Finish to save the new KPI and display the Manage KPIs window.

From the main menu, choose Health Insights > Manage KPIs. The Manage KPIs window opens, displaying lists of the KPI categories and the KPIs available in each category.

Select the KPI you want to link to a Playbook. You can use filters to find the KPI you want, as explained in Manage KPIs.

Click . The Link KPI to Playbook window opens.

The left side of the window lists the name of the selected KPI and the Playbooks appropriate for linking to it. Scroll through the list, or use the Playbook Name field and the to restrict the list to just the Playbooks you want.

When you have found the Playbook you want to link, click on its name. The right side of the window will then list the Playbook Details for the selected Playbook, including:

Verify or modify the Source and parameter values as needed.

When you are finished making changes, click Link to KPI. Change Automation displays the Manage KPIs window again, this time with the linked Playbook shown next to name of the KPI in the Key Performance Indicators (KPIs) list.

To change the Playbook linked to a given KPI, repeat steps 3 through 7 for that KPI, this time choosing the Playbook you want. To unlink a Playbook entirely, select the KPI and click .

From the main menu, choose Health Insights > Job History The Job History window lists the jobs that have been run most recently, indicating whether they succeeded or failed, when they ran, and on what devices.

Click the transaction ID in the job listing to view detailed KPI job information, including the device on which the KPI was enabled and the KPI ID.

From the main menu, choose Health Insights > Enable-Disable KPI Profiles. The Enable-Disable KPI Profiles window opens.

To disable all KPI Profiles enabled on all the devices within a device group:

1. Click the Device Tags button above the table on the left. The table displays the list of device tags.

2. Click the checkbox next to the device tag(s) on which you want to disable KPI Profiles.

   When you select a device tag, the Devices table on the right shows all the devices that are associated with that tag. All of the devices are preselected.

3. Click Disable KPI Profiles. You will be prompted to confirm that you want to disable all the KPIs running on all the devices in the group. Click Disable to confirm.

To disable KPIs enabled on one or more devices:

1. Click the Devices button above the table on the left. The Devices table on the right shows all the devices, with the total number of KPIs enabled on each device.

2. Click the checkbox next to the devices on which you want to disable KPIs.

   If you select one device, you can disable all KPI Profiles for the device or just some of the KPI Profiles. If you select more than one device, you can only disable all KPIs for them.

3. Click Disable KPI Profiles. You will be prompted to confirm that you want to disable the KPIs running on all the selected devices. If you selected only one device, click the checkboxes next to the KPI Profiles you want to disable on that device, or click the checkbox at the top of the column to disable all the KPI Profiles running on that device. Click Disable to confirm.