Documentation
Table of Contents
history.get
¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô
integer/array history.get(object parameters)
El m¨¦todo permite recuperar datos hist¨®ricos de acuerdo con los par¨¢metros suministrados.
Este m¨¦todo puede devolver datos hist¨®ricos de una m¨¦trica eliminada si estos datos no han sido eliminados todav¨ªa por la tarea de limpieza.
::: nota cl¨¢sica Este m¨¦todo est¨¢ disponible para usuarios de cualquier tipo. Permisos llamar al m¨¦todo se puede revocar en la configuraci¨®n de roles de usuario. Ver Usuario roles para m¨¢s informaci¨®n. :::
±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ
(objeto) ±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ que definen la salida deseada.
El m¨¦todo admite los siguientes par¨¢metros.
| ±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç | Tipo | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
|---|---|---|
| history | entero | Tipos de objetos de historial a devolver. Valores posibles: 0 - n¨²mero flotante. 1 - car¨¢cter; 2 - registro; 3 - (predeterminado ) num¨¦rico sin signo; 4 - texto; 5 - binario. |
| hostids | ID/matriz | Devuelve solo el historial de los equipos dados. |
| itemids | ID/array | Devuelve solo el historial de las m¨¦tricas dadas. |
| time_from | timestamp | Devuelve solo los valores que se han recibido despu¨¦s o en el momento indicado. |
| time_till | marca de tiempo | Devuelve solo los valores que se han recibido antes o en el momento dado. |
| sortfield | string/array | Ordena el resultado seg¨²n las propiedades dadas. Valores posibles: itemid, clock, ns. |
| countOutput | booleano | Estos par¨¢metros, que son comunes para todos los m¨¦todos get, se describen en detalle en la p¨¢gina comentario de referencia. |
| editable | booleano | |
| excludeSearch | booleano | |
| filter | objeto | |
| limit | entero | |
| output | consulta | |
| search | objeto | |
| searchByAny | booleano | |
| searchWildcardsEnabled | booleano | |
| sortorder | cadena/matriz | |
| startSearch | booleano |
Valores de retorno
(entero/matriz) Devuelve:
- una matriz de objetos;
- el recuento de objetos recuperados, si el par¨¢metro
countOutputha sido usado.
Ejemplos
Recuperando datos del historial de m¨¦tricas
Devuelve los 10 ¨²ltimos valores recibidos de una m¨¦trica num¨¦rica (flotante).
{
"jsonrpc": "2.0",
"method": "history.get",
"params": {
"output": "extend",
"history": 0,
"itemids": "23296",
"sortfield": "clock",
"sortorder": "DESC",
"limit": 10
},
"id": 1
}Respuesta:
{
"jsonrpc": "2.0",
"result": [
{
"itemid": "23296",
"clock": "1351090996",
"value": "0.085",
"ns": "563157632"
},
{
"itemid": "23296",
"clock": "1351090936",
"value": "0.16",
"ns": "549216402"
},
{
"itemid": "23296",
"clock": "1351090876",
"value": "0.18",
"ns": "537418114"
},
{
"itemid": "23296",
"clock": "1351090816",
"value": "0.21",
"ns": "522659528"
},
{
"itemid": "23296",
"clock": "1351090756",
"value": "0.215",
"ns": "507809457"
},
{
"itemid": "23296",
"clock": "1351090696",
"value": "0.255",
"ns": "495509699"
},
{
"itemid": "23296",
"clock": "1351090636",
"value": "0.36",
"ns": "477708209"
},
{
"itemid": "23296",
"clock": "1351090576",
"value": "0.375",
"ns": "463251343"
},
{
"itemid": "23296",
"clock": "1351090516",
"value": "0.315",
"ns": "447947017"
},
{
"itemid": "23296",
"clock": "1351090456",
"value": "0.275",
"ns": "435307141"
}
],
"id": 1
}Fuente
CHistory::get() en ui/include/classes/api/services/CHistory.php.