Confluence ログを使用する

アプリケーション ログ ファイル

既定では、アプリケーション ログ ファイルは <local-home>/logs ディレクトリにあります。この場所は設定可能であるため、場所のログ設定を確認しなければならない場合があります。

問題のトラブルシューティングを容易にするために、アプリケーション ログはいくつかの異なるログ ファイルに分割されます。

• atlassian-confluence.log
  This is the main application log file, most entries will be written here. When you start Confluence Any log entries written to the console will also be repeated in this log.
• atlassian-confluence-index.log
  このファイルには、検索インデックスに関連するエントリが含まれます。 
• atlassian-confluence-outgoing-mail.log
  このファイルには、通知など、送信メールに関連するエントリが含まれます。 
• atlassian-confluence-security.log
  このファイルには、ユーザーおよびユーザー ディレクトリに関連するエントリが含まれます。 
• atlassian-synchrony.log
  このファイルには、共同編集を可能にする Synchrony 関連するエントリが含まれます。 
• atlassian-diagnostics.log
  このファイルには、ディスク容量やメモリ不足などの警告を提供する実験的な診断機能のエントリが含まれます。 

ドキュメントでは、「アプリケーション ログ」を参照するときに、これらのファイルのいずれかを参照しています。

各ファイルに記録されるクラスやパッケージは、LOGGING LOCATION AND APPENDER にある log4j.properties ファイルで確認できます。

ログ ファイルの設定を変更する 

Confluence および Synchrony でのログ記録の挙動は、以下のプロパティ ファイルで定義されています。
<CONFLUENCE-INSTALL>/confluence/WEB-INF/classes/log4j.properties

このファイルは、Apache の log4j ドキュメントに記載されているような、標準的な log4j 設定ファイルです。

ログ ファイルの出力先を変更する

log4j では、出力先を「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 の設定」を参照してください。 

注: ログ ファイルの場所を変更する場合、サポートの zZip を生成する際にログ ファイルは含まれなくなります。つまり、サポート リクエストにログを手動で添付する必要があります。

ログ ファイルのサイズと数を変更する

既定では、Confluence は 5 つのログ ファイルを保持します。これらのファイルは 20 MB に到達すると上書きされます。 

<CONFLUENCE-INSTALL>/confluence/WEB-INF/classes/log4j.properties ファイルで次の値を編集し、既定のログ サイズと保持するログ ファイルの数を変更できます。

log4j.appender.confluencelog.MaxFileSize=20480KB
log4j.appender.confluencelog.MaxBackupIndex=5

ログ レベルを変更する

これは Confluence UI で行うことができます。Confluence のログ設定を変更する方法の説明については、「ログ作成の設定」を参照してください。

特定の Confluence ロギング オプション

トラブルシューティングの際に必要となる可能性がある具体的なログ設定をいくつか紹介します。 

データベースに対する SQL リクエストの詳細のログ記録

データベースに送信される個々の SQL リクエストを記録できるように、Confluence のログを増やすことができます。これは特定の問題のトラブルシューティングに役立ちます。「詳細な SQL ログの有効化」を参照してください。

各 Confluence ページにアクセスしているユーザーの詳細を記録する

Tomcat Valve を使用したアクセス ログは、既定で Confluence 7.11 から有効になっています。これらのログはアプリケーション ログの一部ではなく、<install directory>/logs/conf_access_log.<date>.log にあります。

ただし、どのユーザーが Confluence 内のどのページにアクセスしているか示すようアプリケーション ログを設定できます。ナレッジ ベースの「ユーザー アクセスのログ取得を有効化する方法」を参照してください。

既知の問題についてのログ ファイルのスキャン

アトラシアンのトラブルシューティングおよびサポート ツールには、Confluence ログのエラーを確認し、それがナレッジ ベースや課題トラッカーの既知の問題と一致するかどうかを照合するログ アナライザーが含まれます。 

ログ ファイルの定期スキャンの設定方法については、「問題のトラブルシューティングおよび技術サポートの依頼」を参照してください。 

問題をトラブルシューティングする際にログにマーク付け

Tomcat ログ

Confluence のインストール ディレクトリには、Confluence サイトに関する課題をトラブルシューティングする際に役立つ追加のログがいくつかあります。 

• <install directory>/logs/catalina-<date>.log
  このログは、アプリケーション サーバーの起動や停止などの Tomcat 操作を記録します。 
• <install directory>/logs/conf_access_log.<date>.log
  Confluence のアクセス ログはここにあります。これらのログは、server.xml で設定されます。設定オプションの詳細については、「Tomcat アクセス ログ バルブ」のドキュメントを参照してください 
• <install directory>/logs/gc.<date>.log
  ガベージ コレクションのログがここにあります。これらのログは、GC の一時停止が長くなる場合に役立つ情報を提供します。