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.
- 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?
IP addresses, MAC addresses, and hostnames might not appear in Splunk when this data is missing from the “extrahop_deviceoid_lookup” KV store lookup table.
In ExtraHop Add-On for Splunk v1.1.1 and later, IP addresses, MAC addresses, and hostnames are saved to the KV Store at the time of data ingest. Additionally, the ExtraHop App for Splunk includes a saved search that retrieves this information from an ExtraHop appliance and adds the information to Splunk in case that information was not already cached.
- 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 next to the saved search Retrieve Device Information.
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.2.0
Added a dashboard for ExtraHop detections.
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.