public inbox for [email protected]  
help / color / mirror / Atom feed
From: Bruce Momjian <[email protected]>
To: Michael Paquier <[email protected]>
Cc: Jeremy Schneider <[email protected]>
Cc: [email protected]
Subject: Re: wait event docs
Date: Sat, 21 Dec 2019 17:46:35 -0500
Message-ID: <[email protected]> (raw)
In-Reply-To: <[email protected]>
References: <[email protected]>
	<[email protected]>

On Fri, Dec 13, 2019 at 03:50:29PM +0900, Michael Paquier wrote:
> On Thu, Dec 12, 2019 at 02:07:14PM -0800, Jeremy Schneider wrote:
> > The wait event information in PostgreSQL is very helpful for
> > troubleshooting.  I always reference the PostgreSQL docs first, and when
> > people ask me about wait events that where I send them first.  The list
> > of wait events there is comprehensive, but the descriptions are a bit
> > terse and often use vocabulary that requires some familiarity with the
> > internals to understand.
> 
> (I think that it would be better to avoid cross-posting among multiple
> lists.  Please note that I have removed -www and -general in my reply,
> keeping -docs because that7s the most meaningful)
> 
> > Could we create a new wiki page as a starting point, and we could draft
> > up and maintain something there for a little while?  Maybe a place like
> > https://wiki.postgresql.org/wiki/Wait_Events ?
> 
> That sounds like a good idea, as it is true that the docs are rather
> sparse about the meaning behind a given wait event showing a lot in
> profiles and what it actually means for your application.  We have a
> couple of links from the docs to the wiki, so it could be an idea to
> add a link to the wiki in the docs near the wait event table.  more to
> the point, this makes me wonder if actually a better place for such
> stuff would be a new section dedicated to wait event profiles here:
> https://www.postgresql.org/docs/devel/monitoring.html

Agreed, it probably should be in the official docs.

-- 
  Bruce Momjian  <[email protected]>        http://momjian.us
  EnterpriseDB                             http://enterprisedb.com

+ As you are, so once was I.  As I am, so you will be. +
+                      Ancient Roman grave inscription +






view thread (3+ messages)

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: [email protected]
  Cc: [email protected], [email protected], [email protected], [email protected]
  Subject: Re: wait event docs
  In-Reply-To: <[email protected]>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox