npm run publish-version
npm install @firestone-hs/aws-lambda-utilsbash
./test-aws-cli-paths.sh
`
2. Simple Setup (Recommended if encountering IAM issues):
`bash
./setup-s3-monitoring-simple.sh
`
_Skips CloudWatch integration to avoid IAM role complexity_
3. Full Automated Setup (with CloudWatch integration):
`bash
./setup-s3-monitoring.sh
`
4. If you encounter issues (Windows Git Bash path problems):
`bash
# Clean up existing resources and start fresh
./setup-s3-monitoring.sh --cleanup
`
5. Manual Setup (Windows PowerShell):
Follow the guide in MANUAL_SETUP_WINDOWS.md
$3
- ✅ CloudTrail with S3 data events for your buckets (xml.firestoneapp.com, static.zerotoheroes.com)
- ✅ CloudWatch Log Group for CloudTrail integration
- ✅ IAM Roles for CloudTrail → CloudWatch permissions
- ✅ Sample CloudWatch Insights queries to analyze S3 usage by Lambda function
$3
Navigate to CloudWatch → Insights and run queries like:
`cloudwatch-insights
fields @timestamp, userIdentity.invokedBy, eventName, resources.0.ARN
| filter eventName like /GetObject/
| filter userIdentity.type = "AssumedRole"
| filter userIdentity.invokedBy like /lambda/
| stats count() as request_count by userIdentity.invokedBy
| sort request_count desc
`
$3
`
userIdentity.invokedBy | request_count
lambda.amazonaws.com:my-data-processor-function | 15,247
lambda.amazonaws.com:my-backup-function | 8,932
lambda.amazonaws.com:my-analytics-function | 3,421
`
$3
- setup-s3-monitoring-simple.sh - Simple setup (no CloudWatch integration)
- setup-s3-monitoring.sh - Full automated setup script
- test-aws-cli-paths.sh - Environment compatibility test
- event-selectors.json - S3 buckets to monitor
- s3-monitoring-queries.md - Comprehensive monitoring guide
- MANUAL_SETUP_WINDOWS.md - Windows PowerShell setup guide
$3
- Setup time: ~10 minutes
- Monthly cost: ~\$2-5 (depends on request volume)
- Data availability: 15-30 minutes after setup
$3
- Trail already exists: Use ./setup-s3-monitoring.sh --cleanup
- IAM role errors: Use the simple version ./setup-s3-monitoring-simple.sh
- Windows path issues: Use MANUAL_SETUP_WINDOWS.md guide
- No data showing: Wait 30 minutes for CloudTrail to populate
$3
`bash
./setup-s3-monitoring.sh --help
``