doc: Add some markup
This commit is contained in:
Peter Eisentraut
parent
f54d0629ec
commit
19e7ca8938
@ -2077,217 +2077,217 @@ SELECT pg_stat_get_backend_pid(s.backendid) AS pid,
|
||||
<tbody>
|
||||
|
||||
<row>
|
||||
<entry>transaction-start</entry>
|
||||
<entry>(LocalTransactionId)</entry>
|
||||
<entry><literal>transaction-start</literal></entry>
|
||||
<entry><literal>(LocalTransactionId)</literal></entry>
|
||||
<entry>Probe that fires at the start of a new transaction.
|
||||
arg0 is the transaction ID.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>transaction-commit</entry>
|
||||
<entry>(LocalTransactionId)</entry>
|
||||
<entry><literal>transaction-commit</literal></entry>
|
||||
<entry><literal>(LocalTransactionId)</literal></entry>
|
||||
<entry>Probe that fires when a transaction completes successfully.
|
||||
arg0 is the transaction ID.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>transaction-abort</entry>
|
||||
<entry>(LocalTransactionId)</entry>
|
||||
<entry><literal>transaction-abort</literal></entry>
|
||||
<entry><literal>(LocalTransactionId)</literal></entry>
|
||||
<entry>Probe that fires when a transaction completes unsuccessfully.
|
||||
arg0 is the transaction ID.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>query-start</entry>
|
||||
<entry>(const char *)</entry>
|
||||
<entry><literal>query-start</literal></entry>
|
||||
<entry><literal>(const char *)</literal></entry>
|
||||
<entry>Probe that fires when the processing of a query is started.
|
||||
arg0 is the query string.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>query-done</entry>
|
||||
<entry>(const char *)</entry>
|
||||
<entry><literal>query-done</literal></entry>
|
||||
<entry><literal>(const char *)</literal></entry>
|
||||
<entry>Probe that fires when the processing of a query is complete.
|
||||
arg0 is the query string.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>query-parse-start</entry>
|
||||
<entry>(const char *)</entry>
|
||||
<entry><literal>query-parse-start</literal></entry>
|
||||
<entry><literal>(const char *)</literal></entry>
|
||||
<entry>Probe that fires when the parsing of a query is started.
|
||||
arg0 is the query string.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>query-parse-done</entry>
|
||||
<entry>(const char *)</entry>
|
||||
<entry><literal>query-parse-done</literal></entry>
|
||||
<entry><literal>(const char *)</literal></entry>
|
||||
<entry>Probe that fires when the parsing of a query is complete.
|
||||
arg0 is the query string.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>query-rewrite-start</entry>
|
||||
<entry>(const char *)</entry>
|
||||
<entry><literal>query-rewrite-start</literal></entry>
|
||||
<entry><literal>(const char *)</literal></entry>
|
||||
<entry>Probe that fires when the rewriting of a query is started.
|
||||
arg0 is the query string.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>query-rewrite-done</entry>
|
||||
<entry>(const char *)</entry>
|
||||
<entry><literal>query-rewrite-done</literal></entry>
|
||||
<entry><literal>(const char *)</literal></entry>
|
||||
<entry>Probe that fires when the rewriting of a query is complete.
|
||||
arg0 is the query string.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>query-plan-start</entry>
|
||||
<entry>()</entry>
|
||||
<entry><literal>query-plan-start</literal></entry>
|
||||
<entry><literal>()</literal></entry>
|
||||
<entry>Probe that fires when the planning of a query is started.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>query-plan-done</entry>
|
||||
<entry>()</entry>
|
||||
<entry><literal>query-plan-done</literal></entry>
|
||||
<entry><literal>()</literal></entry>
|
||||
<entry>Probe that fires when the planning of a query is complete.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>query-execute-start</entry>
|
||||
<entry>()</entry>
|
||||
<entry><literal>query-execute-start</literal></entry>
|
||||
<entry><literal>()</literal></entry>
|
||||
<entry>Probe that fires when the execution of a query is started.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>query-execute-done</entry>
|
||||
<entry>()</entry>
|
||||
<entry><literal>query-execute-done</literal></entry>
|
||||
<entry><literal>()</literal></entry>
|
||||
<entry>Probe that fires when the execution of a query is complete.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>statement-status</entry>
|
||||
<entry>(const char *)</entry>
|
||||
<entry><literal>statement-status</literal></entry>
|
||||
<entry><literal>(const char *)</literal></entry>
|
||||
<entry>Probe that fires anytime the server process updates its
|
||||
<structname>pg_stat_activity</>.<structfield>status</>.
|
||||
arg0 is the new status string.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>checkpoint-start</entry>
|
||||
<entry>(int)</entry>
|
||||
<entry><literal>checkpoint-start</literal></entry>
|
||||
<entry><literal>(int)</literal></entry>
|
||||
<entry>Probe that fires when a checkpoint is started.
|
||||
arg0 holds the bitwise flags used to distinguish different checkpoint
|
||||
types, such as shutdown, immediate or force.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>checkpoint-done</entry>
|
||||
<entry>(int, int, int, int, int)</entry>
|
||||
<entry><literal>checkpoint-done</literal></entry>
|
||||
<entry><literal>(int, int, int, int, int)</literal></entry>
|
||||
<entry>Probe that fires when a checkpoint is complete.
|
||||
(The probes listed next fire in sequence during checkpoint processing.)
|
||||
arg0 is the number of buffers written. arg1 is the total number of
|
||||
buffers. arg2, arg3 and arg4 contain the number of xlog file(s) added,
|
||||
buffers. arg2, arg3 and arg4 contain the number of WAL files added,
|
||||
removed and recycled respectively.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>clog-checkpoint-start</entry>
|
||||
<entry>(bool)</entry>
|
||||
<entry><literal>clog-checkpoint-start</literal></entry>
|
||||
<entry><literal>(bool)</literal></entry>
|
||||
<entry>Probe that fires when the CLOG portion of a checkpoint is started.
|
||||
arg0 is true for normal checkpoint, false for shutdown
|
||||
checkpoint.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>clog-checkpoint-done</entry>
|
||||
<entry>(bool)</entry>
|
||||
<entry><literal>clog-checkpoint-done</literal></entry>
|
||||
<entry><literal>(bool)</literal></entry>
|
||||
<entry>Probe that fires when the CLOG portion of a checkpoint is
|
||||
complete. arg0 has the same meaning as for clog-checkpoint-start.</entry>
|
||||
complete. arg0 has the same meaning as for <literal>clog-checkpoint-start</literal>.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>subtrans-checkpoint-start</entry>
|
||||
<entry>(bool)</entry>
|
||||
<entry><literal>subtrans-checkpoint-start</literal></entry>
|
||||
<entry><literal>(bool)</literal></entry>
|
||||
<entry>Probe that fires when the SUBTRANS portion of a checkpoint is
|
||||
started.
|
||||
arg0 is true for normal checkpoint, false for shutdown
|
||||
checkpoint.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>subtrans-checkpoint-done</entry>
|
||||
<entry>(bool)</entry>
|
||||
<entry><literal>subtrans-checkpoint-done</literal></entry>
|
||||
<entry><literal>(bool)</literal></entry>
|
||||
<entry>Probe that fires when the SUBTRANS portion of a checkpoint is
|
||||
complete. arg0 has the same meaning as for
|
||||
subtrans-checkpoint-start.</entry>
|
||||
<literal>subtrans-checkpoint-start</literal>.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>multixact-checkpoint-start</entry>
|
||||
<entry>(bool)</entry>
|
||||
<entry><literal>multixact-checkpoint-start</literal></entry>
|
||||
<entry><literal>(bool)</literal></entry>
|
||||
<entry>Probe that fires when the MultiXact portion of a checkpoint is
|
||||
started.
|
||||
arg0 is true for normal checkpoint, false for shutdown
|
||||
checkpoint.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>multixact-checkpoint-done</entry>
|
||||
<entry>(bool)</entry>
|
||||
<entry><literal>multixact-checkpoint-done</literal></entry>
|
||||
<entry><literal>(bool)</literal></entry>
|
||||
<entry>Probe that fires when the MultiXact portion of a checkpoint is
|
||||
complete. arg0 has the same meaning as for
|
||||
multixact-checkpoint-start.</entry>
|
||||
<literal>multixact-checkpoint-start</literal>.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>buffer-checkpoint-start</entry>
|
||||
<entry>(int)</entry>
|
||||
<entry><literal>buffer-checkpoint-start</literal></entry>
|
||||
<entry><literal>(int)</literal></entry>
|
||||
<entry>Probe that fires when the buffer-writing portion of a checkpoint
|
||||
is started.
|
||||
arg0 holds the bitwise flags used to distinguish different checkpoint
|
||||
types, such as shutdown, immediate or force.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>buffer-sync-start</entry>
|
||||
<entry>(int, int)</entry>
|
||||
<entry><literal>buffer-sync-start</literal></entry>
|
||||
<entry><literal>(int, int)</literal></entry>
|
||||
<entry>Probe that fires when we begin to write dirty buffers during
|
||||
checkpoint (after identifying which buffers must be written).
|
||||
arg0 is the total number of buffers.
|
||||
arg1 is the number that are currently dirty and need to be written.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>buffer-sync-written</entry>
|
||||
<entry>(int)</entry>
|
||||
<entry><literal>buffer-sync-written</literal></entry>
|
||||
<entry><literal>(int)</literal></entry>
|
||||
<entry>Probe that fires after each buffer is written during checkpoint.
|
||||
arg0 is the ID number of the buffer.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>buffer-sync-done</entry>
|
||||
<entry>(int, int, int)</entry>
|
||||
<entry><literal>buffer-sync-done</literal></entry>
|
||||
<entry><literal>(int, int, int)</literal></entry>
|
||||
<entry>Probe that fires when all dirty buffers have been written.
|
||||
arg0 is the total number of buffers.
|
||||
arg1 is the number of buffers actually written by the checkpoint process.
|
||||
arg2 is the number that were expected to be written (arg1 of
|
||||
buffer-sync-start); any difference reflects other processes flushing
|
||||
<literal>buffer-sync-start</literal>); any difference reflects other processes flushing
|
||||
buffers during the checkpoint.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>buffer-checkpoint-sync-start</entry>
|
||||
<entry>()</entry>
|
||||
<entry><literal>buffer-checkpoint-sync-start</literal></entry>
|
||||
<entry><literal>()</literal></entry>
|
||||
<entry>Probe that fires after dirty buffers have been written to the
|
||||
kernel, and before starting to issue fsync requests.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>buffer-checkpoint-done</entry>
|
||||
<entry>()</entry>
|
||||
<entry><literal>buffer-checkpoint-done</literal></entry>
|
||||
<entry><literal>()</literal></entry>
|
||||
<entry>Probe that fires when syncing of buffers to disk is
|
||||
complete.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>twophase-checkpoint-start</entry>
|
||||
<entry>()</entry>
|
||||
<entry><literal>twophase-checkpoint-start</literal></entry>
|
||||
<entry><literal>()</literal></entry>
|
||||
<entry>Probe that fires when the two-phase portion of a checkpoint is
|
||||
started.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>twophase-checkpoint-done</entry>
|
||||
<entry>()</entry>
|
||||
<entry><literal>twophase-checkpoint-done</literal></entry>
|
||||
<entry><literal>()</literal></entry>
|
||||
<entry>Probe that fires when the two-phase portion of a checkpoint is
|
||||
complete.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>buffer-read-start</entry>
|
||||
<entry>(ForkNumber, BlockNumber, Oid, Oid, Oid, int, bool)</entry>
|
||||
<entry><literal>buffer-read-start</literal></entry>
|
||||
<entry><literal>(ForkNumber, BlockNumber, Oid, Oid, Oid, int, bool)</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).
|
||||
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 InvalidBackendId (-1) for a shared buffer.
|
||||
local buffer, or <symbol>InvalidBackendId</symbol> (-1) for a shared buffer.
|
||||
arg6 is true for a relation extension request, false for normal
|
||||
read.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>buffer-read-done</entry>
|
||||
<entry>(ForkNumber, BlockNumber, Oid, Oid, Oid, int, bool, bool)</entry>
|
||||
<entry><literal>buffer-read-done</literal></entry>
|
||||
<entry><literal>(ForkNumber, BlockNumber, Oid, Oid, Oid, int, bool, 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
|
||||
@ -2295,14 +2295,14 @@ SELECT pg_stat_get_backend_pid(s.backendid) AS pid,
|
||||
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 InvalidBackendId (-1) for a shared buffer.
|
||||
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>
|
||||
</row>
|
||||
<row>
|
||||
<entry>buffer-flush-start</entry>
|
||||
<entry>(ForkNumber, BlockNumber, Oid, Oid, Oid)</entry>
|
||||
<entry><literal>buffer-flush-start</literal></entry>
|
||||
<entry><literal>(ForkNumber, BlockNumber, Oid, Oid, Oid)</literal></entry>
|
||||
<entry>Probe that fires before issuing any write request for a shared
|
||||
buffer.
|
||||
arg0 and arg1 contain the fork and block numbers of the page.
|
||||
@ -2310,102 +2310,102 @@ SELECT pg_stat_get_backend_pid(s.backendid) AS pid,
|
||||
identifying the relation.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>buffer-flush-done</entry>
|
||||
<entry>(ForkNumber, BlockNumber, Oid, Oid, Oid)</entry>
|
||||
<entry><literal>buffer-flush-done</literal></entry>
|
||||
<entry><literal>(ForkNumber, BlockNumber, Oid, Oid, Oid)</literal></entry>
|
||||
<entry>Probe that fires when a write request is complete. (Note
|
||||
that this just reflects the time to pass the data to the kernel;
|
||||
it's typically not actually been written to disk yet.)
|
||||
The arguments are the same as for buffer-flush-start.</entry>
|
||||
The arguments are the same as for <literal>buffer-flush-start</literal>.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>buffer-write-dirty-start</entry>
|
||||
<entry>(ForkNumber, BlockNumber, Oid, Oid, Oid)</entry>
|
||||
<entry><literal>buffer-write-dirty-start</literal></entry>
|
||||
<entry><literal>(ForkNumber, BlockNumber, Oid, Oid, Oid)</literal></entry>
|
||||
<entry>Probe that fires when a server process begins to write a dirty
|
||||
buffer. (If this happens often, it implies that
|
||||
<xref linkend="guc-shared-buffers"> is too
|
||||
small or the bgwriter control parameters need adjustment.)
|
||||
small or the background writer control parameters need adjustment.)
|
||||
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.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>buffer-write-dirty-done</entry>
|
||||
<entry>(ForkNumber, BlockNumber, Oid, Oid, Oid)</entry>
|
||||
<entry><literal>buffer-write-dirty-done</literal></entry>
|
||||
<entry><literal>(ForkNumber, BlockNumber, Oid, Oid, Oid)</literal></entry>
|
||||
<entry>Probe that fires when a dirty-buffer write is complete.
|
||||
The arguments are the same as for buffer-write-dirty-start.</entry>
|
||||
The arguments are the same as for <literal>buffer-write-dirty-start</literal>.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>wal-buffer-write-dirty-start</entry>
|
||||
<entry>()</entry>
|
||||
<entry><literal>wal-buffer-write-dirty-start</literal></entry>
|
||||
<entry><literal>()</literal></entry>
|
||||
<entry>Probe that fires when a server process begins to write a
|
||||
dirty WAL buffer because no more WAL buffer space is available.
|
||||
(If this happens often, it implies that
|
||||
<xref linkend="guc-wal-buffers"> is too small.)</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>wal-buffer-write-dirty-done</entry>
|
||||
<entry>()</entry>
|
||||
<entry><literal>wal-buffer-write-dirty-done</literal></entry>
|
||||
<entry><literal>()</literal></entry>
|
||||
<entry>Probe that fires when a dirty WAL buffer write is complete.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>xlog-insert</entry>
|
||||
<entry>(unsigned char, unsigned char)</entry>
|
||||
<entry><literal>xlog-insert</literal></entry>
|
||||
<entry><literal>(unsigned char, unsigned char)</literal></entry>
|
||||
<entry>Probe that fires when a WAL record is inserted.
|
||||
arg0 is the resource manager (rmid) for the record.
|
||||
arg1 contains the info flags.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>xlog-switch</entry>
|
||||
<entry>()</entry>
|
||||
<entry><literal>xlog-switch</literal></entry>
|
||||
<entry><literal>()</literal></entry>
|
||||
<entry>Probe that fires when a WAL segment switch is requested.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>smgr-md-read-start</entry>
|
||||
<entry>(ForkNumber, BlockNumber, Oid, Oid, Oid, int)</entry>
|
||||
<entry><literal>smgr-md-read-start</literal></entry>
|
||||
<entry><literal>(ForkNumber, BlockNumber, Oid, Oid, Oid, int)</literal></entry>
|
||||
<entry>Probe that fires when beginning to read a block from a relation.
|
||||
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 InvalidBackendId (-1) for a shared buffer.</entry>
|
||||
local buffer, or <symbol>InvalidBackendId</symbol> (-1) for a shared buffer.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>smgr-md-read-done</entry>
|
||||
<entry>(ForkNumber, BlockNumber, Oid, Oid, Oid, int, int, int)</entry>
|
||||
<entry><literal>smgr-md-read-done</literal></entry>
|
||||
<entry><literal>(ForkNumber, BlockNumber, Oid, Oid, Oid, int, int, int)</literal></entry>
|
||||
<entry>Probe that fires when a block read is complete.
|
||||
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 InvalidBackendId (-1) for a shared buffer.
|
||||
local buffer, or <symbol>InvalidBackendId</symbol> (-1) for a shared buffer.
|
||||
arg6 is the number of bytes actually read, while arg7 is the number
|
||||
requested (if these are different it indicates trouble).</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>smgr-md-write-start</entry>
|
||||
<entry>(ForkNumber, BlockNumber, Oid, Oid, Oid, int)</entry>
|
||||
<entry><literal>smgr-md-write-start</literal></entry>
|
||||
<entry><literal>(ForkNumber, BlockNumber, Oid, Oid, Oid, int)</literal></entry>
|
||||
<entry>Probe that fires when beginning to write a block to a relation.
|
||||
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 InvalidBackendId (-1) for a shared buffer.</entry>
|
||||
local buffer, or <symbol>InvalidBackendId</symbol> (-1) for a shared buffer.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>smgr-md-write-done</entry>
|
||||
<entry>(ForkNumber, BlockNumber, Oid, Oid, Oid, int, int, int)</entry>
|
||||
<entry><literal>smgr-md-write-done</literal></entry>
|
||||
<entry><literal>(ForkNumber, BlockNumber, Oid, Oid, Oid, int, int, int)</literal></entry>
|
||||
<entry>Probe that fires when a block write is complete.
|
||||
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 InvalidBackendId (-1) for a shared buffer.
|
||||
local buffer, or <symbol>InvalidBackendId</symbol> (-1) for a shared buffer.
|
||||
arg6 is the number of bytes actually written, while arg7 is the number
|
||||
requested (if these are different it indicates trouble).</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>sort-start</entry>
|
||||
<entry>(int, bool, int, int, bool)</entry>
|
||||
<entry><literal>sort-start</literal></entry>
|
||||
<entry><literal>(int, bool, int, int, bool)</literal></entry>
|
||||
<entry>Probe that fires when a sort operation is started.
|
||||
arg0 indicates heap, index or datum sort.
|
||||
arg1 is true for unique-value enforcement.
|
||||
@ -2414,32 +2414,32 @@ SELECT pg_stat_get_backend_pid(s.backendid) AS pid,
|
||||
arg4 is true if random access to the sort result is required.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>sort-done</entry>
|
||||
<entry>(bool, long)</entry>
|
||||
<entry><literal>sort-done</literal></entry>
|
||||
<entry><literal>(bool, long)</literal></entry>
|
||||
<entry>Probe that fires when a sort is complete.
|
||||
arg0 is true for external sort, false for internal sort.
|
||||
arg1 is the number of disk blocks used for an external sort,
|
||||
or kilobytes of memory used for an internal sort.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>lwlock-acquire</entry>
|
||||
<entry>(char *, int, LWLockMode)</entry>
|
||||
<entry><literal>lwlock-acquire</literal></entry>
|
||||
<entry><literal>(char *, int, LWLockMode)</literal></entry>
|
||||
<entry>Probe that fires when an LWLock has been acquired.
|
||||
arg0 is the LWLock's tranche.
|
||||
arg1 is the LWLock's offset within its tranche.
|
||||
arg2 is the requested lock mode, either exclusive or shared.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>lwlock-release</entry>
|
||||
<entry>(char *, int)</entry>
|
||||
<entry><literal>lwlock-release</literal></entry>
|
||||
<entry><literal>(char *, int)</literal></entry>
|
||||
<entry>Probe that fires when an LWLock has been released (but note
|
||||
that any released waiters have not yet been awakened).
|
||||
arg0 is the LWLock's tranche.
|
||||
arg1 is the LWLock's offset within its tranche.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>lwlock-wait-start</entry>
|
||||
<entry>(char *, int, LWLockMode)</entry>
|
||||
<entry><literal>lwlock-wait-start</literal></entry>
|
||||
<entry><literal>(char *, int, LWLockMode)</literal></entry>
|
||||
<entry>Probe that fires when an LWLock was not immediately available and
|
||||
a server process has begun to wait for the lock to become available.
|
||||
arg0 is the LWLock's tranche.
|
||||
@ -2447,8 +2447,8 @@ SELECT pg_stat_get_backend_pid(s.backendid) AS pid,
|
||||
arg2 is the requested lock mode, either exclusive or shared.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>lwlock-wait-done</entry>
|
||||
<entry>(char *, int, LWLockMode)</entry>
|
||||
<entry><literal>lwlock-wait-done</literal></entry>
|
||||
<entry><literal>(char *, int, LWLockMode)</literal></entry>
|
||||
<entry>Probe that fires when a server process has been released from its
|
||||
wait for an LWLock (it does not actually have the lock yet).
|
||||
arg0 is the LWLock's tranche.
|
||||
@ -2456,8 +2456,8 @@ SELECT pg_stat_get_backend_pid(s.backendid) AS pid,
|
||||
arg2 is the requested lock mode, either exclusive or shared.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>lwlock-condacquire</entry>
|
||||
<entry>(char *, int, LWLockMode)</entry>
|
||||
<entry><literal>lwlock-condacquire</literal></entry>
|
||||
<entry><literal>(char *, int, LWLockMode)</literal></entry>
|
||||
<entry>Probe that fires when an LWLock was successfully acquired when the
|
||||
caller specified no waiting.
|
||||
arg0 is the LWLock's tranche.
|
||||
@ -2465,8 +2465,8 @@ SELECT pg_stat_get_backend_pid(s.backendid) AS pid,
|
||||
arg2 is the requested lock mode, either exclusive or shared.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>lwlock-condacquire-fail</entry>
|
||||
<entry>(char *, int, LWLockMode)</entry>
|
||||
<entry><literal>lwlock-condacquire-fail</literal></entry>
|
||||
<entry><literal>(char *, int, LWLockMode)</literal></entry>
|
||||
<entry>Probe that fires when an LWLock was not successfully acquired when
|
||||
the caller specified no waiting.
|
||||
arg0 is the LWLock's tranche.
|
||||
@ -2474,8 +2474,8 @@ SELECT pg_stat_get_backend_pid(s.backendid) AS pid,
|
||||
arg2 is the requested lock mode, either exclusive or shared.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>lock-wait-start</entry>
|
||||
<entry>(unsigned int, unsigned int, unsigned int, unsigned int, unsigned int, LOCKMODE)</entry>
|
||||
<entry><literal>lock-wait-start</literal></entry>
|
||||
<entry><literal>(unsigned int, unsigned int, unsigned int, unsigned int, unsigned int, LOCKMODE)</literal></entry>
|
||||
<entry>Probe that fires when a request for a heavyweight lock (lmgr lock)
|
||||
has begun to wait because the lock is not available.
|
||||
arg0 through arg3 are the tag fields identifying the object being
|
||||
@ -2483,15 +2483,15 @@ SELECT pg_stat_get_backend_pid(s.backendid) AS pid,
|
||||
arg5 indicates the lock type being requested.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>lock-wait-done</entry>
|
||||
<entry>(unsigned int, unsigned int, unsigned int, unsigned int, unsigned int, LOCKMODE)</entry>
|
||||
<entry><literal>lock-wait-done</literal></entry>
|
||||
<entry><literal>(unsigned int, unsigned int, unsigned int, unsigned int, unsigned int, LOCKMODE)</literal></entry>
|
||||
<entry>Probe that fires when a request for a heavyweight lock (lmgr lock)
|
||||
has finished waiting (i.e., has acquired the lock).
|
||||
The arguments are the same as for lock-wait-start.</entry>
|
||||
The arguments are the same as for <literal>lock-wait-start</literal>.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>deadlock-found</entry>
|
||||
<entry>()</entry>
|
||||
<entry><literal>deadlock-found</literal></entry>
|
||||
<entry><literal>()</literal></entry>
|
||||
<entry>Probe that fires when a deadlock is found by the deadlock
|
||||
detector.</entry>
|
||||
</row>
|
||||
@ -2513,32 +2513,32 @@ SELECT pg_stat_get_backend_pid(s.backendid) AS pid,
|
||||
<tbody>
|
||||
|
||||
<row>
|
||||
<entry>LocalTransactionId</entry>
|
||||
<entry>unsigned int</entry>
|
||||
<entry><type>LocalTransactionId</type></entry>
|
||||
<entry><type>unsigned int</type></entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>LWLockMode</entry>
|
||||
<entry>int</entry>
|
||||
<entry><type>LWLockMode</type></entry>
|
||||
<entry><type>int</type></entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>LOCKMODE</entry>
|
||||
<entry>int</entry>
|
||||
<entry><type>LOCKMODE</type></entry>
|
||||
<entry><type>int</type></entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>BlockNumber</entry>
|
||||
<entry>unsigned int</entry>
|
||||
<entry><type>BlockNumber</type></entry>
|
||||
<entry><type>unsigned int</type></entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>Oid</entry>
|
||||
<entry>unsigned int</entry>
|
||||
<entry><type>Oid</type></entry>
|
||||
<entry><type>unsigned int</type></entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>ForkNumber</entry>
|
||||
<entry>int</entry>
|
||||
<entry><type>ForkNumber</type></entry>
|
||||
<entry><type>int</type></entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>bool</entry>
|
||||
<entry>char</entry>
|
||||
<entry><type>bool</type></entry>
|
||||
<entry><type>char</type></entry>
|
||||
</row>
|
||||
|
||||
</tbody>
|
||||
@ -2658,7 +2658,7 @@ Total time (ns) 2312105013
|
||||
<step>
|
||||
<para>
|
||||
Decide that the probe will be named <literal>transaction-start</> and
|
||||
requires a parameter of type LocalTransactionId
|
||||
requires a parameter of type <type>LocalTransactionId</type>
|
||||
</para>
|
||||
</step>
|
||||
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user