用途:从 Zabbix 获取已轮询采集的指标历史,包括接口利用率、计数器以及任何被采集的 item,可指定时间窗口。底层为第三方 zabbix-mcp 服务器(GPL-3.0,固定提交 0722f48),提供 zabbix_api、zabbix_api_docs、zabbix_api_list 三个工具,只读,通过强制标志与破坏性方法拒绝名单双重约束。
必要用法(必须按顺序):先用 item.get 获取 itemid、value_type、history、trends、units;再调用 history.get 时传入该 item 真实的 value_type,不能沿用默认值(默认 3,而多数接口计数器为 0/float)。不可在一次调用中混用不同值类型,应按 value_type 分组、分次查询再合并。按窗口路由:窗口在 history 范围内用 history.get 取原始值;超出 history 但 trends>0 用 trend.get 取每小时最小值/平均值/最大值(仅数值);跨边界则两者合并并说明来源;两者皆超出则未保留。
限制与注意:返回空数组可能对应五种原因(值类型错、已过期、保留被禁用、从未采集、真正空闲),需区分措辞,不能笼统报“无数据”。回答应包含来源主机/item、实际服务窗口、原始值或小时聚合、单位、Zabbix 时钟、时区、结果上限及缩小查询方式;拒绝未来窗口或起止颠倒并说明原因;同一 item key 存在于多主机时不得未声明地合并。该集成为只读,无写入路径,且没有逐调用审计轨迹。