用途:从 Auvik 监控平台查询时序性能统计,覆盖设备 CPU、内存、带宽、可用性,接口吞吐与错误率,服务(ping)延迟,硬件组件指标,以及自定义 SNMP 轮询器的 OID 历史值。全部为只读遥测数据。
主要能力:提供设备统计(stat_id 支持 bandwidth、cpuUtilization、memoryUtilization、storageUtilization、packetUnicast、packetMulticast、packetBroadcast,设 availability=true 时支持 uptime、outage)、接口统计(bandwidth、utilization、packetLoss、packetDiscard、packetMulticast、packetUnicast、packetBroadcast)、服务统计(pingTime、pingPacket)、组件统计(component_type 可选 cpu、cpuCore、disk、fan、memory、powerSupply、systemBoard;stat_id 含 capacity、power、temperature、utilization 等)以及 OID 即时值和 SNMP 轮询器历史。
使用方式:MCP 服务器为 auvik-mcp,命令 python3 mcp-servers/auvik-mcp/auvik_mcp_server.py(stdio 传输),采用 Basic 认证,需设置 AUVIK_USERNAME 与 AUVIK_API_KEY,可选 AUVIK_BASE_URL、AUVIK_VERIFY_SSL、AUVIK_TIMEOUT、AUVIK_MAX_PAGES。设备与父设备参数支持主机名、IP 或部分名称自动解析。时序工具必须提供 stat_id、from_time、interval;from_time 支持 ISO-8601 或 -1h、-7d、-30d 等相对写法,interval 取 minute、hour 或 day。component_type 在组件统计中必填。自定义 SNMP 轮询需先列出轮询器设置再拉取历史,且两者均需 tenants。
适用场景:设备健康检查与 CPU/内存趋势、接口吞吐与丢包排查、自定义 SNMP 轮询器调查、组件温度与电源审计,并可与库存、告警、生命周期等技能联动。
限制:仅只读,不能配置轮询器、修改轮询间隔或更改设备设置;auvik_get_oid_statistics 仅返回最近一次轮询值,不支持时间窗口;省略必填参数会返回 ValidationError;建议用设备名或 IP 而非内部 ID;若出现认证或连接错误应先检查环境变量,工具报错时如实反馈,不猜测结果。