@johnny-joster/n9e-plugin 1.0.0

package/src/tools/alert-rules.ts

@@ -0,0 +1,120 @@
+import type { ToolHandler } from "openclaw/plugin-sdk";
+import { N9eClient } from "../n9e-client.ts";
+import { n9ePluginConfigSchema } from "../config-schema.ts";
+import { SEVERITY_LABELS } from "../types.ts";
+
+export const alertRulesToolInputSchema = {
+  type: "object",
+  properties: {
+    rule_name: {
+      type: "string",
+      description: "按规则名称搜索(支持模糊匹配)"
+    },
+    datasource_ids: {
+      type: "array",
+      items: { type: "number" },
+      description: "数据源ID列表"
+    },
+    disabled: {
+      type: "number",
+      enum: [0, 1],
+      description: "规则状态: 0=启用, 1=禁用"
+    },
+    limit: {
+      type: "number",
+      minimum: 1,
+      maximum: 1000,
+      default: 50,
+      description: "返回数量限制"
+    }
+  }
+} as const;
+
+export const alertRulesToolHandler: ToolHandler = async (input, context) => {
+  try {
+    // Parse and validate config
+    const rawConfig = context.config.plugins?.entries?.["n9e-plugin"]?.config;
+    if (!rawConfig) {
+      return {
+        content: [{
+          type: "text",
+          text: "❌ 插件配置未找到,请在配置文件中添加n9e-plugin配置"
+        }],
+        isError: true
+      };
+    }
+
+    const config = n9ePluginConfigSchema.parse(rawConfig);
+    const client = new N9eClient(config);
+
+    // Query alert rules
+    const { total, list } = await client.getAlertRules({
+      rule_name: input.rule_name,
+      datasource_ids: input.datasource_ids,
+      disabled: input.disabled as 0 | 1 | undefined,
+      limit: input.limit || 50
+    });
+
+    // Format response
+    const rules = list.map(rule => ({
+      id: rule.id,
+      name: rule.name,
+      note: rule.note,
+      severity: rule.severity,
+      severity_label: SEVERITY_LABELS[rule.severity],
+      disabled: rule.disabled === 1,
+      status: rule.disabled === 1 ? "禁用" : "启用",
+      prom_ql: rule.prom_ql,
+      prom_for_duration: rule.prom_for_duration,
+      prom_eval_interval: rule.prom_eval_interval,
+      notify_channels: rule.notify_channels,
+      datasource_ids: rule.datasource_ids,
+      group_id: rule.group_id,
+      cluster: rule.cluster,
+      created_at: new Date(rule.create_at * 1000).toLocaleString("zh-CN", {
+        timeZone: "Asia/Shanghai"
+      }),
+      created_by: rule.create_by,
+      updated_at: new Date(rule.update_at * 1000).toLocaleString("zh-CN", {
+        timeZone: "Asia/Shanghai"
+      }),
+      updated_by: rule.update_by
+    }));
+
+    // Statistics
+    const enabledCount = rules.filter(r => !r.disabled).length;
+    const disabledCount = rules.filter(r => r.disabled).length;
+    const severityCount = rules.reduce((acc, rule) => {
+      const label = rule.severity_label;
+      acc[label] = (acc[label] || 0) + 1;
+      return acc;
+    }, {} as Record<string, number>);
+
+    const result = {
+      summary: {
+        total,
+        showing: rules.length,
+        enabled_count: enabledCount,
+        disabled_count: disabledCount,
+        severity_distribution: severityCount
+      },
+      rules
+    };
+
+    return {
+      content: [{
+        type: "text",
+        text: JSON.stringify(result, null, 2)
+      }]
+    };
+  } catch (error) {
+    context.logger.error("Failed to query alert rules:", error);
+    return {
+      content: [{
+        type: "text",
+        text: `❌ 查询告警规则失败: ${error instanceof Error ? error.message : String(error)}`
+      }],
+      isError: true
+    };
+  }
+};

package/src/tools/historical-alerts.ts

