
Splunk On-Prem SIEM / Vectra integration guide (start here for RUX)
Start here for Splunk integration with Vectra Respond UX, including supported add-ons/apps, install matrix, API client setup, and data inputs.
Integration Overview
Vectra AI provides Add-ons and Apps to seamlessly integrate with Splunk and Splunk Enterprise Security. Vectra provides 2 main data sources for Splunk:
Vectra RUX
Vectra RUX uses a patent-pending combination of data science, machine learning and behavioral analysis to reveal the fundamental characteristics of malicious threat behavior. The Vectra platform captures packets and logs across public cloud, SaaS, federated identity and data center networks to surface and prioritize threats. These high-fidelity insights can be pulled via API to integrate seamlessly with your workflows and operations.
Network Metadata from Vectra Stream
Leveraging the same platform, Vectra provides the ability to export network metadata collected by the Vectra Sensors deployed through the environment to Splunk. This data provides an in-depth view of any communication observed in your environment and enables you to perform investigation & threat hunting. A list of protocols supported, and attributes extracted is available here.
Vectra RUX Add-On and Apps for Splunk
Vectra RUX
Vectra RUX Technology Add-on
Add-on
10.5, 10.4, 10.3, 10.2, 10.1, 10.0, 9.4, 9.3, 9.2, 9.1
Yes
Yes
Vectra Respond UX
JSON
Vectra RUX App
App
10.5, 10.4, 10.3, 10.2, 10.1, 10.0, 9.4, 9.3, 9.2, 9.1
Yes
Yes
Vectra Respond UX
n/a
Vectra Stream
Technology Add-on for Vectra Stream (JSON)
Add-on
10.5, 10.4, 10.3, 10.2, 10.1, 10.0, 9.4, 9.3, 9.2, 9.1
Yes
Yes
JSON
N/A
Vectra Stream
App
10.5, 10.4, 10.3, 10.2, 10.1, 10.0, 9.4, 9.3, 9.2, 9.1, 9.0
Yes
Yes
n/a
Prerequisites
Before configuring the Vectra AI integration with Splunk On-prem Platform, ensure the following requirements are met:
A valid Splunk account with access to Splunkbase to download the required Vectra apps and add-ons.
A supported version of Splunk Cloud Platform or Splunk Enterprise.
All application dependencies listed in the Add-ons and Apps table are installed and configured.
The required Splunk index or indexes are created before data ingestion begins.
Integration of Splunk On-Prem with Vectra RUX
Integrating Splunk On-Prem Platform with Vectra RUX involves three main steps:
Creating API clients in the Vectra Respond UX for use by the Technology Add-on.
Installing and configuring the Vectra RUX Technology Add-on.
Installing the Vectra RUX App.
Create API Clients in Vectra Respond UX
API clients must be created in the Vectra Respond UX. These API clients are used by the Vectra RUX Technology Add-on for Splunk to authenticate with the Vectra platform and retrieve data.
Install and Configure the Vectra RUX Technology Add-on
The Vectra RUX Technology Add-on for Splunk collects data from the Vectra platform, including:
Entity scoring data
Detection data
Audit data
Lockdown data
Health data
The Technology Add-on performs CIM mapping for detection and audit data. It also maps entity scoring and detection data fields to the corresponding Vectra Syslog event fields.
1. Creating API Clients for Splunk Integration
Before configuring the Splunk integration, create separate API clients for each endpoint required by the integration.
Creating individual API clients for each endpoint is required to ensure that the Splunk integration can securely and efficiently collect data from Vectra.
Why Separate API Clients Are Required
Separate API clients are required for the following reasons:
Each endpoint used by the Splunk integration is polled individually.
Different endpoints require different permission levels in Vectra.
Using separate API clients helps improve performance and scalability when accessing multiple API endpoints.
Troubleshooting is easier because each API client is associated with a specific endpoint and purpose.
Access can be managed more securely by assigning only the required permissions to each API client.
API Clients Required for the Integration
Create the following API clients for use with the Vectra Splunk integration.
ro_splunk_entity_scoring
Read-only
Used by Splunk to poll the entity_scoring endpoint.
ro_splunk_detections
Read-only
Used by Splunk to poll the detections endpoint.
ro_splunk_lockdown
Read-only
Used by Splunk to poll the lockdown endpoint.
audit_splunk_audits
Auditor
Used by Splunk to poll the audits endpoint.
audit_splunk_health
Auditor
Used by Splunk to poll the health endpoint.
Recommended Naming Convention
Use clear and descriptive API client names so that each client can be easily identified during configuration, maintenance, and troubleshooting.
The recommended naming format is:
<role>_splunk_<endpoint>
For example:
ro_splunk_detections
This naming convention indicates that the API client:
Uses a read-only role.
Is intended for Splunk.
Is associated with the detections endpoint.
Permission Guidance
Assign only the permissions required for each endpoint to follow the principle of least privilege.
Use a Read-only role for endpoints that require only read access.
Use an Auditor role for endpoints that require audit-level access.
Avoid using overly permissive roles unless they are specifically required.
Following these guidelines helps maintain least-privilege access for the Splunk integration and reduces unnecessary permissions.
RUX API Client Creation
To create each of the API clients listed above, follow these steps:
Log in to Vectra Respond UX (RUX).
Navigate to Configuration > API Clients under Access.
Click Add API Client.

