claude-flow-novice 1.6.1 → 1.6.3

package/.claude-flow-novice/dist/src/monitoring/metrics-collector.js

@@ -0,0 +1,282 @@
+// Metrics collection system for Claude Flow Novice
+// Integrates with Prometheus, DataDog, and New Relic
+import { createPrometheusMetrics } from './prometheus-collector';
+import { createDataDogMetrics } from './datadog-collector';
+import { createNewRelicMetrics } from './newrelic-collector';
+import { Logger } from '../utils/logger';
+export class MetricsCollector {
+    config;
+    logger;
+    prometheusCollector;
+    dataDogCollector;
+    newRelicCollector;
+    customMetrics = new Map();
+    constructor(config){
+        this.config = config;
+        this.logger = new Logger('MetricsCollector');
+        this.initializeCollectors();
+        this.registerCustomMetrics();
+    }
+    initializeCollectors() {
+        if (this.config.providers.prometheus?.enabled) {
+            this.prometheusCollector = createPrometheusMetrics(this.config.providers.prometheus);
+            this.logger.info('Prometheus metrics collector initialized');
+        }
+        if (this.config.providers.datadog?.enabled) {
+            this.dataDogCollector = createDataDogMetrics(this.config.providers.datadog);
+            this.logger.info('DataDog metrics collector initialized');
+        }
+        if (this.config.providers.newrelic?.enabled) {
+            this.newRelicCollector = createNewRelicMetrics(this.config.providers.newrelic);
+            this.logger.info('New Relic metrics collector initialized');
+        }
+    }
+    registerCustomMetrics() {
+        if (!this.config.customMetrics) return;
+        for (const [name, definition] of Object.entries(this.config.customMetrics)){
+            this.registerMetric(definition);
+        }
+    }
+    registerMetric(definition) {
+        this.customMetrics.set(definition.name, definition);
+        // Register with each provider
+        if (this.prometheusCollector) {
+            this.prometheusCollector.registerMetric(definition);
+        }
+        if (this.dataDogCollector) {
+            this.dataDogCollector.registerMetric(definition);
+        }
+        if (this.newRelicCollector) {
+            this.newRelicCollector.registerMetric(definition);
+        }
+    }
+    increment(name, value = 1, labels) {
+        this.sendToAllProviders('increment', name, value, labels);
+    }
+    gauge(name, value, labels) {
+        this.sendToAllProviders('gauge', name, value, labels);
+    }
+    histogram(name, value, labels) {
+        this.sendToAllProviders('histogram', name, value, labels);
+    }
+    timing(name, value, labels) {
+        this.sendToAllProviders('timing', name, value, labels);
+    }
+    sendToAllProviders(type, name, value, labels) {
+        try {
+            if (this.prometheusCollector) {
+                this.prometheusCollector[type](name, value, labels);
+            }
+            if (this.dataDogCollector) {
+                this.dataDogCollector[type](name, value, labels);
+            }
+            if (this.newRelicCollector) {
+                this.newRelicCollector[type](name, value, labels);
+            }
+        } catch (error) {
+            this.logger.error('Failed to send metric to providers', {
+                error,
+                name,
+                type
+            });
+        }
+    }
+    // HTTP request metrics
+    recordHttpRequest(method, route, statusCode, duration, userAgent) {
+        const labels = {
+            method,
+            route,
+            status_code: statusCode.toString(),
+            status_class: this.getStatusClass(statusCode),
+            user_agent: userAgent ? this.getUserAgentCategory(userAgent) : 'unknown'
+        };
+        this.increment('http_requests_total', 1, labels);
+        this.histogram('http_request_duration_seconds', duration, labels);
+        if (statusCode >= 400) {
+            this.increment('http_errors_total', 1, labels);
+        }
+    }
+    // Business metrics
+    recordAgentOperation(agentType, operation, duration, success, errorType) {
+        const labels = {
+            agent_type: agentType,
+            operation,
+            success: success.toString()
+        };
+        this.increment('agent_operations_total', 1, labels);
+        this.histogram('agent_operation_duration_seconds', duration, labels);
+        if (!success && errorType) {
+            this.increment('agent_errors_total', 1, {
+                ...labels,
+                error_type: errorType
+            });
+        }
+    }
+    recordSwarmActivity(swarmSize, topology, duration, success) {
+        const labels = {
+            topology,
+            success: success.toString()
+        };
+        this.gauge('active_swarm_size', swarmSize);
+        this.increment('swarm_executions_total', 1, labels);
+        this.histogram('swarm_execution_duration_seconds', duration, labels);
+    }
+    // System metrics
+    recordMemoryUsage(used, total, component) {
+        const labels = {
+            component
+        };
+        const usagePercent = used / total * 100;
+        this.gauge('memory_usage_bytes', used, labels);
+        this.gauge('memory_usage_percent', usagePercent, labels);
+    }
+    recordCPUUsage(percent, component) {
+        this.gauge('cpu_usage_percent', percent, {
+            component
+        });
+    }
+    // Database metrics
+    recordDatabaseQuery(operation, table, duration, success, errorType) {
+        const labels = {
+            operation,
+            table,
+            success: success.toString()
+        };
+        this.increment('database_queries_total', 1, labels);
+        this.histogram('database_query_duration_seconds', duration, labels);
+        if (!success && errorType) {
+            this.increment('database_errors_total', 1, {
+                ...labels,
+                error_type: errorType
+            });
+        }
+    }
+    // Cache metrics
+    recordCacheOperation(operation, key, duration) {
+        const labels = {
+            operation,
+            key_prefix: key.split(':')[0] || 'unknown'
+        };
+        this.increment('cache_operations_total', 1, labels);
+        if (duration) {
+            this.histogram('cache_operation_duration_seconds', duration, labels);
+        }
+    }
+    // Utility methods
+    getStatusClass(statusCode) {
+        if (statusCode >= 200 && statusCode < 300) return '2xx';
+        if (statusCode >= 300 && statusCode < 400) return '3xx';
+        if (statusCode >= 400 && statusCode < 500) return '4xx';
+        if (statusCode >= 500) return '5xx';
+        return 'unknown';
+    }
+    getUserAgentCategory(userAgent) {
+        if (userAgent.includes('curl') || userAgent.includes('wget')) return 'cli';
+        if (userAgent.includes('Mozilla')) return 'browser';
+        if (userAgent.includes('bot') || userAgent.includes('crawler')) return 'bot';
+        return 'other';
+    }
+    // Health check
+    async healthCheck() {
+        const providers = {};
+        if (this.prometheusCollector) {
+            try {
+                await this.prometheusCollector.healthCheck();
+                providers.prometheus = true;
+            } catch  {
+                providers.prometheus = false;
+            }
+        }
+        if (this.dataDogCollector) {
+            try {
+                await this.dataDogCollector.healthCheck();
+                providers.datadog = true;
+            } catch  {
+                providers.datadog = false;
+            }
+        }
+        if (this.newRelicCollector) {
+            try {
+                await this.newRelicCollector.healthCheck();
+                providers.newrelic = true;
+            } catch  {
+                providers.newrelic = false;
+            }
+        }
+        const allHealthy = Object.values(providers).every((status)=>status);
+        return {
+            status: allHealthy ? 'healthy' : 'degraded',
+            providers
+        };
+    }
+    // Shutdown
+    async shutdown() {
+        this.logger.info('Shutting down metrics collector');
+        if (this.prometheusCollector) {
+            await this.prometheusCollector.shutdown();
+        }
+        if (this.dataDogCollector) {
+            await this.dataDogCollector.shutdown();
+        }
+        if (this.newRelicCollector) {
+            await this.newRelicCollector.shutdown();
+        }
+        this.logger.info('Metrics collector shutdown complete');
+    }
+}
+// Factory function
+export function createMetricsCollector(config) {
+    return new MetricsCollector(config);
+}
+// Default configuration
+export const defaultMetricsConfig = {
+    enabled: true,
+    providers: {
+        prometheus: {
+            enabled: true,
+            port: 9090,
+            endpoint: '/metrics'
+        }
+    },
+    customMetrics: {
+        claude_flow_operations_total: {
+            type: 'counter',
+            name: 'claude_flow_operations_total',
+            description: 'Total number of Claude Flow operations',
+            labels: [
+                'operation_type',
+                'agent_type',
+                'status'
+            ]
+        },
+        claude_flow_operation_duration: {
+            type: 'histogram',
+            name: 'claude_flow_operation_duration_seconds',
+            description: 'Duration of Claude Flow operations',
+            labels: [
+                'operation_type',
+                'agent_type'
+            ],
+            buckets: [
+                0.1,
+                0.5,
+                1,
+                2,
+                5,
+                10,
+                30,
+                60
+            ]
+        },
+        active_agents_count: {
+            type: 'gauge',
+            name: 'active_agents_count',
+            description: 'Number of currently active agents',
+            labels: [
+                'agent_type'
+            ]
+        }
+    }
+};
+
+//# sourceMappingURL=metrics-collector.js.map