@@ -0,0 +1,134 @@
+import type { ToolHandler } from "openclaw/plugin-sdk";
+import { N9eClient } from "../n9e-client.ts";
+import { n9ePluginConfigSchema } from "../config-schema.ts";
+import { SEVERITY_LABELS, type AlertSeverity } from "../types.ts";
+
+export const historicalAlertsToolInputSchema = {
+  type: "object",
+  properties: {
+    severity: {
+      type: "number",
+      enum: [1, 2, 3],
+      description: "严重级别: 1=严重, 2=警告, 3=提示"
+    },
+    rule_name: {
+      type: "string",
+      description: "按规则名称筛选(支持模糊匹配)"
+    },
+    stime: {
+      type: "number",
+      description: "开始时间戳(秒)"
+    },
+    etime: {
+      type: "number",
+      description: "结束时间戳(秒)"
+    },
+    limit: {
+      type: "number",
+      minimum: 1,
+      maximum: 1000,
+      default: 50,
+      description: "返回数量限制"
+    }
+  }
+} as const;
+
+export const historicalAlertsToolHandler: ToolHandler = async (input, context) => {
+  try {
+    // Parse and validate config
+    const rawConfig = context.config.plugins?.entries?.["n9e-plugin"]?.config;
+    if (!rawConfig) {
+      return {
+        content: [{
+          type: "text",
+          text: "❌ 插件配置未找到,请在配置文件中添加n9e-plugin配置"
+        }],
+        isError: true
+      };
+    }
+
+    const config = n9ePluginConfigSchema.parse(rawConfig);
+    const client = new N9eClient(config);
+
+    // Validate time range
+    if (input.stime && input.etime && input.stime >= input.etime) {
+      return {
+        content: [{
+          type: "text",
+          text: "❌ 开始时间必须早于结束时间"
+        }],
+        isError: true
+      };
+    }
+
+    // Query historical alerts
+    const { total, list } = await client.getHistoricalAlerts({
+      severity: input.severity as AlertSeverity | undefined,
+      rule_name: input.rule_name,
+      stime: input.stime,
+      etime: input.etime,
+      limit: input.limit || 50
+    });
+
+    // Format response
+    const alerts = list.map(alert => {
+      const tags = alert.tags ? JSON.parse(alert.tags) : {};
+      return {
+        id: alert.id,
+        rule_name: alert.rule_name,
+        severity: alert.severity,
+        severity_label: SEVERITY_LABELS[alert.severity],
+        trigger_time: new Date(alert.trigger_time * 1000).toLocaleString("zh-CN", {
+          timeZone: "Asia/Shanghai"
+        }),
+        recover_time: alert.recover_time
+          ? new Date(alert.recover_time * 1000).toLocaleString("zh-CN", {
+              timeZone: "Asia/Shanghai"
+            })
+          : null,
+        is_recovered: alert.is_recovered === 1,
+        target_ident: alert.target_ident,
+        trigger_value: alert.trigger_value,
+        tags,
+        rule_note: alert.rule_note,
+        group_name: alert.group_name
+      };
+    });
+
+    // Statistics
+    const severityCount = alerts.reduce((acc, alert) => {
+      const label = alert.severity_label;
+      acc[label] = (acc[label] || 0) + 1;
+      return acc;
+    }, {} as Record<string, number>);
+
+    const recoveredCount = alerts.filter(a => a.is_recovered).length;
+
+    const result = {
+      summary: {
+        total,
+        showing: alerts.length,
+        severity_distribution: severityCount,
+        recovered_count: recoveredCount,
+        unrecovered_count: alerts.length - recoveredCount
+      },
+      alerts
+    };
+
+    return {
+      content: [{
+        type: "text",
+        text: JSON.stringify(result, null, 2)
+      }]
+    };
+  } catch (error) {
+    context.logger.error("Failed to query historical alerts:", error);
+    return {
+      content: [{
+        type: "text",
+        text: `❌ 查询历史告警失败: ${error instanceof Error ? error.message : String(error)}`
+      }],
+      isError: true
+    };
+  }
+};

package/src/types.ts

