ExtraHop App for Splunk
Overview
Details
About
After you install the ExtraHop Add-On for Splunk, we recommend that you install the ExtraHop App for Splunk to help you configure the ExtraHop Add-On. For more information about the Extrahop Add-On, see https://splunkbase.splunk.com/app/3938.
The ExtraHop App adds additional information to the data that the ExtraHop Add-On collects, including the IP addresses, MAC addresses, and hostnames of devices discovered by ExtraHop. The app also creates default inputs to collect metrics about HTTP, DNS, and storage activity and builds dashboards to display that information.
The app includes the following objects:
- Pre-configured inputs that collect information about HTTP, DNS, and storage performance.
- Three dashboards that display the information collected by the inputs.
- Pre-configured searches that add contextual information about devices and applications discovered by ExtraHop.
Requirements
Splunk Requirements
- Splunk Enterprise 7.0 or later
- The ExtraHop Add-On for Splunk.
ExtraHop Requirements
ExtraHop firmware version 7.1.2 or later
Installation Instructions
If your Splunk Enterprise deployment is distributed, install the app on your search heads. If your Splunk Enterprise deployment is a single instance, install the app on the instance. For information about installing an app, see the Splunk Add-Ons documentation.
Create default dashboards and inputs
After you install the ExtraHop App for Splunk, you can create default dashboards and inputs for HTTP, DNS, and storage activity. Note that the saved searches included in the app do not require you to create the dashboards and inputs; the saved searches will run automatically after the app is installed.
- On the Splunk Web home screen, click the ExtraHop App for Splunk icon in the navigation bar to launch the app.
- Click Configuration > Setup. Note: If the ExtraHop Add-On for Splunk is disabled or uninstalled, you will be prompted to enable or install the add-on before continuing.
- Specify the hostname or IP address of the ExtraHop Discover or Command Appliance that you are collecting metrics from.
- Specify a valid API key for the appliance..
Note: The API key must have at least “metrics”:”full” privileges. - Click Submit.
- After the app verifies connectivity to the ExtraHop appliance, specify a prefix for the app’s inputs.
For example, if you specify “extrahop”, the app will create four ExtraHop inputs named “extrahop_dns”, “extrahop_http”, “extrahop_nas”, and “extrahop_nas_fileinfo”. - Click Create Defaults.
The data inputs created by this process are configured with an interval of 300 seconds and an index of “main”. These settings can be changed by editing the data inputs using the ExtraHop Add-On for Splunk or by manually editing the inputs.conf files.
Troubleshooting FAQ
Why aren’t IP addresses, MAC address, and hostnames appearing in Splunk?
The ExtraHop Add-On for Splunk does not record the IP addresses, MAC addresses, and hostnames of devices by default for performance reasons. However, the ExtraHop App for Splunk includes a saved search that retrieves this information from an ExtraHop appliance and adds the information to Splunk.
The search is only scheduled to run every six hours, so you might not see this information immediately after installing the ExtraHop App. To see this information faster, you can run the search manually at any time by following this procedure:
- On the Splunk Web home screen, click Settings > Knowledge > Searches, reports, and alerts.
- From the App drop-down menu, select ExtraHop App for Splunk.
- Click Run.
Note: Because the saved search consumes system resources and can take a long time to run, we recommend that you run the search only when necessary.
Release Notes
Version 1.0.5
Fixed bug affecting setup page connection to ExtraHop appliance
Inputs created by setup page are now started automatically
Version 1.0.4
Added sanity checks to SSL certificate verification and proxy settings
Version 1.0.3
Version 1.0.2
Added support for ExtraHop Add-On for Splunk's SSL certificate verification and proxy settings
Version 1.0.1
- Creating default inputs now overwrites existing inputs with same name
Version 1.0.0
Initial release.