How to Enable AWS CloudTrail: Step-by-Step Guide
To enable
AWS CloudTrail, create a trail that records account activity and stores logs in an S3 bucket. You can enable it via the AWS Management Console or AWS CLI by specifying a trail name and S3 bucket for log storage.Syntax
Use the AWS CLI command aws cloudtrail create-trail to enable CloudTrail. You must provide a trail name and an S3 bucket name where logs will be saved. Optionally, you can specify if the trail applies to all regions.
bash
aws cloudtrail create-trail --name <TrailName> --s3-bucket-name <BucketName> [--is-multi-region-trail]
Example
This example creates a CloudTrail trail named MyTrail that logs events from all AWS regions and stores them in the S3 bucket my-cloudtrail-logs-bucket.
bash
aws cloudtrail create-trail --name MyTrail --s3-bucket-name my-cloudtrail-logs-bucket --is-multi-region-trail aws cloudtrail start-logging --name MyTrail
Output
{
"Name": "MyTrail",
"S3BucketName": "my-cloudtrail-logs-bucket",
"IsMultiRegionTrail": true
}
Common Pitfalls
- Not creating or specifying an existing S3 bucket before enabling CloudTrail causes errors.
- Forgetting to start logging after creating the trail means no events are recorded.
- Not enabling multi-region trails can miss activity in other regions.
bash
aws cloudtrail create-trail --name MyTrail --s3-bucket-name my-cloudtrail-logs-bucket # Missing start-logging command means no logs are captured # Correct way: aws cloudtrail start-logging --name MyTrail
Quick Reference
Remember these key points when enabling CloudTrail:
- Create or use an existing S3 bucket for logs.
- Use
create-trailto define the trail. - Use
start-loggingto begin capturing events. - Enable multi-region trails to cover all AWS regions.
Key Takeaways
Create a trail with a unique name and specify an S3 bucket to store logs.
Always start logging after creating the trail to capture events.
Enable multi-region trails to monitor activity across all AWS regions.
Ensure the S3 bucket exists and has proper permissions before creating the trail.