Query and Index Statistics Collector

? runtime-sgml.patch Index: runtime.sgml =================================================================== RCS file: /projects/cvsroot/pgsql-server/doc/src/sgml/runtime.sgml,v retrieving revision 1.187 diff -c -r1.187 runtime.sgml *** runtime.sgml 25 Jun 2003 01:13:24 -0000 1.187 --- runtime.sgml 25 Jun 2003 23:00:21 -0000 *************** *** 1394,1399 **** --- 1394,1475 ---- + + Query and Index Statistics Collector + + + + STATS_START_COLLECTOR (boolean) + + + Controls whether the server should start the + statistics-collection subprocess. This is on by default, but + may be turned off if you know you have no interest in + collecting statistics. This option can only be set at server + start. + + + + + + STATS_COMMAND_STRING (boolean) + + + Enables the collection of statistics on the currently + executing command of each session, along with the time at + which that command began execution. This option is off by + default. Note that even when enabled, this information is not + visible to all users, only to superusers and the user owning + the session being reported on; so it should not represent a + security risk. This data can be accessed via the + pg_stat_activity system view; refer + to for more information. + + + + + + STATS_BLOCK_LEVEL (boolean) + STATS_ROW_LEVEL (boolean) + + + These enable the collection of block-level and row-level statistics + on database activity, respectively. These options are off by + default. This data can be accessed via the + pg_stat and + pg_statio family of system views; + refer to for more information. + + + + + + STATS_RESET_ON_SERVER_START (boolean) + + + If on, collected statistics are zeroed out whenever the server + is restarted. If off, statistics are accumulated across server + restarts. The default is on. This option can only be set at + server start. + + + + + + DEFAULT_STATISTICS_TARGET (integer) + + + Sets the default statistics target for table columns that have not + had a column-specific target set via ALTER TABLE SET + STATISTICS. Larger values increase the time needed to do + ANALYZE, but may improve the quality of the planner's + estimates. The default value is 10. + + + + + + Other Query Modifiers *************** *** 1806,1811 **** --- 1882,1908 ---- + + + Statistics Logging + + + + LOG_STATEMENT_STATS (boolean) + LOG_PARSER_STATS (boolean) + LOG_PLANNER_STATS (boolean) + LOG_EXECUTOR_STATS (boolean) + + + For each query, write performance statistics of the respective + module to the server log. This is a crude profiling + instrument. + + + + + + *************** *** 2153,2259 **** - - Statistics - - - Statistics Monitoring - - - - LOG_STATEMENT_STATS (boolean) - LOG_PARSER_STATS (boolean) - LOG_PLANNER_STATS (boolean) - LOG_EXECUTOR_STATS (boolean) - - - For each query, write performance statistics of the respective - module to the server log. This is a crude profiling - instrument. - - - - - - DEFAULT_STATISTICS_TARGET (integer) - - - Sets the default statistics target for table columns that have not - had a column-specific target set via ALTER TABLE SET - STATISTICS. Larger values increase the time needed to do - ANALYZE, but may improve the quality of the planner's - estimates. The default value is 10. - - - - - - - - Query and Index Statistics Collector - - - - STATS_START_COLLECTOR (boolean) - - - Controls whether the server should start the - statistics-collection subprocess. This is on by default, but - may be turned off if you know you have no interest in - collecting statistics. This option can only be set at server - start. - - - - - - STATS_COMMAND_STRING (boolean) - - - Enables the collection of statistics on the currently - executing command of each session, along with the time at - which that command began execution. This option is off by - default. Note that even when enabled, this information is not - visible to all users, only to superusers and the user owning - the session being reported on; so it should not represent a - security risk. This data can be accessed via the - pg_stat_activity system view; refer - to for more information. - - - - - - STATS_BLOCK_LEVEL (boolean) - STATS_ROW_LEVEL (boolean) - - - These enable the collection of block-level and row-level statistics - on database activity, respectively. These options are off by - default. This data can be accessed via the - pg_stat and - pg_statio family of system views; - refer to for more information. - - - - - - STATS_RESET_ON_SERVER_START (boolean) - - - If on, collected statistics are zeroed out whenever the server - is restarted. If off, statistics are accumulated across server - restarts. The default is on. This option can only be set at - server start. - - - - - - - Lock Management --- 2250,2256 ---- *************** *** 2362,2376 **** - HAS_RENDEZVOUS (boolean) - rendezvous - - - - - - - TRANSFORM_NULL_EQUALS (boolean) IS NULL --- 2359,2364 ---- *************** *** 2467,2473 **** TRACE_LOCK_OIDMIN (boolean) TRACE_LOCK_TABLE (boolean) DEBUG_DEADLOCKS (boolean) ! SHOW_BTREE_BUILD_STATS (boolean) Various other code tracing and debugging options. --- 2455,2461 ---- TRACE_LOCK_OIDMIN (boolean) TRACE_LOCK_TABLE (boolean) DEBUG_DEADLOCKS (boolean) ! LOG_BTREE_BUILD_STATS (boolean) Various other code tracing and debugging options.