@zhin.js/agent 0.1.25 → 0.1.27

package/lib/monitoring/index.js

@@ -0,0 +1,197 @@
+/**
+ * Agent 监控和可观测性模块
+ *
+ * 提供：
+ * - 性能指标收集（Prometheus 格式）
+ * - 分布式追踪（OpenTelemetry 格式）
+ * - 实时监控仪表板数据
+ * - 告警规则配置
+ */
+export * from './metrics.js';
+import { getMetricsCollector, getAlertManager, getTraceCollector } from './metrics.js';
+/**
+ * 生成监控仪表板数据
+ */
+export function generateDashboardData() {
+    const metrics = getMetricsCollector();
+    const alerts = getAlertManager();
+    const traces = getTraceCollector();
+    // 获取工具执行统计
+    const toolExecutions = metrics.getValues('agent_tool_executions_total');
+    const toolDurations = metrics.getValues('agent_tool_execution_duration_seconds');
+    const totalExecutions = toolExecutions.reduce((sum, v) => sum + v.value, 0);
+    const successExecutions = toolExecutions
+        .filter(v => v.labels.status === 'success')
+        .reduce((sum, v) => sum + v.value, 0);
+    const failedExecutions = toolExecutions
+        .filter(v => v.labels.status === 'error')
+        .reduce((sum, v) => sum + v.value, 0);
+    const averageDuration = toolDurations.length > 0
+        ? toolDurations.reduce((sum, v) => sum + v.value, 0) / toolDurations.length
+        : 0;
+    // 获取会话统计
+    const sessions = metrics.getValues('agent_sessions_total');
+    const sessionDurations = metrics.getValues('agent_session_duration_seconds');
+    const totalSessions = sessions.reduce((sum, v) => sum + v.value, 0);
+    const activeSessions = sessions
+        .filter(v => v.labels.status === 'active')
+        .reduce((sum, v) => sum + v.value, 0);
+    const averageSessionDuration = sessionDurations.length > 0
+        ? sessionDurations.reduce((sum, v) => sum + v.value, 0) / sessionDurations.length
+        : 0;
+    // 获取 Token 使用统计
+    const tokenUsage = metrics.getValues('agent_token_usage_total');
+    const totalTokens = tokenUsage.reduce((sum, v) => sum + v.value, 0);
+    const inputTokens = tokenUsage
+        .filter(v => v.labels.type === 'input')
+        .reduce((sum, v) => sum + v.value, 0);
+    const outputTokens = tokenUsage
+        .filter(v => v.labels.type === 'output')
+        .reduce((sum, v) => sum + v.value, 0);
+    // 获取安全事件统计
+    const securityEvents = metrics.getValues('agent_security_events_total');
+    const totalSecurityEvents = securityEvents.reduce((sum, v) => sum + v.value, 0);
+    const violations = securityEvents
+        .filter(v => v.labels.type === 'violation')
+        .reduce((sum, v) => sum + v.value, 0);
+    const warnings = securityEvents
+        .filter(v => v.labels.severity === 'warning')
+        .reduce((sum, v) => sum + v.value, 0);
+    // 获取资源使用
+    const resourceUsage = metrics.getValues('agent_resource_usage');
+    const cpuUsage = resourceUsage.find(v => v.labels.type === 'cpu')?.value || 0;
+    const memoryUsage = resourceUsage.find(v => v.labels.type === 'memory')?.value || 0;
+    const activeConnections = resourceUsage.find(v => v.labels.type === 'connections')?.value || 0;
+    // 获取告警
+    const activeAlerts = alerts.getAlerts().map(alert => ({
+        id: alert.ruleId,
+        severity: alert.severity,
+        message: alert.message,
+        timestamp: alert.timestamp,
+    }));
+    // 获取追踪数据
+    const allTraces = traces.getAllSpans();
+    const traceMap = new Map();
+    for (const span of allTraces) {
+        if (!traceMap.has(span.traceId)) {
+            traceMap.set(span.traceId, []);
+        }
+        traceMap.get(span.traceId).push(span);
+    }
+    const traceSummaries = Array.from(traceMap.entries()).map(([traceId, spans]) => {
+        const startTime = Math.min(...spans.map(s => s.startTime));
+        const endTime = Math.max(...spans.map(s => s.endTime || s.startTime));
+        const duration = endTime - startTime;
+        const hasError = spans.some(s => s.status.code === 'ERROR');
+        return {
+            traceId,
+            spans: spans.length,
+            duration,
+            status: hasError ? 'ERROR' : 'OK',
+        };
+    });
+    return {
+        timestamp: Date.now(),
+        metrics: {
+            toolExecutions: {
+                total: totalExecutions,
+                success: successExecutions,
+                failed: failedExecutions,
+                averageDuration,
+            },
+            sessions: {
+                total: totalSessions,
+                active: activeSessions,
+                averageDuration: averageSessionDuration,
+            },
+            tokenUsage: {
+                total: totalTokens,
+                input: inputTokens,
+                output: outputTokens,
+                estimatedCost: totalTokens * 0.000002, // 简化的成本估算
+            },
+            securityEvents: {
+                total: totalSecurityEvents,
+                violations,
+                warnings,
+            },
+            resourceUsage: {
+                cpu: cpuUsage,
+                memory: memoryUsage,
+                activeConnections,
+            },
+        },
+        alerts: activeAlerts,
+        traces: traceSummaries.slice(0, 10), // 只返回最近 10 个追踪
+    };
+}
+/**
+ * 监控系统健康检查
+ */
+export function healthCheck() {
+    const checks = [];
+    // 检查指标收集器
+    try {
+        const metrics = getMetricsCollector();
+        const allMetrics = metrics.getAllMetrics();
+        checks.push({
+            name: 'metrics_collector',
+            status: allMetrics.size > 0 ? 'pass' : 'warn',
+            message: `${allMetrics.size} metrics registered`,
+        });
+    }
+    catch (error) {
+        checks.push({
+            name: 'metrics_collector',
+            status: 'fail',
+            message: `Failed to initialize: ${error}`,
+        });
+    }
+    // 检查追踪收集器
+    try {
+        const traces = getTraceCollector();
+        const allSpans = traces.getAllSpans();
+        checks.push({
+            name: 'trace_collector',
+            status: 'pass',
+            message: `${allSpans.length} spans collected`,
+        });
+    }
+    catch (error) {
+        checks.push({
+            name: 'trace_collector',
+            status: 'fail',
+            message: `Failed to initialize: ${error}`,
+        });
+    }
+    // 检查告警管理器
+    try {
+        const alerts = getAlertManager();
+        const allAlerts = alerts.getAlerts();
+        const criticalAlerts = allAlerts.filter(a => a.severity === 'critical');
+        checks.push({
+            name: 'alert_manager',
+            status: criticalAlerts.length > 0 ? 'warn' : 'pass',
+            message: `${allAlerts.length} alerts (${criticalAlerts.length} critical)`,
+        });
+    }
+    catch (error) {
+        checks.push({
+            name: 'alert_manager',
+            status: 'fail',
+            message: `Failed to initialize: ${error}`,
+        });
+    }
+    // 确定总体状态
+    const hasFail = checks.some(c => c.status === 'fail');
+    const hasWarn = checks.some(c => c.status === 'warn');
+    let status = 'healthy';
+    if (hasFail) {
+        status = 'unhealthy';
+    }
+    else if (hasWarn) {
+        status = 'degraded';
+    }
+    return { status, checks };
+}
+//# sourceMappingURL=index.js.map

