Splunk® IT Service Intelligence

Entity Integrations Manual

Acrobat logo Download manual as PDF

This documentation does not apply to the most recent version of Splunk® IT Service Intelligence. For documentation on the most recent version, go to the latest release.
Acrobat logo Download topic as PDF

Overview of ITSI entity discovery searches

(ITSI) includes saved searches that are enabled by default to discover your infrastructure's entity data.

You can find the complete list of saved searches under the [ITSI Import Objects] stanza in $SPLUNK_HOME/etc/apps/itsi/default/savedsearches.conf. To avoid performance issues caused by excessive search executions, you can disable the entity discovery searches for entities that you're not using to collecting data.


You can use entity discover saved searches after having met the following prerequisites:

Update search macros

Include the index that you are sending data to as part of the itsi_im_metrics_indexes macro to use the entity discovery saved searches shipped with ITSI.

If you are using a custom saved search in ITSI, update the macro to include the index that you are sending data to. You can do this by updating your HEC token configuration to point to the correct ITSI indexes. For more information about updating your HEC tokens, see Configure the HTTP Event Collector to collect entity integration data in ITSI.

Indexed data

You have to have already indexed data you want to associate with entities.

Entity Discovery Searches reference

The following table is a list of entity discovery searches available in ITSI, and the common data sources discovered by each search:

Saved search Data sources Entity type Data integration method
ITSI Import Objects - AWS Cloudwatch EBS
  • AWS Cloudwatch EBS metrics
N/A Splunk Add-on for AWS
ITSI Import Objects - AWS Cloudwatch EC2
  • AWS Cloudwatch EC2 metrics
N/A Splunk Add-on for AWS
ITSI Import Objects - AWS Cloudwatch ELB
  • AWS Cloudwatch ELB metrics
N/A Splunk Add-on for AWS
ITSI Import Objects - Kubernetes Node
  • Kubernetes Node metrics
  • Kubernetes Node metadata
Kubernetes Node Splunk Connect for Kubernetes
ITSI Import Objects - Kubernetes Pod
  • Kubernetes Pod metrics
  • Kubernetes Pod metadata
Kubernetes Pod Splunk Connect for Kubernetes
ITSI Import Objects - OS
  • System metrics
*nix Unix and Linux Integration - Collectd
ITSI Import Objects - Perfmon
  • System metrics
Windows Perfmon on Splunk Universal Forwarder
ITSI Import Objects - TA *Nix
  • System metrics
Unix/Linux Add-on Unix and Linux Integration - Splunk Add-on for Unix and Linux
ITSI Import Objects - VMWare Cluster
  • VMware Cluster metrics
VMware Cluster VMware
ITSI Import Objects - VMware Datastore
  • VMware Datastore metrics
  • VMware VM/ESXI Datastore metrics
VMware Datastore VMware
ITSI Import Objects - VMware Host
  • VMware ESXi metrics
  • VMware ESXi Host
  • VMware
VMware ESXi Host VMware
ITSI Import Objects - VMware VM
  • VMware VM metrics
VMware VM VMware
ITSI Import Objects - VMware vCenter
  • VMware vCenter metrics
VMware vCenter VMware

Entity type to macro mapping

For ITSI and ITE Work to perform as designed, you need to modify macros for entity search from any custom metrics indexes. Use the following table as a reference for the involved entity types and macros.

Entity type Vital metrics macro name
*nix itsi_entity_type_nix_metrics_indexes
Kubernetes Node itsi_entity_type_k8s_node_metrics_indexes
Kubernetes Pod itsi_entity_type_k8s_pod_metrics_indexes
Unix/Linux Add-on itsi_entity_type_ta_nix_metrics_indexes
VMware Cluster itsi_entity_type_vmware_cluster_metrics_indexes
VMware Datastore itsi_entity_type_vmware_datastore_metrics_indexes
VMware ESXi Host itsi_entity_type_vmware_esxihost_metrics_indexes
VMware vCenter itsi_entity_type_vmware_vcenter_metrics_indexes
VMware VM itsi_entity_type_vmware_vm_metrics_indexes
Windows itsi_entity_type_windows_metrics_indexes

Disable entity discovery searches

You can disable the searches for entity types that are not collecting data in your environment.

To disable the searches, follow these steps:

  1. Navigate to Settings > Searches, Reports, and Alerts.
  2. Filter on ITSI Import Objects to display the entity discovery saved searches. The saved searches are enabled by default.

    Filtering to Owner: Nobody on this page causes the searches to not display. Ensure you filter to Owner: All.

  3. Enable the saved searches by clicking Edit > Disable. For best performance, only enable the searches for the entity types you want to use.

After the searches run, your entities display on the Infrastructure Overview page, where you can track the entity's status and investigate vital metrics. For more information, see About the Infrastructure Overview in ITSI.

Last modified on 11 September, 2023
Import entities from a CSV file in ITSI
Set up a recurring import of entities in ITSI

This documentation applies to the following versions of Splunk® IT Service Intelligence: 4.11.0, 4.11.1, 4.11.2, 4.11.3, 4.11.4, 4.11.5, 4.11.6, 4.12.0 Cloud only, 4.12.1 Cloud only, 4.12.2 Cloud only, 4.13.0, 4.13.1, 4.13.2, 4.13.3, 4.14.0 Cloud only, 4.14.1 Cloud only, 4.14.2 Cloud only, 4.15.0, 4.15.1, 4.15.2, 4.15.3, 4.16.0 Cloud only, 4.17.0, 4.17.1

Was this documentation topic helpful?

You must be logged into splunk.com in order to post comments. Log in now.

Please try to keep this discussion focused on the content covered in this documentation topic. If you have a more general question about Splunk functionality or are experiencing a difficulty with Splunk, consider posting a question to Splunkbase Answers.

0 out of 1000 Characters