hollie/misterhouse — pull request #240 by krkeegan (2013-07-25 02:35:06+00:00)
Title: Insteon: Detailed Tracking and Reporting of Statistics Related to Message

In the most simple terms, this adds (or will add once we merge the voice commands changes) the following new voice commands:

Print Message Stats -> $device->print_message_log
Reset Message Stats -> $device->reset_message_log
Print All Message Stats -> ::Insteon::print_message_logs
Reset All Message Stats -> ::Insteon::reset_message_logs

Print Message Stats - Prints the following detail to the print log file:

- In - The number of incoming messages received
- Corrupt - The number of incoming corrupt messages received
- %Corrpt - Of the incoming messages received, the percentage that were corrupt
- Dupe - The number of duplicate messages that have been received from this device.
- %Dupe - The percentage of duplilicate incoming messages received.
- Hops_Left - The average hops left in the messages received from this device.
- Max_Hops - The average maximum hops in the messages received from this device.
- Act_Hops = Max_Hops - Hops_Left, this is the average number of hops that have been required for a message sent from the device to reach MisterHouse.
- Out - The number of unique outgoing messages, without retries, sent.
- Fail - The number times that all retries were exhausted without a successful delivery of a message.
- %Fail - Of the outgoing messages sent, the percentage that failed.
- Retry - The number of retry attempts that have been made to deliver a message. Ideally this is 0, but Sends/Msg is a better indication of this parameter.
- AvgSend - The average number of send attempts that must be made in order to successfully deliver a message. Ideally this would be 1.0.
NOTE: If the number of retries exceeds the value set in the configuration file for Insteon_retry_count, MisterHouse will abandon sending the message. As a result, as this number approaches Insteon_retry_count it becomes a less accurate representation of the number of retries needed to reach a device.
- Avg_Hops - The average number of hops that have been used by MisterHouse when sending messages to this device.
- Hop_Count - The current hop count being used by MH. This count is dynamically controlled by MH and is not reset by calling reset_message_log

Print All Message Stats - Prints the same information above for all devices, plus it prints a nice summary of the average for the entire network.

Reset [All] Message Stats - Resets all of the logs and counters to 0.