LambdaClean: FinOps Cloud Resource Cleanup System

An automated serverless solution for identifying and cleaning up idle AWS resources to optimize cloud costs.

🏆 AWS Lambda Hackathon Submission

🎥 Video Demonstration

📹 Watch Our 3-Minute Demo

Dashboard	Resource Chart	Resource Summary

⚡ How This Application Uses AWS Lambda

This FinOps system is built entirely on serverless AWS Lambda architecture with three specialized functions that demonstrate the power and flexibility of Lambda:

💡 Why Lambda is Perfect for FinOps

• Variable Workloads: FinOps scanning has unpredictable peaks
• Cost Efficiency: Pay only for actual analysis time
• Rapid Scaling: Handle enterprise AWS accounts with thousands of resources
• Zero Maintenance: Focus on business logic, not infrastructure
• Built-in Reliability: AWS handles availability and fault tolerance

📊 Lambda Function Specifications:

Function	Memory	Timeout	Trigger	Purpose
Scanner	256MB	60s	EventBridge (cron)	Resource discovery
Analysis	128MB	10s	DynamoDB Streams	Risk assessment
API	128MB	20s	API Gateway	Dashboard backend

🔧 System Components:

• scanner/ - Scheduled Lambda function for resource discovery
• analysis/ - Event-driven Lambda for intelligent risk scoring
• api/ - HTTP Lambda providing RESTful dashboard API
• frontend/ - Modern responsive web dashboard
• template.yaml - Complete SAM infrastructure definition

---

🚀 Quick Start

1. Deploy Infrastructure

   sam build --use-container
   sam deploy --guided

2. Configure Frontend

   # Update API URL in frontend/app.js
   # Set isDemo = false

3. Access Dashboard

   • Open frontend/index.html in browser
   • View idle resources and cleanup opportunities

📚 Documentation

Complete Technical Documentation

Comprehensive technical documentation is organized in docs/technical/:

• 📋 Documentation Index - Start here for navigation
• 🏗️ System Architecture - System design and AWS integration
• 🚀 Deployment Guide - Step-by-step deployment instructions
• 🔌 API Reference - Complete API documentation with examples
• ⚖️ Algorithms & Logic - Scanning, scoring, and cost calculations
• 🔐 Security & Compliance - IAM policies, encryption, and audit trails
• 📊 Monitoring & Operations - CloudWatch, alerting, and troubleshooting

Quick Reference Guides

• Implementation Summary - Project status and what's built
• Original Project Brief - Problem statement and solution overview

📊 Monitoring

CloudWatch Integration

• Lambda Metrics: Duration, errors, invocations
• Business Metrics: Resources found, cost savings
• Custom Dashboards: Executive and operational views
• Automated Alarms: System health and high-value alerts

Available Endpoints

• GET /dashboard - Summary metrics and trends
• GET /resources - Detailed resource listing with filters
• POST /cleanup - Resource cleanup actions
• POST /scan - Manual scan trigger

✅ List of AWS Tools Used

Primary Services:

1. AWS Lambda - 3 serverless functions (Scanner, Analysis, API)
2. Amazon DynamoDB - Data storage with Streams
3. Amazon API Gateway - RESTful API endpoints
4. Amazon EventBridge - Scheduled job execution
5. Amazon SNS - Notifications and alerts
6. Amazon CloudWatch - Monitoring and metrics
7. AWS IAM - Security and access control
8. AWS Cost Explorer API - Cost calculations
9. Amazon EC2 API - Instance discovery
10. Amazon RDS API - Database monitoring
11. Amazon EBS API - Volume analysis
12. AWS SAM - Infrastructure as Code
13. AWS CloudFormation - Deployment engine
14. AWS Application Insights - Automated monitoring

---