Skip to content

Repository files navigation

☁️ CloudSight-Analyzer – Intelligent Cloud Infrastructure Monitoring & Analysis

CloudSight-Analyzer is an AI-powered cloud infrastructure monitoring, optimization, and security analysis platform for multi-cloud environments.
Real-time visibility into AWS, Azure, GCP, and hybrid cloud deployments with predictive analytics and intelligent automation.


πŸ”Ž Overview

Managing multi-cloud infrastructure is complex. Organizations struggle with:

  • Fragmented visibility across multiple cloud providers
  • Cost inefficiency due to unoptimized resources
  • Security blind spots from misconfigured services
  • Performance degradation without real-time monitoring
  • Compliance gaps across hybrid environments

CloudSight-Analyzer solves these challenges by providing a unified, intelligent platform that:

  • Aggregates metrics from AWS, Azure, and GCP in real-time
  • Uses machine learning to detect anomalies and optimization opportunities
  • Provides automated cost recommendations and compliance checking
  • Offers predictive insights for capacity planning
  • Enables proactive alerting and incident response

✨ Key Features

🌐 Multi-Cloud Integration

  • Native Support: AWS, Azure, Google Cloud Platform, hybrid deployments
  • Unified Dashboard: Single pane of glass for all cloud resources
  • Cross-Cloud Analytics: Correlate metrics across providers
  • API Abstraction: Unified API layer for heterogeneous cloud APIs

🧠 AI-Powered Analytics

  • Anomaly Detection: ML models identify unusual patterns in resource usage
  • Predictive Analytics: Forecast future resource demand and costs
  • Intelligent Alerting: Context-aware alerts reduce noise
  • Root Cause Analysis: AI-driven insights into performance issues

πŸ’° Cost Optimization

  • Real-Time Cost Tracking: Track spending across all cloud services
  • Right-Sizing Recommendations: Identify over/under-provisioned resources
  • Reserved Instance Optimization: Suggest best RIs/savings plans
  • Cost Anomaly Detection: Alert when spending deviates from baseline
  • Chargeback & Allocation: Attribute costs to business units/projects

πŸ” Security & Compliance

  • Misconfig Detection: Identify security group, IAM, and network issues
  • Compliance Scanning: Check against CIS, NIST, ISO 27001, PCI-DSS
  • Vulnerability Assessment: Detect exposed resources and weak policies
  • Audit Trail: Complete logging of all configurations and changes
  • Auto-Remediation: Automated fixes for common security issues

πŸ“Š Performance Monitoring

  • Real-Time Metrics: CPU, memory, disk, network from all cloud instances
  • Custom Dashboards: Build visualizations tailored to your needs
  • Distributed Tracing: Trace requests across microservices
  • Log Aggregation: Centralized logging from all cloud services
  • Alert Management: Configurable thresholds and escalation policies

⚑ Operational Intelligence

  • Resource Inventory: Comprehensive asset catalog across clouds
  • Dependency Mapping: Visualize relationships between resources
  • Capacity Planning: Forecast infrastructure needs
  • Scalability Analytics: Identify bottlenecks in auto-scaling groups
  • Patch Management: Track updates and compliance status

πŸ—οΈ Architecture

High-level architecture of CloudSight-Analyzer:

flowchart TD
    A[User Uploads Cloud Logs or Data] --> B[Frontend Dashboard Interface]
    
    B --> C[Input Validation Layer]
    C --> D[API Request to Backend]
    
    D --> E[Backend Server]
    E --> F[Data Preprocessing Module]
    
    F --> G[Cloud Analysis Engine]
    
    G --> H[Pattern Detection Module]
    G --> I[Anomaly Detection Module]
    G --> J[Statistical Analysis Module]
    
    H --> K[Insight Generation Engine]
    I --> K
    J --> K
    
    K --> L[Structured Analysis Results]
    
    L --> M[Database Storage]
    M --> N[Analysis Metadata Records]
    
    L --> O[JSON Response to Frontend]
    
    O --> P[Visualization Layer]
    P --> Q[Charts and Graphs]
    P --> R[Risk and Insight Panels]
    P --> S[Interactive Analytics Dashboard]
Loading

πŸ“ Project Structure

Clean, modular organization for CloudSight-Analyzer:

