Vitals brings enterprise-grade observability directly into Visual Studio Code. Monitor Prometheus, Jaeger, OpenTelemetry, Datadog, New Relic, AWS CloudWatch, Azure Monitor, and more - all from your editor.

Key Features

Incident Management & On-Call Workflows

• Automatic incident detection from alert thresholds
• One-click runbook automation (Kubernetes restarts, scaling, rollbacks)
• AI-powered post-mortem generation with root cause analysis
• PagerDuty/Opsgenie bi-directional sync for on-call coordination
• Hypothesis tracking with evidence collection timeline
• Team collaboration with MTTD, MTTA, MTTI, MTTR metrics

📖 Incident Management Guide

CI/CD Integration & Deployment Intelligence

• Auto-detect deployments from Git tags or manual tracking
• Statistical performance analysis (Welch's t-test) for regression detection
• Intelligent rollback recommendations with 4 deployment strategies
• Flaky test detection and CI pipeline optimization insights
• Feature flag integration (LaunchDarkly, Split.io, Unleash)
• Auto-generate release notes from commits and metrics

📖 CI/CD Integration Guide

Intelligent Automation

NEW: Closed-loop automation and predictive insights powered by historical learning.

• Automated Actions: Auto-rollback, Slack/PagerDuty alerts, custom webhooks
• Pattern Detection: "This service regresses every Friday" with statistical confidence
• Risk Assessment: Multi-factor deployment risk scoring (0-100)
• Deployment Windows: Optimal deployment time recommendations
• Metric Forecasting: Predict future performance trends
• Historical Storage: JSONL-based time-series storage for long-term analysis

📖 Automation Guide

Example Configuration:

automation:
  policies:
    - name: "Critical Regression Alert"
      trigger: regression_detected
      conditions:
        - field: change_percent
          operator: greater_than
          value: 20
      actions:
        - type: slack
          config:
            webhook_url: "${SLACK_WEBHOOK_URL}"
        - type: rollback
          config:
            webhook_url: "${ROLLBACK_WEBHOOK}"

Distributed Tracing & Performance Profiling

• Visual flame graphs and service dependency maps
• Database query analysis with N+1 detection
• Inline performance annotations via CodeLens
• Critical path analysis and regression detection
• Supports Jaeger, OpenTelemetry, Zipkin

📖 Distributed Tracing Guide

Multi-Cloud Observability

• Unified queries across Datadog, New Relic, AWS, Azure, Prometheus, Grafana
• Automatic query translation (PromQL, NRQL, KQL, etc.)
• Cost tracking and optimization recommendations
• Cross-platform correlation and anomaly detection

📖 Multi-Cloud Integration Guide

Real-Time Metrics & Logs

• Live charts for CPU, memory, latency, and custom metrics
• Streaming logs with syntax highlighting and filtering
• Alert management with VS Code notifications
• Auto-discovery of local Prometheus instances

Zero Configuration

• Works out-of-the-box with sensible defaults
• Theme-aware UI that adapts to VS Code
• Full keyboard navigation and accessibility

Installation

From VS Code Marketplace:

1. Open Extensions view (Ctrl+Shift+X)
2. Search for "Vitals"
3. Click Install

From CLI: code --install-extension theaniketraj.vitals

Quick Start

1. Install Prometheus (if needed): docker run -p 9090:9090 prom/prometheus
2. Open Command Palette: Ctrl+Shift+P → Vitals: Open Dashboard
3. Configure (optional): Set vitals.prometheusUrl in Settings

📖 Getting Started Guide

Configuration

Key settings (access via Ctrl+, → search "vitals"):

• vitals.prometheusUrl - Prometheus endpoint (default: http://localhost:9090)
• vitals.refreshInterval - Update frequency in ms (default: 5000)
• vitals.traceProvider - Tracing backend: jaeger, opentelemetry
• vitals.cloudProviders - Multi-cloud platform credentials

📖 Full Configuration Guide

Commands

Core Observability:

• Vitals: Open Dashboard - Open metrics, logs, and alerts view
• Vitals: Configure Trace Provider - Set up Jaeger/OpenTelemetry
• Vitals: Search Traces - Query distributed traces
• Vitals: View Service Map - Visualize service dependencies
• Vitals: Configure Cloud Provider - Add multi-cloud platforms

Incident Management:

• Vitals: Create Incident - Create incident from alert or manually
• Vitals: View Incidents - Browse active incidents
• Vitals: Execute Runbook - Run automated remediation playbooks
• Vitals: Generate Post-Mortem - Create AI-powered incident reports
• Vitals: Configure Incident Integrations - Set up PagerDuty/Slack/Teams

CI/CD Intelligence:

• Vitals: Track Deployment - Register deployment with metadata
• Vitals: Analyze Deployment Impact - Statistical performance analysis
• Vitals: Rollback Deployment - Execute intelligent rollback
• Vitals: View Build Trends - CI pipeline optimization insights
• Vitals: Connect Feature Flag Provider - Integrate LaunchDarkly/Split.io
• Vitals: Generate Release Notes - Auto-generate from commits

Automation & Intelligence:

• Vitals: Execute Automation - Run automation policies on regression detection
• Vitals: Detect Patterns - Run pattern detection on historical data
• Vitals: Assess Deployment Risk - Calculate deployment risk score
• Vitals: Recommend Deployment Windows - Find optimal deployment times
• Vitals: Forecast Metrics - Generate predictive metric forecasts
• Vitals: View Historical Data - Browse stored regression history

📖 Full API Reference | Automation Guide

Architecture

Vitals uses a modular architecture with TypeScript, React, and VS Code's Webview API.

📖 System Architecture | Project Structure

Development

git clone https://github.com/theaniketraj/vitals.git
cd vitals
npm install
npm run watch  # Start dev mode
# Press F5 in VS Code to launch Extension Development Host

📖 Development Guide | Testing Guide

Contributing

Contributions welcome! Fork the repo, create a feature branch, and open a PR.

📖 Contributing Guide

Roadmap

• ✅ Prometheus, Jaeger, OpenTelemetry integration
• ✅ Multi-cloud support (Datadog, New Relic, AWS, Azure)
• ✅ Distributed tracing and flame graphs
• ✅ Intelligence Layer - Closed-loop automation and historical learning
• 🔄 Custom dashboards and saved queries
• ⏳ VITALS-Owned Data - Regression database, incident knowledge graph

Troubleshooting

Can't connect to Prometheus?

• Verify Prometheus is running: curl http://localhost:9090/api/v1/status/config
• Check vitals.prometheusUrl setting

No metrics displayed?

• Confirm Prometheus has active targets: http://localhost:9090/targets

📖 Troubleshooting Guide | Open an Issue

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Prometheus - Monitoring system and time series database
• Recharts - Charting library for React
• VS Code Extension API - Extensibility platform

Support

• 📖 Documentation
• 🐛 Report Issues
• 💬 Discussions

If Vitals helps you, consider ⭐ starring the repo!

Built with ❤️ by Aniket Raj

Vitals - Real-time Observability for Modern Developers