summaryrefslogtreecommitdiff
path: root/doc/src
diff options
context:
space:
mode:
Diffstat (limited to 'doc/src')
-rw-r--r--doc/src/sgml/monitoring.sgml43
1 files changed, 31 insertions, 12 deletions
diff --git a/doc/src/sgml/monitoring.sgml b/doc/src/sgml/monitoring.sgml
index fd0ffbb1e0..bce9ae4661 100644
--- a/doc/src/sgml/monitoring.sgml
+++ b/doc/src/sgml/monitoring.sgml
@@ -7777,32 +7777,51 @@ FROM pg_stat_get_backend_idset() AS backendid;
complete.</entry>
</row>
<row>
+ <entry><literal>buffer-extend-start</literal></entry>
+ <entry><literal>(ForkNumber, BlockNumber, Oid, Oid, Oid, int, unsigned int)</literal></entry>
+ <entry>Probe that fires when a relation extension starts.
+ arg0 contains the fork to be extended. arg1, arg2, and arg3 contain the
+ tablespace, database, and relation OIDs identifying the relation. arg4
+ is the ID of the backend which created the temporary relation for a
+ local buffer, or <symbol>InvalidBackendId</symbol> (-1) for a shared
+ buffer. arg5 is the number of blocks the caller would like to extend
+ by.</entry>
+ </row>
+ <row>
+ <entry><literal>buffer-extend-done</literal></entry>
+ <entry><literal>(ForkNumber, BlockNumber, Oid, Oid, Oid, int, unsigned int, BlockNumber)</literal></entry>
+ <entry>Probe that fires when a relation extension is complete.
+ arg0 contains the fork to be extended. arg1, arg2, and arg3 contain the
+ tablespace, database, and relation OIDs identifying the relation. arg4
+ is the ID of the backend which created the temporary relation for a
+ local buffer, or <symbol>InvalidBackendId</symbol> (-1) for a shared
+ buffer. arg5 is the number of blocks the relation was extended by, this
+ can be less than the number in the
+ <literal>buffer-extend-start</literal> due to resource
+ constraints. arg6 contains the BlockNumber of the first new
+ block.</entry>
+ </row>
+ <row>
<entry><literal>buffer-read-start</literal></entry>
- <entry><literal>(ForkNumber, BlockNumber, Oid, Oid, Oid, int, bool)</literal></entry>
+ <entry><literal>(ForkNumber, BlockNumber, Oid, Oid, Oid, int)</literal></entry>
<entry>Probe that fires when a buffer read is started.
- arg0 and arg1 contain the fork and block numbers of the page (but
- arg1 will be -1 if this is a relation extension request).
+ arg0 and arg1 contain the fork and block numbers of the page.
arg2, arg3, and arg4 contain the tablespace, database, and relation OIDs
identifying the relation.
arg5 is the ID of the backend which created the temporary relation for a
local buffer, or <symbol>InvalidBackendId</symbol> (-1) for a shared buffer.
- arg6 is true for a relation extension request, false for normal
- read.</entry>
+ </entry>
</row>
<row>
<entry><literal>buffer-read-done</literal></entry>
- <entry><literal>(ForkNumber, BlockNumber, Oid, Oid, Oid, int, bool, bool)</literal></entry>
+ <entry><literal>(ForkNumber, BlockNumber, Oid, Oid, Oid, int, bool)</literal></entry>
<entry>Probe that fires when a buffer read is complete.
- arg0 and arg1 contain the fork and block numbers of the page (if this
- is a relation extension request, arg1 now contains the block number
- of the newly added block).
+ arg0 and arg1 contain the fork and block numbers of the page.
arg2, arg3, and arg4 contain the tablespace, database, and relation OIDs
identifying the relation.
arg5 is the ID of the backend which created the temporary relation for a
local buffer, or <symbol>InvalidBackendId</symbol> (-1) for a shared buffer.
- arg6 is true for a relation extension request, false for normal
- read.
- arg7 is true if the buffer was found in the pool, false if not.</entry>
+ arg6 is true if the buffer was found in the pool, false if not.</entry>
</row>
<row>
<entry><literal>buffer-flush-start</literal></entry>