README.md

Service Monitor

A real-time monitoring system built with Next.js, Prometheus, and Express that tracks service availability and performance metrics across multiple endpoints.

Features

• 🔍 Real-time service monitoring
• 📈 Latency tracking and visualization
• 🔄 Automatic retry mechanism for failed requests
• 🚦 Status indicators with tooltips
• 🎯 Group-based service organization

Architecture

Components

1. Prometheus Exporter (Express Server)

   • Runs on port 3002
   • Collects metrics:
     • service_up: Service availability (1 for up, 0 for down)
     • service_response_time: Response time in milliseconds
   • Implements retry logic for failed requests
   • Handles concurrent service checks

2. Prometheus Server

   • Runs on port 9090
   • Scrapes metrics from the exporter
   • Stores time-series data
   • Handles metric queries via PromQL

3. Next.js Frontend

   • Server-side rendered React (Next.js) application
   • Real-time metric visualization
   • Multiple time-frame views
   • Responsive status indicators
   • Latency graphs

Monitoring Logic

Service Checks

• Concurrent service checking (3 services at a time)
• Configurable retry mechanism:
  • Maximum retries: 3
  • Retry delay: 1000ms (doubles with each retry)
  • Timeout: 10 seconds per request

Status Calculation

• Service is considered "up" if:
  • Response status is 200-299
  • Response matches expected format/content
  • Downtime is less than 9 minutes -- Partial Outage
  • Downtime is more than 9 minutes -- Full Outage

Refresh Intervals

• Latency: every second refresh
• Uptime: 5 minute refresh
• Realtime: 1 second refresh

Setup

1. Install Dependencies

   npm install

2. Configure Endpoints

   • Edit server/endpoints.json to define monitored services
   • Each service can specify:
     • URL
     • Expected response format
     • Custom headers
     • Request body
     • Group assignment

3. Start Prometheus

   npm run prometheus 

4. Start the Exporter and Next.js

   npm run start:all

Configuration

Endpoint Configuration

{
  "urls": [
    {
      "group": "Group Name",
      "servers": [
        {
          "url": "https://api.example.com",
          "name": "Service Name",
          "help": "Service description",
          "expectedResponse": {
            "field": "value"
          },
          "body": {
            "key": "value"
          }
        }
      ]
    }
  ]
}

Environment Variables

• PORT: Exporter port (default: 3002)
• PROMETHEUS_URL: Prometheus server URL (default: http://localhost:9090)
• ENDPOINTS_FILE: Path to endpoints configuration (default: ./endpoints.json)

Development

Project Structure

├── app/                    # Next.js app directory
│   ├── api/               # API routes
│   ├── layout.tsx         # Root layout
│   └── page.tsx           # Main page
├── components/            # React components
├── hooks/                 # Custom React hooks
├── lib/                   # Utility functions
├── server/               # Backend services
│   ├── exporter.js       # Prometheus exporter
│   └── endpoints.json    # Service configuration
└── scripts/              # Helper scripts

Error Handling

1. Network Errors

   • Automatic retry with exponential backoff
   • Maximum 3 retry attempts
   • Failed services marked as down after all retries exhausted

2. Response Validation

   • Checks HTTP status codes
   • Validates response format against expected schema
   • Handles partial matches for text responses

3. Metric Collection

   • Graceful handling of missing data points
   • Automatic recovery from Prometheus connection issues
   • Fallback to cached data when available

Contributing

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push to the branch
5. Create a Pull Request

License

MIT License - feel free to use this project for any purpose.

Support

For issues and feature requests, please create an issue in the repository.