This topic provides an overview of the AWS collection configuration parameters for deploying a remote log collection service (VLC) in an Amazon Web Services (AWS) environment.
This workflow illustrates the basic tasks needed to start collecting events through Log Collection.
|Role||I want to...||Documentation|
Perform basic Log Collection implementation.
|Administrator||Set up a lockbox to maintain lockbox settings.||Set Up a Lockbox|
Start Log Collection services.
|Administrator||*Configure Log Collection protocols and event sources.||Configure Collection Protocols and Event Sources|
Verify that Log Collection is working.
*You can perform this task here.
The following table describes the available configuration parameter for AWS collection.
|Name *||Name of the event source.|
|Enabled||Select the check box to enable the event source configuration to start collection. The check box is selected by default.|
|Account Id *||Account Identification code of the S3 Bucket|
|S3 Bucket Name *|| |
Name of the AWS (CloudTrail) S3 bucket.
Amazon S3 bucket names are globally unique, regardless of the AWS (CloudTrail) region in which you create the bucket. You specify the name at the time you create the bucket.
Bucket names should comply with DNS naming conventions. The rules for DNS-compliant bucket names are:
The following examples are valid bucket names:
The following examples are invalid bucket names:
|Access Key *||Key used to access the S3 bucket. Access Keys are used to make seure REST or Query protocol requests to any AWS service API. Please refer to Manage User Credentials on the Amazon Web Services support site for more information on Access Keys.|
|Secret Key *||Secret key used to access the S3 bucket.|
|Region *||Region of the S3 bucket. us-east-1 is the default value.|
|Region Endpoint||Specifies the AWS CloudTrail hostname. For example, for an AWS public cloud for us-east region, the Region Endpoint would be s3.amazonaws.com. More information can be found at http://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region. This parameter is necessary to collect CloudTrail logs from AWS Government or Private clouds.|
Enable Use Proxy to set proxy for AWS server. By default, it is disabled.
Enter the proxy name you want to connect to access the AWS server.
Enter the port number that connects to the proxy server to access the AWS
Enter the user name to authenticate with the proxy server.
Enter the password to authenticate with proxy port.
|Start Date *||Starts AWS (CloudTrail) collection from the specified number of days in the past, measured from the current timestamp. The default value is 0, which starts from today. The range is 0–89 days.|
|Log File Prefix|| |
Prefix of the files to be processed.
Enables or disables debug logging for the event source.
Valid values are:
This parameter is designed to debug and monitor isolated event source collection issues. The debug logging is verbose, so limit the number of event sources to minimize performance impact.
If you change this value, the change takes effect immediately (no restart required).
|Command Args||Arguments added to the script.|
|Polling Interval||Interval (amount of time in seconds) between each poll. The default value is 60.|
For example, if you specify 60, the collector schedules a polling of the event source every 60 seconds. If the previous polling cycle is still underway, it will wait for it to finish that cycle. If you have a large number of event sources that you are polling, it may take longer than 60 seconds for the polling to start because the threads are busy.
|SSL Enabled|| |
Select the check box to communicate using SSL. The security of data transmission is managed by encrypting information and providing authentication with SSL certificates.
The check box is selected by default.
|Test Connection||Validates the configuration parameters specified in this dialog are correct. For example, this test validates that: |
|Cancel||Closes the dialog without adding the AWS (CloudTrail).|
|OK||Adds the current parameter values as a new AWS (CloudTrail).|