matrix-docker-ansible-deploy/docs/configuring-playbook-telemetry.md
Slavi Pantaleev c0afcaa2e3 Replace (almost) all matrix-org/synapse references with element-hq/synapse
Issues and Pull Requests were not migrated to the new
organization/repository, so `matrix-org/synapse/pull` and
`matrix-org/synapse/issues` references were kept as-is.

`matrix-org/synapse-s3-storage-provider` references were also kept,
as that module still continues living under the `matrix-org` organization.

This patch mainly aims to change documentation-related things, not actual
usage in full yet. For polish that, another more comprehensive patch is coming later.
2024-01-17 08:02:47 +02:00

1.4 KiB

Enabling Telemetry for your Matrix server (optional)

By default, this playbook configures your Matrix homeserver to not send any telemetry data anywhere.

The matrix.org team would really appreciate it if you could help the project out by reporting usage statistics from your homeserver. Enabling usage statistics helps track the growth of the Matrix community, and helps to make Matrix a success.

Enabling Telemetry

If you'd like to help by enabling submission of general usage statistics for your homeserver, add this to your configuration file (inventory/host_vars/matrix.<your-domain>/vars.yml):

matrix_synapse_report_stats: true # for synapse

matrix_dendrite_report_stats: true # for dendrite

Usage statistics being submitted

When enabled, your homeserver will regularly upload a few dozen statistics about your server. This data includes your homeserver's domain, the total number of users, the number of active users, the total number of rooms, and the number of messages sent per day on your homeserver.

See Synapse's documentation or Dendrite's documentation for the full list of statistics that are reported.