Telemetry

TIP

Telemetry was added to EMQ X in version 4.2-rc.1.

EMQ collects information about the usage of EMQ X through telemetry. This function is designed to provide us with comprehensive information about users and communities, as well as an understanding of how EMQ X is used. Sharing these metrics with us can help us better understand how you use our products and can continuously help us improve our products.

These statistics do not contain individual data, such as server model, hardware number, IP address, and will never be shared with anyone else.

Telemetry data example

Telemetry reports data to by encrypting HTTP requests https://telemetry.emqx.io/api/telemetry. If you have any questions, please click IssuesTelemetry - 图1 (opens new window) to contact us:

  1. {
  2.   "license": {
  3.     "edition": "community"
  4.   },
  5.   "nodes_uuid": [],
  6.   "active_plugins": [
  7.     "emqx_telemetry",
  8.     "emqx_retainer",
  9.     "emqx_recon",
  10.     "emqx_management",
  11.     "emqx_dashboard"
  12.   ],
  13.   "active_modules": [
  14.     "emqx_mod_presence",
  15.     "emqx_mod_acl_internal"
  16.   ],
  17.   "num_clients": 0,
  18.   "messages_received": 0,
  19.   "messages_sent": 0,
  20.   "emqx_version": "4.2-rc.1",
  21.   "os_name": "Ubuntu",
  22.   "os_version": "16.04.6 LTS (Xenial Xerus)",
  23.   "otp_version": "22",
  24.   "up_time": 7081,
  25.   "uuid": "D6138FCE-E455-11EA-A854-FD8F5F98125F"
  26. }

Telemetry is enabled by default. Any people may feel uncomfortable collecting such data. You can disable it in the simplest way before startup and during operation.

Disable before start EMQ X

Edit data/loaded_plugins file, and remove the line of emqx_telemetry. (Note that there is a “.” character at the end of the line）, which means that the telemetry plug-in will never start.

Disable in running

Stop the emqx_telemetry plugin in the command line: ./bin/emqx_ctl plugins unload emqx_telemetry

Stop emqx_telemetry plugin in the Dashboard: Open http://localhost:18083 to enter Dashboard, enter the plugin page, find emqx_telemetry and click Stop button.