2001-10-17 01:57:06 +02:00
|
|
|
<!--
|
2003-11-29 20:52:15 +01:00
|
|
|
$PostgreSQL: pgsql/doc/src/sgml/monitoring.sgml,v 1.25 2003/11/29 19:51:37 pgsql Exp $
|
2001-10-17 01:57:06 +02:00
|
|
|
-->
|
|
|
|
|
|
|
|
<chapter id="monitoring">
|
|
|
|
<title>Monitoring Database Activity</title>
|
|
|
|
|
2003-08-31 19:32:24 +02:00
|
|
|
<indexterm zone="monitoring">
|
|
|
|
<primary>monitoring</primary>
|
|
|
|
<secondary>database activity</secondary>
|
|
|
|
</indexterm>
|
|
|
|
|
|
|
|
<indexterm zone="monitoring">
|
|
|
|
<primary>database activity</primary>
|
|
|
|
<secondary>monitoring</secondary>
|
|
|
|
</indexterm>
|
|
|
|
|
2001-10-17 01:57:06 +02:00
|
|
|
<para>
|
2002-11-11 21:14:04 +01:00
|
|
|
A database administrator frequently wonders, <quote>What is the system
|
2001-10-17 01:57:06 +02:00
|
|
|
doing right now?</quote>
|
|
|
|
This chapter discusses how to find that out.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
Several tools are available for monitoring database activity and
|
|
|
|
analyzing performance. Most of this chapter is devoted to describing
|
2003-03-24 15:32:51 +01:00
|
|
|
<productname>PostgreSQL</productname>'s statistics collector,
|
2001-10-17 01:57:06 +02:00
|
|
|
but one should not neglect regular Unix monitoring programs such as
|
|
|
|
<command>ps</> and <command>top</>. Also, once one has identified a
|
|
|
|
poorly-performing query, further investigation may be needed using
|
|
|
|
<productname>PostgreSQL</productname>'s <command>EXPLAIN</> command.
|
2003-03-25 17:15:44 +01:00
|
|
|
<xref linkend="using-explain"> discusses <command>EXPLAIN</>
|
2001-10-17 01:57:06 +02:00
|
|
|
and other methods for understanding the behavior of an individual
|
|
|
|
query.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<sect1 id="monitoring-ps">
|
|
|
|
<title>Standard Unix Tools</Title>
|
|
|
|
|
2001-11-12 20:19:39 +01:00
|
|
|
<indexterm zone="monitoring-ps">
|
|
|
|
<primary>ps</primary>
|
|
|
|
<secondary>to monitor activity</secondary>
|
|
|
|
</indexterm>
|
|
|
|
|
2001-10-17 01:57:06 +02:00
|
|
|
<para>
|
|
|
|
On most platforms, <productname>PostgreSQL</productname> modifies its
|
|
|
|
command title as reported by <command>ps</>, so that individual server
|
|
|
|
processes can readily be identified. A sample display is
|
|
|
|
|
|
|
|
<screen>
|
|
|
|
$ ps auxww | grep ^postgres
|
|
|
|
postgres 960 0.0 1.1 6104 1480 pts/1 SN 13:17 0:00 postmaster -i
|
|
|
|
postgres 963 0.0 1.1 7084 1472 pts/1 SN 13:17 0:00 postgres: stats buffer process
|
|
|
|
postgres 965 0.0 1.1 6152 1512 pts/1 SN 13:17 0:00 postgres: stats collector process
|
2001-10-19 02:46:51 +02:00
|
|
|
postgres 998 0.0 2.3 6532 2992 pts/1 SN 13:18 0:00 postgres: tgl runbug 127.0.0.1 idle
|
2001-10-17 01:57:06 +02:00
|
|
|
postgres 1003 0.0 2.4 6532 3128 pts/1 SN 13:19 0:00 postgres: tgl regression [local] SELECT waiting
|
|
|
|
postgres 1016 0.1 2.4 6532 3080 pts/1 SN 13:19 0:00 postgres: tgl regression [local] idle in transaction
|
|
|
|
</screen>
|
|
|
|
|
|
|
|
(The appropriate invocation of <command>ps</> varies across different
|
|
|
|
platforms, as do the details of what is shown. This example is from a
|
|
|
|
recent Linux system.) The first process listed here is the
|
2003-03-24 15:32:51 +01:00
|
|
|
<application>postmaster</>, the master server process. The command arguments
|
2001-10-17 01:57:06 +02:00
|
|
|
shown for it are the same ones given when it was launched. The next two
|
|
|
|
processes implement the statistics collector, which will be described in
|
|
|
|
detail in the next section. (These will not be present if you have set
|
|
|
|
the system not to start the statistics collector.) Each of the remaining
|
|
|
|
processes is a server process handling one client connection. Each such
|
|
|
|
process sets its command line display in the form
|
|
|
|
|
|
|
|
<screen>
|
2001-10-19 02:46:51 +02:00
|
|
|
postgres: <replaceable>user</> <replaceable>database</> <replaceable>host</> <replaceable>activity</>
|
2001-10-17 01:57:06 +02:00
|
|
|
</screen>
|
|
|
|
|
|
|
|
The user, database, and connection source host items remain the same for
|
|
|
|
the life of the client connection, but the activity indicator changes.
|
2002-11-11 21:14:04 +01:00
|
|
|
The activity may be <literal>idle</> (i.e., waiting for a client command),
|
|
|
|
<literal>idle in transaction</> (waiting for client inside a <command>BEGIN</> block),
|
2001-10-17 01:57:06 +02:00
|
|
|
or a command type name such as <literal>SELECT</>. Also,
|
2003-03-24 15:32:51 +01:00
|
|
|
<literal>waiting</> is attached if the server process is presently waiting
|
2001-10-17 01:57:06 +02:00
|
|
|
on a lock held by another server process. In the above example we can infer
|
|
|
|
that process 1003 is waiting for process 1016 to complete its transaction and
|
|
|
|
thereby release some lock or other.
|
|
|
|
</para>
|
2001-11-29 21:26:55 +01:00
|
|
|
|
|
|
|
<tip>
|
|
|
|
<para>
|
|
|
|
<productname>Solaris</productname> requires special handling. You must
|
|
|
|
use <command>/usr/ucb/ps</command>, rather than
|
2003-03-24 15:32:51 +01:00
|
|
|
<command>/bin/ps</command>. You also must use two <option>w</option>
|
2001-11-29 21:26:55 +01:00
|
|
|
flags, not just one. In addition, your original invocation of the
|
2003-03-24 15:32:51 +01:00
|
|
|
<command>postmaster</command> command must have a shorter
|
2001-11-29 21:26:55 +01:00
|
|
|
<command>ps</command> status display than that provided by each
|
2003-03-24 15:32:51 +01:00
|
|
|
server process. If you fail to do all three things, the <command>ps</>
|
|
|
|
output for each server process will be the original <command>postmaster</>
|
2001-11-29 21:43:43 +01:00
|
|
|
command line.
|
2001-11-29 21:26:55 +01:00
|
|
|
</para>
|
|
|
|
</tip>
|
2001-10-17 01:57:06 +02:00
|
|
|
</sect1>
|
|
|
|
|
|
|
|
<sect1 id="monitoring-stats">
|
2003-03-24 15:32:51 +01:00
|
|
|
<title>The Statistics Collector</Title>
|
2001-10-17 01:57:06 +02:00
|
|
|
|
2001-11-12 20:19:39 +01:00
|
|
|
<indexterm zone="monitoring-stats">
|
|
|
|
<primary>statistics</primary>
|
|
|
|
</indexterm>
|
|
|
|
|
2001-10-17 01:57:06 +02:00
|
|
|
<para>
|
|
|
|
<productname>PostgreSQL</productname>'s <firstterm>statistics collector</>
|
|
|
|
is a subsystem that supports collection and reporting of information about
|
|
|
|
server activity. Presently, the collector can count accesses to tables
|
|
|
|
and indexes in both disk-block and individual-row terms. It also supports
|
2003-03-24 15:32:51 +01:00
|
|
|
determining the exact command currently being executed by other server
|
2001-10-17 01:57:06 +02:00
|
|
|
processes.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<sect2 id="monitoring-stats-setup">
|
|
|
|
<title>Statistics Collection Configuration</Title>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
Since collection of statistics adds some overhead to query execution,
|
|
|
|
the system can be configured to collect or not collect information.
|
2003-03-24 15:32:51 +01:00
|
|
|
This is controlled by configuration parameters that are normally set in
|
|
|
|
<filename>postgresql.conf</>. (See <xref linkend="runtime-config"> for
|
|
|
|
details about setting configuration parameters.)
|
2001-10-17 01:57:06 +02:00
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
2003-03-24 15:32:51 +01:00
|
|
|
The parameter <varname>stats_start_collector</varname> must be set to
|
2001-10-17 01:57:06 +02:00
|
|
|
<literal>true</> for the statistics collector to
|
|
|
|
be launched at all. This is the default and recommended setting,
|
|
|
|
but it may be turned off if you have no interest in statistics and
|
|
|
|
want to squeeze out every last drop of overhead. (The savings is
|
|
|
|
likely to be small, however.) Note that this option
|
|
|
|
cannot be changed while the server is running.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
2003-03-24 15:32:51 +01:00
|
|
|
The parameters <varname>stats_command_string</varname>,
|
|
|
|
<varname>stats_block_level</varname>,
|
|
|
|
and <varname>stats_row_level</varname> control how much information is
|
|
|
|
actually sent to the collector and thus determine how much run-time
|
2001-10-17 01:57:06 +02:00
|
|
|
overhead occurs. These respectively determine whether a server process
|
|
|
|
sends its current command string, disk-block-level access statistics, and
|
2003-03-24 15:32:51 +01:00
|
|
|
row-level access statistics to the collector. Normally these parameters are
|
2001-10-17 01:57:06 +02:00
|
|
|
set in <filename>postgresql.conf</> so that they apply to all server
|
2003-03-24 15:32:51 +01:00
|
|
|
processes, but it is possible to turn them on or off in individual sessions
|
|
|
|
using the <command>SET</> command. (To prevent ordinary users
|
2001-10-17 01:57:06 +02:00
|
|
|
from hiding their activity from the administrator, only superusers are
|
2003-03-24 15:32:51 +01:00
|
|
|
allowed to change these parameters with <command>SET</>.)
|
2001-10-17 01:57:06 +02:00
|
|
|
</para>
|
|
|
|
|
2003-03-24 15:32:51 +01:00
|
|
|
<note>
|
2001-10-17 01:57:06 +02:00
|
|
|
<para>
|
2003-03-24 15:32:51 +01:00
|
|
|
Since the parameters <varname>stats_command_string</varname>,
|
|
|
|
<varname>stats_block_level</varname>, and
|
|
|
|
<varname>stats_row_level</varname> default to <literal>false</>,
|
2003-03-20 04:34:57 +01:00
|
|
|
very few statistics are collected in the default
|
|
|
|
configuration. Enabling one or more of these configuration
|
|
|
|
variables will significantly enhance the amount of useful data
|
|
|
|
produced by the statistics collector, at the expense of
|
|
|
|
additional run-time overhead.
|
2001-10-17 01:57:06 +02:00
|
|
|
</para>
|
2003-03-24 15:32:51 +01:00
|
|
|
</note>
|
2001-10-17 01:57:06 +02:00
|
|
|
|
|
|
|
</sect2>
|
|
|
|
|
|
|
|
<sect2 id="monitoring-stats-views">
|
|
|
|
<title>Viewing Collected Statistics</Title>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
Several predefined views are available to show the results of
|
2002-11-11 21:14:04 +01:00
|
|
|
statistics collection, listed in <xref
|
|
|
|
linkend="monitoring-stats-views-table">. Alternatively, one can
|
|
|
|
build custom views using the underlying statistics functions.
|
2001-10-17 01:57:06 +02:00
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
When using the statistics to monitor current activity, it is important
|
|
|
|
to realize that the information does not update instantaneously.
|
|
|
|
Each individual server process transmits new access counts to the collector
|
|
|
|
just before waiting for another client command; so a query still in
|
|
|
|
progress does not affect the displayed totals. Also, the collector itself
|
2002-11-11 21:14:04 +01:00
|
|
|
emits new totals at most once per <varname>pgstat_stat_interval</varname> milliseconds
|
|
|
|
(500 by default). So the displayed totals lag behind actual activity.
|
2001-10-17 01:57:06 +02:00
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
Another important point is that when a server process is asked to display
|
|
|
|
any of these statistics, it first fetches the most recent totals emitted by
|
2003-03-24 15:32:51 +01:00
|
|
|
the collector process and then continues to use this snapshot for all
|
2001-10-17 01:57:06 +02:00
|
|
|
statistical views and functions until the end of its current transaction.
|
|
|
|
So the statistics will appear not to change as long as you continue the
|
|
|
|
current transaction.
|
|
|
|
This is a feature, not a bug, because it allows you to perform several
|
|
|
|
queries on the statistics and correlate the results without worrying that
|
|
|
|
the numbers are changing underneath you. But if you want to see new
|
|
|
|
results with each query, be sure to do the queries outside any transaction
|
|
|
|
block.
|
|
|
|
</para>
|
|
|
|
|
2002-11-11 21:14:04 +01:00
|
|
|
<table id="monitoring-stats-views-table">
|
2001-10-17 01:57:06 +02:00
|
|
|
<title>Standard Statistics Views</title>
|
|
|
|
|
|
|
|
<tgroup cols="2">
|
|
|
|
<thead>
|
|
|
|
<row>
|
|
|
|
<entry>View Name</entry>
|
|
|
|
<entry>Description</entry>
|
|
|
|
</row>
|
|
|
|
</thead>
|
|
|
|
|
|
|
|
<tbody>
|
|
|
|
<row>
|
|
|
|
<entry><structname>pg_stat_activity</></entry>
|
2003-03-20 04:34:57 +01:00
|
|
|
<entry>One row per server process, showing process
|
|
|
|
<acronym>ID</>, database, user, current query, and the time at
|
|
|
|
which the current query began execution. The columns that report
|
2003-03-24 15:32:51 +01:00
|
|
|
data on the current query are only available if the parameter
|
|
|
|
<varname>stats_command_string</varname> has been turned on.
|
2003-04-04 05:03:54 +02:00
|
|
|
Furthermore, these columns read as null unless the user examining
|
|
|
|
the view is a superuser or the same as the user owning the process
|
|
|
|
being reported on. (Note that because of the
|
2003-03-20 19:51:16 +01:00
|
|
|
collector's reporting delay, current query will only be up-to-date for
|
|
|
|
long-running queries.)</entry>
|
2001-10-17 01:57:06 +02:00
|
|
|
</row>
|
|
|
|
|
|
|
|
<row>
|
|
|
|
<entry><structname>pg_stat_database</></entry>
|
2003-03-24 15:32:51 +01:00
|
|
|
<entry>One row per database, showing the number of active backend server processes,
|
2001-10-17 01:57:06 +02:00
|
|
|
total transactions committed and total rolled back in that database,
|
2002-11-11 21:14:04 +01:00
|
|
|
total disk blocks read, and total number of buffer hits (i.e., block
|
2001-10-17 01:57:06 +02:00
|
|
|
read requests avoided by finding the block already in buffer cache).
|
|
|
|
</entry>
|
|
|
|
</row>
|
|
|
|
|
|
|
|
<row>
|
|
|
|
<entry><structname>pg_stat_all_tables</></entry>
|
|
|
|
<entry>For each table in the current database, total numbers of
|
2003-11-01 02:56:29 +01:00
|
|
|
sequential and index scans, total numbers of rows returned by
|
|
|
|
each type of scan, and totals of row insertions, updates,
|
2003-03-24 15:32:51 +01:00
|
|
|
and deletions.</entry>
|
2001-10-17 01:57:06 +02:00
|
|
|
</row>
|
|
|
|
|
|
|
|
<row>
|
|
|
|
<entry><structname>pg_stat_sys_tables</></entry>
|
2002-11-11 21:14:04 +01:00
|
|
|
<entry>Same as <structname>pg_stat_all_tables</>, except that only system tables
|
2001-10-17 01:57:06 +02:00
|
|
|
are shown.</entry>
|
|
|
|
</row>
|
|
|
|
|
|
|
|
<row>
|
|
|
|
<entry><structname>pg_stat_user_tables</></entry>
|
2002-11-11 21:14:04 +01:00
|
|
|
<entry>Same as <structname>pg_stat_all_tables</>, except that only user tables
|
2001-10-17 01:57:06 +02:00
|
|
|
are shown.</entry>
|
|
|
|
</row>
|
|
|
|
|
|
|
|
<row>
|
|
|
|
<entry><structname>pg_stat_all_indexes</></entry>
|
|
|
|
<entry>For each index in the current database, the total number
|
2003-11-01 02:56:29 +01:00
|
|
|
of index scans that have used that index, the number of index rows
|
|
|
|
read, and the number of successfully fetched heap rows. (This may
|
|
|
|
be less when there are index entries pointing to expired heap rows.)
|
2001-10-17 01:57:06 +02:00
|
|
|
</entry>
|
|
|
|
</row>
|
|
|
|
|
|
|
|
<row>
|
|
|
|
<entry><structname>pg_stat_sys_indexes</></entry>
|
2002-11-11 21:14:04 +01:00
|
|
|
<entry>Same as <structname>pg_stat_all_indexes</>, except that only indexes on
|
2001-10-17 01:57:06 +02:00
|
|
|
system tables are shown.</entry>
|
|
|
|
</row>
|
|
|
|
|
|
|
|
<row>
|
|
|
|
<entry><structname>pg_stat_user_indexes</></entry>
|
2002-11-11 21:14:04 +01:00
|
|
|
<entry>Same as <structname>pg_stat_all_indexes</>, except that only indexes on
|
2001-10-17 01:57:06 +02:00
|
|
|
user tables are shown.</entry>
|
|
|
|
</row>
|
|
|
|
|
|
|
|
<row>
|
|
|
|
<entry><structname>pg_statio_all_tables</></entry>
|
|
|
|
<entry>For each table in the current database, the total number of disk
|
|
|
|
blocks read from that table, the number of buffer hits, the numbers of
|
|
|
|
disk blocks read and buffer hits in all the indexes of that table,
|
|
|
|
the numbers of disk blocks read and buffer hits from the table's
|
|
|
|
auxiliary TOAST table (if any), and the numbers of disk blocks read
|
|
|
|
and buffer hits for the TOAST table's index.
|
|
|
|
</entry>
|
|
|
|
</row>
|
|
|
|
|
|
|
|
<row>
|
|
|
|
<entry><structname>pg_statio_sys_tables</></entry>
|
2002-09-21 20:32:54 +02:00
|
|
|
<entry>Same as <structname>pg_statio_all_tables</>, except that only system tables
|
2001-10-17 01:57:06 +02:00
|
|
|
are shown.</entry>
|
|
|
|
</row>
|
|
|
|
|
|
|
|
<row>
|
|
|
|
<entry><structname>pg_statio_user_tables</></entry>
|
2002-09-21 20:32:54 +02:00
|
|
|
<entry>Same as <structname>pg_statio_all_tables</>, except that only user tables
|
2001-10-17 01:57:06 +02:00
|
|
|
are shown.</entry>
|
|
|
|
</row>
|
|
|
|
|
|
|
|
<row>
|
|
|
|
<entry><structname>pg_statio_all_indexes</></entry>
|
|
|
|
<entry>For each index in the current database, the numbers of
|
|
|
|
disk blocks read and buffer hits in that index.
|
|
|
|
</entry>
|
|
|
|
</row>
|
|
|
|
|
|
|
|
<row>
|
|
|
|
<entry><structname>pg_statio_sys_indexes</></entry>
|
2002-09-21 20:32:54 +02:00
|
|
|
<entry>Same as <structname>pg_statio_all_indexes</>, except that only indexes on
|
2001-10-17 01:57:06 +02:00
|
|
|
system tables are shown.</entry>
|
|
|
|
</row>
|
|
|
|
|
|
|
|
<row>
|
|
|
|
<entry><structname>pg_statio_user_indexes</></entry>
|
2002-09-21 20:32:54 +02:00
|
|
|
<entry>Same as <structname>pg_statio_all_indexes</>, except that only indexes on
|
2001-10-17 01:57:06 +02:00
|
|
|
user tables are shown.</entry>
|
|
|
|
</row>
|
|
|
|
|
|
|
|
<row>
|
|
|
|
<entry><structname>pg_statio_all_sequences</></entry>
|
|
|
|
<entry>For each sequence object in the current database, the numbers
|
|
|
|
of disk blocks read and buffer hits in that sequence.
|
|
|
|
</entry>
|
|
|
|
</row>
|
|
|
|
|
|
|
|
<row>
|
|
|
|
<entry><structname>pg_statio_sys_sequences</></entry>
|
2002-09-21 20:32:54 +02:00
|
|
|
<entry>Same as <structname>pg_statio_all_sequences</>, except that only system
|
2001-10-17 01:57:06 +02:00
|
|
|
sequences are shown. (Presently, no system sequences are defined,
|
|
|
|
so this view is always empty.)</entry>
|
|
|
|
</row>
|
|
|
|
|
|
|
|
<row>
|
|
|
|
<entry><structname>pg_statio_user_sequences</></entry>
|
2002-09-21 20:32:54 +02:00
|
|
|
<entry>Same as <structname>pg_statio_all_sequences</>, except that only user
|
2001-10-17 01:57:06 +02:00
|
|
|
sequences are shown.</entry>
|
|
|
|
</row>
|
|
|
|
</tbody>
|
|
|
|
</tgroup>
|
|
|
|
</table>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
The per-index statistics are particularly useful to determine which
|
|
|
|
indexes are being used and how effective they are.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
2003-03-20 04:34:57 +01:00
|
|
|
The <structname>pg_statio_</> views are primarily useful to
|
|
|
|
determine the effectiveness of the buffer cache. When the number
|
|
|
|
of actual disk reads is much smaller than the number of buffer
|
|
|
|
hits, then the cache is satisfying most read requests without
|
|
|
|
invoking a kernel call. However, these statistics do not give the
|
|
|
|
entire story: due to the way in which <productname>PostgreSQL</>
|
|
|
|
handles disk I/O, data that is not in the
|
|
|
|
<productname>PostgreSQL</> buffer cache may still reside in the
|
|
|
|
kernel's I/O cache, and may therefore still be fetched without
|
|
|
|
requiring a physical read. Users interested in obtaining more
|
|
|
|
detailed information on <productname>PostgreSQL</> I/O behavior are
|
|
|
|
advised to use the <productname>PostgreSQL</> statistics collector
|
|
|
|
in combination with operating system utilities that allow insight
|
|
|
|
into the kernel's handling of I/O.
|
2001-10-17 01:57:06 +02:00
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
2002-11-11 21:14:04 +01:00
|
|
|
Other ways of looking at the statistics can be set up by writing
|
|
|
|
queries that use the same underlying statistics access functions as
|
|
|
|
these standard views do. These functions are listed in <xref
|
|
|
|
linkend="monitoring-stats-funcs-table">. The per-database access
|
2003-11-04 10:55:39 +01:00
|
|
|
functions take a database OID as argument to identify which
|
|
|
|
database to report on. The per-table and per-index functions take
|
|
|
|
a table or index OID. (Note that only tables and indexes in the
|
|
|
|
current database can be seen with these functions.) The
|
|
|
|
per-backend process access functions take a backend process ID
|
|
|
|
number, which ranges from one to the number of currently active
|
|
|
|
backend processes.
|
2001-10-17 01:57:06 +02:00
|
|
|
</para>
|
|
|
|
|
2002-11-11 21:14:04 +01:00
|
|
|
<table id="monitoring-stats-funcs-table">
|
2001-10-17 01:57:06 +02:00
|
|
|
<title>Statistics Access Functions</title>
|
|
|
|
|
|
|
|
<tgroup cols="3">
|
|
|
|
<thead>
|
|
|
|
<row>
|
|
|
|
<entry>Function</entry>
|
|
|
|
<entry>Return Type</entry>
|
|
|
|
<entry>Description</entry>
|
|
|
|
</row>
|
|
|
|
</thead>
|
|
|
|
|
|
|
|
<tbody>
|
|
|
|
<row>
|
2003-03-24 15:32:51 +01:00
|
|
|
<entry><literal><function>pg_stat_get_db_numbackends</function>(<type>oid</type>)</literal></entry>
|
2001-10-17 01:57:06 +02:00
|
|
|
<entry><type>integer</type></entry>
|
|
|
|
<entry>
|
2003-03-24 15:32:51 +01:00
|
|
|
Number of active backend processes for database
|
2001-10-17 01:57:06 +02:00
|
|
|
</entry>
|
|
|
|
</row>
|
|
|
|
|
|
|
|
<row>
|
2003-03-24 15:32:51 +01:00
|
|
|
<entry><literal><function>pg_stat_get_db_xact_commit</function>(<type>oid</type>)</literal></entry>
|
2001-10-17 01:57:06 +02:00
|
|
|
<entry><type>bigint</type></entry>
|
|
|
|
<entry>
|
|
|
|
Transactions committed in database
|
|
|
|
</entry>
|
|
|
|
</row>
|
|
|
|
|
|
|
|
<row>
|
2003-03-24 15:32:51 +01:00
|
|
|
<entry><literal><function>pg_stat_get_db_xact_rollback</function>(<type>oid</type>)</literal></entry>
|
2001-10-17 01:57:06 +02:00
|
|
|
<entry><type>bigint</type></entry>
|
|
|
|
<entry>
|
|
|
|
Transactions rolled back in database
|
|
|
|
</entry>
|
|
|
|
</row>
|
|
|
|
|
|
|
|
<row>
|
2003-03-24 15:32:51 +01:00
|
|
|
<entry><literal><function>pg_stat_get_db_blocks_fetched</function>(<type>oid</type>)</literal></entry>
|
2001-10-17 01:57:06 +02:00
|
|
|
<entry><type>bigint</type></entry>
|
|
|
|
<entry>
|
|
|
|
Number of disk block fetch requests for database
|
|
|
|
</entry>
|
|
|
|
</row>
|
|
|
|
|
|
|
|
<row>
|
2003-03-24 15:32:51 +01:00
|
|
|
<entry><literal><function>pg_stat_get_db_blocks_hit</function>(<type>oid</type>)</literal></entry>
|
2001-10-17 01:57:06 +02:00
|
|
|
<entry><type>bigint</type></entry>
|
|
|
|
<entry>
|
2003-03-20 04:34:57 +01:00
|
|
|
Number of disk block fetch requests found in cache for database
|
2001-10-17 01:57:06 +02:00
|
|
|
</entry>
|
|
|
|
</row>
|
|
|
|
|
|
|
|
<row>
|
2003-03-24 15:32:51 +01:00
|
|
|
<entry><literal><function>pg_stat_get_numscans</function>(<type>oid</type>)</literal></entry>
|
2001-10-17 01:57:06 +02:00
|
|
|
<entry><type>bigint</type></entry>
|
|
|
|
<entry>
|
|
|
|
Number of sequential scans done when argument is a table,
|
|
|
|
or number of index scans done when argument is an index
|
|
|
|
</entry>
|
|
|
|
</row>
|
|
|
|
|
|
|
|
<row>
|
2003-03-24 15:32:51 +01:00
|
|
|
<entry><literal><function>pg_stat_get_tuples_returned</function>(<type>oid</type>)</literal></entry>
|
2001-10-17 01:57:06 +02:00
|
|
|
<entry><type>bigint</type></entry>
|
|
|
|
<entry>
|
2003-11-01 02:56:29 +01:00
|
|
|
Number of rows read by sequential scans when argument is a table,
|
|
|
|
or number of index rows read when argument is an index
|
2001-10-17 01:57:06 +02:00
|
|
|
</entry>
|
|
|
|
</row>
|
|
|
|
|
|
|
|
<row>
|
2003-03-24 15:32:51 +01:00
|
|
|
<entry><literal><function>pg_stat_get_tuples_fetched</function>(<type>oid</type>)</literal></entry>
|
2001-10-17 01:57:06 +02:00
|
|
|
<entry><type>bigint</type></entry>
|
|
|
|
<entry>
|
2003-11-01 02:56:29 +01:00
|
|
|
Number of valid (unexpired) table rows fetched by sequential scans
|
2001-10-17 01:57:06 +02:00
|
|
|
when argument is a table, or fetched by index scans using this index
|
|
|
|
when argument is an index
|
|
|
|
</entry>
|
|
|
|
</row>
|
|
|
|
|
|
|
|
<row>
|
2003-03-24 15:32:51 +01:00
|
|
|
<entry><literal><function>pg_stat_get_tuples_inserted</function>(<type>oid</type>)</literal></entry>
|
2001-10-17 01:57:06 +02:00
|
|
|
<entry><type>bigint</type></entry>
|
|
|
|
<entry>
|
2003-11-01 02:56:29 +01:00
|
|
|
Number of rows inserted into table
|
2001-10-17 01:57:06 +02:00
|
|
|
</entry>
|
|
|
|
</row>
|
|
|
|
|
|
|
|
<row>
|
2003-03-24 15:32:51 +01:00
|
|
|
<entry><literal><function>pg_stat_get_tuples_updated</function>(<type>oid</type>)</literal></entry>
|
2001-10-17 01:57:06 +02:00
|
|
|
<entry><type>bigint</type></entry>
|
|
|
|
<entry>
|
2003-11-01 02:56:29 +01:00
|
|
|
Number of rows updated in table
|
2001-10-17 01:57:06 +02:00
|
|
|
</entry>
|
|
|
|
</row>
|
|
|
|
|
|
|
|
<row>
|
2003-03-24 15:32:51 +01:00
|
|
|
<entry><literal><function>pg_stat_get_tuples_deleted</function>(<type>oid</type>)</literal></entry>
|
2001-10-17 01:57:06 +02:00
|
|
|
<entry><type>bigint</type></entry>
|
|
|
|
<entry>
|
2003-11-01 02:56:29 +01:00
|
|
|
Number of rows deleted from table
|
2001-10-17 01:57:06 +02:00
|
|
|
</entry>
|
|
|
|
</row>
|
|
|
|
|
|
|
|
<row>
|
2003-03-24 15:32:51 +01:00
|
|
|
<entry><literal><function>pg_stat_get_blocks_fetched</function>(<type>oid</type>)</literal></entry>
|
2001-10-17 01:57:06 +02:00
|
|
|
<entry><type>bigint</type></entry>
|
|
|
|
<entry>
|
|
|
|
Number of disk block fetch requests for table or index
|
|
|
|
</entry>
|
|
|
|
</row>
|
|
|
|
|
|
|
|
<row>
|
2003-03-24 15:32:51 +01:00
|
|
|
<entry><literal><function>pg_stat_get_blocks_hit</function>(<type>oid</type>)</literal></entry>
|
2001-10-17 01:57:06 +02:00
|
|
|
<entry><type>bigint</type></entry>
|
|
|
|
<entry>
|
|
|
|
Number of disk block requests found in cache for table or index
|
|
|
|
</entry>
|
|
|
|
</row>
|
|
|
|
|
|
|
|
<row>
|
2003-03-24 15:32:51 +01:00
|
|
|
<entry><literal><function>pg_stat_get_backend_idset</function>()</literal></entry>
|
2001-10-17 01:57:06 +02:00
|
|
|
<entry><type>set of integer</type></entry>
|
|
|
|
<entry>
|
2003-03-24 15:32:51 +01:00
|
|
|
Set of currently active backend process IDs (from 1 to the
|
|
|
|
number of active backend processes). See usage example in the text.
|
2001-10-17 01:57:06 +02:00
|
|
|
</entry>
|
|
|
|
</row>
|
2002-08-04 21:51:30 +02:00
|
|
|
|
|
|
|
<row>
|
2003-03-24 15:32:51 +01:00
|
|
|
<entry><literal><function>pg_backend_pid</function>()</literal></entry>
|
2002-08-04 21:51:30 +02:00
|
|
|
<entry><type>integer</type></entry>
|
|
|
|
<entry>
|
2003-03-24 15:32:51 +01:00
|
|
|
Process ID of the backend process attached to the current session
|
2002-08-04 21:51:30 +02:00
|
|
|
</entry>
|
|
|
|
</row>
|
2002-07-31 03:49:13 +02:00
|
|
|
|
2001-10-17 01:57:06 +02:00
|
|
|
<row>
|
2003-03-24 15:32:51 +01:00
|
|
|
<entry><literal><function>pg_stat_get_backend_pid</function>(<type>integer</type>)</literal></entry>
|
2001-10-17 01:57:06 +02:00
|
|
|
<entry><type>integer</type></entry>
|
|
|
|
<entry>
|
2003-03-24 15:32:51 +01:00
|
|
|
Process ID of the given backend process
|
2001-10-17 01:57:06 +02:00
|
|
|
</entry>
|
|
|
|
</row>
|
|
|
|
|
|
|
|
<row>
|
2003-03-24 15:32:51 +01:00
|
|
|
<entry><literal><function>pg_stat_get_backend_dbid</function>(<type>integer</type>)</literal></entry>
|
2001-10-17 01:57:06 +02:00
|
|
|
<entry><type>oid</type></entry>
|
|
|
|
<entry>
|
2003-03-24 15:32:51 +01:00
|
|
|
Database ID of the given backend process
|
2001-10-17 01:57:06 +02:00
|
|
|
</entry>
|
|
|
|
</row>
|
|
|
|
|
|
|
|
<row>
|
2003-03-24 15:32:51 +01:00
|
|
|
<entry><literal><function>pg_stat_get_backend_userid</function>(<type>integer</type>)</literal></entry>
|
2001-10-17 01:57:06 +02:00
|
|
|
<entry><type>oid</type></entry>
|
|
|
|
<entry>
|
2003-03-24 15:32:51 +01:00
|
|
|
User ID of the given backend process
|
2001-10-17 01:57:06 +02:00
|
|
|
</entry>
|
|
|
|
</row>
|
|
|
|
|
|
|
|
<row>
|
2003-03-24 15:32:51 +01:00
|
|
|
<entry><literal><function>pg_stat_get_backend_activity</function>(<type>integer</type>)</literal></entry>
|
2001-10-17 01:57:06 +02:00
|
|
|
<entry><type>text</type></entry>
|
|
|
|
<entry>
|
2003-03-24 15:32:51 +01:00
|
|
|
Active command of the given backend process (null if the
|
|
|
|
current user is not a superuser nor the same user as that of
|
|
|
|
the session being queried, or
|
|
|
|
<varname>stats_command_string</varname> is not on)
|
2001-10-17 01:57:06 +02:00
|
|
|
</entry>
|
|
|
|
</row>
|
2002-08-20 06:47:52 +02:00
|
|
|
|
2003-03-20 04:34:57 +01:00
|
|
|
<row>
|
2003-03-24 15:32:51 +01:00
|
|
|
<entry><literal><function>pg_stat_get_backend_activity_start</function>(<type>integer</type>)</literal></entry>
|
2003-04-04 05:03:54 +02:00
|
|
|
<entry><type>timestamp with time zone</type></entry>
|
2003-03-20 04:34:57 +01:00
|
|
|
<entry>
|
2003-04-04 05:03:54 +02:00
|
|
|
The time at which the given backend process' currently
|
|
|
|
executing query was started (null if the
|
|
|
|
current user is not a superuser nor the same user as that of
|
|
|
|
the session being queried, or
|
|
|
|
<varname>stats_command_string</varname> is not on)
|
2003-03-20 04:34:57 +01:00
|
|
|
</entry>
|
|
|
|
</row>
|
|
|
|
|
2002-08-20 06:47:52 +02:00
|
|
|
<row>
|
2003-03-24 15:32:51 +01:00
|
|
|
<entry><literal><function>pg_stat_reset</function>()</literal></entry>
|
2002-08-20 06:47:52 +02:00
|
|
|
<entry><type>boolean</type></entry>
|
|
|
|
<entry>
|
2003-03-20 04:34:57 +01:00
|
|
|
Reset all currently collected statistics
|
2002-08-20 06:47:52 +02:00
|
|
|
</entry>
|
|
|
|
</row>
|
2001-10-17 01:57:06 +02:00
|
|
|
</tbody>
|
|
|
|
</tgroup>
|
|
|
|
</table>
|
|
|
|
|
2002-11-11 21:14:04 +01:00
|
|
|
<note>
|
|
|
|
<para>
|
2003-03-24 15:32:51 +01:00
|
|
|
<function>pg_stat_get_db_blocks_fetched</function> minus
|
|
|
|
<function>pg_stat_get_db_blocks_hit</function> gives the number of kernel
|
2002-11-11 21:14:04 +01:00
|
|
|
<function>read()</> calls issued for the table, index, or
|
|
|
|
database; but the actual number of physical reads is usually
|
|
|
|
lower due to kernel-level buffering.
|
|
|
|
</para>
|
|
|
|
</note>
|
2001-10-17 01:57:06 +02:00
|
|
|
|
|
|
|
<para>
|
|
|
|
The function <function>pg_stat_get_backend_idset</function> provides
|
2003-03-24 15:32:51 +01:00
|
|
|
a convenient way to generate one row for each active backend process. For
|
|
|
|
example, to show the <acronym>PID</>s and current queries of all backend processes:
|
2001-10-17 01:57:06 +02:00
|
|
|
|
|
|
|
<programlisting>
|
2003-03-24 15:32:51 +01:00
|
|
|
SELECT pg_stat_get_backend_pid(s.backendid) AS procpid,
|
|
|
|
pg_stat_get_backend_activity(s.backendid) AS current_query
|
|
|
|
FROM (SELECT pg_stat_get_backend_idset() AS backendid) AS s;
|
2001-10-17 01:57:06 +02:00
|
|
|
</programlisting>
|
|
|
|
</para>
|
|
|
|
|
|
|
|
</sect2>
|
|
|
|
</sect1>
|
2002-08-17 15:04:19 +02:00
|
|
|
|
2002-11-11 21:14:04 +01:00
|
|
|
<sect1 id="monitoring-locks">
|
|
|
|
<title>Viewing Locks</title>
|
|
|
|
|
2003-08-31 19:32:24 +02:00
|
|
|
<indexterm zone="monitoring-locks">
|
|
|
|
<primary>lock</primary>
|
|
|
|
<secondary>monitoring</secondary>
|
|
|
|
</indexterm>
|
|
|
|
|
2002-11-11 21:14:04 +01:00
|
|
|
<para>
|
|
|
|
Another useful tool for monitoring database activity is the
|
2003-10-18 00:38:20 +02:00
|
|
|
<structname>pg_locks</structname> system table. It allows the
|
2002-11-11 21:14:04 +01:00
|
|
|
database administrator to view information about the outstanding
|
|
|
|
locks in the lock manager. For example, this capability can be used
|
|
|
|
to:
|
|
|
|
|
|
|
|
<itemizedlist>
|
|
|
|
<listitem>
|
|
|
|
<para>
|
|
|
|
View all the locks currently outstanding, all the locks on
|
|
|
|
relations in a particular database, all the locks on a
|
|
|
|
particular relation, or all the locks held by a particular
|
|
|
|
<productname>PostgreSQL</productname> session.
|
|
|
|
</para>
|
|
|
|
</listitem>
|
|
|
|
|
|
|
|
<listitem>
|
|
|
|
<para>
|
2003-03-24 15:32:51 +01:00
|
|
|
Determine the relation in the current database with the most
|
2002-11-11 21:14:04 +01:00
|
|
|
ungranted locks (which might be a source of contention among
|
|
|
|
database clients).
|
|
|
|
</para>
|
|
|
|
</listitem>
|
|
|
|
|
|
|
|
<listitem>
|
|
|
|
<para>
|
|
|
|
Determine the effect of lock contention on overall database
|
|
|
|
performance, as well as the extent to which contention varies
|
|
|
|
with overall database traffic.
|
|
|
|
</para>
|
|
|
|
</listitem>
|
|
|
|
</itemizedlist>
|
|
|
|
|
2003-10-18 00:38:20 +02:00
|
|
|
Details of the <structname>pg_locks</structname> view appear in
|
|
|
|
<xref linkend="view-pg-locks">.
|
2002-11-11 21:14:04 +01:00
|
|
|
For more information on locking and managing concurrency with
|
2003-03-25 17:15:44 +01:00
|
|
|
<productname>PostgreSQL</productname>, refer to <xref linkend="mvcc">.
|
2002-11-11 21:14:04 +01:00
|
|
|
</para>
|
|
|
|
</sect1>
|
2001-10-17 01:57:06 +02:00
|
|
|
</chapter>
|
|
|
|
|
|
|
|
<!-- Keep this comment at the end of the file
|
|
|
|
Local variables:
|
|
|
|
mode:sgml
|
|
|
|
sgml-omittag:nil
|
|
|
|
sgml-shorttag:t
|
|
|
|
sgml-minimize-attributes:nil
|
|
|
|
sgml-always-quote-attributes:t
|
|
|
|
sgml-indent-step:1
|
|
|
|
sgml-indent-data:t
|
|
|
|
sgml-parent-document:nil
|
|
|
|
sgml-default-dtd-file:"./reference.ced"
|
|
|
|
sgml-exposed-tags:nil
|
|
|
|
sgml-local-catalogs:("/usr/lib/sgml/catalog")
|
|
|
|
sgml-local-ecat-files:nil
|
|
|
|
End:
|
|
|
|
-->
|