package/.claude-flow-novice/dist/src/monitoring/metrics-collector.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/monitoring/metrics-collector.ts"],"names":["createPrometheusMetrics","createDataDogMetrics","createNewRelicMetrics","Logger","MetricsCollector","config","logger","prometheusCollector","dataDogCollector","newRelicCollector","customMetrics","Map","initializeCollectors","registerCustomMetrics","providers","prometheus","enabled","info","datadog","newrelic","name","definition","Object","entries","registerMetric","set","increment","value","labels","sendToAllProviders","gauge","histogram","timing","type","error","recordHttpRequest","method","route","statusCode","duration","userAgent","status_code","toString","status_class","getStatusClass","user_agent","getUserAgentCategory","recordAgentOperation","agentType","operation","success","errorType","agent_type","error_type","recordSwarmActivity","swarmSize","topology","recordMemoryUsage","used","total","component","usagePercent","recordCPUUsage","percent","recordDatabaseQuery","table","recordCacheOperation","key","key_prefix","split","includes","healthCheck","allHealthy","values","every","status","shutdown","createMetricsCollector","defaultMetricsConfig","port","endpoint","claude_flow_operations_total","description","claude_flow_operation_duration","buckets","active_agents_count"],"mappings":"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"}

package/.claude-flow-novice/dist/src/observability/metrics-counter.js

