<!-- doc/src/sgml/config.sgml -->

<sect1 id="runtime-config-connection-pooling">
<!--
  <title>Connection Pooling</title>
-->
  <title>コネクションプーリング</title>

  <para>
<!--
   <productname>Pgpool-II</productname> maintains established
    connections to the <productname>PostgreSQL</> servers, and reuses them whenever a
    new connection with the same properties (i.e. user name, database,
    protocol version) comes in. It reduces the connection overhead,
    and improves system's overall throughput.
-->
<productname>Pgpool-II</productname>は確立された<productname>PostgreSQL</>サーバへの接続を保存しておき、同じ属性(ユーザ名、データベース、プロトコルバージョン)を持つ新しい接続が来た時にこれらを再利用します。
これにより接続のオーバヘッドを低減し、システム全体のスループットを向上することができます。
  </para>

  <sect2 id="runtime-config-connection-pooling-settings">
<!--
    <title>Connection Pooling Settings</title>
-->
    <title>コネクションプールの設定</title>

    <variablelist>

      <varlistentry id="guc-connection-cache" xreflabel="connection_cache">
	<term><varname>connection_cache</varname> (<type>boolean</type>)
	  <indexterm>
<!--
	    <primary><varname>connection_cache</varname> configuration parameter</primary>
-->
	    <primary><varname>connection_cache</varname> 設定パラメータ</primary>
	  </indexterm>
	</term>
	<listitem>
	  <para>
<!--
	    Caches connections to backends when set to on. Default is on.
	    <emphasis>However, connections to <literal>template0</>, <literal>template1</>,
		<literal>postgres</> and <literal>regression</> databases are not cached even if
		<varname>connection_cache</> is on.</emphasis>
-->
onに設定されるとバックエンドへの接続をキャッシュします。
デフォルトはonです。
<emphasis>ただし、<varname>connection_cache</>がonでも、<literal>template0</>、<literal>template1</>、<literal>postgres</>、<literal>regression</>データベースへの接続はキャッシュされません。</emphasis>
	  </para>
	  <para>
<!--
	    You need to restart <productname>Pgpool-II</productname>
	    if you change this value.
-->
このパラメータを変更した時には<productname>Pgpool-II</productname>を再起動してください。
	  </para>
	</listitem>
      </varlistentry>

      <varlistentry id="guc-max-pool" xreflabel="max_pool">
	<term><varname>max_pool</varname> (<type>integer</type>)
	  <indexterm>
<!--
	    <primary><varname>max_pool</varname> configuration parameter</primary>
-->
	    <primary><varname>max_pool</varname> 設定パラメータ</primary>
	  </indexterm>
	</term>
	<listitem>
	  <para>
<!--
	    The maximum number of cached connections
	    in each <productname>Pgpool-II</productname> child
	    process.  <productname>Pgpool-II</productname> reuses the
	    cached connection if an incoming connection is connecting
	    to the same database with the same user name.  If not,
	    <productname>Pgpool-II</productname> creates a new
	    connection to the backend.  If the number of cached
	    connections exceeds max_pool, the oldest connection will
	    be discarded, and uses that slot for the new connection.
-->
<productname>Pgpool-II</productname>の各子プロセスがキャッシュするコネクションの最大数です。
<productname>Pgpool-II</productname>は、受け付けた接続が同じユーザ名で同じデータベースに接続しようとする場合に、キャッシュされたコネクションを再利用します。
そうでなければ<productname>Pgpool-II</productname>はバックエンドへの新しい接続を生成します。
もしキャッシュされている接続の数がmax_poolを超えた場合には、一番古いコネクションが廃棄され、そのスロットが新しい接続のために使用されます。
	  </para>
	  <para>
<!--
	    Default value is 4. Please be aware that the number of
	    connections from <productname>Pgpool-II</productname> processes to the backends may reach
	    <xref linkend="guc-num-init-children"> * <varname>max_pool</> in total.
-->
デフォルト値は4です。
<productname>Pgpool-II</productname>のプロセスからバックエンドへの接続の数は全部で<xref linkend="guc-num-init-children"> * <varname>max_pool</>に達する可能性があることに注意してください。
	  </para>
	  <para>
<!--
	    This parameter can only be set at server start.
-->
このパラメータはサーバ起動時にのみ設定可能です。
	  </para>
	</listitem>
    </varlistentry>

    <varlistentry id="guc-listen-backlog-multiplier" xreflabel="listen_backlog_multiplier">
      <term><varname>listen_backlog_multiplier</varname> (<type>integer</type>)
        <indexterm>
<!--
        <primary><varname>listen_backlog_multiplier</varname> configuration parameter</primary>
-->
        <primary><varname>listen_backlog_multiplier</varname> 設定パラメータ</primary>
        </indexterm>
      </term>
      <listitem>
        <para>
