Configure inputs
Set up a Config input using Splunk Web
In Splunk Web, click on Splunk Add-on for AWS in the left navigation bar, then click Create New Input > Config > Config. Use the information in the following table to help you configure the fields for an AWS Config input on your data collection node.
Argument in configuration file | Field in Splunk Web | Description | Action |
---|---|---|---|
aws_account
|
AWS Account | The AWS account or EC2 IAM role the Splunk platform uses to access your Config data. | In Splunk Web, select an account from the drop-down list. In inputs.conf , enter the name of one of the AWS accounts that you configured on the Configuration page or the name of the autodiscovered EC2 IAM role.
|
aws_region
|
AWS Region | The AWS region that contains the log notification SQS queue. See the AWS documentation for more information. | In inputs.conf , enter the region ID.
|
sqs_queue
|
SQS queue name | The name of the queue to which AWS sends new Config notifications. The queue name is the final segment of the full queue URL. For example, if your SQS queue URL is http://sqs.us-east-1.amazonaws.com/123456789012/testQueue , then your SQS queue name is testQueue .
|
If your service account has appropriate permissions, Splunk Web lets you select your queue from the drop-down list. Otherwise, enter the queue name manually. |
sourcetype
|
Source type | Event extraction relies on the default value of source type. If you change the default value, you must update props.conf as well.
The Splunk platform indexes AWS Config events using three variations of this source type, as follows:
|
Enter a value only if you want to override the default of aws:config . If you modify the default value of aws:config , you see <yourcustomsourcetype>:notification and <yourcustomsourcetype>:log .
|
index
|
Index | The index name where the Splunk platform puts the Config data. The default is "main". | Optionally change the index name where the Splunk platform will put the Config data. |
Polling interval
|
Interval | The number of seconds for the Splunk platform to wait before it runs the command again. The default value is 30 seconds. | Optionally change the polling interval, in seconds. |
Switch from a Config input to an SQS-based S3 input
The SQS-based S3 input is a more fault-tolerant and higher-performing alternative to the Config input for collecting CloudTrail data. If you are already collecting Config data using a Config input, you can configure an SQS-based S3 input and seamlessly switch to the new input for Config data collection with little disruption.
- Disable the Config input you are using to collect Config data.
- Set up a dead-letter queue and the SQS visibility timeout setting for the SQS queue from which you are collecting Config data.
- Create an SQS-based S3 input, pointing to the SQS Queue you configured in the last step.
Once configured, the new SQS-based S3 input replaces the old Config input to collect Config data from the same SQS queue.
This documentation applies to the following versions of Splunk® Enterprise: 7.3.0, 7.3.1
Feedback submitted, thanks!