trend.get

Descripción

integer/array trend.get(object parameters)

El método permite recuperar datos de tendencias de acuerdo con los parámetros dados.

Este método está disponible para usuarios de cualquier tipo. Los permisos para llamar al método se puede revocar en la configuración de roles de usuario. Ver Roles de usuario para obtener más información.

Parámetros

(object) Parámetros que definen la salida deseada.

El método admite los siguientes parámetros.

Parámetro Tipo Descripción
itemids ID/matriz Devolver solo tendencias con los identificadores de elementos indicados.
time_from timestamp Devolver solo valores que se hayan recopilado después o en el momento indicado.
time_till timestamp Devolver solo valores que se hayan recopilado antes o en el momento indicado.
countOutput booleano Cuenta la cantidad de objetos recuperados.
limit entero Limita la cantidad de objetos recuperados.
output consulta Establece las propiedades del objeto Tendencia que se devolverán.

Valores de retorno

(entero/matriz) Devuelve:

  • una matriz de objetos;
  • el recuento de objetos recuperados, si el parámetro countOutput ha sido usado.

Ejemplos

Recuperando datos de tendencias de métricas

Solicitud:

{
           "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.