Add metric exceptions in Splunk Asset and Risk Intelligence
Exclude particular assets from a metric calculation by adding a metric exception. When you add a metric exception, any assets that are in scope for the metric, but also meet your exception criteria, are excluded in the metric calculation. However, you can still see the omitted assets listed in the metric dashboard.
Adding a metric exception is helpful when there are assets that are typically compliant with the metric, but there is an exceptional reason why those assets are not compliant. For example, if there are servers running a legacy operating system, you might want to exclude them from your metric calculation because Splunk Asset and Risk Intelligence labels those servers as defects.
To filter the scope of your metric, such as filtering out workstations, rather than adding an exception, see Edit metric settings.
Add a manual metric exception
There are two ways you can manually add a metric exception:
- Add an exception from a metric dashboard
- Add an exception from the Metric exceptions page
Add an exception from a metric dashboard
To add a metric exception from a particular metric dashboard, complete the following steps:
- In Splunk Asset and Risk Intelligence, select Risk and then Metrics.
- Select the metric you want to add exceptions to.
- In the Metric details table, select the check boxes for the records you want to exclude.
You can filter the list of records by toggling between Defects and Compliant.
- Select Exceptions and then Add selected exceptions.
You can also select View all exceptions to open the Metric exceptions page.
- Enter a Note for the exception. The note is recorded as the
exception_reason
. - (Optional) Select the toggle switch to turn on Exception expiry. By turning on this option, you can create a temporary exception by designating a time period until the exception expires. For example, you can enter 15 to remove the exception after 15 days.
- Select Add.
After you add an exception, you can find it on the Metric exceptions page by selecting View all exceptions or by selecting the single value exception panel on the metric dashboard.
Add an exception from the Metric exceptions page
To add a metric exception from the Metric exceptions page, complete the following steps:
- In Splunk Asset and Risk Intelligence, select Risk then Metrics and then Metric exceptions.
- Select Add exception.
- Using the drop-down list, select the Metric that you want to add an exception to.
- Enter the Exception value. For example, if you select NT Host for the field, enter the hostname for the exception value.
- Enter a reason for adding the exception.
- (Optional) Select the toggle switch to turn on Exception expiry. By turning on this option, you can create a temporary exception by designating a time period until the exception expires. For example, you can enter 15 to remove the exception after 15 days.
- Select Add.
After you add an exception, you can find it in the Exception listing table. You can filter and search for particular exceptions by reason and by value.
For more details on adding and managing metric exceptions, see Add and manage metric exceptions in the Investigate Assets and Assess Risk in Splunk Asset and Risk Intelligence manual.
Add an automated metric exception using exception logic
If you want to add a more advanced exception to your metric, such as exclude assets with a particular naming convention, you can do so with the metric exception logic.
Each metric has an exception logic where you can identify the assets to exclude from the given metric. Splunk Asset and Risk Intelligence turns off exception searches by default.
To activate an exception search and edit the exception logic, complete the following steps:
- In Splunk Asset and Risk Intelligence, select Admin then Risk management and then Metric and framework management.
- In the Metrics table, select the more icon (
) for the metric you want to edit.
- Select Edit exception logic.
- Review the logic for the metric opportunities.
- Edit the Exception logic.
- Enter a schedule in cron format to designate when the search runs.
- (Optional) Select the toggle switch to turn on Exception expiry. By turning on this option, you can create a temporary exception by designating a time period until the exception expires. For example, you can enter 15 to remove the exception after 15 days.
- Modify the search. The search identifies assets that are exceptions. Exceptions can be any of the fields in the Opportunities section.
- Enter a reason. You can enter a reason in quotes or in an if() / case() eval statement.
- (Optional) Test the logic by selecting Preview.
- Activate the exception search by changing the toggle switch to Active.
- Select Update.
After you activate the exception search and it runs in accordance with the specified schedule, you can find your updated metric exception by navigating to Risk then Metrics and then Metric exceptions in Splunk Asset and Risk Intelligence.
Create and manage metrics in Splunk Asset and Risk Intelligence | Create and manage risk scoring rules in Splunk Asset and Risk Intelligence |
This documentation applies to the following versions of Splunk® Asset and Risk Intelligence: 1.1.1
Feedback submitted, thanks!