Enter a name for the API client, select the appropriate role, and optionally provide a description. Once you have entered the required details, click Generate Credentials.

Save the API Client Credentials
On the API Client Created screen, copy the Client ID and Secret Key and store them in a secure location for later configuration in Splunk. Then, click Done.
Important: The Secret Key is displayed only once and cannot be retrieved later. If you do not copy and securely save the Secret Key at this stage, you must delete the API client and create a new one to obtain a new key.

Once you have created all five required API clients, your screen should look similar to the following:

After Creating the API Clients
After all required API clients have been created:
Securely save the client credentials. Store the Client ID and Secret Key in a secure location for use during the Splunk configuration.
Verify the assigned roles. Confirm that each API client has been assigned the correct role.
Configure the API clients in Splunk. Use the API client credentials when configuring accounts in the Vectra RUX Technology Add-on for Splunk.
Create the account configurations. Create one account configuration in the add-on for each API client.
Continue with the Splunk configuration. Once all API clients are created and verified, proceed with the remaining add-on configuration steps in Splunk.
2. Installation and Configuration of "Vectra RUX Technology Add-on"
Installation of the Vectra RUX Technology Add-on for Splunk
This section explains how to install the Vectra RUX Technology Add-on for Splunk.
The add-on can be installed using one of the following methods:
Recommended: Install the add-on from Find More Apps in Splunk Web.
Alternative: Install the add-on from a downloaded file using Splunk Web.
Manual Installation: Install the add-on directly from the Splunk server file system.
Use the installation methods in the order listed above. The Find More Apps method is recommended because it allows the add-on to be installed directly from Splunk Web with minimal manual steps.
Recommended Installation Order
Install the add-on using the following order of preference:
1
Install from Find More Apps
Recommended method for most Splunk environments
2
Install from a file using Splunk Web
Use when you have already downloaded the add-on package
3
Manual installation from the file system
Use when Splunk Web installation is not available or not suitable
Method 1: Install the Add-on from Find More Apps
This is the recommended method for installing the Vectra RUX Technology Add-on for Splunk.
Use this method if the add-on is available from the Find More Apps section in Splunk Web.
Steps
Log in to Splunk Web using an administrator account.
From the Splunk home dashboard, go to the Apps section.
Click Find More Apps.
In the search bar, search for:
Vectra RUX Technology Add-on
Select the Vectra RUX Technology Add-on from the search results.
Click Install.
Follow the on-screen instructions to complete the installation.
If Splunk prompts you to restart, restart the Splunk instance.
After the restart is complete, log back in to Splunk Web.
Navigate to:
Apps > Manage Apps
Search for the Vectra RUX Technology Add-on and confirm that it is installed and enabled.
Method 2: Install the Add-on from a File Using Splunk Web
Use this method if the add-on package has already been downloaded and you want to upload it through Splunk Web.
Steps
Download the Vectra RUX Technology Add-on package from Splunk.
Log in to Splunk Web using an administrator account.
From the Splunk home page, navigate to:
Apps > Manage Apps
In the upper-right corner of the page, click:
Install app from file
Click Choose File.
Browse to the location where the Vectra RUX Technology Add-on installation file is saved.
Select the add-on installation file.
Click Upload.
Follow the on-screen prompts to complete the installation.
If Splunk prompts you to restart, restart the Splunk instance.
After the restart is complete, verify that the add-on is installed by navigating to:
Apps > Manage Apps
Search for the Vectra RUX Technology Add-on and confirm that it appears in the installed apps list.
Verify the Installation
After completing any of the installation methods, verify that the add-on was installed successfully.
Steps
Log in to Splunk Web.
Navigate to:
Apps > Manage Apps
Search for:
Vectra RUX Technology Add-on
Confirm that the add-on appears in the list of installed apps.
Verify that the add-on status is Enabled.
If the add-on does not appear, restart Splunk and check again.
Configure Accounts in the Vectra RUX Technology Add-on
After the Vectra RUX Technology Add-on for Splunk is installed, configure the accounts that the add-on will use to authenticate with the Vectra platform.
In Splunk Cloud Platform, navigate to Apps.
Open Vectra RUX Technology Add-on.
Go to Configuration > Account.
Click Add to create a new account.
Add one account for each API client created earlier in the Vectra Respond UX.
Enter the required connection details, including the Vectra platform URL and the API client credentials.
Save each account configuration.
When complete, the Account page should include separate account entries for each required API client, similar to the following:
splunk_entity_scoring
Polls the entity_scoring endpoint.
ro_splunk_detections
Polls the detections endpoint.
ro_splunk_lockdown
Polls the lockdown endpoint.
audit_splunk_audits
Polls the audits endpoint.
audit_splunk_health
Polls the health endpoint.

