Agologging

Revision as of 21:56, 20 May 2014

Ago Logging Discussion

This page was created as a means for community input in regards to a centralized ago control log file and what should be contained within the log file.

Example log file

Here is an example of how one home automation package logs it's transactions:

12/20/2010 6:48:57 AM ~!~X10 Received~!~B12 (1st Floor Living Room LRMotion)  B On
12/20/2010 6:48:57 AM ~!~Info~!~Event Trigger "LR Lights On Morning"
12/20/2010 6:48:57 AM ~!~Info~!~Device: 1st Floor Living Room FloorLamp (A3+2) ON
12/20/2010 6:55:15 AM ~!~X10 Received~!~B12 (1st Floor Living Room LRMotion)  B Off
12/20/2010 7:10:03 AM ~!~X10 Received~!~B3 (1st Floor Living Room Keypad)  B Off
12/20/2010 7:10:03 AM ~!~X10 Received~!~B12 (1st Floor Living Room LRMotion)  B On
12/20/2010 7:10:03 AM ~!~Info~!~Event Trigger "RemoteOff"
12/20/2010 7:10:03 AM ~!~Info~!~Device: 1st Floor Living Room FloorLamp (A3+2) OFF
12/20/2010 7:12:55 AM ~!~X10 Received~!~B9 (1st Floor Garage GarageMotion)  B On
12/20/2010 7:13:50 AM ~!~X10 Received~!~B9 (1st Floor Garage GarageMotion)  B Off
12/20/2010 7:27:00 AM ~!~Info~!~Event Trigger "Nightlight Off"
12/20/2010 7:27:00 AM ~!~Info~!~Device: 1st Floor Gracie Nightlight (A9) OFF
12/20/2010 8:11:03 AM ~!~Info~!~Event Trigger "RemoteOn"
12/20/2010 8:11:03 AM ~!~Info~!~Device: 1st Floor Living Room FloorLamp (A3+2) ON
12/20/2010 5:01:57 PM ~!~X10 Received~!~B9 (1st Floor Garage GarageMotion)  B On
12/20/2010 5:01:57 PM ~!~Info~!~Event Trigger "Coming Home Lights On"
12/20/2010 5:01:57 PM ~!~Info~!~Device: 1st Floor Living Room FloorLamp (A3+2) ON
12/20/2010 5:03:32 PM ~!~X10 Received~!~B12 (1st Floor Living Room LRMotion)  B On
12/20/2010 5:04:00 PM ~!~X10 Received~!~B9 (1st Floor Garage GarageMotion)  B Off
12/20/2010 5:08:21 PM ~!~X10 Received~!~B12 (1st Floor Living Room LRMotion)  B Off
12/20/2010 10:21:07 PM ~!~X10 Received~!~B3 (1st Floor Living Room Keypad)  B Off
12/20/2010 10:21:07 PM ~!~Info~!~Event Trigger "RemoteOff"
12/20/2010 10:21:07 PM ~!~Info~!~Device: 1st Floor Living Room FloorLamp (A3+2) OFF
12/20/2010 11:59:58 PM ~!~System~!~Switching to a new log file. 

ago control Specifications

The log file should contain timestamped information regarding:

• Event/Scenario execution
• Device status changes (if logging enabled for device)
• Any error messages generated by device driver or system

ago control Sample Log Format

Below is a mock up of what the ago control formatted log could look like with various examples:

Event that turns lights on if motion is detected between 6:45AM-7:15AM:

05/20/2014 6:48:57 AM [agoX10] 1st Floor - Living Room LRMotion changed state to On
05/20/2014 6:48:57 AM [Info] Event Trigger "LR Lights On Morning"
05/20/2014 6:48:57 AM [agoX10] 1st Floor - Living Room FloorLamp changed state to On
05/20/2014 6:55:15 AM [agoX10] 1st Floor - Living Room LRMotion  changed state to Off

Environmental update:

05/20/2014 7:10:03 AM [agoweather] Outside Temperature value changed to 81F
05/20/2014 7:10:04 AM [agoweather] Outside Humidity value changed to 93%

LUA scripting changing thermostat setpoint values at a given time:

05/20/2014 10:00:00 PM [agolua] Thermostat Cool setpoint value changed to 75F
05/20/2014 10:00:02 PM [agolua] Thermostat Heat setpoint value changed to 65F

System messages:

05/20/2014 11:59:58 PM [System] Switching to a new log file.