Zabbix 5调用trend.get接口返回值与图表显示数值不一致如何解决

问题原因 #

• 参数配置错误：你在请求中添加了limit: "1"参数，该参数会强制接口仅返回时间范围内第一条趋势数据（即首个小时的聚合结果），而非你指定的24小时全时段聚合结果，前端图表默认展示的是所选时间范围内的所有数据聚合，二者统计维度完全不一致。
• 数据来源不一致：Zabbix前端图表默认会优先展示未过期的原始采集数据（即history表数据），仅当查询时间范围超过history存储周期时才会降级到小时聚合的trend表数据，如果你查询的24小时范围仍在history存储周期内，前端展示的是原始数据聚合结果，和你调用trend接口拿到的小时预聚合结果自然存在偏差。
• 参数类型错误：time_from和time_till参数在Zabbix API中要求输入整数类型，你传入了带引号的字符串类型，部分Zabbix 5版本存在字符串解析异常，可能导致时间范围过滤错误。
• 时区不匹配：你使用的Unix时间戳为UTC时区，如果Zabbix前端配置了用户自定义时区（比如东八区），前端展示的时间范围和你指定的时间范围实际并不重合，会导致数值对不上。
• 数值格式异常：你返回结果中value_avg数值中间存在空格，属于复制或接口返回的格式异常，未清洗直接计算也会导致结果偏差。

解决方案 #

• 修正trend接口请求参数：如果要获取全24小时的聚合数据，删除limit: "1"参数，拿到所有小时的trend数据后自行计算全局的均值、最大值、最小值即可，同时将时间参数改为整数类型。
  修正后的请求示例：

curl -L -k -i -X POST -H 'Content-Type:application/json' -d '{"jsonrpc":"2.0","method":"trend.get","id":1,"auth":"1a543455bd48e6ddc222219acccb52e9","params" : {"output": ["clock","value_avg","value_min","value_max","num", "itemid"],"itemids":["10234"],"time_from": 1632112200,"time_till": 1632198600}}' https://172.30.134.03:423/api_jsonrpc.php

• 对齐数据来源：先在Zabbix后台确认该监控项的history存储周期（默认是7天），如果查询时间范围在history存储周期内，改为调用history.get接口获取原始采集值后再做聚合，结果会和前端展示完全一致。
• 对齐时区：确认Zabbix前端用户的时区配置，将时间范围转换为对应时区的Unix时间戳后再调用接口，避免时间范围偏移。
• 清洗返回数值：先将返回结果中数值字段的多余空格删除后再做计算，避免解析错误。

内容的提问来源于stack exchange，提问作者BlackCrystal