ServerPulse
AI-powered service monitoring for VS Code. ServerPulse monitors Django, Node.js, Docker, and other web services directly from your editor, with optional AI-assisted error analysis to help you understand why errors happen and what to do next.
Website: serverpulse.cloud | Plans: View Pricing | Terms: Terms of Service | Privacy: Privacy Policy
Features
🚀 AI-Powered Error Analysis (New in 2.0.0)
ServerPulse AI provides intelligent error analysis directly in VS Code:
- Automatic traceback & log analysis for detected errors
- Actionable explanations, not generic advice
- Framework-aware insights (Django, Node.js, Docker, etc.)
- Evidence-based reasoning that references specific log lines
- Confidence scoring (high / medium / low) to communicate certainty
- Three analysis modes: Manual, Smart (auto for high-confidence errors), or Aggressive (auto for all eligible errors)
AI analysis is strictly opt-in and disabled by default. View plans and usage limits
Core Monitoring Features
- Auto-Detection: Automatically finds Django, Node.js, Docker Compose services, and Dockerfiles
- Real-Time Status: Visual status bar showing service state (Starting, Ready, Error, Stopped)
- Log Monitoring: Detects errors, tracebacks, and state changes from application logs
- Intelligent Error Recovery: Auto-recovers from handled errors after configurable timeout, preserving error messages for visibility
- Smart Pattern Matching: Word boundaries and context-aware patterns prevent false positives (e.g., "Building Knowledge graph" won't trigger state changes)
- Docker Support: Monitor containers, start/stop services, automatic service name detection. Supports both Docker Compose and standalone Dockerfiles
- Interactive Control: Click status bar to start/stop services
- Health Checks: TCP port and HTTP endpoint monitoring with adaptive intervals
- Pattern Customization: Configurable regex patterns for state detection (custom patterns merge with defaults)
AI Analysis
How It Works
ServerPulse AI analyzes errors when they're detected in your logs. The AI:
- Collects context from tracebacks and surrounding log lines
- Detects your framework (Django, Node.js, Docker, etc.)
- Sanitizes sensitive data before sending for analysis
- Provides actionable insights with evidence-based reasoning
- Caches results to avoid redundant analysis
Analysis Modes
- Manual: Run analysis only when you click the analysis button
- Smart: Automatically analyze high-confidence blocking errors
- Aggressive: Automatically analyze all eligible errors
Privacy & Control
- Only relevant error logs are sent for analysis (tracebacks and context lines)
- No background scanning or silent uploads
- AI can be fully disabled at any time
- Built-in cooldowns and caching prevent redundant requests
Usage Limits
- Free plan includes limited AI analyses to try the feature risk-free
- Paid plans unlock higher limits and priority analysis
- View all plans and pricing
Quick Start
ServerPulse automatically detects Django projects (manage.py), Node.js services (including Express), Docker Compose services (docker-compose.yml), and standalone Dockerfiles. On first use, a setup wizard will guide you through configuration. You can access ServerPulse anytime via the Command Palette (Ctrl+Shift+P / Cmd+Shift+P → type "Server Pulse").
Manual Configuration
Configure services in VS Code settings (Ctrl+, / Cmd+,):
Django
{
"serverpulse.services": [
{
"name": "My Django App",
"type": "django",
"port": 8000,
"healthCheckPath": "/health/"
}
]
}
Express.js (Node.js)
{
"serverpulse.services": [
{
"name": "My Express App",
"type": "nodejs",
"port": 3000,
"healthCheckPath": "/health"
}
]
}
Configuration
Basic Service
{
"serverpulse.services": [
{
"name": "My Django App",
"type": "django",
"port": 8000,
"healthCheckPath": "/health/"
}
]
}
Docker Compose Service
{
"serverpulse.services": [
{
"name": "web",
"type": "django",
"port": 8000,
"useDocker": {
"pathToComposeFile": "${workspaceFolder}/docker-compose.yml",
"selectedContainerName": "web_1",
"serviceName": "web"
}
}
]
}
Note: serviceName is auto-detected or prompted on first use. selectedContainerName is the actual container name for logs.
Standalone Dockerfile Service
{
"serverpulse.services": [
{
"name": "My App",
"type": "docker",
"port": 3000,
"useDocker": {
"pathToDockerFile": "${workspaceFolder}/Dockerfile",
"selectedContainerName": "my-app",
"imageName": "my-app:latest",
"portMapping": "3000:3000"
}
}
]
}
Custom Log Patterns
Patterns merge with defaults. Add custom patterns per-service. Patterns use word boundaries to prevent false positives - use \b for whole word matching:
{
"serverpulse.services": [
{
"name": "Celery Worker",
"type": "generic",
"port": 8000,
"logPatterns": {
"ready": "celery@.*\\s+ready\\.?"
}
}
]
}
AI Configuration
Enable and configure AI analysis:
{
"serverpulse.ai.enabled": true,
"serverpulse.ai.cooldownMinutes": 10,
"serverpulse.ai.cacheTTLHours": 24
}
serverpulse.ai.enabled: Enable AI-powered error analysis (default: false)serverpulse.ai.cooldownMinutes: Cooldown period in minutes between AI analyses per service (default: 10, range: 1-1440)serverpulse.ai.cacheTTLHours: Time-to-live for cached AI analysis results in hours (default: 24, range: 1-168)
Key Settings
errorRecoveryTimeout (default: 5 seconds) - How long to show errors before auto-recoverycheckInterval (default: 5 seconds) - Port check frequencyenableHealthCheck (default: true) - Enable HTTP health checks
Usage
Status Bar
Click the status bar to control services:
- Stopped → Click to start
- Ready/Starting → Click to stop
- Error → Click to show logs and AI analysis (if enabled)
Commands
Access via Command Palette (Ctrl+Shift+P / Cmd+Shift+P):
- Refresh Service Detection
- Show Service Logs
- Start/Stop Service
- Add New Service
- Reset First-Time Setup
AI Analysis
When AI is enabled and an error is detected:
- Manual mode: Click the analysis button in the error panel
- Smart/Aggressive mode: Analysis runs automatically for eligible errors
- View analysis results in the AI Result Panel with confidence scores and actionable insights
Troubleshooting
Service not detected: Ensure manage.py exists or manually configure in settings
Docker logs not working: Verify Docker is running (docker ps), check container name matches config, ensure serviceName is set for compose services
Patterns not matching: Check Developer Console (Help > Toggle Developer Tools) for [LogWatcher] messages. Verify regex patterns are valid and use word boundaries (\b) for whole words
Error state not showing: Check console for traceback collection messages. Ensure error pattern includes Traceback and Exception
AI analysis not working: Ensure serverpulse.ai.enabled is set to true in settings. Check that you have available analysis credits in your plan. Verify authentication if required.
Examples
Django with Docker Compose
{
"serverpulse.services": [
{
"name": "Django API",
"type": "django",
"port": 8000,
"useDocker": {
"pathToComposeFile": "${workspaceFolder}/docker-compose.yml",
"selectedContainerName": "web_1",
"serviceName": "web"
},
"healthCheckPath": "/api/health/"
}
]
}
Changelog
[2.0.3] – 2026-02-05
- Changed: Improved AI analysis availability and upgrade experience
[2.0.2] – 2026-02-05
- Changed: AI result panel and analysis flow improvements
[2.0.0] – 2026-01-19
- Added: ServerPulse AI – optional AI-assisted error analysis with traceback & log analysis, actionable explanations, framework-aware insights (Django, Node.js, Docker), evidence-based reasoning, and three analysis modes (Manual, Smart, Aggressive)
- Added: Usage limits (free plan: limited AI analyses), cooldowns, and caching
- Added: Settings
serverpulse.ai.enabled, serverpulse.ai.cooldownMinutes, serverpulse.ai.cacheTTLHours
See CHANGELOG.md for full history.
Support
Requirements
- VS Code 1.74.0 or higher
- Docker (optional, for container monitoring)
ServerPulse - AI-powered service monitoring for VS Code. Get started | View plans
© 2026 ServerPulse. All rights reserved. Proprietary software.
