@nanocollective/nanocoder 1.17.3 → 1.19.0

package/dist/utils/logging/health-monitor.d.ts

@@ -0,0 +1,216 @@
+/**
+ * Health check and monitoring system for logging infrastructure
+ * Provides comprehensive health metrics and monitoring capabilities
+ */
+/**
+ * Health check result interface
+ */
+export interface HealthCheckResult {
+    status: 'healthy' | 'degraded' | 'unhealthy';
+    score: number;
+    checks: HealthCheck[];
+    timestamp: string;
+    duration: number;
+    correlationId: string;
+    summary: {
+        total: number;
+        passed: number;
+        failed: number;
+        warnings: number;
+    };
+    recommendations: string[];
+}
+/**
+ * Individual health check interface
+ */
+export interface HealthCheck {
+    name: string;
+    status: 'pass' | 'fail' | 'warn';
+    score: number;
+    duration: number;
+    message?: string;
+    details?: Record<string, unknown>;
+    error?: string;
+    threshold?: {
+        warning: number;
+        critical: number;
+    };
+}
+/**
+ * System metrics interface
+ */
+export interface SystemMetrics {
+    timestamp: string;
+    memory: {
+        heapUsed: number;
+        heapTotal: number;
+        external: number;
+        rss: number;
+        heapUsagePercent: number;
+    };
+    cpu: {
+        usage: number;
+        loadAverage: number[];
+    };
+    process: {
+        uptime: number;
+        pid: number;
+        nodeVersion: string;
+        platform: string;
+        arch: string;
+    };
+    logging: {
+        totalLogEntries: number;
+        logRate: number;
+        errorRate: number;
+        averageLogSize: number;
+        oldestLogEntry?: string;
+        newestLogEntry?: string;
+    };
+    requests: {
+        totalRequests: number;
+        activeRequests: number;
+        averageDuration: number;
+        errorRate: number;
+        requestsPerSecond: number;
+    };
+    performance: {
+        operationCount: number;
+        averageDuration: number;
+        slowOperations: number;
+        memoryIntensiveOps: number;
+    };
+}
+/**
+ * Health check configuration
+ */
+export interface HealthCheckConfig {
+    enabled: boolean;
+    interval: number;
+    timeout: number;
+    thresholds: {
+        memory: {
+            heapUsageWarning: number;
+            heapUsageCritical: number;
+            externalWarning: number;
+            externalCritical: number;
+        };
+        performance: {
+            averageDurationWarning: number;
+            averageDurationCritical: number;
+            errorRateWarning: number;
+            errorRateCritical: number;
+        };
+        logging: {
+            logRateWarning: number;
+            logRateCritical: number;
+            errorRateWarning: number;
+            errorRateCritical: number;
+        };
+        requests: {
+            durationWarning: number;
+            durationCritical: number;
+            errorRateWarning: number;
+            errorRateCritical: number;
+        };
+    };
+    alerts: {
+        enabled: boolean;
+        channels: ('console' | 'file' | 'webhook')[];
+        webhookUrl?: string;
+        cooldown: number;
+    };
+}
+/**
+ * Health monitoring system
+ */
+export declare class HealthMonitor {
+    private config;
+    private isRunning;
+    private intervalId?;
+    private lastCheck?;
+    private lastAlert?;
+    private correlationId;
+    constructor(config?: Partial<HealthCheckConfig>);
+    /**
+     * Start health monitoring
+     */
+    start(): void;
+    /**
+     * Stop health monitoring
+     */
+    stop(): void;
+    /**
+     * Run a comprehensive health check
+     */
+    runHealthCheck(): Promise<HealthCheckResult>;
+    /**
+     * Get current system metrics
+     */
+    getSystemMetrics(): SystemMetrics;
+    /**
+     * Get last health check result
+     */
+    getLastHealthCheck(): HealthCheckResult | undefined;
+    /**
+     * Check if monitoring is running
+     */
+    isActive(): boolean;
+    /**
+     * Update health check configuration
+     */
+    updateConfig(config: Partial<HealthCheckConfig>): void;
+    private checkMemory;
+    private checkLoggingSystem;
+    private checkRequestTracking;
+    private checkPerformanceMonitoring;
+    private checkConfigurationSystem;
+    private calculateScore;
+    private generateRecommendations;
+    private sendAlert;
+}
+/**
+ * Global health monitor instance
+ */
+export declare const globalHealthMonitor: HealthMonitor;
+/**
+ * Quick health check functions
+ */
+export declare const healthChecks: {
+    /**
+     * Quick health check - returns status only
+     */
+    quick: () => Promise<"healthy" | "degraded" | "unhealthy">;
+    /**
+     * Full health check with details
+     */
+    full: () => Promise<HealthCheckResult>;
+    /**
+     * System metrics snapshot
+     */
+    metrics: () => SystemMetrics;
+    /**
+     * Check if system is ready
+     */
+    ready: () => Promise<boolean>;
+    /**
+     * Check if system is alive (basic check)
+     */
+    alive: () => boolean;
+};
+/**
+ * Initialize health monitoring with default configuration
+ */
+export declare function initializeHealthMonitoring(config?: Partial<HealthCheckConfig>): void;
+/**
+ * Health check middleware for HTTP servers
+ */
+export declare function healthCheckMiddleware(): (req: {
+    path: string;
+}, res: {
+    status: (code: number) => {
+        json: (data: unknown) => void;
+    };
+    json: (data: unknown) => void;
+}, next: () => void) => Promise<void>;
+//# sourceMappingURL=health-monitor.d.ts.map

package/dist/utils/logging/health-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-monitor.d.ts","sourceRoot":"","sources":["../../../source/utils/logging/health-monitor.ts"],"names":[],"mappings":"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"}