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. You can access the logs from the Confluence Administration Console, via the support tool. If you cannot access the Confluence Administration Console, 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.

On this page:

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

 

Confluence ログ ファイルの検索

This section describes Confluence's default logging behaviour, 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.

Both the Confluence and Confluence EAR/WAR distributions follow the same default behaviour:

  • 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 behaviour 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 – This is a custom appender which controls the default logging destination described above. This appender allows the following settings:
    • MaxFileSize
    • MaxBackupIndex
  • org.apache.log4j.RollingFileAppender - 異なる場所にログを出力する場合、RollingFileAppender 行のコメント化を解除し、その下の行で出力ファイルを変更します。ConfluenceHomeLogAppender を参照する、手前の行をコメントアウトします。

Confluence には log4j の提供するアペンダの完全なスイートが同梱されています。アペンダの詳細については、log4j のドキュメントを参照してください。

ログ レベルの変更

Confluence のログ設定を変更する方法の説明については、「ログ作成の設定」を参照してください。

一部の特定の Confluence ログ オプションの使用

このセクションには、必要になるかもしれない特定のログ設定に関するアドバイスがいくつか含まれています。

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

データベースに送信される個々の SQL リクエストを記録できるように、Confluence のログを増やすことができます。これは特定の問題のトラブルシューティングに役立ちます。

2つの方法で、詳細な SQL のログ記録を有効化できます。

  • 実行時 - 上記の手順を参照してください。
  • ログ記録のプロパティ ファイルを使用 - 詳細な手順を参照してください。

各 Confluence ページへのユーザーの参照/アクセスの詳細のログ記録

ユーザーが Confluence 内のどのページにアクセスしているかを示すようにログを設定することができます。これは、ログ記録のプロパティ ファイルの介してのみ利用可能です。詳細な手順を参照してください。

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

Confluence では、Confluence ログのエラーを確認したり、それがナレッジ ベースやバグ トラッカーの既知の問題に一致するかどうかを確認する組み込みのログ スキャナーを提供しています。「問題のトラブルシューティングおよび技術サポートの依頼」を参照してください。

注意

  • スレッド ダンプの検索： スレッドダンプは、アプリケーション サーバのログ ファイルに記録されます。
関連トピック

Enabling Detailed SQL Logging
Enabling user access logging
Generating a Thread Dump
Enabling Page Request Profiling
Troubleshooting Problems and Requesting Technical Support

 

  • ラベルなし