Splunk® App for Infrastructure (Legacy)

Administer Splunk App for Infrastructure

On August 22, 2022, the Splunk App Infrastructure will reach its end of life and Splunk will no longer maintain or develop this product.

Collect Windows metrics and logs with Splunk App for Infrastructure

Use the easy install script to install and configure data collection agents on a host from which you want to collect metrics and log data. You can forward metrics and log data to the Splunk App for Infrastructure (SAI) for performance monitoring and to investigate your infrastructure.

When you have set up the data collection agent on your host system and validated new entities are connected, you can start monitoring your infrastructure. Hosts you are monitoring are called entities. Go to the Investigate page to monitor your entities in the Infrastructure Overview or List View. You can group your entities to monitor them more easily, and drilldown to the Analysis Workspace to further analyze your infrastructure.


The easy install script requires the following.

Item Requires
Windows machine

See Operating system support for data collection.

Easy install script

See Windows data collection requirements.

Admin privileges Admin privileges are required to configure data collection.


1. Specify configuration options

Select which metrics and logs to collect from the system. If you're running SAI on Splunk Cloud, you must enter specific settings for the Monitoring machine and Receiver port. For more information, see Install and configure the data collection agents on each applicable system in the Install and Upgrade Splunk App for Infrastructure guide.

  1. In the SAI user interface, click the Add Data tab.
  2. Select Windows in the integration panel.
  3. In 1: Specify configuration options > Data to be collected, click the Customize link.
    • When you select or customize the data to be collected, this customizes the script you run on your host system.
  4. Select the metrics and log sources for which you want to collect data.
    • The metric cpu is selected by default, and cannot be deselected.
    • If selecting cpu > Collect data for each CPU, metrics are stored for each cpu individually, which enables you to use the Split-by feature in the Analysis Workspace.
    • If selecting cpu > Collect sum over all CPUs, only aggregate metrics are stored.
  5. Click Save.
  6. Add Dimensions for easier troubleshooting, analysis, and filtering hosts.
    • Dimensions are key/value pairs that provide metadata about the metric (describes the measurement) used for searching and filtering relevant datasets (distinct time series) during an investigation.
    • Use the format of dimension:value, such as env:prod.
  7. Enter the Monitoring machine hostname or IP address of the system that has Splunk App for Infrastructure installed. If you are using Splunk Cloud, this field is not available.
    • For example, my.instance.domain.name.
  8. Specify the Receiver port of the system you want to send log and metrics data to. The recommended port is 9997. If you are using Splunk Cloud, this field is not available.
  9. Enter an Install Location for where you want the script to install the Splunk Universal Forwarder on your system. If you are using Splunk Cloud, this field is not available.
  10. Enable Use SSL to run the script with SSL. This option removes [System.Net.ServicePointManager]::ServerCertificateValidationCallback={true};. You may want to disable SSL if you're using self-signed certificates. If you're using Splunk Cloud, keep this option enabled.

2. Run the easy install script

Deploy the easy install script on your host to collect metrics and logs.

  1. Connect to the Windows system with the Remote Desktop Protocol (RDP).
  2. On the Windows system, open a PowerShell window.
  3. Paste the script in the PowerShell window and run it.
  4. When you run the script on a Windows system for the first time, you might receive a message stating that the universal forwarder was installed without creating an admin user. If this occurs, you have to manually create admin credentials. For information about creating admin credentials, see user-seed.conf in the Splunk Enterprise Admin Manual.

3. Verify your data connection

Verify your data connection to start monitoring your infrastructure.

It can take up to about five (5) minutes for your hosts to display in the user interface.

  1. In the SAI user interface, return to your web browser and the Add Data view.
  2. When the script finishes running, the user interface indicates your host is connected and data is available to view.
    • If no new hosts are connected after a few minutes, click Refresh.
    • When new hosts are connected, click New host found to view your host.
Last modified on 07 July, 2020
Update SELinux to allow for data collection in Splunk App for Infrastructure   Manually configure metrics and log collection for a Windows host for Splunk App for Infrastructure

This documentation applies to the following versions of Splunk® App for Infrastructure (Legacy): 2.2.0 Cloud only, 2.2.1, 2.2.3 Cloud only, 2.2.4, 2.2.5

Was this topic useful?

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