diff options
| author | Melanie Plageman <melanieplageman@gmail.com> | 2025-03-12 11:33:08 -0400 |
|---|---|---|
| committer | Melanie Plageman <melanieplageman@gmail.com> | 2025-03-12 11:35:27 -0400 |
| commit | 18cd15e706ac1f2d6b1c49847a82774ca143352f (patch) | |
| tree | 148f8a5def0fc9ebc2d2ccffa113395b0a4c5aea /doc/src | |
| parent | 9219093cab2607f34ac70612a65430a9c519157f (diff) | |
| download | postgresql-18cd15e706ac1f2d6b1c49847a82774ca143352f.tar.gz postgresql-18cd15e706ac1f2d6b1c49847a82774ca143352f.zip | |
Add connection establishment duration logging
Add log_connections option 'setup_durations' which logs durations of
several key parts of connection establishment and backend setup.
For an incoming connection, starting from when the postmaster gets a
socket from accept() and ending when the forked child backend is first
ready for query, there are multiple steps that could each take longer
than expected due to external factors. This logging provides visibility
into authentication and fork duration as well as the end-to-end
connection establishment and backend initialization time.
To make this portable, the timings captured in the postmaster (socket
creation time, fork initiation time) are passed through the
BackendStartupData.
Author: Melanie Plageman <melanieplageman@gmail.com>
Reviewed-by: Bertrand Drouvot <bertranddrouvot.pg@gmail.com>
Reviewed-by: Fujii Masao <masao.fujii@oss.nttdata.com>
Reviewed-by: Daniel Gustafsson <daniel@yesql.se>
Reviewed-by: Jacob Champion <jacob.champion@enterprisedb.com>
Reviewed-by: Jelte Fennema-Nio <postgres@jeltef.nl>
Reviewed-by: Guillaume Lelarge <guillaume.lelarge@dalibo.com>
Discussion: https://postgr.es/m/flat/CAAKRu_b_smAHK0ZjrnL5GRxnAVWujEXQWpLXYzGbmpcZd3nLYw%40mail.gmail.com
Diffstat (limited to 'doc/src')
| -rw-r--r-- | doc/src/sgml/config.sgml | 13 |
1 files changed, 13 insertions, 0 deletions
diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml index 2ce93fbfa36..7ece94474d9 100644 --- a/doc/src/sgml/config.sgml +++ b/doc/src/sgml/config.sgml @@ -7370,6 +7370,19 @@ local0.* /var/log/postgresql </row> <row> + <entry><literal>setup_durations</literal></entry> + <entry> + Logs the time spent establishing the connection and setting up the + backend at the time the connection is ready to execute its first + query. The log message includes the total setup duration, starting + from the postmaster accepting the incoming connection and ending + when the connection is ready for query. It also includes the time + it took to fork the new backend and the time it took to + authenticate the user. + </entry> + </row> + + <row> <entry><literal>all</literal></entry> <entry> A convenience alias equivalent to specifying all options. If |