doc: Update track_io_timing documentation to mention pg_stat_io.
authorFujii Masao
Wed, 10 Jul 2024 06:56:07 +0000 (15:56 +0900)
committerFujii Masao
Wed, 10 Jul 2024 06:56:07 +0000 (15:56 +0900)
The I/O timing information collected when track_io_timing is
enabled is now documented to appear in the pg_stat_io view,
which was previously not mentioned.

This commit also enhances the description of track_io_timing
to clarify that it monitors not only block read and write
but also block extend and fsync operations. Additionally,
the description of track_wal_io_timing has been improved
to mention both WAL write and WAL fsync monitoring.

Backpatch to v16 where pg_stat_io was added.

Author: Hajime Matsunaga
Reviewed-by: Melanie Plageman, Nazir Bilal Yavuz, Fujii Masao
Discussion: https://postgr.es/m/TYWPR01MB10742EE4A6F34C33061429D38A4D52@TYWPR01MB10742.jpnprd01.prod.outlook.com

doc/src/sgml/config.sgml
doc/src/sgml/monitoring.sgml

index f627a3e63cd5a7df2b1622f1b20e31831a07ecc3..4a0c9ba97dd728b677d0eb93aa138b740364191e 100644 (file)
@@ -8319,7 +8319,9 @@ COPY postgres_log FROM '/full/path/to/logfile.csv' WITH csv;
         measure the overhead of timing on your system.
         I/O timing information is
         displayed in 
-        pg_stat_database, in the output of
+        pg_stat_database,
+        
+        pg_stat_io, in the output of
          when the BUFFERS option
         is used, in the output of  when
         the VERBOSE option is used, by autovacuum
index 991f629907518106b9e64ec8cae552b5e7ab04a5..9ca74348c7fbc67602c664d8b02e8e1cab72f2ad 100644 (file)
@@ -180,12 +180,12 @@ postgres   27093  0.0  0.0  30096  2752 ?        Ss   11:34   0:00 postgres: ser
 
   
    The parameter  enables monitoring
-   of block read and write times.
+   of block read, write, extend, and fsync times.
   
 
   
    The parameter  enables monitoring
-   of WAL write times.
+   of WAL write and fsync times.