Important change for Kopano Groupware Core >=8.6.82.110

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.

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

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