<!--
					Specifies the length of connection queue from frontend to
					<productname>Pgpool-II</productname>. The queue length (actually
					<literal>"backlog"</literal> parameter of <literal>listen()</literal>
					system call) is defined as
					<varname>listen_backlog_multiplier</varname> * <xref linkend="guc-num-init-children">.
-->
フロントエンドから<productname>Pgpool-II</productname>への接続待ち行列の長さを制御します。
接続待ち行列の長さ(具体的には<literal>listen()</literal>システムコールの<literal>backlog</literal>パラメータ)は、<varname>listen_backlog_multiplier</varname> * <xref linkend="guc-num-init-children">で決まります。
				</para>
				<note>
					<para>
<!--
						Some systems have the upper limit of the backlog parameter of
						<literal>listen()</literal> system call.
						See <xref linkend="guc-num-init-children"> for more details.
-->
システムのよっては<literal>listen()</literal>システムコールの<literal>backlog</literal>パラメータに上限が設定されています。
詳細は<xref linkend="guc-num-init-children">の項を参照してください。
					</para>
				</note>
        <para>
<!--
					Default is 2.
-->
デフォルト値は2です。
				</para>
        <para>
<!--
          This parameter can only be set at server start.
-->
このパラメータはサーバ起動時にのみ設定可能です。
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="guc-serialize-accept" xreflabel="serialize_accept">
      <term><varname>serialize_accept</varname> (<type>boolean</type>)
        <indexterm>
<!--
        <primary><varname>serialize_accept</varname> configuration parameter</primary>
-->
        <primary><varname>serialize_accept</varname> 設定パラメータ</primary>
        </indexterm>
      </term>
      <listitem>
        <para>
<!--
					When set to on, <productname>Pgpool-II</productname> enables the serialization
					on incoming client connections.
					Without serialization the OS kernel wakes up all of the <productname>
					Pgpool-II</productname> children processes to execute <literal>accept()</> and one of them
					actually gets the incoming connection. The problem here is, because so my child
					process wake up at a same time, heavy context switching occurs and the
					performance is affected.
-->
onに設定することで、<productname>Pgpool-II</productname>は受け付けるクライアント接続のシリアライズを有効にします。
シリアライズを行わない場合、OSカーネルは<literal>accept()</literal>を実行するために全ての<productname>Pgpool-II</productname>子プロセスを起こし、実際にはそのうちの１つのみが入ってきた接続を処理します。
ここでの問題は、子プロセスが一度に起こされるために重いコンテキストスイッチングが起こり、性能に影響がでることです。
				</para>
				<para>
<!--
					This phenomena is a well known classic problem called
					"the thundering herd problem". This can be solved by
					serialization of the <literal>accept()</> calls, so that only one
					<productname>Pgpool-II</productname> process gets woken up
					for incoming connection to execute the <literal>accept()
					</literal>.
-->
この現象は「thundering herd problem（猛獣の暴走）」と呼ばれる古典的な問題です。
これは<literal>accept()</literal>呼び出しのシリアライズを行うことで解決できます。
入ってきた接続に対して<productname>Pgpool-II</productname>プロセスのうちひとつだけが起こされて<literal>accept()</literal>を実行ようになるためです。
				</para>

				<para>
<!--
					But serialization has its own overheads, and it is recomended
					to be used only with the larger values of <xref linkend="guc-num-init-children">.
					For the small number of <xref linkend="guc-num-init-children">,
					the serialize accept can degrade the performance because of
					serializing overhead.
-->
しかしシリアライズにはオーバヘッドがあり、<xref linkend="guc-num-init-children">が大きい時のみ使用することを推奨します。
小さい<xref linkend="guc-num-init-children">に対しては、シリアライズのオーバヘッドのために性能が低下するかもしれません。
				</para>

				<note>
					<para>
<!--
						It is recomended to do a benchmark before deciding wether to use
						<varname>serialize_accept</varname> or not, because the corelation
						of <xref linkend="guc-num-init-children"> and <varname>serialize_accept</varname>
						can be different on different environments.
-->
<xref linkend="guc-num-init-children">と<varname>serialize_accept</varname>の相関は環境によって異なるので、<varname>serialize_accept</varname>を使うかどうか決める前にベンチマークテストを行ってみることをおすすめします。
					</para>
				</note>

				<example id="example-serialize-accept-pgbench">
<!--
          <title>Using pgbench to decide if serialize_accept should be used</title>
-->
          <title>serialize_acceptの使用判断のためにpgbenchを利用する</title>
          <para>
<!--
						To run the <command>pgbench</command> use the following
						command.
-->
以下のコマンドを使って<command>pgbench</command>を実行します。
          <programlisting>
pgbench -n -S -p 9999 -c 32 -C -S -T 300 test
          </programlisting>
<!--
						Here, <literal>-C</literal> tells <command>pgbench</command> to connect
						to database each time a transaction gets executed. <literal>-c 32</literal>
						specifies the number of the concurrent sessions to <productname>Pgpool-II</productname>.
						You should change this according to your system's requirement.
						After <command>pgbench</command> finishes, check the number from
						"including connections establishing".
