mirror of
https://mau.dev/maunium/synapse.git
synced 2024-10-01 01:36:05 -04:00
Synapse 1.71.0rc2 (2022-11-04)
============================== Please note that, as announced in the release notes for Synapse 1.69.0, legacy Prometheus metric names are now disabled by default. They will be removed altogether in Synapse 1.73.0. If not already done, server administrators should update their dashboards and alerting rules to avoid using the deprecated metric names. See the [upgrade notes](https://matrix-org.github.io/synapse/v1.71/upgrade.html#upgrading-to-v1710) for more details. Improved Documentation ---------------------- - Document the changes to monthly active user metrics due to deprecation of legacy Prometheus metric names. ([\#14358](https://github.com/matrix-org/synapse/issues/14358), [\#14360](https://github.com/matrix-org/synapse/issues/14360)) Deprecations and Removals ------------------------- - 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](https://github.com/matrix-org/synapse/issues/14353)) Internal Changes ---------------- - Run unit tests against Python 3.11. ([\#13812](https://github.com/matrix-org/synapse/issues/13812)) -----BEGIN PGP SIGNATURE----- iQGzBAABCgAdFiEEWMTnW8Z8khaaf90R+84KzgcyGG8FAmNlD5YACgkQ+84Kzgcy GG8T0Qv+PkTt9+lUbDAsqWnqWtSYCit4DEZU/g0G+/xUVdZypo+pIHYzzEHEEPoB Siinh5sLqUagoOn0i+YU+D6WZw+20F5+qdQi6QSkpPDorReYBl+4MvyRNqjn3lAE a/bfyHY3+88SfVMza+GRQS7pU06CCMD5aqUZABnYwV5fpKWdF2hOESSuzqEElQDR 7zaZuc7I/8d/VNz79FmyDfGzYnvWS+tr0BcNIyye6OIzZ2AS+q8loBzQiJ5rd1kY ZiGeAHfeu/r05X25kzD1E1qr04ycM7mFjDgBa/aSdf5kkimNNUISo424sawoCVOU oDm+QVefH4zKK9b+DVAJ7eaHIaQsRjJir+h/umXrX09I/x/eMB7Zll1wy1T+KzUS Zf4GCVCI1kKY3FzcPWh2Jf1j899JtbkrKasA+UYf3+PEeFxQ4LyjYlVHC+J1sCXL NGn5YDZkvhfpTOR300eDisUsxKIBFPxL6FjzW5whOnBddKC+VVnlSQkAbn6yHQGE LU1xKhta =m6ze -----END PGP SIGNATURE----- Merge tag 'v1.71.0rc2' into develop Synapse 1.71.0rc2 (2022-11-04) ============================== Please note that, as announced in the release notes for Synapse 1.69.0, legacy Prometheus metric names are now disabled by default. They will be removed altogether in Synapse 1.73.0. If not already done, server administrators should update their dashboards and alerting rules to avoid using the deprecated metric names. See the [upgrade notes](https://matrix-org.github.io/synapse/v1.71/upgrade.html#upgrading-to-v1710) for more details. Improved Documentation ---------------------- - Document the changes to monthly active user metrics due to deprecation of legacy Prometheus metric names. ([\#14358](https://github.com/matrix-org/synapse/issues/14358), [\#14360](https://github.com/matrix-org/synapse/issues/14360)) Deprecations and Removals ------------------------- - 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](https://github.com/matrix-org/synapse/issues/14353)) Internal Changes ---------------- - Run unit tests against Python 3.11. ([\#13812](https://github.com/matrix-org/synapse/issues/13812))
This commit is contained in:
commit
e5d18956b9
27
CHANGES.md
27
CHANGES.md
@ -1,3 +1,30 @@
|
|||||||
|
Synapse 1.71.0rc2 (2022-11-04)
|
||||||
|
==============================
|
||||||
|
|
||||||
|
Please note that, as announced in the release notes for Synapse 1.69.0, legacy Prometheus metric names are now disabled by default.
|
||||||
|
They will be removed altogether in Synapse 1.73.0.
|
||||||
|
If not already done, server administrators should update their dashboards and alerting rules to avoid using the deprecated metric names.
|
||||||
|
See the [upgrade notes](https://matrix-org.github.io/synapse/v1.71/upgrade.html#upgrading-to-v1710) for more details.
|
||||||
|
|
||||||
|
|
||||||
|
Improved Documentation
|
||||||
|
----------------------
|
||||||
|
|
||||||
|
- Document the changes to monthly active user metrics due to deprecation of legacy Prometheus metric names. ([\#14358](https://github.com/matrix-org/synapse/issues/14358), [\#14360](https://github.com/matrix-org/synapse/issues/14360))
|
||||||
|
|
||||||
|
|
||||||
|
Deprecations and Removals
|
||||||
|
-------------------------
|
||||||
|
|
||||||
|
- 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](https://github.com/matrix-org/synapse/issues/14353))
|
||||||
|
|
||||||
|
|
||||||
|
Internal Changes
|
||||||
|
----------------
|
||||||
|
|
||||||
|
- Run unit tests against Python 3.11. ([\#13812](https://github.com/matrix-org/synapse/issues/13812))
|
||||||
|
|
||||||
|
|
||||||
Synapse 1.71.0rc1 (2022-11-01)
|
Synapse 1.71.0rc1 (2022-11-01)
|
||||||
==============================
|
==============================
|
||||||
|
|
||||||
|
6
debian/changelog
vendored
6
debian/changelog
vendored
@ -1,3 +1,9 @@
|
|||||||
|
matrix-synapse-py3 (1.71.0~rc2) stable; urgency=medium
|
||||||
|
|
||||||
|
* New Synapse release 1.71.0rc2.
|
||||||
|
|
||||||
|
-- Synapse Packaging team <packages@matrix.org> Fri, 04 Nov 2022 12:00:33 +0000
|
||||||
|
|
||||||
matrix-synapse-py3 (1.71.0~rc1) stable; urgency=medium
|
matrix-synapse-py3 (1.71.0~rc1) stable; urgency=medium
|
||||||
|
|
||||||
* New Synapse release 1.71.0rc1.
|
* New Synapse release 1.71.0rc1.
|
||||||
|
@ -209,6 +209,9 @@ altogether in Synapse v1.73.0.**
|
|||||||
| synapse_http_httppusher_http_pushes_failed_total | synapse_http_httppusher_http_pushes_failed |
|
| synapse_http_httppusher_http_pushes_failed_total | synapse_http_httppusher_http_pushes_failed |
|
||||||
| synapse_http_httppusher_badge_updates_processed_total | synapse_http_httppusher_badge_updates_processed |
|
| synapse_http_httppusher_badge_updates_processed_total | synapse_http_httppusher_badge_updates_processed |
|
||||||
| synapse_http_httppusher_badge_updates_failed_total | synapse_http_httppusher_badge_updates_failed |
|
| synapse_http_httppusher_badge_updates_failed_total | synapse_http_httppusher_badge_updates_failed |
|
||||||
|
| synapse_admin_mau_current | synapse_admin_mau:current |
|
||||||
|
| synapse_admin_mau_max | synapse_admin_mau:max |
|
||||||
|
| synapse_admin_mau_registered_reserved_users | synapse_admin_mau:registered_reserved_users |
|
||||||
|
|
||||||
Removal of deprecated metrics & time based counters becoming histograms in 0.31.0
|
Removal of deprecated metrics & time based counters becoming histograms in 0.31.0
|
||||||
---------------------------------------------------------------------------------
|
---------------------------------------------------------------------------------
|
||||||
|
@ -116,6 +116,22 @@ local users and some remote users is why the spec was changed/clarified and this
|
|||||||
caveat is no longer supported.
|
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
|
# Upgrading to v1.69.0
|
||||||
|
|
||||||
## Changes to the receipts replication streams
|
## Changes to the receipts replication streams
|
||||||
|
@ -73,12 +73,12 @@ When a request is blocked, the response will have the `errcode` `M_RESOURCE_LIMI
|
|||||||
|
|
||||||
Synapse records several different prometheus metrics for MAU.
|
Synapse records several different prometheus metrics for MAU.
|
||||||
|
|
||||||
`synapse_admin_mau:current` records the current MAU figure for native (non-application-service) users.
|
`synapse_admin_mau_current` records the current MAU figure for native (non-application-service) users.
|
||||||
|
|
||||||
`synapse_admin_mau:max` records the maximum MAU as dictated by the `max_mau_value` config value.
|
`synapse_admin_mau_max` records the maximum MAU as dictated by the `max_mau_value` config value.
|
||||||
|
|
||||||
`synapse_admin_mau_current_mau_by_service` records the current MAU including application service users. The label `app_service` can be used
|
`synapse_admin_mau_current_mau_by_service` records the current MAU including application service users. The label `app_service` can be used
|
||||||
to filter by a specific service ID. This *also* includes non-application-service users under `app_service=native` .
|
to filter by a specific service ID. This *also* includes non-application-service users under `app_service=native` .
|
||||||
|
|
||||||
`synapse_admin_mau:registered_reserved_users` records the number of users specified in `mau_limits_reserved_threepids` which have
|
`synapse_admin_mau_registered_reserved_users` records the number of users specified in `mau_limits_reserved_threepids` which have
|
||||||
registered accounts on the homeserver.
|
registered accounts on the homeserver.
|
||||||
|
@ -2441,8 +2441,8 @@ enable_metrics: true
|
|||||||
|
|
||||||
Set to `true` to publish both legacy and non-legacy Prometheus metric names,
|
Set to `true` to publish both legacy and non-legacy Prometheus metric names,
|
||||||
or to `false` to only publish non-legacy Prometheus metric names.
|
or to `false` to only publish non-legacy Prometheus metric names.
|
||||||
Defaults to `true`. Has no effect if `enable_metrics` is `false`.
|
Defaults to `false`. Has no effect if `enable_metrics` is `false`.
|
||||||
**In Synapse v1.71.0, this will default to `false` before being removed in Synapse v1.73.0.**
|
**In Synapse v1.67.0 up to and including Synapse v1.70.1, this defaulted to `true`.**
|
||||||
|
|
||||||
Legacy metric names include:
|
Legacy metric names include:
|
||||||
- metrics containing colons in the name, such as `synapse_util_caches_response_cache:hits`, because colons are supposed to be reserved for user-defined recording rules;
|
- metrics containing colons in the name, such as `synapse_util_caches_response_cache:hits`, because colons are supposed to be reserved for user-defined recording rules;
|
||||||
|
@ -57,7 +57,7 @@ manifest-path = "rust/Cargo.toml"
|
|||||||
|
|
||||||
[tool.poetry]
|
[tool.poetry]
|
||||||
name = "matrix-synapse"
|
name = "matrix-synapse"
|
||||||
version = "1.71.0rc1"
|
version = "1.71.0rc2"
|
||||||
description = "Homeserver for the Matrix decentralised comms protocol"
|
description = "Homeserver for the Matrix decentralised comms protocol"
|
||||||
authors = ["Matrix.org Team and Contributors <packages@matrix.org>"]
|
authors = ["Matrix.org Team and Contributors <packages@matrix.org>"]
|
||||||
license = "Apache-2.0"
|
license = "Apache-2.0"
|
||||||
|
@ -43,7 +43,7 @@ class MetricsConfig(Config):
|
|||||||
def read_config(self, config: JsonDict, **kwargs: Any) -> None:
|
def read_config(self, config: JsonDict, **kwargs: Any) -> None:
|
||||||
self.enable_metrics = config.get("enable_metrics", False)
|
self.enable_metrics = config.get("enable_metrics", False)
|
||||||
|
|
||||||
self.enable_legacy_metrics = config.get("enable_legacy_metrics", True)
|
self.enable_legacy_metrics = config.get("enable_legacy_metrics", False)
|
||||||
|
|
||||||
self.report_stats = config.get("report_stats", None)
|
self.report_stats = config.get("report_stats", None)
|
||||||
self.report_stats_endpoint = config.get(
|
self.report_stats_endpoint = config.get(
|
||||||
|
Loading…
Reference in New Issue
Block a user