sudiviz 1.5.2

Sufficient visibility into cloud infrastructure failures — live AWS topology + Terraform drift in one CLI.

🔬 sudiviz

X-ray vision for your cloud infrastructure

sudiviz visualizes your live AWS infrastructure as an interactive graph — across multiple regions. Auto-detects misconfigurations, unhealthy targets, and orphan resources — then fixes them with one command.

🚀 Zero AI tokens | 💸 Zero cost | 🐍 Pure Python | 🌍 Multi-region

---

📦 Quick Start

pip install 'sudiviz[all]'

# Diagnose your infrastructure
sudiviz diagnose

# Interactive web visualization
sudiviz graph --output web --open

# Auto-fix issues
sudiviz fix --apply

Auth: Uses standard boto3 credentials (~/.aws/credentials, env vars, SSO, or instance profile)

---

✨ Features

Feature	Description
Live Topology	Real-time graph of ALB → Target Groups → EC2 → Security Groups
AWS Resource Icons	Each node displays a colour-coded AWS-style icon (ALB, EC2, RDS, S3, ECS, EKS, Lambda, SG…)
Multi-Region	Switch between AWS regions (us-east-1, us-west-2, eu-west-1, ap-northeast-1…) from a dropdown — no restart needed
Health Detection	Unhealthy targets, failing health checks, orphan resources
Auto-Fix	One-click remediation with sudiviz fix --apply
Traffic Animation	Visualize request flow with animated pulses
Health Heatmaps	Color-code infrastructure by health status
Cost Heatmap	FinOps view — visualize estimated monthly costs per resource
Security Group Flows	Visualize ingress/egress rules between security groups (blue = ingress, purple = egress)
CloudWatch Integration	One-click links to metrics and logs for each resource
Dark/Light Mode	Toggle theme in web UI
Cluster Grouping	Group resources by service type (Load Balancers, ECS, Security, etc.)
Terraform Drift	Compare live AWS vs Terraform state
Multi-Service	ALB, EC2, ECS, EKS, RDS, Lambda, S3, Security Groups

---

🎨 Visualization Modes

Terminal

sudiviz diagnose --region us-east-1

TUI (Interactive Terminal)

sudiviz tui

Web (Cytoscape.js)

sudiviz graph --output web --port 8000 --open

# Specify a default region (switch regions live from the UI dropdown)
sudiviz graph --output web --region us-east-1 --port 8000 --open

PNG Export

sudiviz graph --output png --file topology.png

---

🔧 Auto-Fix

sudiviz fix                    # Preview fixes (dry-run)
sudiviz fix --apply            # Apply all fixes
sudiviz fix 1 --apply          # Apply specific fix
sudiviz fix --apply --force    # Include destructive operations

Supported fixes:

• Security group missing ingress rules
• S3 public access / encryption
• RDS public accessibility
• Orphan target groups (with --force)
• Unused security groups (with --force)

---

🔒 Security

sudiviz is built with security in mind. Every release is scanned for vulnerabilities.

Check	Status
Bandit SAST	✅ No issues
XSS Protection	✅ HTML sanitization enabled
Dependency CVEs	✅ All patched
Hardcoded Secrets	✅ None
Shell Injection	✅ No shell=True
Code Injection	✅ No eval()

Run security scan locally:

pip install bandit[toml]
bandit -c pyproject.toml -r sudiviz/

---

🔄 Terraform Drift

terraform show -json > tfstate.json
sudiviz drift --tfstate tfstate.json

---

📊 CI Integration

# Fail CI on critical issues
sudiviz diagnose --json | jq '.diagnosis.fixes[] | select(.severity=="critical")'

# Drift detection gate
sudiviz drift --tfstate tfstate.json --json

Exit Code	Meaning
0	No issues
1	Drift detected
2	Critical issues found

---

📸 More Screenshots

Click to expand

AWS Resource Icons + Multi-Region Topology

Each node shows a colour-coded AWS icon. Switch regions live from the dropdown in the top bar (us-east-1, us-east-2, eu-west-1, us-west-2 and more).

Security Group Ingress/Egress Flows (Dark Mode)

Terminal TUI

Diagnose Output

Auto-Fix Preview

Traffic Flow Animation (Dark Mode)

Health Heatmap

Cluster Grouping (Dark Mode)

Cost Heatmap (FinOps)

---

🆚 Comparison

Feature	sudiviz	Hava.io	Cloudcraft
Live data	✅	❌	❌
AWS resource icons	✅	✅	✅
Multi-region switcher	✅	✅	✅
Auto-fix	✅	❌	❌
Traffic animation	✅	❌	❌
Health heatmaps	✅	❌	❌
Cost heatmap	✅	❌	❌
Cluster grouping	✅	❌	❌
Terraform drift	✅	❌	❌
Orphan detection	✅	❌	❌
Free & open source	✅ GPL-3.0	$29/mo	$49/mo

---

🔐 IAM Permissions

Read-only (sudiviz diagnose):

• ReadOnlyAccess AWS managed policy

Write (sudiviz fix --apply):

• AmazonEC2FullAccess
• ElasticLoadBalancingFullAccess
• AmazonS3FullAccess
• AmazonRDSFullAccess

---

📖 Documentation

AWS Services Discovered

Service	What's collected
ALB / NLB	Load balancers, listeners, rules
Target Groups	Health status per target
EC2	State, IPs, security groups
Security Groups	Ingress/egress rules
ECS	Clusters, services, task counts
EKS	Clusters, node groups
RDS	Instances, encryption, public access
Lambda	Functions, VPC config
S3	Buckets, encryption, public access

Diagnostic Rules

Check	Severity
Unhealthy targets	critical
SG missing port from ALB	critical
S3 public access open	critical
RDS publicly accessible	warning
Storage not encrypted	warning
Orphan target group	warning
Unused security group	info

Architecture

sudiviz/
├── cli.py           # Typer commands
├── tui.py           # Textual TUI
├── web.py           # FastAPI + WebSocket
├── discovery/       # AWS discovery (boto3)
├── graph/           # NetworkX + analyzers
├── remediation/     # Auto-fix engine
└── web_templates/   # Cytoscape.js UI

---

📝 License

GPL-3.0-or-later — see LICENSE

---

Built by @pydevsg