Business Critical Services(BCS) Operational Insights API

Risk Mitigation

Risk Mitigation (RM) helps you identify devices at risk of failure by leveraging our patented predictive Machine Learning (ML) algorithms. RM helps you increase your network uptime by identifying and providing remediation measures to reduce or minimize the devices at high crash risk.

The RM engine taps into a global list of Cisco devices (~2 million) and provides through ML a global risk score and global risk rank for each device in your network. The risk category indicates that the device is at a certain risk of failure compared to other devices. Categorization (High, Medium, or Low) is determined by analyzing the Cisco global device dataset and assigning a risk score to all the devices based on the product family its risk distribution.

NOTE: The categorization is done analytically using distributions. As such, this API resource is not explictly informing why a device is at a certain risk. It is informing you that by analyzing crashes of millions of other analyzed Cisco devices of a same product family, your device is at a certain risk. It is advisable to find the devices with the highest risk score, and perform a deeper inspection of those devices, their software, and maybe worth a discussion with your Consulting Engineer. As a first step it would be good to review the /productAlerts/* API resources for the device in question.

It is sub-divided into these endpoints:

  • /riskMitigation/details
  • /riskMitigation/details/:deviceId
  • /riskMitigation/summary
  • /riskMitigation/summary/:productFamily

Details

The details endpoint provides risk insights for all devices.

Here is an example:

json
Copy{
    "deviceId": 5848341,
    "deviceIp": "10.41.89.252",
    "deviceName": "msglb01",
    "productFamily": "Cisco Catalyst 6500 Series Switches",
    "productId": "WS-C6509-E",
    "riskCategory": "High",
    "riskScore": 30.26,
    "softwareType": "IOS",
    "softwareVersion": "15.1(2)SY12"
}

The device with ID 5848341 running IOS version 15.1(2)SY12 is categorized with a High risk score of 30.25.

Summary

The summary endpoint provides aggregate risk details per product family. It provides insights into how many devices that are at High, Medium, and Low risk per product family.

Here is an example:

json
Copy{
    "highRiskDeviceCount": 0,
    "lowRiskDeviceCount": 28,
    "mediumRiskDeviceCount": 56,
    "productFamily": "Cisco Nexus 5000 Series Switches"
},
{
    "highRiskDeviceCount": 0,
    "lowRiskDeviceCount": 0,
    "mediumRiskDeviceCount": 8,
    "productFamily": "Cisco Nexus 6000 Series Switches"
}

In the previous example you can see that the 56 Cisco Nexus 5000 Series Switches in this network are at Medium risk. None of them are at High risk, and 28 are at Low risk. There are 8 devices of the type Nexus 6000 are at Medium risk and should be reviewed closer.

Next