Confluence uses Apache's log4j logging service. This allows administrators to control the logging behavior and the log output file. There are six log4j logging levels.

If you request help from Atlassian Support, we will almost always ask for the Confluence application logs.  The easiest way to get these logs is to go to Administration menu , then General Configuration > Troubleshooting and support tools and follow the prompts to create a Support Zip.

On this page:

関連ページ

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

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

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

  • atlassian-confluence.log
    メインのアプリ ログ ファイルであり、ほとんどのエントリがここに書き込まれます。Confluence を起動すると、コンソールに書き込まれたログ エントリも、このログで繰り返されます。
  • atlassian-confluence-index.log
    このファイルには、検索インデックスに関連するエントリが含まれます。 
  • atlassian-confluence-outgoing-mail.log
    このファイルには、通知など、送信メールに関連するエントリが含まれます。 
  • atlassian-confluence-security.log
    このファイルには、ユーザーおよびユーザー ディレクトリに関連するエントリが含まれます。 
  • atlassian-synchrony.log
    このファイルには、共同編集を可能にする Synchrony 関連するエントリが含まれます。 
  • atlassian-diagnostics.log
    このファイルには、ディスク容量やメモリ不足などの警告を提供する実験的な診断機能のエントリが含まれます。
  • atlassian-confluence-jmx.log
    このファイルには、インスタンスのステータスをリアルタイムに監視できる Java Management Extensions API メトリックのエントリが含まれます。

  • atlassian-confluence-app-monitoring.log
    このファイルには、スケジュールに従って毎分収集されるアプリ関連の Java Management Extensions (JMX) API データのエントリが含まれています。

  • atlassian-confluence-ipd-monitoring.log
    このファイルには、データベース接続や HTTP 接続メトリックなどの製品内診断用のエントリが含まれ、インフラストラクチャのパフォーマンスの問題を特定するのに役立ちます。
  • atlassian-confluence-migrations.log
    このファイルには、Cloud への移行に関連するエントリが含まれます。

  • atlassian-confluence-health-checks.log
    このファイルには、Confluence インスタンスの起動中に検出され、解決する必要がある問題やエラーに関する詳細が含まれます。

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

各ファイルに記録されるクラスやパッケージは、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 のドキュメントを参照してください。

For more detailed information see Configuring log4j in Confluence to send specific entries to a different log file in our Knowledge Base. 

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

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

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

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


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


ログ レベルを変更する

This can be done in the Confluence UI. See Configuring Logging for instructions on how to change the logging configuration of Confluence.

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

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

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

You may want to increase Confluence's logging so that it records individual SQL requests sent to the database. This is useful for troubleshooting specific problems. See Enabling Detailed SQL Logging.

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

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

You can however configure the application log to show which users are accessing which pages in Confluence. See Internal Only - How to Enable User Access Logging in our Knowledge Base.

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

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

See Troubleshooting Problems and Requesting Technical Support to find out how to set up a periodic scan of your log files. 

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

トラブルシューティングを行う際に、問題を再現する前後でログ ファイルをマークできると便利な場合があります。これにより、ログの中で調査すべき部分を簡単に発見できます。  

アプリケーション ログ ファイルにマークを付けるには、次の手順を実行します。

  1. Go to Administration menu , then General Configuration > Logging and Profiling.
  2. Confluence をクラスタで実行する場合は、クラスタ ノードを選択します。
  3. たとえば、「ディレクトリ同期の課題が再現します」というメッセージを入力します。
  4. マークを使用して新しいログ ファイルを開始する場合は、[Rollover log files (ログ ファイルのロールオーバー)] を選択します (これにより、最も古いログ ファイルが削除されます)。 
  5. [マーク] を選択します。


スクリーンショット: クラスターのログとプロファイル画面

メッセージは、すべてのアプリケーション ログ ファイル (atlassian-confluence.log や atlassian-confluence-security.log など) に追加されます。ログには、必要な頻度でマークを付けることができます。

例:

... 
2021-01-04 13:21:47,421 INFO [http-nio-8090-exec-5 
[impl.admin.actions.MarkAllLogsAction] execute
***********************************************
Reproduce directory sync issue
************************************************ 
2021-01-04 13:25:23,901 ERROR [test error] [atlassian.confluence.test] This 
is a sample error java.lang.RuntimeException: Unable to find sample error 
for testuser 
...

Tomcat ログ

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

  • <install directory>/logs/catalina-<date>.log
    このログは、アプリケーション サーバーの起動や停止などの Tomcat 操作を記録します。 
  • <install directory>/logs/conf_access_log.<date>.log
    This is where you find Confluence's access logs. These logs are configured in the server.xml. See Tomcat Access Log Valve documentation for further configuration options. 
  • <install directory>/logs/gc.<date>.log
    ガベージ コレクションのログがここにあります。これらのログは、GC の一時停止が長くなる場合に役立つ情報を提供します。