package/lib/monitoring/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/monitoring/index.ts"],"names":[],"mappings":"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"}

package/lib/monitoring/metrics.d.ts

@@ -0,0 +1,240 @@
+/**
+ * Agent 监控和可观测性模块
+ *
+ * 提供：
+ * - 性能指标收集（Prometheus 格式）
+ * - 分布式追踪（OpenTelemetry 格式）
+ * - 实时监控仪表板数据
+ * - 告警规则配置
+ */
+export type MetricType = 'counter' | 'gauge' | 'histogram' | 'summary';
+export interface MetricLabels {
+    [key: string]: string;
+}
+export interface MetricValue {
+    value: number;
+    labels: MetricLabels;
+    timestamp?: number;
+}
+export interface MetricDefinition {
+    name: string;
+    type: MetricType;
+    help: string;
+    labels?: string[];
+}
+export declare class MetricsCollector {
+    private metrics;
+    private values;
+    /**
+     * 注册指标
+     */
+    register(definition: MetricDefinition): void;
+    /**
+     * 增加计数器
+     */
+    increment(name: string, labels?: MetricLabels, value?: number): void;
+    /**
+     * 设置仪表盘值
+     */
+    set(name: string, value: number, labels?: MetricLabels): void;
+    /**
+     * 记录直方图值
+     */
+    observe(name: string, value: number, labels?: MetricLabels): void;
+    /**
+     * 获取指标值
+     */
+    getValues(name: string): MetricValue[];
+    /**
+     * 获取所有指标
+     */
+    getAllMetrics(): Map<string, MetricDefinition>;
+    /**
+     * 导出 Prometheus 格式
+     */
+    toPrometheus(): string;
+    /**
+     * 构建指标键
+     */
+    private buildKey;
+}
+export declare const AGENT_METRICS: {
+    TOOL_EXECUTIONS: {
+        name: string;
+        type: MetricType;
+        help: string;
+        labels: string[];
+    };
+    TOOL_EXECUTION_DURATION: {
+        name: string;
+        type: MetricType;
+        help: string;
+        labels: string[];
+    };
+    AGENT_SESSIONS: {
+        name: string;
+        type: MetricType;
+        help: string;
+        labels: string[];
+    };
+    AGENT_SESSION_DURATION: {
+        name: string;
+        type: MetricType;
+        help: string;
+        labels: string[];
+    };
+    TOKEN_USAGE: {
+        name: string;
+        type: MetricType;
+        help: string;
+        labels: string[];
+    };
+    SECURITY_EVENTS: {
+        name: string;
+        type: MetricType;
+        help: string;
+        labels: string[];
+    };
+    RESOURCE_USAGE: {
+        name: string;
+        type: MetricType;
+        help: string;
+        labels: string[];
+    };
+    ERRORS: {
+        name: string;
+        type: MetricType;
+        help: string;
+        labels: string[];
+    };
+};
+export interface TraceSpan {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+    name: string;
+    startTime: number;
+    endTime?: number;
+    attributes: Record<string, unknown>;
+    events: Array<{
+        name: string;
+        timestamp: number;
+        attributes: Record<string, unknown>;
+    }>;
+    status: {
+        code: 'OK' | 'ERROR' | 'UNSET';
+        message?: string;
+    };
+}
+export declare class TraceCollector {
+    private spans;
+    private activeSpans;
+    /**
+     * 开始一个新的 Span
+     */
+    startSpan(name: string, parentSpanId?: string, attributes?: Record<string, unknown>): TraceSpan;
+    /**
+     * 结束 Span
+     */
+    endSpan(spanId: string, status?: {
+        code: 'OK' | 'ERROR' | 'UNSET';
+        message?: string;
+    }): void;
+    /**
+     * 添加事件到 Span
+     */
+    addEvent(spanId: string, name: string, attributes?: Record<string, unknown>): void;
+    /**
+     * 设置 Span 属性
+     */
+    setAttributes(spanId: string, attributes: Record<string, unknown>): void;
+    /**
+     * 获取 Span
+     */
+    getSpan(spanId: string): TraceSpan | undefined;
+    /**
+     * 获取所有 Span
+     */
+    getAllSpans(): TraceSpan[];
+    /**
+     * 获取追踪
+     */
+    getTrace(traceId: string): TraceSpan[];
+    /**
+     * 导出 OpenTelemetry 格式
+     */
+    toOpenTelemetry(): object;
+    /**
+     * 生成 Trace ID
+     */
+    private generateTraceId;
+    /**
+     * 生成 Span ID
+     */
+    private generateSpanId;
+}
+export interface AlertRule {
+    id: string;
+    name: string;
+    description: string;
+    condition: (metrics: MetricsCollector) => boolean;
+    severity: 'info' | 'warning' | 'error' | 'critical';
+    message: string;
+    enabled: boolean;
+}
+export declare class AlertManager {
+    private rules;
+    private alerts;
+    /**
+     * 添加告警规则
+     */
+    addRule(rule: AlertRule): void;
+    /**
+     * 移除告警规则
+     */
+    removeRule(ruleId: string): void;
+    /**
+     * 检查告警
+     */
+    checkAlerts(metrics: MetricsCollector): Array<{
+        ruleId: string;
+        timestamp: number;
+        message: string;
+        severity: string;
+    }>;
+    /**
+     * 获取所有告警
+     */
+    getAlerts(): Array<{
+        ruleId: string;
+        timestamp: number;
+        message: string;
+        severity: string;
+    }>;
+    /**
+     * 清除告警
+     */
+    clearAlerts(): void;
+}
+export declare const DEFAULT_ALERT_RULES: AlertRule[];
+/**
+ * 获取全局指标收集器
+ */
+export declare function getMetricsCollector(): MetricsCollector;
+/**
+ * 获取全局追踪收集器
+ */
+export declare function getTraceCollector(): TraceCollector;
+/**
+ * 获取全局告警管理器
+ */
+export declare function getAlertManager(): AlertManager;
+/**
+ * 初始化监控系统
+ */
+export declare function initMonitoring(): {
+    metrics: MetricsCollector;
+    traces: TraceCollector;
+    alerts: AlertManager;
+};
+//# sourceMappingURL=metrics.d.ts.map

package/lib/monitoring/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/monitoring/metrics.ts"],"names":[],"mappings":"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"}