Confluence のログ作成を自分自身の要件に設定することをお勧めします。以下の 2 通りの方法で、ログ設定を変更できます。

  • Confluence 管理でログ作成を設定する – 変更は、次回 Confluence を再起動するまで有効になるだけです。
  • プロパティファイルを編集する – 変更は、次回 Confluence を開始したとき有効になり、それ以後のすべてのセッションに適用されます。

両方の方法について以下で説明します。稀な状況で、logging.properties ファイルを設定する必要がある場合もあります。

用語: log4j で、"logger" は、名前を持つエンティティです。logger 名では大文字と小文字が区別され、階層的な命名基準に従います。たとえば、com.foo という名前の logger は、com.foo.Bar という名前の logger の親です。

 

(warning) The information on this page does not apply to Confluence Cloud.

Confluence 管理でログ作成を設定する

You can change some of Confluence's logging behaviour via the Administration Console while Confluence is running. Any changes made in this way will apply only to the currently-running Confluence lifetime. The changes are not written to the log4j.properties file and are therefore discarded when you next stop Confluence.

すべてのログ作成動作が管理コンソールから変更できるわけではありません。以下に説明されていなログ作成設定の場合、Confluence を停止してから、ログ作成プロパティファイルを編集する必要があります。

「ログとプロファイルの作成」画面には、現在のすべての定義済みロガーの一覧が表示されます。この画面では、以下の操作が可能です。

  • ページ プロファイルの作成のオンまたはオフ。
  • 詳細な SQL ログ作成のオンまたはオフ。
  • クラス/パッケージ名の新しいロガーの追加。
  • クラス/パッケージ名のロガーの削除。
  • 各クラスまたはパッケージ名のログ作成レベル (INFO、WARN、FATAL、ERROR またはDEBUG) の設定。
  • すべてのログ作成レベルを事前定義済みプロファイルにリセット。
ログ作成の設定を変更する
  1. Choose the cog icon , then choose General Configuration under Confluence Administration.
  2. Select 'Logging and Profiling' in the 'Administration' section of the left-hand panel.
    (info) You need to have System Administrator permissions in order to perform this function.
  3. 以下に示すように、「ログとプロファイル作成の構成」画面が表示されます。Confluence の稼働中に次のガイドラインを使用してログ作成動作を変更します。
    • 「ログとプロファイル作成の構成」 — 「 ページリクエスト プロファイル作成」を参照してください。
    • 'SQL Logging' — Click the 'Enable SQL Logging' button to log the details of SQL requests made to the database.
      (info) If you need to enable logging of SQL parameter values, you will need to change the setting in the properties file. This option is not available via the Administration Console.
    • 「Log4j ログ作成」' — 次のプロファイル ボタンのいずれかをクリックして、すべてのロガーを事前定義済みのプロファイルにリセットします。
      • 「実稼働用」プロファイルは非常に標準的なプロファイルであり、通常の本番環境条件に推奨されます。
      • 「診断用」プロファイルはより多くの情報を提供し、トラブルシューティングやデバッグに役立ちます。このため、パフォーマンスは落ちますが、ログファイルへの記録は速くなります。
    • 「新規エントリの追加」 — クラスまたはパッケージ名をテキストボックスに入力して「エントリの追加」ボタンをクリックします。新しいロガーは、画面下部の「既存のレベル」の一覧に表示されます。
    • 「既存のレベル」 - これらは、ご使用の Confluence インスタンスに関して現在実行中のロガーです。
      • ログ作成レベルは、「新しいレベル」ドロップダウンリストから値を選択することによって変更できます。各レベルの定義については、Apache ドキュメントをお読みください。
      • 「削除」リンクをクリックして、選択したクラス/パッケージ名のログ作成を停止します。
  4. 「保存」ボタンをクリックして、「既存のレベル」セクションで行った変更を保存します。

スクリーンショット: ログレベルの変更とプロファイル作成
 

プロパティファイルを編集する

To configure the logging levels and other settings on a permanent basis, you need to stop Confluence and then change the settings in the log4j.properties file, described above.

プロパティファイルには、様々なロガーの多くのエントリが含まれています。これらは、特定のコンポーネントからログ作成したい場合、コメントを外すことができます。詳細は、Apache log4j ドキュメントをお読みください。

役立つと思われる特定の設定オプションに関するガイドラインについては、「Confluence ログの使用」を参照してください。

logging.properties 内の java.util.logging のレベルを設定する

Confluence によって使用される少数のライブラリは、log4j または slf4j ではなく、java.util.logging を使用します。該当するライブラリは以下のとおりです。

  • com.sun.jersey
  • org.apache.shindig
  • net.sf.ehcache

Confluence の logging.properties ファイルは、特定のレベルの java.util.logging を slf4j 経由で log4j にリダイレクトするように設定されています。

To increase logging levels for these libraries you must first configure the logging.properties file in <CONFLUENCE-INSTALL>/confluence/WEB-INF/classes/. The logging levels are different from log4j and are listed here.
For example, to increase logging for shindig change the following line in the logging.properties file:

org.apache.shindig.level = INFO

to

org.apache.shindig.level = FINE

その後、同様に上述のいずれかの方法を使用して log4j レベルを設定します。

  • ラベルなし

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.