Overview of configuring KPIs in ITSI
A KPI (Key Performance Indicator) is a recurring saved search that returns the value of an IT performance metric, such as CPU load percentage, memory used percentage, response time, and so on.
ITSI lets you create KPIs and add them to your services. You can then use KPI search result values inside ITSI to monitor service health, check the status of IT components, and troubleshoot trends that might indicate an issue with your IT systems.
cpu_load_percent is a KPI that measures the CPU load percentage on a server. If your organization has a site uptime guarantee of 99.9% per month, you will need to monitor the status of this KPI (and others) to ensure that CPU performance remains within acceptable parameters.
When you initially create a KPI search, you configure the following set of search properties:
|Source search||A search string that you define as the basis for your KPI, using a data model, ad hoc search, metrics search, or base search.||Yes|
|Entity Split Field||A field in your data that can be used to break down the KPI. This option lets you apply a KPI search to multiple entities, enabling comparative analysis of search results on a per-entity basis. This field can be different from the Entity Filter Field.||Optional|
|Entity Filter Field and Entity Alias Filtering||Filter entities in or out of a KPI search using Entity Filter Field. Map entity aliases to fields in your search data to determine the specific entities to which a KPI search applies.||Optional|
|Monitoring calculations||The recurring KPI search schedule and statistical operations on search results, including service health score calculations.||Yes|
|Backfill||Fills the summary index (itsi_summary) with historical raw service health score data.||Optional|
|Severity-level thresholds||Thresholds that you apply to KPI search results. Severity-level thresholds let you monitor KPI status (normal, low, medium, high, and critical) and set trigger conditions for alerts.||Yes|
For example, to monitor the CPU load percentage of an entity (machine) in a service, you can create a KPI using an ad hoc base search that returns the value of the field
cpu_load_percent at 5 minute intervals over a 5 minute time range, then set a range of severity-level thresholds between 0% and 100%.
For a step-by-step guide to adding a KPI to a service, see Add a KPI to a service in ITSI.
After you add a KPI to a service, you can perform other configuration tasks, like setting KPI importance values and applying anomaly detection.
How service health scores work in ITSI
Add a KPI to a service in ITSI
This documentation applies to the following versions of Splunk® IT Service Intelligence: 4.1.0, 4.1.1, 4.1.2, 4.1.5