summary refs log tree commit diff
path: root/docs/upgrade.md
diff options
context:
space:
mode:
authorreivilibre <oliverw@matrix.org>2022-11-02 17:33:45 +0000
committerGitHub <noreply@github.com>2022-11-02 17:33:45 +0000
commit6546308c1e7d3eff316631a5909151dc6c7a9e1e (patch)
tree80060e3988f803498d594fb073a081c66a40c960 /docs/upgrade.md
parentAdjust changelog (diff)
downloadsynapse-6546308c1e7d3eff316631a5909151dc6c7a9e1e.tar.xz
Disable legacy Prometheus metric names by default. They can still be re-enabled for now, but they will be removed altogether in Synapse 1.73.0. (#14353)
Diffstat (limited to 'docs/upgrade.md')
-rw-r--r--docs/upgrade.md16
1 files changed, 16 insertions, 0 deletions
diff --git a/docs/upgrade.md b/docs/upgrade.md
index f095bbc3a6..41b06cc253 100644
--- a/docs/upgrade.md
+++ b/docs/upgrade.md
@@ -116,6 +116,22 @@ local users and some remote users is why the spec was changed/clarified and this
 caveat is no longer supported.
 
 
+## Legacy Prometheus metric names are now disabled by default
+
+Synapse v1.71.0 disables legacy Prometheus metric names by default.
+For administrators that still rely on them and have not yet had chance to update their
+uses of the metrics, it's still possible to specify `enable_legacy_metrics: true` in
+the configuration to re-enable them temporarily.
+
+Synapse v1.73.0 will **remove legacy metric names altogether** and at that point,
+it will no longer be possible to re-enable them.
+
+If you do not use metrics or you have already updated your Grafana dashboard(s),
+Prometheus console(s) and alerting rule(s), there is no action needed.
+
+See [v1.69.0: Deprecation of legacy Prometheus metric names](#deprecation-of-legacy-prometheus-metric-names).
+
+
 # Upgrading to v1.69.0
 
 ## Changes to the receipts replication streams