xPL hub overview

Domogik is now delivered with 2 xPL hubs:

  • the C xPL hub which was used wince the first Domogik release.
  • the new python xPL hub.

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.

F.A.Q

  • Q: I want to use the C hub instead of the python hub. How can I do ?
  • R: On Domogik installation, add the –hub_c option to the ./install.sh command. After the installation, you can switch by editing /etc/default/domogik and setting DOMOGIK_XPL_HUB to c (or python for the new hub)
  • Q: Where are the hub log files ?
  • R: The C hub has no log files. The python hub log files are in /var/log/xplhub/. You can also customize the loglevel in the hub config file : /etc/domogik/xplhub.cfg.

The python hub

Configuration file

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.

Log files

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.