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.

Prerequisites

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.