@igortrindade/server-monitor

import { ServerMonitor } from '@igortrindade/server-monitor';

const monitor = new ServerMonitor({
  interval: 60000, // Collect metrics every 60 seconds
  dbPath: './server-metrics.db', // SQLite database path
  enableMemoryMonitoring: true,
  enableCpuMonitoring: true,
  enableDiskMonitoring: true,
  enablePM2Monitoring: true
});

// Event listeners
monitor.on('memoryMetrics', (metrics) => {
  console.log(`Memory usage: ${metrics.percentage.toFixed(2)}%`);
});

monitor.on('error', (error) => {
  console.error('Monitor error:', error);
});

// Start monitoring
await monitor.initialize();
await monitor.start();

// Get current metrics
const currentMemory = await monitor.getMemoryUsage();
const currentCpu = await monitor.getCpuUsage();
const currentDisk = await monitor.getDiskUsage();

// Get historical data
const memoryHistory = await monitor.getHistoricalData('memory', 100);

// Stop monitoring
await monitor.stop();

interface MonitorConfig {
  interval: number;              // Monitoring interval in milliseconds (default: 60000)
  dbPath?: string;              // SQLite database path (default: './server-monitor.db')
  enableMemoryMonitoring: boolean;   // Enable memory monitoring (default: true)
  enableCpuMonitoring: boolean;      // Enable CPU monitoring (default: true)
  enableDiskMonitoring: boolean;     // Enable disk monitoring (default: true)
  enablePM2Monitoring: boolean;      // Enable PM2 monitoring (default: true)
  maxRecords?: number;          // Maximum records to keep (default: 10000)
  diskPaths?: string[];         // Disk paths to monitor (default: ['/'])
}

new ServerMonitor(config?: Partial<MonitorConfig>)

interface MemoryUsage {
  total: number;        // Total memory in bytes
  used: number;         // Used memory in bytes
  free: number;         // Free memory in bytes
  percentage: number;   // Usage percentage
  topProcesses: ProcessInfo[];
}

interface CpuUsage {
  percentage: number;   // CPU usage percentage
  loadAverage: number[]; // Load average [1min, 5min, 15min]
  topProcesses: ProcessInfo[];
}

interface DiskUsage {
  total: number;        // Total disk space in bytes
  used: number;         // Used disk space in bytes
  free: number;         // Free disk space in bytes
  percentage: number;   // Usage percentage
  topFolders: FolderInfo[];
}

interface ProcessInfo {
  pid: number;          // Process ID
  name: string;         // Process name
  memoryUsage: number;  // Memory usage (MB or %)
  cpuUsage: number;     // CPU usage percentage
  command: string;      // Full command
}