Configure Proxy Settings
If your Splunk environment requires a proxy to connect to external services, configure the proxy settings in the add-on.
Skip this section if your Splunk environment does not use a proxy.
Steps
Navigate to:
Vectra RUX Technology Add-on > Configuration > Proxy
Enable proxy configuration if required.
Enter the required proxy details, such as:
Proxy host
Proxy port
Proxy username, if authentication is required
Proxy password, if authentication is required
Save the proxy configuration.
Example Proxy Configuration:

Configure Logging Level
The logging level controls the amount of detail written to the add-on logs.
Steps
Navigate to:
Vectra RUX Technology Add-on > Configuration > Logging
Select the desired logging level.
Save the configuration.
If you are unsure which logging level to use, Vectra recommends selecting:
The Info logging level provides a balanced amount of operational detail and is suitable for most environments.
Recommended Logging Level
Info
Recommended for normal operation.
Debug
Use temporarily when troubleshooting an issue.
Error
Use when you only want to capture error messages.
Note: Debug logging can generate more log data. Use it only when troubleshooting and change the logging level back to Info after the issue is resolved.
Verify the Add-on Configuration
After completing the configuration:
Confirm that all required accounts are listed under the Account tab.
Confirm that proxy settings are configured only if required by your Splunk environment.
Confirm that the logging level is set to Info, unless a different level is needed.
Continue to the data input configuration section.

2.2 Vectra RUX Technology Add-on: New Installation and Data Input Configuration
After installing the Vectra RUX Technology Add-on and configuring the required Vectra account. It explains how to create data inputs that collect data from the selected Vectra endpoints. Create a separate data input for each account and endpoint that you want to ingest into Splunk.
Add a New Data Input
Navigate to Vectra RUX Technology Add-on.
Open Inputs.
Select Create New Input or Add Input, depending on the option available in your Splunk interface.
Select the input type and configure the required fields.
Save the input and confirm that it is enabled.
Data Input Configuration Fields
Create a separate input for each Vectra account and endpoint that you want to ingest. Configure the following fields for the selected input type.
Entity Scoring Input Fields
Name: A unique name for the data input.
Interval: How often Splunk polls the selected Vectra endpoint, in seconds.
Index: The Splunk index where collected events are stored.
Vectra RUX Account: The configured Vectra RUX account used to authenticate to the endpoint.
Historical Data: When enabled, collects the previous 24 hours of data on the first collection cycle.
Detection Input Fields
Name: A unique name for the data input.
Interval: How often Splunk polls the selected Vectra endpoint, in seconds.
Index: The Splunk index where collected events are stored.
Vectra RUX Account: The configured Vectra RUX account used to authenticate to the endpoint.
Historical Data: When enabled, collects the previous 24 hours of data on the first collection cycle. This option is available only for Entity Scoring, Detection, and Audit inputs.
From Checkpoint ID: An optional event id from which collection begins on the first run. Use it when you want collection to start after a specific event instead of collecting the previous 24 hours.
Include Triaged: Include triaged detections.
Include Info Category: Include informational detections.
Input Start Time: Select the event timestamp source used for data collection.
Audit Input Fields
Name: A unique name for the data input.
Interval: How often Splunk polls the selected Vectra endpoint, in seconds.
Index: The Splunk index where collected events are stored.
Vectra RUX Account: The configured Vectra RUX account used to authenticate to the endpoint.
Lockdown Input Fields
Name: A unique name for the data input.
Interval: How often Splunk polls the selected Vectra endpoint, in seconds.
Index: The Splunk index where collected events are stored.
Vectra RUX Account: The configured Vectra RUX account used to authenticate to the endpoint.
Health Input Fields
Name: A unique name for the data input.
Interval: How often Splunk polls the selected Vectra endpoint, in seconds. Use 900 seconds for the Health input.
Index: The Splunk index where collected events are stored.
Vectra RUX Account: The configured Vectra RUX account used to authenticate to the endpoint.
Get Health EDR: Collect data from the health EDR endpoint.
Get Health EDR Details: Collect data from the detailed health EDR endpoint.
Get Health External Connectors: Collect data from the health external connectors endpoint.
Get Health External Connectors Details: Collect data from the detailed health external connectors endpoint.
Recommended Input Interval
For Entity Scoring, Detection, Audit, and Lockdown inputs, an interval of 60 seconds is recommended. Splunk checks the configured endpoint every 60 seconds and collects available data.
Health Input Interval
For the Health input, use an interval of 900 seconds. Health data is refreshed every 15 minutes on the Vectra side, so the longer interval avoids unnecessary polling and aligns Splunk collection with the data refresh cycle.
Historical Data Option
Historical Data is optional. When enabled, the input collects data from the previous 24 hours. This can be useful in smaller environments when verifying that the add-on is working and data is reaching Splunk.
Use From Checkpoint ID with the latest event id when you need to resume collection without re-ingesting the previous 24 hours. Do not use detection_id as the checkpoint value.
Use this Splunk search to retrieve the latest event id:
Copy the id field from the result into From Checkpoint ID. Do not use detection_id.
Verify Data Input Configuration
After creating data inputs:
Confirm that each required input appears in the Inputs table.
Verify that its status is Enabled.
Confirm that the correct Vectra account and Splunk index are selected.
Wait for the configured interval to pass.
Verify that data is being ingested by searching the configured index in Splunk Search.

