eventlog

Return data from the event log

Description#

https://api.eze.io/v1/eventlog/{serial}/from={datetime}/[to={datetime}]

Parameters#

`serial`	The serial number of the ezeio (XYZ987)
`from=datetime`	The beginning of the range. Format per RFC3339, or 1m/1h/1d
`to=datetime`	The end of the range. Format per RFC3339. If omitted, current time is assumed.

The from parameter can be given as number of minutes/hours/days relative to current time. For example from=90m means “90 minutes ago”.

Under no circumstances will the call return more than 300 rows of data.

Example usage#

https://api.eze.io/v1/eventlog/XYZ987/from=2017-03-01/to=2017-03-15

Return value#

JSON formatted data including the event specifics as well as a snapshot of all field values at the time of the event.

(below examples have whitespaces added for readability)

Example query:
https://api.eze.io/v1/eventlog/baa157/from=2019-02-01/to=2019-03-01
 
{
  "reqtime":"2019-10-28T20:58:06Z",
  "reqfrom":"2019-10-20T00:00:00Z",
  "reqto":"2020-01-18T00:00:00Z",
  "events":[
    {
    "time":"2019-10-28T20:48:17Z",
    "eventid":72857,
    "type":"ALARM",
    "source":"SCRIPT",
    "sourcename":"USER",
    "actionname":"My homemade script",
    "param1":"111.000000",
    "param2":"222.000000",
    "param3":"333.000000",
    "param4":"444.000000",
    "message":"The text sent from the script call",
    "meta":{
      "serial":"BAA-144",
      "group":102,
      "accountgroupid":2,
      "uptime":544,
      "name":"Test board 144",
      "tzofs":"-420"
    },
    "adc":{
      "1":4,
      "2":2,
      "3":2,
      "4":2,
      "5":2,
      "6":4,
      "7":1554,
      "8":29665,
      "Vin":12350,
      "Vbat":12172,
      "V5":5054
    },
    "out":{
      "1":0,
      "2":100,
      "3":100,
      "4":47
    },
    "pos":{
      "x":0,
      "y":0,
      "z":0,
      "signal":0
    },
    "fields":{
      "1":{
        "name":"Humidity",
        "unit":"%",
        "assettag":"",
        "value":"38.4"
      },
      "2":{
        "name":"Temperature",
        "unit":"°F",
        "assettag":"temp",
        "value":"82.45"
      }
    }
  ],
  "status":"OK",
  "exec_time":0.025
}

Last updated Aug 24, 2021