Important change for Kopano Groupware Core >=8.6.82.110

fbartels

Starting with todays Kopano Groupware Core nightly builds (8.6.82.110) the server process contains a new reporting functionality that is sending basic usage statistics back to us at Kopano. The transmitted statistics include:

an unique machine ID
the name of the submitting program
the version of the submitting program
an internal Kopano server GUID
an OS identifier
an identifier for the Kernel and architecture used
the configured Kopano user plugin
the amount of active users
the amount of contacts created
the number of inactive users (split in users, equipment and rooms)

Internally we are also enhancing these stats with a timestamp for first time this system sent a report and the last time the system contacted us.

Below is an example of how we store such a report internally:

+------------------------------------------------------------------+------------------------------------------------------------------+------------------------------------------------------------------+---------------------+---------------------+----------------+-----------------+-------------------+-----------------+-------------------+------------+------------------------------+--------------------------------------------+---------------+-----------------+-------+
| uid                                                              | machine_id_sha256                                                | server_guid_sha256                                               | first_seen          | last_update         | usercnt_active | usercnt_contact | usercnt_equipment | usercnt_na_user | usercnt_nonactive | userplugin | osrelease                    | utsname                                    | program_name  | program_version | flags |
+------------------------------------------------------------------+------------------------------------------------------------------+------------------------------------------------------------------+---------------------+---------------------+----------------+-----------------+-------------------+-----------------+-------------------+------------+------------------------------+--------------------------------------------+---------------+-----------------+-------+
| 021612ba5bf55f097b9f2cba53b108e876329aa99a74bf879daa9d9c555bc259 | bb1f4f2d3541a1d9b0dd7416737608bedee162e442ed3c2c33aecfa26cefef19 | 48dfb2111e373d67ec034e0d26a37c8a7f81b84d864ac6b0c97022d7416661e4 | 2018-10-16 13:12:52 | 2018-10-16 13:12:52 |              0 |               0 |                 0 |               0 |                 0 | db         | Debian GNU/Linux buster/sid  | Linux x86_64 4.18.0-1-amd64                | kopano-server | 8.6.82          |     0 |
+------------------------------------------------------------------+------------------------------------------------------------------+------------------------------------------------------------------+---------------------+---------------------+----------------+-----------------+-------------------+-----------------+-------------------+------------+------------------------------+--------------------------------------------+---------------+-----------------+-------+

We hope to learn a bit more about our user base from these reports.

How to turn the survey reporting off?

The following configuration options in server.cfg have an influence over the report sending:

surveyclient_url
surveyclient_interval
surveyclient_ssl_verify

To disable sending if reports it is sufficient to include the line surveyclient_interval=0 in your server.cfg

At the moment of writing this post, the above mentioned configuration options are not yet included in the example configuration and man pages, we plan to address this with KC-1320.

Gerald

Thanks for being open about this! What is the default reporting interval of nothing is configured in server.cfg?

fbartels

Hi @Gerald,

at this moment this is triggered every 3600 seconds. Eventually we want to increase this to e.g. once a day.

For more info see https://stash.kopano.io/projects/KC/repos/kopanocore/browse/provider/server/ECServer.cpp#1009-1011