-->
ここで、<literal>-C</literal>は<command>pgbench</command>にトランザクション実行の度に毎回データベースに接続することを指示します。
<literal>-c 32</literal>は、<productname>Pgpool-II</productname>への同時セッション数です。
これはシステム要件にあわせて変更するのがよいでしょう。
<command>pgbench</command>が終了後、"including connections establishing" の数値をチェックします。
          </para>
        </example>

				<note>
					<para>
<!--
						When <xref linkend="guc-child-life-time"> is enabled, <varname>serialize_accept</varname>
						has no effect. Make sure that you set <xref linkend="guc-child-life-time"> to 0 if you intend
						to turn on the <varname>serialize_accept</varname>.
						And if you are worried about <productname>Pgpool-II</productname> process memory leaks
						or whatever potential issue, you could use <xref linkend="guc-child-max-connections"> instead.
						This is purely an implementation limitation and may be removed in the future.
-->
なお、<xref linkend="guc-child-life-time"> が有効だと、<varname>serialize_accept</varname>は効果がありません。
<varname>serialize_accept</varname>をonにしたい場合は、<xref linkend="guc-child-life-time">が0であることを確認してください。
<productname>Pgpool-II</productname>プロセスのメモリーリークなどの潜在的な問題を気にする場合は、代わりに<xref linkend="guc-child-max-connections">を使ってください。
この制限は純粋に実装上の問題であり、将来はなくなるかもしれません。
          </para>
				</note>

        <para>
<!--
					Default is off.
-->
デフォルトはoffです。
				</para>
        <para>
<!--
          This parameter can only be set at server start.
-->
このパラメータはサーバ起動時にのみ設定可能です。
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="guc-child-life-time" xreflabel="child_life_time">
      <term><varname>child_life_time</varname> (<type>integer</type>)
        <indexterm>
<!--
        <primary><varname>child_life_time</varname> configuration parameter</primary>
-->
        <primary><varname>child_life_time</varname> 設定パラメータ</primary>
        </indexterm>
      </term>
      <listitem>
        <para>
<!--
          Specifies the time in seconds to terminate a <productname>Pgpool-II
					</productname> child process if it remains idle. The new child process
					is immediately spawned by <productname>Pgpool-II</productname> when it
					is terminated because of <varname>child_life_time</varname>.
					<varname>child_life_time</varname> is a measure to prevent the
					memory leaks and other unexpected errors in <productname>Pgpool-II
					</productname> children.
-->
<productname>Pgpool-II</productname>の子プロセスがアイドル状態のままでいるときに、それを強制終了するまでの時間を秒単位で指定します。
<varname>child_life_time</varname>により終了された時には、すぐに新しい子プロセスが<productname>Pgpool-II</productname>により起動されます。
<varname>child_life_time</varname>は<productname>Pgpool-II</productname>子プロセスのメモリリークやその他の不測のエラーに備えた予防措置です。
				</para>
				<note>
					<para>
<!--
						<varname>child_life_time</varname> does not apply to
						processes that have not accepted any connection yet.
-->
<varname>child_life_time</varname>はまだ一度もコネクションを受け付けていないプロセスには適用されません。
					</para>
				</note>
				<note>
					<para>
						<xref linkend="guc-serialize-accept"> becomes ineffective when
						<varname>child_life_time</varname> is enabled.
					</para>
				</note>
        <para>
<!--
					Default is 300 (5 minutes) and setting it to 0 disables the feature.
-->
デフォルト値は300秒（すなわち5分）です。
0を指定するとこの機能は無効になります。
				</para>
        <para>
<!--
          This parameter can only be set at server start.
-->
このパラメータはサーバ起動時にのみ設定可能です。
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="guc-client-idle-limit" xreflabel="client_idle_limit">
      <term><varname>client_idle_limit</varname> (<type>integer</type>)
        <indexterm>
<!--
        <primary><varname>client_idle_limit</varname> configuration parameter</primary>
-->
        <primary><varname>client_idle_limit</varname> 設定パラメータ</primary>
        </indexterm>
      </term>
      <listitem>
        <para>
<!--
          Specifies the time in seconds to disconnect a client if it remains idle
          since the last query.
          This is useful for preventing the <productname>Pgpool-II</productname>
          children from being occupied by a lazy clients or broken TCP/IP
					connection between client and <productname>Pgpool-II</productname>.
-->
クライアントが前回のクエリからアイドル状態のままでいるときに、それを切断するまでの時間を秒単位で指定します。
これは、だらしないクライアントや<productname>Pgpool-II</productname>の間のTCP/IPコネクションの不調によって、<productname>Pgpool-II</productname>の子プロセスが占有されてしまうのを回避するのに役立ちます。
				</para>
				<note>
					<para>
<!--
						<varname>client_idle_limit</varname> is ignored in
						the second stage of online recovery.
-->
<varname>client_idle_limit</varname>はオンラインリカバリのセカンドステージでは無視されます。
					</para>
				</note>
        <para>
<!--
          The default is 0, which turns off the feature.
-->
デフォルト値は0で、この機能はoffとなります。
				</para>
        <para>
<!--
          This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
					You can also use <xref linkend="SQL-PGPOOL-SET"> command to alter the value of
					this parameter for a current session.
-->
このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
現在のセッションでのパラメータ値は、<xref linkend="SQL-PGPOOL-SET">コマンドで変更することもできます。
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="guc-child-max-connections" xreflabel="child_max_connections">
      <term><varname>child_max_connections</varname> (<type>integer</type>)
        <indexterm>
<!--
        <primary><varname>child_max_connections</varname> configuration parameter</primary>
-->
        <primary><varname>child_max_connections</varname> 設定パラメータ</primary>
        </indexterm>
      </term>
      <listitem>
        <para>
<!--
          Specifies the lifetime of a <productname>Pgpool-II</productname>
					child process in terms of the number of client connections it can receive.
					<productname>Pgpool-II</productname> will terminate the child process
					after it has served <varname>child_max_connections</varname> client
					connections and will immediately spawn a new child process to take its place.
-->
各<productname>Pgpool-II</productname>子プロセスの寿命を、受付可能なクライアント接続の数で指定します。
<varname>child_max_connections</varname>個のクライアント接続を処理した後に<productname>Pgpool-II</productname>はその子プロセスを終了させ、すぐに代わりの新しい子プロセスを生成します。
				</para>
				<para>
<!--
					<varname>child_max_connections</varname> is useful on a very busy server,
					where <xref linkend="guc-child-life-time"> and <xref linkend="guc-connection-life-time">
					never gets triggered. It is also useful to prevent the <productname>PostgreSQL</> servers from getting
					too big.
-->
<varname>child_max_connections</varname>は<xref linkend="guc-child-life-time">や<xref linkend="guc-connection-life-time">が効かないくらい忙しいサーバで有用です。
また<productname>PostgreSQL</>バックエンドが肥大化するのを防ぐのにも有用です。
				</para>
        <para>
<!--
          The default is 0, which turns off the feature.
-->
デフォルト値は0で、この機能はoffとなります。
				</para>
        <para>
<!--
          This parameter can only be set at server start.
-->
このパラメータはサーバ起動時にのみ設定可能です。
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="guc-connection-life-time" xreflabel="connection_life_time">
      <term><varname>connection_life_time</varname> (<type>integer</type>)
        <indexterm>
<!--
        <primary><varname>connection_life_time</varname> configuration parameter</primary>
-->
        <primary><varname>connection_life_time</varname> 設定パラメータ</primary>
        </indexterm>
      </term>
      <listitem>
        <para>
<!--
          Specifies the time in seconds to terminate the cached connections
		to the <productname>PostgreSQL</> backend. This serves as the cached connection expiration time.
-->
キャッシュされた<productname>PostgreSQL</>への接続を切断するまでの時間を秒単位で指定します。
これはキャッシュされた接続の有効期間として働きます。
				</para>
        <para>
<!--
          The default is 0, which means the cached connections will not be disconnected.
-->
デフォルトは0です。
これはキャッシュされた接続が切断されないことを意味しています。
				</para>
        <para>
<!--
          This parameter can only be set at server start.
-->
このパラメータはサーバ起動時にのみ設定可能です。
        </para>
      </listitem>
    </varlistentry>

    <varlistentry id="guc-reset-query-list" xreflabel="reset_query_list">
      <term><varname>reset_query_list</varname> (<type>string</type>)
        <indexterm>
<!--
        <primary><varname>reset_query_list</varname> configuration parameter</primary>
-->
        <primary><varname>reset_query_list</varname> 設定パラメータ</primary>
        </indexterm>
      </term>
      <listitem>
        <para>
<!--
					Specifies the <acronym>SQL</acronym> commands to be sent to reset the backend connection
					when exiting the user session. Multiple commands can be specified by delimiting each
					by <literal>";"</literal>.
-->
ユーザセッションを終了するときにバックエンドコネクションを初期化するために送られる<acronym>SQL</acronym>コマンドを指定します。
複数のコマンドを<literal>";"</literal>で区切って指定することができます。
				</para>

				<para>
<!--
					The available commands differ among <productname>PostgreSQL</> versions.
					Below are some recommended settings for <varname>reset_query_list</varname>
					on different <productname>PostgreSQL</> versions.
					Note, however, that <literal>ABORT</literal> command should be always included.
-->
利用できるコマンドは<productname>PostgreSQL</>のバージョンによって異なります。
各<productname>PostgreSQL</>バージョンごとの設定は以下です。
ただし、"ABORT"は必ずコマンドに含めてください。
				</para>

				<table id="reset-query-list-suggestions-table">
<!--
					<title>Recommended setting for <varname>reset_query_list</varname>
					on different PostgreSQL versions</title>
-->
					<title>PostgreSQLバージョンごとの<varname>reset_query_list</varname>の推奨設定</title>
					<tgroup cols="2">
						<thead>
							<row>
<!--
								<entry>PostgreSQL version</entry>
-->
								<entry>PostgreSQLバージョン</entry>
								<entry>reset_query_list</entry>
							</row>
						</thead>

						<tbody>
							<row>
<!--
								<entry>7.1 or earlier</entry>
-->
								<entry>7.1以前</entry>
								<entry><literal>'ABORT'</literal></entry>
							</row>

							<row>
<!--
								<entry>7.2 to 8.2</entry>
-->
								<entry>7.2から8.2</entry>
								<entry><literal>'ABORT; RESET ALL; SET SESSION AUTHORIZATION DEFAULT'</literal></entry>
							</row>

							<row>
<!--
								<entry>8.3 or later</entry>
-->
								<entry>8.3以降</entry>
								<entry><literal>'ABORT; DISCARD ALL'</literal></entry>
							</row>

						</tbody>
					</tgroup>
				</table>

				<note>
					<para>
<!--
						<literal>"ABORT"</literal> is not issued when not in a transaction block for 7.4 or later
						<productname>PostgreSQL</> versions.
-->

<literal>ABORT</literal>は、<productname>PostgreSQL</> 7.4以降ではトランザクションブロックの中にいない場合には発行されません。

					</para>
				</note>
				<para>
<!--
					Default is <literal>'ABORT; DISCARD ALL'</literal>.
-->
デフォルト<literal>'ABORT; DISCARD SLL'</literal>です。
				</para>
        <para>
<!--
          This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
-->
このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
        </para>
      </listitem>
    </varlistentry>

    </variablelist>
  </sect2>
</sect1>

<sect1 id="runtime-config-logging">
<!--
  <title>Error Reporting and Logging</title>
-->
  <title>エラー報告とログ取得</title>

	<sect2 id="runtime-config-logging-where-to-log">
<!--
  	<title>Where To Log</title>
-->
  	<title>ログの出力先</title>

		<variablelist>

		<varlistentry id="guc-log-destination" xreflabel="log_destination">
      <term><varname>log_destination</varname> (<type>string</type>)
        <indexterm>
<!--
        <primary><varname>log_destination</varname> configuration parameter</primary>
-->
        <primary><varname>log_destination</varname> 設定パラメータ</primary>
        </indexterm>
      </term>
      <listitem>
				<para>
<!--
					<productname>Pgpool-II</productname> supports two destinations
					for logging the <productname>Pgpool-II</productname> messages.
					The supported log destinations are <literal>stderr</literal>
					and <literal>syslog</literal>. You can also set this parameter to a list
					of desired log destinations separated by commas if you want the log messages
					on the multiple destinations.
-->
<productname>Pgpool-II</productname>は、<productname>Pgpool-II</productname>のメッセージのログ出力先を2種類サポートします。
複数のログ出力先を使用したい場合は、希望するログ出力先をカンマで区切ったリストをパラメータに設定することができます。
						<programlisting>
#for example to log on both syslog and stderr
log_destination = 'syslog,stderr'
            </programlisting>
<!--
					The default is to log to <literal>stderr</literal> only.
-->
デフォルトでは<literal>stderr</literal>のみにログ出力します。
				</para>
				<note>
					<para>
<!--
						On some systems you will need to alter the configuration of your
						system's <application>syslog</application> daemon in order to make use of the
						<literal>syslog</literal> option
						for <varname>log_destination</varname>. <productname>Pgpool-II</productname>
						can log to <application>syslog</application> facilities LOCAL0 through LOCAL7
						(see <xref linkend="guc-syslog-facility">), but the default
						<application>syslog</application>
						configuration on most platforms will discard all such messages.
						You will need to add something like:
-->
<varname>log_destination</varname>でsyslogオプションを使用できるようにするために、いくつかのシステムではシステムの<application>syslog</application>デーモンの設定を変更しなければならないでしょう。
<productname>Pgpool-II</productname>ではログを<literal>LOCAL0</literal>から<literal>LOCAL7</literal>までの<application>syslog</application>ファシリティで記録することができます（<xref linkend="guc-syslog-facility">を参照してください）。
しかし、ほとんどのプラットフォームのデフォルトの<application>syslog</application>設定ではこれらのメッセージはすべて破棄されます。
うまく動作させるために<application>syslog</application>デーモンの設定に以下のようなものを追加しなければならないでしょう。
						<programlisting>
local0.*    /var/log/pgpool.log
						</programlisting>
<!--
						to the syslog daemon's configuration file to make it work.
-->
					</para>
				</note>
        <para>
<!--
          This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
-->
このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
        </para>
      </listitem>
    </varlistentry>

		<varlistentry id="guc-syslog-facility" xreflabel="syslog_facility">
      <term><varname>syslog_facility</varname> (<type>enum</type>)
        <indexterm>
<!--
        <primary><varname>syslog_facility</varname> configuration parameter</primary>
-->
        <primary><varname>syslog_facility</varname> 設定パラメータ</primary>
        </indexterm>
      </term>
      <listitem>
				<para>
<!--
					When logging to <application>syslog</application> is enabled,
					this parameter determines the <application>syslog</application>
					<literal>"facility"</literal> to be used.
					You can choose from <literal>LOCAL0</>, <literal>LOCAL1</>,
					<literal>LOCAL2</>, <literal>LOCAL3</>, <literal>LOCAL4</>,
					<literal>LOCAL5</>, <literal>LOCAL6</>, <literal>LOCAL7</>;
					the default is <literal>LOCAL0</>.
					See also the documentation of your system's <application>syslog</> daemon.
-->
<application>syslog</application>へのログ取得が有効な場合、このパラメータは<application>syslog</application>の「<literal>facility</literal>」が使われるように確定します。
<literal>LOCAL0</>、<literal>LOCAL1</>、<literal>LOCAL2</>、<literal>LOCAL3</>、<literal>LOCAL4</>、<literal>LOCAL5</>、<literal>LOCAL6</>、<literal>LOCAL7</>の中から選んでください。
デフォルトは<literal>LOCAL0</>です。
使用しているシステムの<application>syslog</application>デーモンの文書を同時に参照してください。
				</para>

        <para>
<!--
          This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
-->
このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
        </para>
      </listitem>
    </varlistentry>

		<varlistentry id="guc-syslog-ident" xreflabel="syslog_ident">
      <term><varname>syslog_ident</varname> (<type>string</type>)
        <indexterm>
<!--
        <primary><varname>syslog_ident</varname> configuration parameter</primary>
-->
        <primary><varname>syslog_ident</varname> 設定パラメータ</primary>
        </indexterm>
      </term>
      <listitem>
				<para>
<!--
					When logging to <application>syslog</> is enabled, this parameter determines
					the program name used to identify <productname>Pgpool-II</productname>
					messages in <application>syslog</> logs. The default is <literal>pgpool</literal>.
-->
<application>syslog</>にログ取得が有効な場合、このパラメータは<application>syslog</>ログ内の<productname>Pgpool-II</productname>メッセージを特定するのに使用するプログラム名を確定します。
デフォルトは<literal>pgpool</literal>です。
				</para>
        <para>
<!--
          This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
-->
このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
        </para>
      </listitem>
    </varlistentry>

		</variablelist>
  </sect2>

	<sect2 id="runtime-config-logging-when-to-log">
<!--
  	<title>When To Log</title>
-->
  	<title>いつログを取得するか</title>

		<variablelist>

		<varlistentry id="guc-client-min-messages" xreflabel="client_min_messages">
      <term><varname>client_min_messages</varname> (<type>enum</type>)
        <indexterm>
<!--
        <primary><varname>client_min_messages</varname> configuration parameter</primary>
-->
        <primary><varname>client_min_messages</varname> 設定パラメータ</primary>
        </indexterm>
      </term>
      <listitem>
				<para>
<!--
					Controls which minimum message levels are sent to the client.
					Valid values are <literal>DEBUG5</>, <literal>DEBUG4</>,
					<literal>DEBUG3</>, <literal>DEBUG2</>, <literal>DEBUG1</>,
					<literal>LOG</>, <literal>NOTICE</>, <literal>WARNING</> and
					<literal>ERROR</>. Each level includes
					all the levels that follow it. The default is <literal>NOTICE</>.
-->
どのメッセージ階層をクライアントに送るかを管理します。
有効な値は、<literal>DEBUG5</>、<literal>DEBUG4</>、<literal>DEBUG3</>、<literal>DEBUG2</>、<literal>DEBUG1</>、<literal>LOG</>、<literal>NOTICE</>、<literal>WARNING</>、および<literal>ERROR</>です。
それぞれの階層はそれに続く全ての階層を包含します。
デフォルトは<literal>NOTICE</>です。
				</para>

        <para>
<!--
          This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
					You can also use <xref linkend="SQL-PGPOOL-SET"> command to alter the value of
					this parameter for a current session.
-->
このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
現在のセッションでのパラメータ値は、<xref linkend="SQL-PGPOOL-SET">コマンドで変更することもできます。
        </para>
      </listitem>
    </varlistentry>

		<varlistentry id="guc-log-min-messages" xreflabel="log_min_messages">
      <term><varname>log_min_messages</varname> (<type>enum</type>)
        <indexterm>
<!--
        <primary><varname>log_min_messages</varname> configuration parameter</primary>
-->
        <primary><varname>log_min_messages</varname> 設定パラメータ</primary>
        </indexterm>
      </term>
      <listitem>
				<para>
<!--
					Controls which minimum message levels are emitted to log.
					Valid values are <literal>DEBUG5</>, <literal>DEBUG4</>,
					<literal>DEBUG3</>, <literal>DEBUG2</>, <literal>DEBUG1</>,
					<literal>INFO</>, <literal>NOTICE</>, <literal>WARNING</>,
					<literal>ERROR</>, <literal>LOG</>, <literal>FATAL</>,
					and <literal>PANIC</>.
					Each level includes all the levels that follow it.
					The default is <literal>WARNING</>.
-->
どのメッセージ階層をサーバログに書き込むかを管理します。有効な値は<literal>DEBUG5</>、<literal>DEBUG4</>、<literal>DEBUG3</>、<literal>DEBUG2</>、<literal>DEBUG1</>、<literal>INFO</>、<literal>NOTICE</>、<literal>WARNING</>、<literal>ERROR</>、<literal>LOG</>、<literal>FATAL</>、および<literal>PANIC</>です。
それぞれの階層はその下の全ての階層を含みます。
デフォルトは<literal>WARNING</>です。
				</para>
        <para>
<!--
          This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
					You can also use <xref linkend="SQL-PGPOOL-SET"> command to alter the value of
					this parameter for a current session.
-->
このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
現在のセッションでのパラメータ値は、<xref linkend="SQL-PGPOOL-SET">コマンドで変更することもできます。
        </para>
      </listitem>
    </varlistentry>

		</variablelist>
  </sect2>

	<sect2 id="runtime-config-logging-what-to-log">
<!--
  	<title>What To Log</title>
-->
  	<title>何をログに</title>

		<variablelist>

		<varlistentry id="guc-log-statement" xreflabel="log_statement">
      <term><varname>log_statement</varname> (<type>boolean</type>)
        <indexterm>
<!--
        <primary><varname>log_statement</varname> configuration parameter</primary>
-->
        <primary><varname>log_statement</varname> 設定パラメータ</primary>
        </indexterm>
      </term>
      <listitem>
				<para>
<!--
					Setting to on, prints all SQL statements to the log.
-->
onに設定されている場合、全てのSQL文をログ出力します。
				</para>

        <para>
<!--
          This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
					You can also use <xref linkend="SQL-PGPOOL-SET"> command to alter the value of
					this parameter for a current session.
-->
このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
現在のセッションでのパラメータ値は、<xref linkend="SQL-PGPOOL-SET">コマンドで変更することもできます。
        </para>
      </listitem>
    </varlistentry>

		<varlistentry id="guc-log-per-node-statement" xreflabel="log_per_node_statement">
      <term><varname>log_per_node_statement</varname> (<type>boolean</type>)
        <indexterm>
<!--
        <primary><varname>log_per_node_statement</varname> configuration parameter</primary>
-->
        <primary><varname>log_per_node_statement</varname> 設定パラメータ</primary>
        </indexterm>
      </term>
      <listitem>
				<para>
<!--
					Similar to <xref linkend="guc-log-statement">, except that it print the
					logs for each DB node separately. It can be useful to make sure that
					replication or load-balancing is working.
-->
<xref linkend="guc-log-statement">と似ていますが、DBノード単位でログが出力されます。
レプリケーションや負荷分散が動いていることを確認するのに便利です。
				</para>
        <para>
<!--
          This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
					You can also use <xref linkend="SQL-PGPOOL-SET"> command to alter the value of
					this parameter for a current session.
-->
このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
現在のセッションでのパラメータ値は、<xref linkend="SQL-PGPOOL-SET">コマンドで変更することもできます。
        </para>
      </listitem>
    </varlistentry>

		<varlistentry id="guc-log-hostname" xreflabel="log_hostname">
      <term><varname>log_hostname</varname> (<type>boolean</type>)
        <indexterm>
<!--
        <primary><varname>log_hostname</varname> configuration parameter</primary>
-->
        <primary><varname>log_hostname</varname> 設定パラメータ</primary>
        </indexterm>
      </term>
      <listitem>
				<para>
<!--
					Setting to on, prints the hostname instead of IP address
					in the <command>ps</> command result, and connection logs
					(when <xref linkend="guc-log-connections"> is on).
-->
onに設定されている場合、<command>ps</>コマンドの結果、および（<xref linkend="guc-log-connections">がonの場合には）接続時のログに、IPアドレスではなくホスト名を表示します。
				</para>
        <para>
<!--
          This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
-->
このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
        </para>
      </listitem>
    </varlistentry>

		<varlistentry id="guc-log-connections" xreflabel="log_connections">
      <term><varname>log_connections</varname> (<type>boolean</type>)
        <indexterm>
<!--
        <primary><varname>log_connections</varname> configuration parameter</primary>
-->
        <primary><varname>log_connections</varname> 設定パラメータ</primary>
        </indexterm>
      </term>
      <listitem>
				<para>
<!--
					Setting to on, prints all client connections from to the log.
-->
onに設定されている場合、全てのクライアント接続をログへ出力します。
				</para>
        <para>
<!--
          This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
-->
このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
        </para>
      </listitem>
    </varlistentry>

		<varlistentry id="guc-log-error-verbosity" xreflabel="log_error_verbosity">
      <term><varname>log_error_verbosity</varname> (<type>enum</type>)
        <indexterm>
<!--
        <primary><varname>log_error_verbosity</varname> configuration parameter</primary>
-->
        <primary><varname>log_error_verbosity</varname> 設定パラメータ</primary>
        </indexterm>
      </term>
      <listitem>
				<para>
<!--
					Controls the amount of detail emitted for each message that is logged.
					Valid values are <literal>TERSE</>, <literal>DEFAULT</>, and <literal>VERBOSE</>,
					each adding more fields
					to displayed messages. <literal>TERSE</> excludes the logging of <literal>DETAIL</>,
					<literal>HINT</>,
					and <literal>CONTEXT</> error information.
-->
ログ取得されるそれぞれのメッセージに対し、サーバログに書き込まれる詳細の量を制御します。
有効な値は、<literal>TERSE</>、<literal>DEFAULT</>、および<literal>VERBOSE</>で、それぞれは表示されるメッセージにより多くのフィールドを追加します。
<literal>TERSE</>は<literal>DETAIL</>、<literal>HINT</>、<literal>QUERY</>、および<literal>CONTEXT</>エラー情報を除外します。
				</para>
        <para>
<!--
          This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
					You can also use <xref linkend="SQL-PGPOOL-SET"> command to alter the value of
					this parameter for a current session.
-->
このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
現在のセッションでのパラメータ値は、<xref linkend="SQL-PGPOOL-SET">コマンドで変更することもできます。
        </para>
      </listitem>
    </varlistentry>

		<varlistentry id="guc-log-line-prefix" xreflabel="log_line_prefix">
      <term><varname>log_line_prefix</varname> (<type>string</type>)
        <indexterm>
<!--
        <primary><varname>log_line_prefix</varname> configuration parameter</primary>
-->
        <primary><varname>log_line_prefix</varname> 設定パラメータ</primary>
        </indexterm>
      </term>
      <listitem>
				<para>
<!--
					This is a <function>printf</>-style string that is output at the beginning of
					each log line.
					<literal>%</literal> characters begin <quote>escape sequences</> that are replaced
					with information outlined below.
					All unrecognized escapes are ignored. Other characters are copied straight to
					the log line. Default is '%t: pid %p: ', which prints timestamp and process id,
					which keeps backward compatibily with pre<productname>Pgpool-II</productname>
					<emphasis>V3.4</emphasis>.
-->
これは、各ログ行の先頭に出力する<function>printf</>の書式文字列です。
<literal>%</>から始まる<quote>エスケープシーケンス</>は、後述の通りのステータス情報で置き換えられます。
認識できないエスケープは無視されます。
他の文字はそのままログ行に出力されます。
デフォルトは '%t: pid %p: 'で、タイムスタンプとプロセスIDを印字します。
これは、<productname>Pgpool-II</productname> <emphasis>V3.4</emphasis>より前のバージョンとの互換性を保つためです。
				</para>

				<table id="log-line-prefix-table">
					<title>log_line_prefix escape options</title>

					<tgroup cols="2">
						<thead>
							<row>
<!--
								<entry>Escape</entry>
								<entry>Effect</entry>
-->
								<entry>エスケープ</entry>
								<entry>効果</entry>
							</row>
						</thead>

						<tbody>
							<row>
								<entry>%a</entry>
<!--
								<entry>Client application name</entry>
-->
								<entry>クライアントのアプリケーション名</entry>
							</row>

							<row>
								<entry>%p</entry>
<!--
								<entry>Process ID (PID)</entry>
-->
								<entry>プロセスID (PID)</entry>
							</row>

							<row>
								<entry>%P</entry>
<!--
								<entry>Process name</entry>
-->
								<entry>プロセス名</entry>
							</row>

							<row>
								<entry>%t</entry>
<!--
								<entry>Time stamp</entry>
-->
								<entry>タイムスタンプ</entry>
							</row>

							<row>
								<entry>%d</entry>
<!--
								<entry>Database name</entry>
-->
								<entry>データベース名</entry>
							</row>

							<row>
								<entry>%u</entry>
<!--
								<entry>User name</entry>
-->
								<entry>ユーザ名</entry>
							</row>

							<row>
								<entry>%l</entry>
<!--
								<entry>Log line number for each process</entry>
-->
								<entry>プロセスごとのログ行番号</entry>
							</row>

							<row>
								<entry>%%</entry>
<!--
								<entry>'%' character</entry>
-->
								<entry>'%' 文字自身</entry>
							</row>

						</tbody>
					</tgroup>
				</table>
        <para>
<!--
          This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
-->
このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
        </para>
      </listitem>
    </varlistentry>

		</variablelist>
  </sect2>
</sect1>
