diff --git a/develop/metrics-howto.html b/develop/metrics-howto.html index ee0962d4ab..62f4307dde 100644 --- a/develop/metrics-howto.html +++ b/develop/metrics-howto.html @@ -336,6 +336,9 @@ altogether in Synapse v1.73.0.

synapse_http_httppusher_http_pushes_failed_totalsynapse_http_httppusher_http_pushes_failed synapse_http_httppusher_badge_updates_processed_totalsynapse_http_httppusher_badge_updates_processed synapse_http_httppusher_badge_updates_failed_totalsynapse_http_httppusher_badge_updates_failed +synapse_admin_mau_currentsynapse_admin_mau:current +synapse_admin_mau_maxsynapse_admin_mau:max +synapse_admin_mau_registered_reserved_userssynapse_admin_mau:registered_reserved_users

Removal of deprecated metrics & time based counters becoming histograms in 0.31.0

The duplicated metrics deprecated in Synapse 0.27.0 have been removed.

diff --git a/develop/print.html b/develop/print.html index 2dae861d99..d540eab919 100644 --- a/develop/print.html +++ b/develop/print.html @@ -1642,6 +1642,16 @@ room to be interesting to the application service.

this will no longer match as you expect. The behavioral mismatch between matching all 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.

Upgrading to v1.69.0

Changes to the receipts replication streams

Synapse now includes information indicating if a receipt applies to a thread when @@ -5265,8 +5275,8 @@ Defaults to false.

enable_legacy_metrics

Set to true to publish both legacy and 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. -In Synapse v1.71.0, this will default to false before being removed in Synapse v1.73.0.

+Defaults to false. Has no effect if enable_metrics is false. +In Synapse v1.67.0 up to and including Synapse v1.70.1, this defaulted to true.

Legacy metric names include: