Confluence ログを使用する
Confluence では、Apache の log4j ログ記録サービスを使用しています。これによって、開発者または管理者は、アプリケーション バイナリに触ることなく、設定ファイルを編集することで、ログ記録の動作やログ出力ファイルを制御することができます。log4j のログレベルは 6 つあります。
If you request help from Atlassian Support, we will almost always ask for the atlassian-confluence.log
from the confluence-home/logs
directory. To access the logs, go to go to > General Configuration > Atlassian Support Tools.
If you cannot access logs via Support Tools, check the properties file at <confluence-installation>/confluence/WEB-INF/classes/confluence-init.properties
, look for the confluence.home
setting in that file, then find the logs in the Confluence home directory.
Confluence ログ ファイルの検索
This section describes Confluence's default logging behavior, assuming that you have not changed the destination of the logs. In order to unify logging across different application servers, Confluence uses the atlassian-confluence.log
as its primary log, not the application server log.
Confluence および Confluence EAR/WAR ディストリビューションは同じデフォルトの動作に従います。
- Confluence を起動すると、Confluence の初期 bootstrap が完了するまで、ログ エントリがアプリケーション サーバーに送られます。以下で説明するように、コンソールに書き込まれたログ エントリは、Confluence のログに繰り返されます。
- 初期スタートアップ シーケンスが完了すると、すべてのログは
<confluence-home>/logs/atlassian-confluence.log
に記録されます。例:c:/confluence/data/logs/atlassian-confluence.log
デフォルトの場所はアプリケーション サーバーのログ ファイルではなく、Confluence のホーム ディレクトリであることに注意してください。ホーム ディレクトリは <confluence-installation>/confluence/WEB-INF/classes/confluence-init.properties
で指定されています。
ログ設定ファイルの場所
Confluence's logging behavior is defined in the following properties file:
<CONFLUENCE-INSTALL>/confluence/WEB-INF/classes/log4j.properties
このファイルは、Apache の log4j ドキュメントに記載されているような、標準的な log4j 設定ファイルです。
ログ ファイルの出力先の変更
用語: log4j では、出力先を「アペンダ」と呼びます。
To change the destination of the log files, you need to stop Confluence and then change the settings in the 'Logging Location and Appender' section of the log4j.properties
file. The location of this file is described above.
標準的なプロパティ ファイルには、2つのアペンダ エントリがあります。
com.atlassian.confluence.logging.ConfluenceHomeLogAppender
– これは、上記の既定のログの出力先を制御するカスタム appender です。この appender では以下の設定が可能です。- MaxFileSize
- MaxBackupIndex
org.apache.log4j.RollingFileAppender
- 異なる場所にログを出力する場合、RollingFileAppender
行のコメント化を解除し、その下の行で出力ファイルを変更します。ConfluenceHomeLogAppender
を参照する、手前の行をコメントアウトします。
Confluence には log4j の提供するアペンダの完全なスイートが同梱されています。アペンダの詳細については、log4j のドキュメントを参照してください。
ログ レベルの変更
Confluence のログ設定を変更する方法の説明については、「ログ作成の設定」を参照してください。
一部の特定の Confluence ログ オプションの使用
このセクションには、必要になるかもしれない特定のログ設定に関するアドバイスがいくつか含まれています。
データベースに対する SQL リクエストの詳細のログ記録
データベースに送信される個々の SQL リクエストを記録できるように、Confluence のログを増やすことができます。これは特定の問題のトラブルシューティングに役立ちます。
2つの方法で、詳細な SQL のログ記録を有効化できます。
各 Confluence ページへのユーザーの参照/アクセスの詳細のログ記録
ユーザーが Confluence 内のどのページにアクセスしているかを示すようにログを設定することができます。これは、ログ記録のプロパティ ファイルの介してのみ利用可能です。詳細な手順を参照してください。
既知の問題についてのログ ファイルのスキャン
Confluence では、Confluence ログのエラーを確認したり、それがナレッジ ベースやバグ トラッカーの既知の問題に一致するかどうかを確認する組み込みのログ スキャナーを提供しています。「問題のトラブルシューティングおよび技術サポートの依頼」を参照してください。
注意
- スレッド ダンプの検索: スレッドダンプは、アプリケーション サーバのログ ファイルに記録されます。