Sidebar
zh:manual:api:reference:history:get
获取
描述
整数/数组 history.get(object parameters)
该方法允许根据给定的参数检索历史数据 参考: known issues
参数
(object) 定义期望输出的参数.
该方法支持以下参数：
| 参数 | 类型 | 描述 |
|---|---|---|
| history | 整数 | 要返回的历史对象类型. 可能的值: 0 - 数字浮点; 1 - 字符串; 2 - 日志; 3 - 无符号数字; 4 - 文本. 默认值: 3. |
| hostids | 字符串/数组 | 只返回给定主机的历史记录 |
| itemids | 字符串/数组 | 只返回给定监控项的历史记录 |
| time_from | 时间戳 | 仅返回在给定时间时或之后收到的值 |
| time_till | 时间戳 | 仅返回在给定时间时或之前收到的值 |
| sortfield | 字符串/数组 | 按照给定的属性对结果进行排序 可能的值: itemid 或 clock |
| countOutput | 布尔值 | 这些参数对于所有get方法都是通用的，详细描述可参考： reference commentary |
| editable | 布尔值 | |
| excludeSearch | 布尔值 | |
| filter | 对象 | |
| limit | 整数 | |
| output | 查询 | |
| search | 对象 | |
| searchByAny | 布尔值 | |
| searchWildcardsEnabled | 布尔值 | |
| sortorder | 字符串/数组 | |
| startSearch | 布尔值 | |
返回值
(整数/数组) 返回:
- 一组对象
- 如果使用了
countOutput参数，返回检索对象的数量
示例
获取监控项历史数据
从数字(浮点)监控项中获取最近10条数据
请求:
{ "jsonrpc": "2.0", "method": "history.get", "params": { "output": "extend", "history": 0, "itemids": "23296", "sortfield": "clock", "sortorder": "DESC", "limit": 10 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 }
响应:
{ "jsonrpc": "2.0", "result": [ { "itemid": "23296", "clock": "1351090996", "value": "0.0850", "ns": "563157632" }, { "itemid": "23296", "clock": "1351090936", "value": "0.1600", "ns": "549216402" }, { "itemid": "23296", "clock": "1351090876", "value": "0.1800", "ns": "537418114" }, { "itemid": "23296", "clock": "1351090816", "value": "0.2100", "ns": "522659528" }, { "itemid": "23296", "clock": "1351090756", "value": "0.2150", "ns": "507809457" }, { "itemid": "23296", "clock": "1351090696", "value": "0.2550", "ns": "495509699" }, { "itemid": "23296", "clock": "1351090636", "value": "0.3600", "ns": "477708209" }, { "itemid": "23296", "clock": "1351090576", "value": "0.3750", "ns": "463251343" }, { "itemid": "23296", "clock": "1351090516", "value": "0.3150", "ns": "447947017" }, { "itemid": "23296", "clock": "1351090456", "value": "0.2750", "ns": "435307141" } ], "id": 1 }
来源
CHistory::get() in frontends/php/include/classes/api/services/CHistory.php.