3. Installation of Vectra RUX App for Splunk
This section explains how to install, configure, troubleshoot, and uninstall the Vectra RUX App for Splunk.
The Vectra RUX App provides dashboards and visualizations for data collected by the Vectra RUX Technology Add-on for Splunk. Before using the app, ensure that the add-on is installed, configured, and collecting data successfully.
Installation
The Vectra XDR App for Splunk can be installed using one of the following methods:
Recommended: Install the app from Find More Apps in Splunk Web.
Alternative: Install the app from a downloaded file using Splunk Web.
Method 1: Install from Find More Apps
Use this method if the app is available directly from Splunk Web.
Steps
Log in to Splunk Web using an administrator account.
From the Splunk Home dashboard, go to the Apps section.
Click Find More Apps.
Search for:
Vectra RUX App for Splunk
Select the app from the search results.
Click Install.
Follow the on-screen instructions to complete the installation.
Restart Splunk if prompted.
After installation, verify that the app is available from the Splunk Apps menu.
Method 2: Install from a File Using Splunk Web
Use this method if you have already downloaded the app package.
Steps
Download the Vectra RUX App for Splunk package from Splunk.
Log in to Splunk Web using an administrator account.
Navigate to:
Apps > Manage Apps
In the upper-right corner, click:
Install app from file
Click Choose File.
Select the downloaded Vectra RUX App package.
Click Upload.
Follow the on-screen prompts to complete the installation.
Restart Splunk if prompted.
After installation, confirm that the app appears in the Splunk Apps menu.
Configuration
No additional configuration is required if the data collected by the add-on is stored in the default Splunk index:
However, if you configured the data inputs to send data to an index other than main, you must update the app macro so that the dashboards search the correct index.
Important: Updating the vectra_xdr_index_macro is required for the Vectra RUX App for Splunk to display data correctly when a custom index is used. If this macro is not updated, the dashboards may not show Vectra data because the app will continue searching the default main index.
Configure the App Index
In the new Vectra RUX App for Splunk, you do not need to update the vectra_xdr_index_macro manually.
Log in to Splunk Web.
Open Vectra RUX App for Splunk.
Go to the Configuration section.
Select the index where the Vectra RUX Technology Add-on stores data from the Index drop-down.
Click Save.
Open the dashboards and confirm that data is displayed.
The app uses the selected index for its dashboard searches.
Uninstall and Clean Up Steps
Use the following steps to uninstall the Vectra RUX Technology Add-on for Splunk and remove related log files from the Splunk instance.
Remove the Add-on Directory
Remove the add-on directory from the Splunk apps folder:
This removes the installed add-on files from the Splunk instance.
Remove Add-on Log Files
Remove the log files generated by the add-on from the Splunk log directory:
These log files are created by the add-on during configuration, data collection, and troubleshooting activities.
Restart Splunk
After removing the add-on directory and related log files, restart the Splunk Enterprise instance.
Restarting Splunk ensures that the cleanup changes are reflected in the Splunk Web UI.
After the restart is complete, verify that the add-on no longer appears under:
Troubleshooting
This section provides basic troubleshooting steps for the Vectra RUX Technology Add-on for Splunk.
Use these checks if the add-on is not working as expected, data is not being collected, or logs need to be reviewed.
General Checks
To troubleshoot the add-on, review the add-on log files located in the Splunk log directory:
All log files generated by this add-on are stored in this directory and use the following naming pattern:
You can also review the logs directly from Splunk Web using the following search query:
This query displays all log messages generated by the add-on.
To view only error messages, use the following query:
Review the error messages to identify configuration issues, authentication failures, connectivity problems, or data collection errors.
Add-on Icons Are Not Showing
The add-on does not require a Splunk restart immediately after installation for its core functionality to work.
However, the add-on icons may not appear in Splunk Web until Splunk is restarted once after installation.
If the icons are not visible:
Restart the Splunk Enterprise instance.
Log back in to Splunk Web.
Navigate to the Apps menu and verify that the add-on icons are displayed.
Data Collection Issues
If data collection is not working, verify the following:
Confirm that the Splunk server has internet connectivity.
If your environment uses a proxy, confirm that the proxy is enabled and configured correctly in the add-on.
Confirm that the configured account credentials are correct.
Verify that the data inputs are enabled.
Confirm that the selected index exists and is searchable.
Review the relevant input log files for error messages.
Input-Specific Log Files
Each data input writes logs to a specific log file. Use the log file that matches the input type you are troubleshooting.
Entity Scoring
ta_vectra_xdr_entity_scoring_input_<input_name>.log
Detections
ta_vectra_xdr_detections_input_<input_name>.log
Audits
ta_vectra_xdr_audits_input_<input_name>.log
Lockdown
ta_vectra_xdr_lockdown_input_<input_name>.log
Health
ta_vectra_xdr_health_input_<input_name>.log
Replace <input_name> with the name of the data input configured in Splunk.
Example Troubleshooting Searches
Use the following Splunk searches to review add-on activity.
View All Add-on Logs
View Add-on Errors
View Logs for a Specific Input
Replace <input_name> with the name of the input you want to troubleshoot.
Recommended Troubleshooting Flow
Use the following order when troubleshooting data collection issues:
Confirm that the data input is enabled.
Confirm that the account configuration is correct.
Confirm that the index is configured correctly.
Check network connectivity from the Splunk server.
Verify proxy configuration, if a proxy is required.
Review the add-on logs in:
Search the
_internalindex for add-on errors.Resolve any errors found in the logs and restart Splunk if required.
Troubleshooting Dashboards
Use this section if dashboards are not displaying data or if you need to verify that Vectra data is available in Splunk.
Verify Data in the Configured Index
To confirm that data is being collected, run a search using the index configured for the add-on.
Example:
Replace <your_index_name> with the index used in your data input configuration.
Search by Individual Sourcetype
You can also search each sourcetype individually.
Lockdown Events
Audit Events
Detection Events
Entity Scoring Events
Health Events
Review Add-on Logs
The Vectra RUX App uses data collected by the Vectra RUX Technology Add-on. If data is not available, review the add-on logs.
The add-on log files are located in:
Check log files that match the following pattern:
You can also search the logs from Splunk Web:
To view only error messages, use:
Dashboard Is Not Populating
If the Vectra RUX App dashboards are not displaying data, verify the following:
Confirm that the Vectra RUX Technology Add-on is installed and collecting data.
Confirm that the data inputs are enabled.
Confirm that data exists in the configured index.
Confirm that the expected sourcetypes are available in Splunk.
If you are using a custom index, confirm that the
vectra_xdr_index_macromacro is updated correctly.Refresh the dashboard after updating the macro.
If required, restart Splunk and check the dashboard again.
Integration of Splunk with Vectra Stream
There are 3 main steps required to integrate Splunk with Vectra Stream:
Installation and configuration of "Technology Add-on for Vectra Stream (JSON) ".
Installation of "Vectra Stream " App.
Configuring Vectra Stream to send metadata to Splunk using Publisher of "Raw JSON" using Protocol of "TCP" to the server IP/Hostname and port number of your choice where Splunk will be listening.
For details please see the Splunk Integration Guide for Vectra AI .
Last updated
Was this helpful?