@@ -0,0 +1,180 @@
+// Configuration types
+export interface N9ePluginConfig {
+  apiBaseUrl: string;
+  apiKey: string;
+  timeout: number;
+}
+
+// Alert severity mapping
+export type AlertSeverity = 1 | 2 | 3;  // 1=严重, 2=警告, 3=提示
+
+export const SEVERITY_LABELS: Record<AlertSeverity, string> = {
+  1: "严重",
+  2: "警告",
+  3: "提示"
+};
+
+// Active alert (current event)
+export interface AlertCurEvent {
+  id: number;
+  cluster: string;
+  group_id: number;
+  group_name?: string;
+  hash: string;
+  rule_id: number;
+  rule_name: string;
+  rule_note: string;
+  severity: AlertSeverity;
+  prom_for_duration: number;
+  prom_ql: string;
+  prom_eval_interval: number;
+  callbacks: string;
+  runbook_url?: string;
+  notify_recovered: number;
+  notify_channels: string;
+  notify_groups: string;
+  notify_repeat_step: number;
+  notify_max_number: number;
+  recover_duration: number;
+  created_at: number;
+  updated_at: number;
+  tags: string;
+  target_ident: string;
+  target_note: string;
+  first_trigger_time?: number;
+  trigger_time: number;
+  trigger_value: string;
+  annotations?: string;
+  rule_config?: string;
+}
+
+// Historical alert event
+export interface AlertHisEvent {
+  id: number;
+  is_recovered: number;
+  cluster: string;
+  group_id: number;
+  group_name?: string;
+  hash: string;
+  rule_id: number;
+  rule_name: string;
+  rule_note: string;
+  severity: AlertSeverity;
+  prom_for_duration: number;
+  prom_ql: string;
+  prom_eval_interval: number;
+  callbacks: string;
+  runbook_url?: string;
+  notify_recovered: number;
+  notify_channels: string;
+  notify_groups: string;
+  notify_repeat_step: number;
+  notify_max_number: number;
+  recover_duration: number;
+  created_at: number;
+  updated_at: number;
+  tags: string;
+  target_ident: string;
+  target_note: string;
+  first_trigger_time?: number;
+  trigger_time: number;
+  trigger_value: string;
+  recover_time?: number;
+  last_eval_time?: number;
+  annotations?: string;
+  rule_config?: string;
+}
+
+// Alert rule
+export interface AlertRule {
+  id: number;
+  group_id: number;
+  cluster: string;
+  name: string;
+  note: string;
+  severity: AlertSeverity;
+  disabled: number;  // 0=enabled, 1=disabled
+  prom_for_duration: number;
+  prom_ql: string;
+  prom_eval_interval: number;
+  enable_stime?: string;
+  enable_etime?: string;
+  enable_days_of_week?: string;
+  enable_in_bg?: number;
+  notify_recovered: number;
+  notify_channels: string;
+  notify_repeat_step: number;
+  notify_max_number: number;
+  recover_duration: number;
+  callbacks: string;
+  runbook_url?: string;
+  append_tags?: string;
+  create_at: number;
+  create_by: string;
+  update_at: number;
+  update_by: string;
+  datasource_ids?: number[];
+  extra_config?: string;
+}
+
+// Alert mute
+export interface AlertMute {
+  id: number;
+  group_id: number;
+  cluster: string;
+  tags: string;
+  cause: string;
+  btime: number;
+  etime: number;
+  disabled: number;  // 0=enabled, 1=disabled
+  create_at: number;
+  create_by: string;
+  update_at: number;
+  update_by: string;
+}
+
+// Query parameters
+export interface ActiveAlertQuery {
+  severity?: AlertSeverity;
+  rule_name?: string;
+  limit?: number;
+  query?: string;
+  p?: number;  // page number
+}
+
+export interface HistoricalAlertQuery {
+  severity?: AlertSeverity;
+  rule_name?: string;
+  stime?: number;  // start timestamp (seconds)
+  etime?: number;  // end timestamp (seconds)
+  limit?: number;
+  p?: number;
+}
+
+export interface AlertRuleQuery {
+  rule_name?: string;
+  datasource_ids?: number[];
+  disabled?: 0 | 1;
+  p?: number;
+  limit?: number;
+}
+
+export interface AlertMuteQuery {
+  query?: string;
+  p?: number;
+  limit?: number;
+}
+
+// API response wrapper
+export interface N9eApiResponse<T> {
+  dat: T;
+  err: string;
+}
+
+export interface N9eListResponse<T> {
+  dat: {
+    list: T[];
+    total: number;
+  };
+  err: string;
+}

package/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "esModuleInterop": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "allowSyntheticDefaultImports": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": false,
+    "outDir": "./dist",
+    "allowImportingTsExtensions": true,
+    "noEmit": true
+  },
+  "include": ["src/**/*", "index.ts"],
+  "exclude": ["node_modules"]
+}