Domogik is now delivered with 2 xPL hubs:
As the C hub has an issue on some servers, the python hub is now used as the default one. This new hub is better for analysing the xPL network as it maintains a list of all the xpl clients and some statistics on them (number of valid and invalid messages, last time seen, ...). It also logs all the invalid xpl messages.
The configuration file is /etc/domogik/xplhub. All the configuration items are related to the logs. The content of this file is enough to understand how to tune it. The default configuration is enough for all end users. Only the developpers may need to increase the logs verbosity.
The default folder for the logs is /var/log/xplhub/. Several log files are created:
client_list.txt:
| Client id | Client source | Interval | Last seen | Status | Nb OK | Nb KO |
|-----------------------+------------------------------------+----------+----------------------------+---------+--------+--------|
| 192.168.1.10_43879 | domogik-manager.darkstar | 5 | 2013-01-06T17:14:55.641510 | alive | 11 | 0 |
| 192.168.1.10_45993 | domogik-dbmgr.darkstar | 5 | 2013-01-06T17:14:59.044806 | alive | 9 | 0 |
| 192.168.1.10_57712 | domogik-rest.darkstar | 5 | 2013-01-06T17:14:59.343223 | alive | 1 | 0 |
|-----------------------+------------------------------------+----------+----------------------------+---------+--------+--------|
This log file contains the list of all the clients that the hub has seen, even if they have been stopped or if they disappear.
bandwidth.csv:
192.168.1.10_57712 ; 1357488915.05 ; domogik-rest.darkstar ; hbeat.app ; xpl-stat
192.168.1.50_54361 ; 1357488915.05 ; domogik-teleinfo.ambre ; hbeat.app ; xpl-stat
192.168.1.50_54937 ; 1357488915.05 ; domogik-wol_ping.ambre ; hbeat.app ; xpl-stat
192.168.1.50_56589 ; 1357488915.06 ; domogik-diskfree.ambre ; hbeat.app ; xpl-stat
192.168.1.50_33303 ; 1357488915.06 ; domogik-rest.ambre ; hbeat.app ; xpl-stat
192.168.1.50_58976 ; 1357488915.06 ; domogik-xpl_time.ambre ; hbeat.app ; xpl-stat
192.168.1.50_47922 ; 1357488915.06 ; domogik-manager.ambre ; hbeat.app ; xpl-stat
192.168.1.50_49465 ; 1357488915.06 ; domogik-dbmgr.ambre ; hbeat.app ; xpl-stat
192.168.1.50_58976 ; 1357488927.23 ; domogik-xpl_time.ambre ; datetime.basic ; xpl-trig
192.168.1.50_47922 ; 1357488927.64 ; domogik-manager.ambre ; hbeat.request ; xpl-cmnd
192.168.1.50_54937 ; 1357488927.64 ; domogik-wol_ping.ambre ; hbeat.app ; xpl-stat
192.168.1.50_56589 ; 1357488927.65 ; domogik-diskfree.ambre ; hbeat.app ; xpl-stat
192.168.1.10_45993 ; 1357488927.65 ; domogik-dbmgr.darkstar ; hbeat.app ; xpl-stat
This log file will track all the xpl messages on the network. The columns are:
- the client id (ip and port used by the xpl client)
- the timestamp
- the source
- the message schema
- the message type
invalid_data.csv: this file contains all the invalid xpl messages =.
xplhub.log: this is the hub log file.