@@ -0,0 +1,268 @@
+/**
+ * Simple Metrics Counter API
+ *
+ * Provides easy-to-use functions to increment metrics counters
+ * with optional tags for dimensional analysis.
+ */ import { getGlobalTelemetry } from './telemetry.js';
+// ============================================================================
+// Public API - Simple Counter Functions
+// ============================================================================
+/**
+ * Increment a metric counter by 1 (or custom value)
+ *
+ * @example
+ * ```typescript
+ * // Simple counter
+ * incrementMetric('api.requests');
+ *
+ * // Counter with tags
+ * incrementMetric('api.requests', 1, {
+ *   endpoint: '/users',
+ *   method: 'GET',
+ *   status: '200'
+ * });
+ *
+ * // Custom increment value
+ * incrementMetric('bytes.uploaded', 1024, { fileType: 'image' });
+ * ```
+ */ export function incrementMetric(metricName, value = 1, tags = {}) {
+    const telemetry = getGlobalTelemetry();
+    telemetry.recordCounter(metricName, value, tags);
+}
+/**
+ * Record a gauge value (point-in-time measurement)
+ *
+ * @example
+ * ```typescript
+ * // Record current queue size
+ * recordGauge('queue.size', 42);
+ *
+ * // Record with context
+ * recordGauge('memory.usage', process.memoryUsage().heapUsed, {
+ *   unit: 'bytes',
+ *   process: 'worker-1'
+ * });
+ * ```
+ */ export function recordGauge(metricName, value, tags = {}) {
+    const telemetry = getGlobalTelemetry();
+    telemetry.recordGauge(metricName, value, tags);
+}
+/**
+ * Record a timing/duration metric
+ *
+ * @example
+ * ```typescript
+ * const start = Date.now();
+ * await doWork();
+ * recordTiming('task.duration', Date.now() - start, { taskType: 'export' });
+ * ```
+ */ export function recordTiming(metricName, durationMs, tags = {}) {
+    const telemetry = getGlobalTelemetry();
+    telemetry.recordTimer(metricName, durationMs, tags);
+}
+/**
+ * Wrapper to measure function execution time
+ *
+ * @example
+ * ```typescript
+ * const result = await measureExecution('api.fetch', async () => {
+ *   return await fetch('https://api.example.com/data');
+ * }, { endpoint: '/data' });
+ * ```
+ */ export async function measureExecution(metricName, fn, tags = {}) {
+    const start = Date.now();
+    try {
+        const result = await fn();
+        recordTiming(metricName, Date.now() - start, {
+            ...tags,
+            status: 'success'
+        });
+        return result;
+    } catch (error) {
+        recordTiming(metricName, Date.now() - start, {
+            ...tags,
+            status: 'error'
+        });
+        throw error;
+    }
+}
+/**
+ * Synchronous execution measurement
+ */ export function measureExecutionSync(metricName, fn, tags = {}) {
+    const start = Date.now();
+    try {
+        const result = fn();
+        recordTiming(metricName, Date.now() - start, {
+            ...tags,
+            status: 'success'
+        });
+        return result;
+    } catch (error) {
+        recordTiming(metricName, Date.now() - start, {
+            ...tags,
+            status: 'error'
+        });
+        throw error;
+    }
+}
+// ============================================================================
+// Pre-defined Domain Metrics (Convenience Functions)
+// ============================================================================
+/**
+ * Track provider routing decisions
+ */ export function trackProviderRouting(provider, tier, agentType, source) {
+    incrementMetric('provider.request', 1, {
+        provider,
+        tier,
+        agentType,
+        source
+    });
+}
+/**
+ * Track agent spawns
+ */ export function trackAgentSpawn(agentType, swarmId, topology) {
+    incrementMetric('agent.spawned', 1, {
+        agentType,
+        swarmId,
+        topology
+    });
+}
+/**
+ * Track agent completion
+ */ export function trackAgentCompletion(agentType, success, durationMs) {
+    incrementMetric('agent.completed', 1, {
+        agentType,
+        status: success ? 'success' : 'failure'
+    });
+    recordTiming('agent.duration', durationMs, {
+        agentType,
+        status: success ? 'success' : 'failure'
+    });
+}
+/**
+ * Track task orchestration
+ */ export function trackTaskOrchestration(taskType, strategy, agentCount) {
+    incrementMetric('task.orchestrated', 1, {
+        taskType,
+        strategy
+    });
+    recordGauge('task.agents', agentCount, {
+        taskType,
+        strategy
+    });
+}
+/**
+ * Track swarm operations
+ */ export function trackSwarmOperation(operation, topology, agentCount) {
+    incrementMetric('swarm.operation', 1, {
+        operation,
+        topology
+    });
+    if (agentCount !== undefined) {
+        recordGauge('swarm.size', agentCount, {
+            topology
+        });
+    }
+}
+/**
+ * Track API calls (generic)
+ */ export function trackAPICall(endpoint, method, statusCode, durationMs) {
+    incrementMetric('api.requests', 1, {
+        endpoint,
+        method,
+        status: statusCode.toString()
+    });
+    recordTiming('api.duration', durationMs, {
+        endpoint,
+        method
+    });
+}
+/**
+ * Track errors
+ */ export function trackError(errorType, component, severity = 'medium') {
+    incrementMetric('errors.count', 1, {
+        errorType,
+        component,
+        severity
+    });
+}
+/**
+ * Track memory usage
+ */ export function trackMemoryUsage(component) {
+    const usage = process.memoryUsage();
+    recordGauge('memory.heap.used', usage.heapUsed, {
+        component,
+        unit: 'bytes'
+    });
+    recordGauge('memory.heap.total', usage.heapTotal, {
+        component,
+        unit: 'bytes'
+    });
+    recordGauge('memory.rss', usage.rss, {
+        component,
+        unit: 'bytes'
+    });
+}
+/**
+ * Track subscription usage
+ */ export function trackSubscriptionUsage(used, limit, remaining) {
+    recordGauge('subscription.usage', used, {
+        limit: limit.toString(),
+        remaining: remaining.toString(),
+        utilizationPct: (used / limit * 100).toFixed(1)
+    });
+}
+// ============================================================================
+// Query Helpers
+// ============================================================================
+/**
+ * Get current metric value (latest gauge or counter sum)
+ */ export function getMetricValue(metricName) {
+    const telemetry = getGlobalTelemetry();
+    const metrics = telemetry.getMetrics(metricName);
+    if (metrics.length === 0) return 0;
+    // For counters, sum all values
+    if (metrics[0].type === 'counter') {
+        return metrics.reduce((sum, m)=>sum + m.value, 0);
+    }
+    // For gauges, return latest value
+    return metrics[metrics.length - 1].value;
+}
+/**
+ * Get metric breakdown by tag
+ */ export function getMetricBreakdown(metricName, tagKey) {
+    const telemetry = getGlobalTelemetry();
+    const metrics = telemetry.getMetrics(metricName);
+    const breakdown = {};
+    metrics.forEach((metric)=>{
+        const tagValue = metric.tags[tagKey] || 'unknown';
+        breakdown[tagValue] = (breakdown[tagValue] || 0) + metric.value;
+    });
+    return breakdown;
+}
+// ============================================================================
+// Exports
+// ============================================================================
+export default {
+    // Core functions
+    incrementMetric,
+    recordGauge,
+    recordTiming,
+    measureExecution,
+    measureExecutionSync,
+    // Domain-specific trackers
+    trackProviderRouting,
+    trackAgentSpawn,
+    trackAgentCompletion,
+    trackTaskOrchestration,
+    trackSwarmOperation,
+    trackAPICall,
+    trackError,
+    trackMemoryUsage,
+    trackSubscriptionUsage,
+    // Query helpers
+    getMetricValue,
+    getMetricBreakdown
+};
+
+//# sourceMappingURL=metrics-counter.js.map

package/.claude-flow-novice/dist/src/observability/metrics-counter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/observability/metrics-counter.ts"],"names":["getGlobalTelemetry","incrementMetric","metricName","value","tags","telemetry","recordCounter","recordGauge","recordTiming","durationMs","recordTimer","measureExecution","fn","start","Date","now","result","status","error","measureExecutionSync","trackProviderRouting","provider","tier","agentType","source","trackAgentSpawn","swarmId","topology","trackAgentCompletion","success","trackTaskOrchestration","taskType","strategy","agentCount","trackSwarmOperation","operation","undefined","trackAPICall","endpoint","method","statusCode","toString","trackError","errorType","component","severity","trackMemoryUsage","usage","process","memoryUsage","heapUsed","unit","heapTotal","rss","trackSubscriptionUsage","used","limit","remaining","utilizationPct","toFixed","getMetricValue","metrics","getMetrics","length","type","reduce","sum","m","getMetricBreakdown","tagKey","breakdown","forEach","metric","tagValue"],"mappings":"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"}