Confluence ログを使用する
Confluence では、Apache の log4j ログ記録サービスを使用しています。このサービスによって、管理者は、構成ファイルを編集して、ログ記録の動作やログ出力ファイルを制御できます。log4j のログ記録サービスは 6 つあります。
アトラシアン サポートにサポートをリクエストする場合、Confluence のアプリケーション ログが必要な場合が多くあります。これらのログを取得する最も簡単な方法として、
> [一般設定] > [トラブルシューティングとサポート ツール] へ移動し、プロンプトに従ってサポート zip を作成します。
Confluence ログ ファイルの検索
このセクションでは、ログの出力先を変更していない前提で、Confluence の既定のログ記録の動作について説明します。さまざまなアプリケーション サーバー全体でログ記録を統一するため、Confluence はアプリケーション サーバーのログではなく atlassian-confluence.log をプライマリとして使用します。
- 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 および Synchrony でのログ記録の挙動は、以下のプロパティ ファイルで定義されています。
<CONFLUENCE-INSTALL>/confluence/WEB-INF/classes/log4j.properties
このファイルは、Apache の log4j ドキュメントに記載されているような、標準的な log4j 設定ファイルです。
ログ ファイルの出力先の変更
logtruej では出力先を "appender" と呼びます。ログ ファイルの出力先を変更するには、Confluence を停止し、log4j.properties ファイルの "Logging Location and Appender" セクションの設定を変更する必要があります。このファイルの場所は、上記のとおりです。
標準的なプロパティ ファイルには、2つのアペンダ エントリがあります。
com.atlassian.confluence.logging.ConfluenceHomeLogAppender– これは、上記の既定のログの出力先を制御するカスタム appender です。この appender では以下の設定が可能です。- MaxFileSize
- MaxBackupIndex
org.apache.log4j.RollingFileAppender- 異なる場所にログを出力する場合、RollingFileAppender行のコメント化を解除し、その下の行で出力ファイルを変更します。ConfluenceHomeLogAppenderを参照する、手前の行をコメントアウトします。
Synchrony ログファイルの出力先は、ファイルと同じ方法で変更できます。
Confluence には log4j の提供するアペンダの完全なスイートが同梱されています。アペンダの詳細については、log4j のドキュメントを参照してください。
詳細は、ナレッジ ベースの「別のログ ファイルに特定のエントリを送信するための、Confluence での log4j の設定」を参照してください。
ログ ファイルのサイズと数を変更する
既定では、Confluence は 5 のログ ファイルを保持します。これらのファイルは 20 MB に到達すると上書きされます。
<CONFLUENCE-INSTALL>/confluence/WEB-INF/classes/log4j.properties ファイルで次の値を編集し、既定のログ サイズと保持するログ ファイルの数を変更できます。
log4j.appender.confluencelog.MaxFileSize=20480KB
log4j.appender.confluencelog.MaxBackupIndex=5ログ レベルの変更
Confluence のログ設定を変更する方法の説明については、「ログ作成の設定」を参照してください。
特定の Confluence ロギング オプション
トラブルシューティングの際に必要となる可能性がある具体的なログ設定をいくつか紹介します。
データベースに対する SQL リクエストの詳細のログ記録
データベースに送信される個々の SQL リクエストを記録できるように、Confluence のログを増やすことができます。これは特定の問題のトラブルシューティングに役立ちます。
2つの方法で、詳細な SQL のログ記録を有効化できます。
各 Confluence ページへのユーザーの参照/アクセスの詳細のログ記録
ユーザーが Confluence 内のどのページにアクセスしているかを示すようにログを設定することができます。これは、ログ記録のプロパティ ファイルの介してのみ利用可能です。詳細な手順を参照してください。
既知の問題についてのログ ファイルのスキャン
アトラシアンのトラブルシューティングおよびサポート ツールには、Confluence ログのエラーを確認し、それがナレッジ ベースや課題トラッカーの既知の問題と一致するかどうかを照合するログ アナライザーが含まれます。
ログ ファイルの定期スキャンの設定方法については、「問題のトラブルシューティングおよび技術サポートの依頼」を参照してください。