From 99ac15ac818a1afcc2215974672f4edc10e6ca7f Mon Sep 17 00:00:00 2001 From: Peter Smith Date: Thu, 6 Oct 2022 15:54:04 +1100 Subject: [PATCH v2] Fix ordering - tables in stats docs. Rearrange the rows of some stats docs tables to be alphabetically ordered. Many of them were ordered already, but not all. Modified tables are: - Table 28.1 Dynamic Statistics View - Table 28.2 Collected Statistics Views - Table 28.12 Wait Events of type LWLock - Table 28.34 Additional Statistic Functions - Table 28.35 Per-Backend Statistics Functions --- doc/src/sgml/monitoring.sgml | 442 +++++++++++++++++++++---------------------- 1 file changed, 221 insertions(+), 221 deletions(-) diff --git a/doc/src/sgml/monitoring.sgml b/doc/src/sgml/monitoring.sgml index c223ca2..f94ff14 100644 --- a/doc/src/sgml/monitoring.sgml +++ b/doc/src/sgml/monitoring.sgml @@ -316,63 +316,42 @@ postgres 27093 0.0 0.0 30096 2752 ? Ss 11:34 0:00 postgres: ser - pg_stat_replicationpg_stat_replication - One row per WAL sender process, showing statistics about - replication to that sender's connected standby server. - See - pg_stat_replication for details. - - - - - pg_stat_wal_receiverpg_stat_wal_receiver - Only one row, showing statistics about the WAL receiver from - that receiver's connected server. - See - pg_stat_wal_receiver for details. - - - - - pg_stat_recovery_prefetchpg_stat_recovery_prefetch - Only one row, showing statistics about blocks prefetched during recovery. - See - pg_stat_recovery_prefetch for details. + pg_stat_gssapipg_stat_gssapi + One row per connection (regular and replication), showing information about + GSSAPI authentication and encryption used on this connection. + See + pg_stat_gssapi for details. - pg_stat_subscriptionpg_stat_subscription - At least one row per subscription, showing information about - the subscription workers. - See - pg_stat_subscription for details. + pg_stat_progress_analyzepg_stat_progress_analyze + One row for each backend (including autovacuum worker processes) running + ANALYZE, showing current progress. + See . - pg_stat_sslpg_stat_ssl - One row per connection (regular and replication), showing information about - SSL used on this connection. - See - pg_stat_ssl for details. + pg_stat_progress_basebackuppg_stat_progress_basebackup + One row for each WAL sender process streaming a base backup, + showing current progress. + See . - pg_stat_gssapipg_stat_gssapi - One row per connection (regular and replication), showing information about - GSSAPI authentication and encryption used on this connection. - See - pg_stat_gssapi for details. + pg_stat_progress_clusterpg_stat_progress_cluster + One row for each backend running + CLUSTER or VACUUM FULL, showing current progress. + See . - pg_stat_progress_analyzepg_stat_progress_analyze - One row for each backend (including autovacuum worker processes) running - ANALYZE, showing current progress. - See . + pg_stat_progress_copypg_stat_progress_copy + One row for each backend running COPY, showing current progress. + See . @@ -393,25 +372,46 @@ postgres 27093 0.0 0.0 30096 2752 ? Ss 11:34 0:00 postgres: ser - pg_stat_progress_clusterpg_stat_progress_cluster - One row for each backend running - CLUSTER or VACUUM FULL, showing current progress. - See . + pg_stat_recovery_prefetchpg_stat_recovery_prefetch + Only one row, showing statistics about blocks prefetched during recovery. + See + pg_stat_recovery_prefetch for details. - pg_stat_progress_basebackuppg_stat_progress_basebackup - One row for each WAL sender process streaming a base backup, - showing current progress. - See . + pg_stat_replicationpg_stat_replication + One row per WAL sender process, showing statistics about + replication to that sender's connected standby server. + See + pg_stat_replication for details. - pg_stat_progress_copypg_stat_progress_copy - One row for each backend running COPY, showing current progress. - See . + pg_stat_sslpg_stat_ssl + One row per connection (regular and replication), showing information about + SSL used on this connection. + See + pg_stat_ssl for details. + + + + + pg_stat_subscriptionpg_stat_subscription + At least one row per subscription, showing information about + the subscription workers. + See + pg_stat_subscription for details. + + + + + pg_stat_wal_receiverpg_stat_wal_receiver + Only one row, showing statistics about the WAL receiver from + that receiver's connected server. + See + pg_stat_wal_receiver for details. @@ -431,6 +431,26 @@ postgres 27093 0.0 0.0 30096 2752 ? Ss 11:34 0:00 postgres: ser + pg_stat_all_indexespg_stat_all_indexes + + One row for each index in the current database, showing statistics + about accesses to that specific index. + See + pg_stat_all_indexes for details. + + + + + pg_stat_all_tablespg_stat_all_tables + + One row for each table in the current database, showing statistics + about accesses to that specific table. + See + pg_stat_all_tables for details. + + + + pg_stat_archiverpg_stat_archiver One row only, showing statistics about the WAL archiver process's activity. See @@ -449,14 +469,6 @@ postgres 27093 0.0 0.0 30096 2752 ? Ss 11:34 0:00 postgres: ser - pg_stat_walpg_stat_wal - One row only, showing statistics about WAL activity. See - - pg_stat_wal for details. - - - - pg_stat_databasepg_stat_database One row per database, showing database-wide statistics. See @@ -475,89 +487,97 @@ postgres 27093 0.0 0.0 30096 2752 ? Ss 11:34 0:00 postgres: ser - pg_stat_all_tablespg_stat_all_tables - - One row for each table in the current database, showing statistics - about accesses to that specific table. - See - pg_stat_all_tables for details. + pg_stat_replication_slotspg_stat_replication_slots + One row per replication slot, showing statistics about the + replication slot's usage. See + + pg_stat_replication_slots for details. - pg_stat_sys_tablespg_stat_sys_tables - Same as pg_stat_all_tables, except that only - system tables are shown. + pg_stat_slrupg_stat_slru + One row per SLRU, showing statistics of operations. See + + pg_stat_slru for details. + - pg_stat_user_tablespg_stat_user_tables - Same as pg_stat_all_tables, except that only user - tables are shown. + pg_stat_subscription_statspg_stat_subscription_stats + One row per subscription, showing statistics about errors. + See + pg_stat_subscription_stats for details. + - pg_stat_xact_all_tablespg_stat_xact_all_tables - Similar to pg_stat_all_tables, but counts actions - taken so far within the current transaction (which are not - yet included in pg_stat_all_tables and related views). - The columns for numbers of live and dead rows and vacuum and - analyze actions are not present in this view. + pg_stat_sys_indexespg_stat_sys_indexes + Same as pg_stat_all_indexes, except that only + indexes on system tables are shown. - pg_stat_xact_sys_tablespg_stat_xact_sys_tables - Same as pg_stat_xact_all_tables, except that only + pg_stat_sys_tablespg_stat_sys_tables + Same as pg_stat_all_tables, except that only system tables are shown. - pg_stat_xact_user_tablespg_stat_xact_user_tables - Same as pg_stat_xact_all_tables, except that only - user tables are shown. - - - - pg_stat_all_indexespg_stat_all_indexes + pg_stat_user_functionspg_stat_user_functions - One row for each index in the current database, showing statistics - about accesses to that specific index. - See - pg_stat_all_indexes for details. + One row for each tracked function, showing statistics + about executions of that function. See + + pg_stat_user_functions for details. - pg_stat_sys_indexespg_stat_sys_indexes + pg_stat_user_indexespg_stat_user_indexes Same as pg_stat_all_indexes, except that only - indexes on system tables are shown. + indexes on user tables are shown. - pg_stat_user_indexespg_stat_user_indexes - Same as pg_stat_all_indexes, except that only - indexes on user tables are shown. + pg_stat_user_tablespg_stat_user_tables + Same as pg_stat_all_tables, except that only user + tables are shown. - pg_statio_all_tablespg_statio_all_tables - - One row for each table in the current database, showing statistics - about I/O on that specific table. - See - pg_statio_all_tables for details. + pg_stat_walpg_stat_wal + One row only, showing statistics about WAL activity. See + + pg_stat_wal for details. - pg_statio_sys_tablespg_statio_sys_tables - Same as pg_statio_all_tables, except that only + pg_stat_xact_all_tablespg_stat_xact_all_tables + Similar to pg_stat_all_tables, but counts actions + taken so far within the current transaction (which are not + yet included in pg_stat_all_tables and related views). + The columns for numbers of live and dead rows and vacuum and + analyze actions are not present in this view. + + + + pg_stat_xact_sys_tablespg_stat_xact_sys_tables + Same as pg_stat_xact_all_tables, except that only system tables are shown. - pg_statio_user_tablespg_statio_user_tables - Same as pg_statio_all_tables, except that only + pg_stat_xact_user_functionspg_stat_xact_user_functions + Similar to pg_stat_user_functions, but counts only + calls during the current transaction (which are not + yet included in pg_stat_user_functions). + + + + pg_stat_xact_user_tablespg_stat_xact_user_tables + Same as pg_stat_xact_all_tables, except that only user tables are shown. @@ -572,18 +592,6 @@ postgres 27093 0.0 0.0 30096 2752 ? Ss 11:34 0:00 postgres: ser - pg_statio_sys_indexespg_statio_sys_indexes - Same as pg_statio_all_indexes, except that only - indexes on system tables are shown. - - - - pg_statio_user_indexespg_statio_user_indexes - Same as pg_statio_all_indexes, except that only - indexes on user tables are shown. - - - pg_statio_all_sequencespg_statio_all_sequences One row for each sequence in the current database, @@ -594,58 +602,50 @@ postgres 27093 0.0 0.0 30096 2752 ? Ss 11:34 0:00 postgres: ser - pg_statio_sys_sequencespg_statio_sys_sequences - Same as pg_statio_all_sequences, except that only - system sequences are shown. (Presently, no system sequences are defined, - so this view is always empty.) + pg_statio_all_tablespg_statio_all_tables + + One row for each table in the current database, showing statistics + about I/O on that specific table. + See + pg_statio_all_tables for details. + - pg_statio_user_sequencespg_statio_user_sequences - Same as pg_statio_all_sequences, except that only - user sequences are shown. + pg_statio_sys_indexespg_statio_sys_indexes + Same as pg_statio_all_indexes, except that only + indexes on system tables are shown. - pg_stat_user_functionspg_stat_user_functions - - One row for each tracked function, showing statistics - about executions of that function. See - - pg_stat_user_functions for details. - + pg_statio_sys_sequencespg_statio_sys_sequences + Same as pg_statio_all_sequences, except that only + system sequences are shown. (Presently, no system sequences are defined, + so this view is always empty.) - pg_stat_xact_user_functionspg_stat_xact_user_functions - Similar to pg_stat_user_functions, but counts only - calls during the current transaction (which are not - yet included in pg_stat_user_functions). + pg_statio_sys_tablespg_statio_sys_tables + Same as pg_statio_all_tables, except that only + system tables are shown. - pg_stat_slrupg_stat_slru - One row per SLRU, showing statistics of operations. See - - pg_stat_slru for details. - + pg_statio_user_indexespg_statio_user_indexes + Same as pg_statio_all_indexes, except that only + indexes on user tables are shown. - pg_stat_replication_slotspg_stat_replication_slots - One row per replication slot, showing statistics about the - replication slot's usage. See - - pg_stat_replication_slots for details. - + pg_statio_user_sequencespg_statio_user_sequences + Same as pg_statio_all_sequences, except that only + user sequences are shown. - pg_stat_subscription_statspg_stat_subscription_stats - One row per subscription, showing statistics about errors. - See - pg_stat_subscription_stats for details. - + pg_statio_user_tablespg_statio_user_tables + Same as pg_statio_all_tables, except that only + user tables are shown. @@ -2072,6 +2072,18 @@ postgres 27093 0.0 0.0 30096 2752 ? Ss 11:34 0:00 postgres: ser serializable transaction during a parallel query. + PgStatsDSA + Waiting for stats dynamic shared memory allocator access + + + PgStatsHash + Waiting for stats shared memory hash table access + + + PgStatsData + Waiting for shared memory stats data access + + PredicateLockManager Waiting to access predicate lock information used by serializable transactions. @@ -2130,18 +2142,6 @@ postgres 27093 0.0 0.0 30096 2752 ? Ss 11:34 0:00 postgres: ser serializable transactions. - PgStatsDSA - Waiting for stats dynamic shared memory allocator access - - - PgStatsHash - Waiting for stats shared memory hash table access - - - PgStatsData - Waiting for shared memory stats data access - - SerializableXactHash Waiting to read or update information about serializable transactions. @@ -5285,6 +5285,19 @@ SELECT pid, wait_event_type, wait_event FROM pg_stat_activity WHERE wait_event i + pg_stat_clear_snapshot + + pg_stat_clear_snapshot () + void + + + Discards the current statistics snapshot or cached information. + + + + + + pg_stat_get_activity pg_stat_get_activity ( integer ) @@ -5318,30 +5331,36 @@ SELECT pid, wait_event_type, wait_event FROM pg_stat_activity WHERE wait_event i - pg_stat_clear_snapshot + pg_stat_reset - pg_stat_clear_snapshot () + pg_stat_reset () void - Discards the current statistics snapshot or cached information. + Resets all statistics counters for the current database to zero. + + + This function is restricted to superusers by default, but other users + can be granted EXECUTE to run the function. - pg_stat_reset + pg_stat_reset_replication_slot - pg_stat_reset () + pg_stat_reset_replication_slot ( text ) void - Resets all statistics counters for the current database to zero. + Resets statistics of the replication slot defined by the argument. If + the argument is NULL, resets statistics for all + the replication slots. - This function is restricted to superusers by default, but other users - can be granted EXECUTE to run the function. + This function is restricted to superusers by default, but other users + can be granted EXECUTE to run the function. @@ -5374,14 +5393,14 @@ SELECT pid, wait_event_type, wait_event FROM pg_stat_activity WHERE wait_event i - pg_stat_reset_single_table_counters + pg_stat_reset_single_function_counters - pg_stat_reset_single_table_counters ( oid ) + pg_stat_reset_single_function_counters ( oid ) void - Resets statistics for a single table or index in the current database - or shared across all databases in the cluster to zero. + Resets statistics for a single function in the current database to + zero. This function is restricted to superusers by default, but other users @@ -5392,14 +5411,14 @@ SELECT pid, wait_event_type, wait_event FROM pg_stat_activity WHERE wait_event i - pg_stat_reset_single_function_counters + pg_stat_reset_single_table_counters - pg_stat_reset_single_function_counters ( oid ) + pg_stat_reset_single_table_counters ( oid ) void - Resets statistics for a single function in the current database to - zero. + Resets statistics for a single table or index in the current database + or shared across all databases in the cluster to zero. This function is restricted to superusers by default, but other users @@ -5441,25 +5460,6 @@ SELECT pid, wait_event_type, wait_event FROM pg_stat_activity WHERE wait_event i - pg_stat_reset_replication_slot - - pg_stat_reset_replication_slot ( text ) - void - - - Resets statistics of the replication slot defined by the argument. If - the argument is NULL, resets statistics for all - the replication slots. - - - This function is restricted to superusers by default, but other users - can be granted EXECUTE to run the function. - - - - - - pg_stat_reset_subscription_stats pg_stat_reset_subscription_stats ( oid ) @@ -5523,19 +5523,6 @@ FROM pg_stat_get_backend_idset() AS backendid; - pg_stat_get_backend_idset - - pg_stat_get_backend_idset () - setof integer - - - Returns the set of currently active backend ID numbers. - - - - - - pg_stat_get_backend_activity pg_stat_get_backend_activity ( integer ) @@ -5598,6 +5585,19 @@ FROM pg_stat_get_backend_idset() AS backendid; + + + + pg_stat_get_backend_idset + + pg_stat_get_backend_idset () + setof integer + + + Returns the set of currently active backend ID numbers. + + + @@ -5640,29 +5640,29 @@ FROM pg_stat_get_backend_idset() AS backendid; - pg_stat_get_backend_wait_event_type + pg_stat_get_backend_wait_event - pg_stat_get_backend_wait_event_type ( integer ) + pg_stat_get_backend_wait_event ( integer ) text - Returns the wait event type name if this backend is currently waiting, - otherwise NULL. See for details. + Returns the wait event name if this backend is currently waiting, + otherwise NULL. See through + . - pg_stat_get_backend_wait_event + pg_stat_get_backend_wait_event_type - pg_stat_get_backend_wait_event ( integer ) + pg_stat_get_backend_wait_event_type ( integer ) text - Returns the wait event name if this backend is currently waiting, - otherwise NULL. See through - . + Returns the wait event type name if this backend is currently waiting, + otherwise NULL. See for details. -- 1.8.3.1