Skip to content

SagarBawanthade/InfraGuardian

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

5 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ›‘οΈ InfraGuardian

Typing SVG

Kubernetes monitoring and anomaly detection system

Version Kubernetes License PRs Welcome


🌟 Features

πŸ” Real-time Kubernetes Monitoring

  • Monitors Kubernetes Pods, Nodes, Events
  • Tracks pod health continuously (CrashLoopBackOff, Pending, ImagePull errors)
  • Fetches cluster events for issue detection
  • Works inside cluster for continuous monitoring (no port-forward needed)

πŸ“ˆ Prometheus Metrics & Insights

  • Prometheus-powered metrics collection
  • CPU / Memory / Network / Disk metrics support
  • Converts metrics into actionable analytics
  • Automated Prometheus setup using Helm (no manual installation)

πŸ€– Smart Problem Detection

  • Detects problematic workloads using pod status + events
  • Identifies restart loops, failed scheduling, image pull failures
  • Highlights frequently failing pods/services
  • Helps debugging faster with event-based reasoning

πŸ“Š Analytics Dashboard Ready

  • Metrics structured for dashboard integration
  • Supports Grafana dashboards via Prometheus datasource
  • Real-time + historical trend support
  • Can be extended to export insights/reports

πŸ”” Alert-Ready Architecture

  • Easily extendable to Slack / Email alerts
  • Can integrate Alertmanager for notifications
  • Suitable for SRE-style incident monitoring
  • Designed for cluster failure prevention

βš™οΈ Easy Deployment

  • Kubernetes manifests included (Deployment, Service, RBAC)
  • One-command Prometheus setup via Helm
  • Cluster-auth auto handled:
    • loadFromCluster() for in-cluster
    • loadFromDefault() for local testing
  • Production-ready approach for Kubernetes environments

πŸš€ Quick Start

Prerequisites

# Verify you have the required tools
kubectl version --client
helm version
git version
docker --version

Installation

πŸ“¦ Deploy with Helm (Recommended)
# 1. Clone the repository
git clone https://github.com/your-org/infraguardian.git
cd infraguardian

# 2. Install InfraGuardian
helm install infraguardian ./infraguardian

# 3. Verify installation
kubectl get all -n infraguardian

That's it! πŸŽ‰ InfraGuardian is now running in your cluster.

🐳 Custom Installation Options
# Install in specific namespace
helm install infraguardian ./infraguardian \
  --namespace monitoring \
  --create-namespace

# Install with custom values
helm install infraguardian ./infraguardian \
  -f custom-values.yaml

# Dry run to see what will be installed
helm install infraguardian ./infraguardian --dry-run --debug

πŸ—οΈ Architecture

graph TB
    subgraph "Kubernetes Cluster"
        A[InfraGuardian Core] --> B[Prometheus]
        A --> C[Kubernetes API]
        B --> D[Restarts]
        B --> E[kube-state-metrics]
        A --> F[Grafana]
        A --> G[Alert Manager]
        G --> H[Slack]
    end
    
    I[Users] --> A
    I --> F
    
    style A fill:#00d9ff,stroke:#333,stroke-width:3px,color:#000
    style B fill:#e6522c,stroke:#333,stroke-width:2px
    style F fill:#f46800,stroke:#333,stroke-width:2px
    style G fill:#ff6b6b,stroke:#333,stroke-width:2px
Loading

πŸ”§ Components

Component Description Technology
InfraGuardian Core Main monitoring engine Node.js + Express
Prometheus Metrics collection and storage Prometheus
Grafana Data visualization Grafana
Alert Manager Alert routing and management Prometheus AlertManager
Kubernetes API Cluster state monitoring Kubernetes

πŸ’‘ Usage Examples

Access the Dashboard

# Port forward to your local machine
kubectl port-forward -n infraguardian svc/infra-guardian-core 3000:3000

# Open in browser
open http://localhost:3000

View Logs

# Stream application logs
kubectl logs -f -n infraguardian -l app=infra-guardian-core

# View last 100 lines
kubectl logs -n infraguardian -l app=infra-guardian-core --tail=100

Scale Deployment

# Scale to 3 replicas
kubectl scale deployment infra-guardian-core -n infraguardian --replicas=3

# Verify scaling
kubectl get pods -n infraguardian

Update Configuration

# Update with new values
helm upgrade infraguardian ./infraguardian -f new-values.yaml

# Rollback if needed
helm rollback infraguardian

🎨 Technology Stack

Kubernetes
Kubernetes
Docker
Docker
Helm
Helm
Prometheus
Prometheus
Grafana
Grafana
Node.js
Node.js
Express
Express
React
React
JavaScript
JavaScript
MongoDB
MongoDB

🀝 Contributing

We love contributions! πŸŽ‰ Here's how you can help:

πŸ› Report Bugs

Found a bug? Open an issue with:

  • Clear description
  • Steps to reproduce
  • Expected vs actual behavior
  • Environment details
✨ Request Features

Have an idea? Open a feature request with:

  • Use case description
  • Proposed solution
  • Alternative approaches

πŸ’– Show Your Support

If you find InfraGuardian helpful, please consider:

⭐ Starring this repository
🐦 Sharing on social media
πŸ“ Writing a blog post
πŸ—£οΈ Speaking at meetups


Built with ❀️ by the InfraGuardian Team

⚑ Powered by Kubernetes | πŸ”₯ Monitored by Prometheus | πŸ“Š Visualized by Grafana

About

Kubernetes observability tool for pod/event monitoring and Prometheus-powered insights with automated Helm setup.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors