add report_stats_endpoint config option

changelog.d/6012.feature

@@ -0,0 +1 @@
+Add report_stats_endpoint option to configure where stats are reported to, if enabled

docs/sample_config.yaml

@@ -978,6 +978,8 @@ metrics_flags:
 # Whether or not to report anonymized homeserver usage statistics.
 # report_stats: true|false
 
+# The endpoint where to report the anonymized homeserver usage statistics to. Defaults to matrix.org
+# report_stats_endpoint: "https://matrix.org/report-usage-stats/push"
 
 ## API Configuration ##
 

synapse/app/homeserver.py

@@ -561,11 +561,16 @@ def phone_stats_home():
 
  stats["database_engine"] = hs.get_datastore().database_engine_name
  stats["database_server_version"] = hs.get_datastore().get_server_version()
- logger.info("Reporting stats to matrix.org: %s" % (stats,))
+ logger.info("Reporting stats: %s" % (stats,))
  try:
- yield hs.get_simple_http_client().put_json(
- "https://matrix.org/report-usage-stats/push", stats
- )
+ if hs.config.report_stats_endpoint:
+ yield hs.get_simple_http_client().put_json(
+ hs.config.report_stats_endpoint, stats
+ )
+ else:
+ yield hs.get_simple_http_client().put_json(
+ "https://matrix.org/report-usage-stats/push", stats
+ )
  except Exception as e:
  logger.warn("Error reporting stats: %s", e)
 

synapse/config/metrics.py

@@ -39,6 +39,7 @@ class MetricsConfig(Config):
  def read_config(self, config, **kwargs):
  self.enable_metrics = config.get("enable_metrics", False)
  self.report_stats = config.get("report_stats", None)
+ self.report_stats_endpoint = config.get("report_stats_endpoint", None)
  self.metrics_port = config.get("metrics_port")
  self.metrics_bind_host = config.get("metrics_bind_host", "127.0.0.1")