Table of Contents
trend.get
Descripción
integer/array trend.get(object parameters)
El método permite recuperar datos de tendencias según los parámetros proporcionados.
Este método está disponible para usuarios de cualquier tipo. Los permisos para llamar al método pueden ser revocados en la configuración del rol de usuario. Consulte Roles de usuario para obtener más información.
Parámetros
(objeto) Parámetros que definen la salida deseada.
El método admite los siguientes parámetros.
| Parámetro | Tipo | Descripción |
|---|---|---|
| itemids | ID/array | Devolver solo tendencias con los IDs de métricas dados. |
| time_from | timestamp | Devolver solo valores que se hayan recogido después o en el momento dado. |
| time_till | timestamp | Devolver solo valores que se hayan recogido antes o en el momento dado. |
| countOutput | boolean | Contar el número de objetos recuperados. |
| limit | integer | Limitar la cantidad de objetos recuperados. |
| output | query | Establecer las propiedades del objeto Trend que se devolverán. |
Valores de retorno
(integer/array) Devuelve:
- un array de objetos;
- el número de objetos recuperados, si se ha utilizado el parámetro
countOutput.
Ejemplos
Recuperando datos de tendencias de métricas
{
"jsonrpc": "2.0",
"method": "trend.get",
"params": {
"output": [
"itemid",
"clock",
"num",
"value_min",
"value_avg",
"value_max",
],
"itemids": [
"23715"
],
"limit": "1"
},
"id": 1
}Respuesta:
{
"jsonrpc": "2.0",
"result": [
{
"itemid": "23715",
"clock": "1446199200",
"num": "60",
"value_min": "0.165",
"value_avg": "0.2168",
"value_max": "0.35",
}
],
"id": 1
}Fuente
CTrend::get() en ui/include/classes/api/services/CTrend.php.