CloudSight-Analyzer/
β”œβ”€ README.md
β”œβ”€ LICENSE
β”œβ”€ requirements.txt
β”œβ”€ docker-compose.yml
β”œβ”€ Dockerfile
β”œβ”€ .dockerignore
β”‚
β”œβ”€ cloudsight_analyzer/
β”‚  β”œβ”€ __init__.py
β”‚  β”œβ”€ config.py              # Configuration management
β”‚  β”œβ”€ utils/
β”‚  β”‚  β”œβ”€ logger.py
β”‚  β”‚  β”œβ”€ decorators.py
β”‚  β”‚  β”œβ”€ validators.py
β”‚  β”‚  └─ helpers.py
β”‚  β”‚
β”‚  β”œβ”€ cloud/
β”‚  β”‚  β”œβ”€ base.py             # Abstract cloud provider class
β”‚  β”‚  β”œβ”€ aws_provider.py      # AWS integration
β”‚  β”‚  β”œβ”€ azure_provider.py    # Azure integration
β”‚  β”‚  β”œβ”€ gcp_provider.py      # GCP integration
β”‚  β”‚  └─ provider_factory.py  # Factory pattern for providers
β”‚  β”‚
β”‚  β”œβ”€ collectors/
β”‚  β”‚  β”œβ”€ base_collector.py
β”‚  β”‚  β”œβ”€ metrics_collector.py # CPU, memory, disk, network
β”‚  β”‚  β”œβ”€ cost_collector.py    # Billing and cost data
β”‚  β”‚  β”œβ”€ security_collector.py # Security and compliance
β”‚  β”‚  └─ scheduler.py         # Orchestrate collections
β”‚  β”‚
β”‚  β”œβ”€ storage/
β”‚  β”‚  β”œβ”€ timeseries_db.py    # InfluxDB / Prometheus
β”‚  β”‚  β”œβ”€ document_db.py      # MongoDB for metadata
β”‚  β”‚  β”œβ”€ cache.py            # Redis caching
β”‚  β”‚  └─ migrations.py       # Database versioning
β”‚  β”‚
β”‚  β”œβ”€ analytics/
β”‚  β”‚  β”œβ”€ anomaly_detector.py # ML-based anomaly detection
β”‚  β”‚  β”œβ”€ cost_optimizer.py   # Cost analysis & recommendations
β”‚  β”‚  β”œβ”€ compliance_checker.py # CIS, NIST, ISO checks
β”‚  β”‚  β”œβ”€ predictor.py        # Time-series forecasting
β”‚  β”‚  └─ models/             # Pre-trained ML models (.pkl, .h5)
β”‚  β”‚
β”‚  β”œβ”€ api/
β”‚  β”‚  β”œβ”€ main.py             # FastAPI application
β”‚  β”‚  β”œβ”€ schemas.py          # Pydantic models
β”‚  β”‚  β”œβ”€ routes/
β”‚  β”‚  β”‚  β”œβ”€ clouds.py        # Cloud provider endpoints
β”‚  β”‚  β”‚  β”œβ”€ resources.py     # Resource management
β”‚  β”‚  β”‚  β”œβ”€ metrics.py       # Metrics & monitoring
β”‚  β”‚  β”‚  β”œβ”€ costs.py         # Cost analysis
β”‚  β”‚  β”‚  β”œβ”€ security.py      # Security & compliance
β”‚  β”‚  β”‚  β”œβ”€ alerts.py        # Alert management
β”‚  β”‚  β”‚  β”œβ”€ reports.py       # Report generation
β”‚  β”‚  β”‚  └─ health.py        # System health checks
β”‚  β”‚  β”‚
β”‚  β”‚  └─ auth/
β”‚  β”‚     β”œβ”€ jwt_handler.py
β”‚  β”‚     └─ permissions.py
β”‚  β”‚
β”‚  β”œβ”€ integrations/
β”‚  β”‚  β”œβ”€ slack_notifier.py
β”‚  β”‚  β”œβ”€ teams_notifier.py
β”‚  β”‚  β”œβ”€ email_sender.py
β”‚  β”‚  β”œβ”€ webhook_dispatcher.py
β”‚  β”‚  └─ siem_connector.py  # SIEM (Splunk, ELK) integration
β”‚  β”‚
β”‚  └─ dashboard/             # (Optional) Streamlit/React frontend
β”‚     └─ app.py
β”‚
β”œβ”€ tests/
β”‚  β”œβ”€ unit/
β”‚  β”‚  β”œβ”€ test_aws_provider.py
β”‚  β”‚  β”œβ”€ test_metrics_collector.py
β”‚  β”‚  β”œβ”€ test_anomaly_detector.py
β”‚  β”‚  └─ test_cost_optimizer.py
β”‚  β”‚
β”‚  └─ integration/
β”‚     └─ test_api_endpoints.py
β”‚
β”œβ”€ experiments/
β”‚  β”œβ”€ notebooks/             # Jupyter exploration
β”‚  β”‚  β”œβ”€ cost_analysis.ipynb
β”‚  β”‚  β”œβ”€ anomaly_tuning.ipynb
β”‚  β”‚  └─ compliance_audit.ipynb
β”‚  β”‚
β”‚  └─ results/               # Experiment reports
β”‚
└─ data/
   β”œβ”€ raw/                   # Raw cloud API responses (ignored)
   β”œβ”€ processed/             # Cleaned & enriched data
   └─ models/                # ML model artifacts

