SuperAPI AI 工具集

auvik-network-alerts

通用与其它

查看项目

更新于 10-15 17:21

技能介绍

用途:呈现、筛选并分类 Auvik 网络监控平台产生的告警,适用于 MSP 多租户环境下的日常告警梳理、单设备排查和事件事后复盘。所有操作为只读,无法通过本技能关闭、确认或修改告警状态,告警管理需在 Auvik Dashboard 中完成。

主要能力:核心工具 auvik_list_alerts 可列出告警历史,并按严重级别(emergency、critical、warning、info、unknown)、状态(created、resolved、paused、unpaused)、是否已忽略、实体、时间窗口或告警定义进行筛选;entity 参数接受设备名、主机名或 IP,服务器会解析为 Auvik 内部实体 ID,若匹配多个设备则返回 ResolutionCandidate[] 供进一步缩小范围。dismissed=false 可排除已忽略告警,dismissed=true 可查看忽略记录与时间;detected_time_after 与 detected_time_before 接受 ISO-8601 时间字符串以限定复盘窗口。分页由 AUVIK_MAX_PAGES 控制,fetch_all=false 可用于大告警队列的增量加载。

使用方式:通过 MCP 服务器 auvik-mcp 运行,命令为 python3 mcp-servers/auvik-mcp/auvik_mcp_server.py(stdio 传输),使用 AUVIK_USERNAME 与 AUVIK_API_KEY 进行 Basic 认证。必需环境变量为 AUVIK_USERNAME、AUVIK_API_KEY;可选包括 AUVIK_BASE_URL(默认 https://auvikapi.us1.my.auvik.com,可按区域替换 us1)、AUVIK_VERIFY_SSL、AUVIK_TIMEOUT(默认 30 秒)、AUVIK_MAX_PAGES(默认 50)。典型流程为先开启 GAIT 分支记录会话,再列出未忽略的开放告警,按严重级别或租户收窄,结合 auvik-inventory 获取设备详情,并把摘要提交到 GAIT。

适用场景:晨间告警梳理、针对特定设备的告警历史排查、事件复盘时的告警时间线拉取,并可与其他技能(如 auvik-lifecycle、auvik-performance、servicenow-change-workflow)交叉印证。

限制:仅支持 GET 只读操作;设备需以名称或 IP 而非 Auvik 实体 ID 引用;MSP 环境应指定 tenants 以免混入其他客户告警;已忽略与已解决含义不同,不可混同。若工具调用出现认证或连接错误,应先检查三个环境变量是否有效;遇到超时、主机不可达或响应异常时,应直接向用户报告错误信息,不得编造结果。其他未在资料中说明的功能、收费与平台支持情况暂未提供。