doc: Recommend pg_stat_io rather than pg_stat_wal in WAL configuration
authorMichael Paquier <michael@paquier.xyz>
Thu, 20 Feb 2025 04:55:00 +0000 (13:55 +0900)
committerMichael Paquier <michael@paquier.xyz>
Thu, 20 Feb 2025 04:55:00 +0000 (13:55 +0900)
commit2f70871c2bc18d103d5dd25ff9d91e0da29412ee
treeaf6a061e987b92055d12fe5a9a553adefc4cb770
parent71f17823ba010296da9946bd906bb8bcad6325bc
doc: Recommend pg_stat_io rather than pg_stat_wal in WAL configuration

Since a051e71e28a1, pg_stat_io is able to track statistics for the WAL
activity, providing an equivalent of pg_stat_wal with more granularity
for the fsyncs/writes counts and timings, as the data is split across
backend types.

This commit now recommends pg_stat_io rather than pg_stat_wal in the
section "WAL configuration", some of the latter's attributes being
candidate for removal in a follow-up commit.

Extracted from a larger patch by the same author.

Author: Bertrand Drouvot <bertranddrouvot.pg@gmail.com>
Discussion: https://postgr.es/m/Z7RkQ0EfYaqqjgz/@ip-10-97-1-34.eu-west-3.compute.internal
doc/src/sgml/wal.sgml