☁️ Supported Cloud Platforms

Amazon Web Services (AWS)

  • Services Monitored: EC2, RDS, S3, Lambda, DynamoDB, ECS, EKS, ALB/NLB, CloudFront, and 200+
  • Metrics: CPU, memory, disk I/O, network, application-specific
  • Cost: Track EC2, RDS, S3, Lambda, compute costs with detailed breakdowns
  • Security: IAM policies, security groups, VPC configuration, S3 bucket policies
  • Compliance: CIS AWS Foundations Benchmark, PCI-DSS, HIPAA, SOC 2

Microsoft Azure

  • Services Monitored: VMs, App Services, SQL Database, Cosmos DB, AKS, Functions, Storage
  • Metrics: CPU %, available memory, disk I/O, network throughput
  • Cost: Azure consumption-based billing analysis, reserved instance optimization
  • Security: Network security groups, IAM roles, encryption status, key vault audit
  • Compliance: CIS Azure Foundations, ISO 27001, NIST

Google Cloud Platform (GCP)

  • Services Monitored: Compute Engine, GKE, Cloud SQL, Firestore, Cloud Storage, Cloud Functions
  • Metrics: VM metrics via Monitoring API, application performance
  • Cost: BigQuery-based cost analysis, commitment discounts
  • Security: IAM bindings, VPC firewall rules, bucket ACLs
  • Compliance: CIS GCP Foundations, PCI-DSS, ISO compliance tracking

Hybrid & Multi-Cloud

  • On-Premises Integration: Connect physical servers and VMs
  • Cross-Cloud Analytics: Correlate metrics and costs across providers
  • Unified Billing: Single pane of glass for all infrastructure costs

πŸš€ Installation & Setup

πŸ“‹ Prerequisites

Make sure the following are installed:

  • Node.js (v18 or later recommended)
  • npm (included with Node.js)
  • Git (optional, for cloning the repository)
  • Docker & Docker Compose (optional, for containerized deployment)

πŸ“¦ Installation

Clone the repository and install all required dependencies.

git clone <repository-url>
cd CloudSight-Analyzer
npm install

Note: Since this is a unified full-stack project, the root package.json installs both frontend and backend dependencies.


▢️ Run in Development Mode

Start both the React frontend and Express backend simultaneously.

npm run dev

Running Services

Service URL
🌐 Frontend (Vite) http://localhost:5173
βš™οΈ Backend API http://localhost:3000
❀️ Health Check http://localhost:3000/api/health

The development server includes:

  • ⚑ Hot Module Replacement (HMR) for React
  • πŸ”„ Automatic backend restart with Nodemon
  • πŸš€ Concurrent frontend and backend execution

πŸ—οΈ Build for Production

Generate an optimized production build.

npm run build

Preview the production build locally:

npm run preview

βš™οΈ Environment Variables

The application works out of the box with sensible defaults.

Create a .env file in the project root if you wish to customize the configuration.

PORT=3000
API_URL=/api
Variable Default Description
PORT 3000 Backend server port
API_URL /api Base API endpoint

🐳 Running with Docker

Build and start the application using Docker Compose.

docker-compose up -d --build

🌍 Access the Application

After the containers have started:

Service URL
🌐 Frontend Dashboard http://localhost:5173
βš™οΈ Backend API http://localhost:3000
❀️ API Health Check http://localhost:3000/api/health

πŸ“œ View Container Logs

Monitor application logs in real time.

docker-compose logs -f

πŸ›‘ Stop the Containers

docker-compose down

πŸ”„ Rebuild Containers

If dependencies or configuration change:

docker-compose up -d --build

πŸ“ Project Workflow

Clone Repository
        β”‚
        β–Ό
   npm install
        β”‚
        β–Ό
    npm run dev
        β”‚
        β”œβ”€β”€β”€β”€β”€β”€β”€β”€β–Ί Frontend β†’ http://localhost:5173
        β”‚
        └────────► Backend  β†’ http://localhost:3000
                           β”‚
                           └── Health Check β†’ /api/health

🐳 Create the .dockerignore File

Create a file named .dockerignore in the root directory of the project and add the following contents:

node_modules
dist
.env
.git
.gitignore
.idx
README.md

This file prevents unnecessary files and folders from being copied into the Docker build context, resulting in faster builds and smaller Docker images.


πŸ“Š API Endpoints

Method Endpoint Description
GET /api/v1/clouds List configured clouds
POST /api/v1/clouds Register new cloud provider
GET /api/v1/clouds/{id}/resources List cloud resources
GET /api/v1/metrics Fetch time-series metrics
POST /api/v1/metrics/search Advanced metric search
GET /api/v1/costs/summary Cost overview
GET /api/v1/costs/recommendations Optimization recommendations
POST /api/v1/security/scan Run security scan
GET /api/v1/compliance/status Compliance status
POST /api/v1/alerts/configure Set up alerts
GET /api/v1/reports/list List available reports
POST /api/v1/reports/generate Generate custom report
GET /api/v1/health System health check

πŸ“Š Monitoring Dashboards

Grafana Integration

CloudSight-Analyzer includes pre-built Grafana dashboards:

  • Cloud Overview: High-level metrics from all providers
  • Cost Analytics: Spending trends, forecasting, recommendations
  • Security Posture: Compliance status, vulnerabilities, misconfigurations
  • Performance Metrics: CPU, memory, disk, network utilization
  • Capacity Planning: Resource forecasts and trends

Custom Dashboards

# Access Grafana
http://localhost:3000

# Default credentials
username: admin
password: admin

# Import CloudSight dashboards from:
/grafana/dashboards/

πŸ› οΈ Tech Stack

Category Technologies
Core Language TypeScript
Frontend Framework React 18
Build Tool Vite
Routing React Router (react-router-dom)
Styling Tailwind CSS
UI Components shadcn/ui, Radix UI
Icons Lucide React
Theme Management Next Themes
State Management & Data Fetching SWR
Forms React Hook Form
Validation Zod, @hookform/resolvers
Charts & Analytics Recharts
Animations Framer Motion
Carousel Embla Carousel
Date & Calendar date-fns, React Day Picker
Backend Runtime Node.js
Backend Framework Express.js
Development Server tsx, Nodemon
Middleware CORS, Dotenv
Development Tools Concurrently
Code Quality ESLint
CSS Processing PostCSS, Autoprefixer
Package Manager npm
Version Control Git, GitHub


πŸ“ˆ Analytics & Reporting

Available Reports

  1. Executive Summary

    • High-level KPIs
    • Cost overview and trends
    • Security posture
    • Top recommendations
  2. Cost Analysis

    • Detailed cost breakdown by service
    • Month-over-month comparison
    • Right-sizing opportunities
    • Reserved instance savings
  3. Security & Compliance

    • Compliance status against frameworks
    • Vulnerabilities and misconfigurations
    • Remediation status
    • Audit trail
  4. Performance Report

    • Resource utilization metrics
    • Bottleneck identification
    • Scalability analysis
    • Recommendations

⚑ Performance Optimization

Scaling Considerations

# docker-compose.yml - Production configuration
version: '3.9'
services:
  cloudsight-api:
    image: cloudsight-analyzer:latest
    deploy:
      replicas: 3
      resources:
        limits:
          cpus: '2'
          memory: 4G
    environment:
      - WORKERS=4
      - DATABASE_POOL_SIZE=20

  influxdb:
    image: influxdb:2.7
    volumes:
      - influxdb-storage:/var/lib/influxdb2
    environment:
      - INFLUXDB_DB_RETENTION=30d

  postgres:
    image: postgres:15-alpine
    environment:
      - POSTGRES_MAX_CONNECTIONS=200

  redis:
    image: redis:7-alpine
    command: redis-server --maxmemory 2gb --maxmemory-policy allkeys-lru

Query Optimization

  • Caching: Redis caches frequently accessed metrics
  • Batch Processing: Bulk inserts for time-series data
  • Index Strategy: Optimized database indexes for common queries
  • Aggregation: Pre-computed hourly/daily summaries

About

It is an AI-driven cloud and log intelligence platform that analyzes system logs, detects anomalies, and visualizes security insights to help identify threats, suspicious activities, and cloud infrastructure vulnerabilities through an interactive dashboard.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages