Configuring Postgres Workload Report
====================================

``pwr`` 構成ファイル
--------------------

``pwr``
の実行時に必要なコマンドライン引数の数を減らすには、構成ファイルを使用して、常に同じ値を持つオプションを指定できますが、その値はデフォルトとは異なります。

実行中に、\ ``pwr``
は、最初に見つかったものを使用して、\ ``~/.pwr.conf``
および\ ``/etc/pwr.conf``
の順序で既存の構成ファイルを検索します。ただし、 ``--config``
オプションで構成ファイルを指定している場合、それはデフォルトの場所をオーバーライドします。

インストールパッケージは、\ ``/etc/pwr.conf.templ``
に構成ファイルのテンプレートを作成します。このファイルを\ ``pwr``
が構成ファイルを検索する2つの場所のいずれかにコピーし、必要に応じてテンプレートのオプションを編集することをお勧めします。

以下のセクションでは、構成可能なオプションについて説明します。

input_dir
^^^^^^^^^

Lassoレポートの\ ``edb_wait_states``
コンテンツが存在する既存のディレクトリを識別します。このオプションは、主に\ ``pwr report``
実行に使用されます :ref:`Using Postgres Workload Report <Using Postgres Workload Report>` を参照してください。

Output_dir
^^^^^^^^^^

レポートを出力する場所を指定します。実行中に、Postgres Workload
Reportは、ディレクトリが存在しない場合は作成しようとします。

Report_name
^^^^^^^^^^^

生成されたレポートファイルの名前を提供します。通常、レポートごとに名前が異なるため、このオプションはコマンドラインから指定します。

log_file
^^^^^^^^

``pwr`` が\ ``stdout`` および\ ``stderr``
ログを書き込むファイルへのフルパスを提供します。

log_level
^^^^^^^^^

Postgresワークロードレポートを実行するときに使用するログレベルを指定します。有効な値は、より冗長なものからより低いものです。

``DEBUG`` ``INFO`` 指定しない場合のデフォルト ``WARNING`` ``ERROR``
``CRITICAL``

ログレベルの詳細については、
 `the Python logging <https://docs.python.org/3/library/logging.html#logging-levels>`_ ドキュメントを参照してください。

log_format
^^^^^^^^^^

ログファイルに書き込まれるログメッセージの形式を提供します。ログのフォーマットの詳細については、
 `the Python logging <https://docs.python.org/3/library/logging.html#logrecord-attributes>`_ ドキュメントを参照してください。

attempts_dir
^^^^^^^^^^^^

HTML出力のフォーマットに使用されるjinjaテンプレートとPDF出力に使用されるCSSを見つけられるディレクトリを示します。通常、デフォルトで使用するディレクトリは\ ``/usr/share/pwr/assets``
で、これには、 ``edb-pwr``
パッケージで提供されるアセットが含まれています。
