Suspicious description of track_io_timing

Lists: pgsql-docs
From: exclusion(at)gmail(dot)com
To: pgsql-docs(at)postgresql(dot)org
Subject: Suspicious description of track_io_timing
Date: 2016-06-01 04:18:33
Message-ID: [email protected]
Views: Whole Thread | Raw Message | Download mbox | Resend email
Lists: pgsql-docs

The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/9.6/static/runtime-config-statistics.html
Description:

There is the following sentence in description of the track_io_timing
parameter:

I/O timing information is displayed in <xref
linkend="pg-stat-database-view">, in the output of <xref
linkend="sql-explain"> when the <literal>BUFFERS</> option is used, and
by <xref linkend="pgstatstatements">.

Is it correct? Shouldn't the TIMING option be mentioned there instead of
BUFFERS?


From: Egor Rogov <e(dot)rogov(at)postgrespro(dot)ru>
To: pgsql-docs(at)postgresql(dot)org
Subject: Re: Suspicious description of track_io_timing
Date: 2016-06-12 20:03:51
Message-ID: [email protected]
Views: Whole Thread | Raw Message | Download mbox | Resend email
Lists: pgsql-docs

Alexander Law wrote
> The following documentation comment has been logged on the website:
>
> Page:
> https://www.postgresql.org/docs/9.6/static/runtime-config-statistics.html
> Description:
>
> There is the following sentence in description of the track_io_timing
> parameter:
>
> I/O timing information is displayed in &lt;xref
> linkend=&quot;pg-stat-database-view&quot;&gt;, in the output of &lt;xref
> linkend=&quot;sql-explain&quot;&gt; when the
> &lt;literal&gt;BUFFERS&lt;/&gt; option is used, and
> by &lt;xref linkend=&quot;pgstatstatements&quot;&gt;.
>
> Is it correct? Shouldn&#39;t the TIMING option be mentioned there instead
> of
> BUFFERS?

Yes, it's correct. Track_io_timing parameter corresponds to the buffer
manager. With BUFFERS option EXPLAIN shows buffers usage; when
track_io_timing is on it also shows I/O read and write time.

Egor Rogov
Postgres Professional: http://www.postgrespro.com
The Russian Postgres Company

--
View this message in context: http://postgresql.nabble.com/Suspicious-description-of-track-io-timing-tp5905853p5907482.html
Sent from the PostgreSQL - docs mailing list archive at Nabble.com.