rdelaage
/
postgresql
mirror of https://git.postgresql.org/git/postgresql.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Group cluster_name and update_process_title settings together

This commit is contained in:
Peter Eisentraut 2015-10-04 11:14:28 -04:00
parent cf007a4bca
commit 6390c8c654
4 changed files with 64 additions and 46 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

97
doc/src/sgml/config.sgml
View File

@ -4394,30 +4394,6 @@ local0.* /var/log/postgresql
</listitem>
</varlistentry>
<varlistentry id="guc-cluster-name" xreflabel="cluster_name">
<term><varname>cluster_name</varname> (<type>string</type>)
<indexterm>
<primary><varname>cluster_name</> configuration parameter</primary>
</indexterm>
</term>
<listitem>
<para>
Sets the cluster name that appears in the process title for all
processes in this cluster. The name can be any string of less than
<symbol>NAMEDATALEN</> characters (64 characters in a standard
build). Only printable ASCII characters may be used in the
<varname>cluster_name</varname> value. Other characters will be
replaced with question marks (<literal>?</literal>). No name is shown
if this parameter is set to the empty string <literal>''</> (which is
the default). This parameter can only be set at server start.
</para>
<para>
The process title is typically viewed using programs like
<application>ps</> or, on Windows, <application>Process Explorer</>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname>debug_print_parse</varname> (<type>boolean</type>)
<indexterm>
@ -5010,9 +4986,61 @@ COPY postgres_log FROM '/full/path/to/logfile.csv' WITH csv;
</listitem>
</orderedlist>
</para>
</sect2>
</sect1>
<sect2>
<title>Process Title</title>
<para>
These settings control how the process title as seen
by <command>ps</command> is modified. See <xref linkend="monitoring-ps">
for details.
</para>
<variablelist>
<varlistentry id="guc-cluster-name" xreflabel="cluster_name">
<term><varname>cluster_name</varname> (<type>string</type>)
<indexterm>
<primary><varname>cluster_name</> configuration parameter</primary>
</indexterm>
</term>
<listitem>
<para>
Sets the cluster name that appears in the process title for all
processes in this cluster. The name can be any string of less than
<symbol>NAMEDATALEN</> characters (64 characters in a standard
build). Only printable ASCII characters may be used in the
<varname>cluster_name</varname> value. Other characters will be
replaced with question marks (<literal>?</literal>). No name is shown
if this parameter is set to the empty string <literal>''</> (which is
the default). This parameter can only be set at server start.
</para>
<para>
The process title is typically viewed using programs like
<application>ps</> or, on Windows, <application>Process Explorer</>.
</para>
</listitem>
</varlistentry>
<varlistentry id="guc-update-process-title" xreflabel="update_process_title">
<term><varname>update_process_title</varname> (<type>boolean</type>)
<indexterm>
<primary><varname>update_process_title</> configuration parameter</primary>
</indexterm>
</term>
<listitem>
<para>
Enables updating of the process title every time a new SQL command
is received by the server. The process title is typically viewed
by the <command>ps</> command,
or in Windows by using the <application>Process Explorer</>.
Only superusers can change this setting.
</para>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>
<sect1 id="runtime-config-statistics">
<title>Run-time Statistics</title>
@ -5130,23 +5158,6 @@ COPY postgres_log FROM '/full/path/to/logfile.csv' WITH csv;
</listitem>
</varlistentry>
<varlistentry id="guc-update-process-title" xreflabel="update_process_title">
<term><varname>update_process_title</varname> (<type>boolean</type>)
<indexterm>
<primary><varname>update_process_title</> configuration parameter</primary>
</indexterm>
</term>
<listitem>
<para>
Enables updating of the process title every time a new SQL command
is received by the server. The process title is typically viewed
by the <command>ps</> command,
or in Windows by using the <application>Process Explorer</>.
Only superusers can change this setting.
</para>
</listitem>
</varlistentry>
<varlistentry id="guc-stats-temp-directory" xreflabel="stats_temp_directory">
<term><varname>stats_temp_directory</varname> (<type>string</type>)
<indexterm>

6
src/backend/utils/misc/guc.c
View File

@ -580,6 +580,8 @@ const char *const config_group_names[] =
gettext_noop("Reporting and Logging / When to Log"),
/* LOGGING_WHAT */
gettext_noop("Reporting and Logging / What to Log"),
/* PROCESS_TITLE */
gettext_noop("Process Title"),
/* STATS */
gettext_noop("Statistics"),
/* STATS_MONITORING */
@ -1180,7 +1182,7 @@ static struct config_bool ConfigureNamesBool[] =
},
{
{"update_process_title", PGC_SUSET, STATS_COLLECTOR,
{"update_process_title", PGC_SUSET, PROCESS_TITLE,
gettext_noop("Updates the process title to show the active SQL command."),
gettext_noop("Enables updating of the process title every time a new SQL command is received by the server.")
},
@ -3395,7 +3397,7 @@ static struct config_string ConfigureNamesString[] =
},
{
{"cluster_name", PGC_POSTMASTER, LOGGING_WHAT,
{"cluster_name", PGC_POSTMASTER, PROCESS_TITLE,
gettext_noop("Sets the name of the cluster which is included in the process title."),
NULL,
GUC_IS_NAME

6
src/backend/utils/misc/postgresql.conf.sample
View File

@ -447,8 +447,13 @@
# than the specified size in kilobytes;
# -1 disables, 0 logs all temp files
#log_timezone = 'GMT'
# - Process Title -
#cluster_name = '' # added to process titles if nonempty
# (change requires restart)
#update_process_title = on
#------------------------------------------------------------------------------
@ -462,7 +467,6 @@
#track_io_timing = off
#track_functions = none # none, pl, all
#track_activity_query_size = 1024 # (change requires restart)
#update_process_title = on
#stats_temp_directory = 'pg_stat_tmp'

1
src/include/utils/guc_tables.h
View File

@ -81,6 +81,7 @@ enum config_group
LOGGING_WHERE,
LOGGING_WHEN,
LOGGING_WHAT,
PROCESS_TITLE,
STATS,
STATS_MONITORING,
STATS_COLLECTOR,