summary refs log tree commit diff
path: root/UPGRADE.rst
diff options
context:
space:
mode:
authorAndrew Morgan <andrew@amorgan.xyz>2021-04-21 14:53:02 +0100
committerAndrew Morgan <andrew@amorgan.xyz>2021-04-21 14:54:03 +0100
commita0972085ed2b06bdaaf94a2265cb3512c85423b8 (patch)
treef86e21530ab24f07ceb26a9e723d6909d84f28c1 /UPGRADE.rst
parentMention Prometheus metrics regression in v1.32.0 (diff)
parentClarify 1.32.0/1 changelog and upgrade notes (diff)
downloadsynapse-a0972085ed2b06bdaaf94a2265cb3512c85423b8.tar.xz
Merge tag 'v1.32.1'
Synapse 1.32.1 (2021-04-21)
===========================

This release fixes [a regression](https://github.com/matrix-org/synapse/issues/9853) in Synapse 1.32.0 that caused connected Prometheus instances to become unstable. If you ran Synapse 1.32.0 with Prometheus metrics, first upgrade to Synapse 1.32.1 and follow [these instructions](https://github.com/matrix-org/synapse/pull/9854#issuecomment-823472183) to clean up any excess writeahead logs.

Bugfixes
--------

- Fix a regression in Synapse 1.32.0 which caused Synapse to report large numbers of Prometheus time series, potentially overwhelming Prometheus instances. ([\#9854](https://github.com/matrix-org/synapse/issues/9854))
Diffstat (limited to 'UPGRADE.rst')
-rw-r--r--UPGRADE.rst13
1 files changed, 8 insertions, 5 deletions
diff --git a/UPGRADE.rst b/UPGRADE.rst
index c8dce62227..76d2ee394f 100644
--- a/UPGRADE.rst
+++ b/UPGRADE.rst
@@ -91,11 +91,14 @@ Upgrading to v1.32.0
 Regression causing connected Prometheus instances to become overwhelmed
 -----------------------------------------------------------------------
 
-This release introduces `a regression <https://githubcom/matrix-org/synapse/issues/9853>`_
-that can overwhelm connected Prometheus instances. This issue was not present in
-Synapse v1.32.0rc1. It is recommended not to update to this release. If you have
-upgraded to v1.32.0 already, please downgrade to v1.31.0. This issue will be
-resolved in a subsequent release version shortly.
+This release introduces `a regression <https://github.com/matrix-org/synapse/issues/9853>`_
+that can overwhelm connected Prometheus instances. This issue is not present in
+Synapse v1.32.0rc1, and is fixed in Synapse v1.32.1.
+
+If you have been affected, please first upgrade to a more recent Synapse version.
+You then may need to remove excess writeahead logs in order for Prometheus to recover.
+Instructions for doing so are provided
+`here <https://github.com/matrix-org/synapse/pull/9854#issuecomment-823472183>`_.
 
 Dropping support for old Python, Postgres and SQLite versions
 -------------------------------------------------------------