Confluence ログを使用する

Confluence では、Apache の log4j ログ記録サービスを使用しています。このサービスによって、管理者は、構成ファイルを編集して、ログ記録の動作やログ出力ファイルを制御できます。log4j のログ記録サービスは 6 つあります。

アトラシアン サポートにサポートをリクエストする場合、Confluence のアプリケーション ログが必要な場合が多くあります。これらのログを取得する最も簡単な方法として、> [一般設定] > [トラブルシューティングとサポート ツール] へ移動し、プロンプトに従ってサポート zip を作成します。

Confluence ログ ファイルの検索

This section describes Confluence's default logging behavior, and assumes 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 の初期 bootstrap が完了するまで、ログ エントリがアプリケーション サーバーに送られます。以下で説明するように、コンソールに書き込まれたログ エントリは、Confluence のログに繰り返されます。
  • Once the initial startup sequence is complete, all logging will be to <confluence-home>/logs/atlassian-confluence.log. For example: c:/confluence/data/logs/atlassian-confluence.log.

Note that the default location is the Confluence home directory, not the application server's log file. The home directory is specified in <confluence-installation>/confluence/WEB-INF/classes/confluence-init.properties.

ログ設定ファイルの場所

The logging behavior for Confluence and Synchrony is defined in the following properties file:
<CONFLUENCE-INSTALL>/confluence/WEB-INF/classes/log4j.properties

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

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

In log4j, an output destination is called an 'appender'. 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 – If you want to log to a different location, uncomment the RollingFileAppender line and change the destination file in the line below it. Comment out the previous lines referring to the ConfluenceHomeLogAppender.

Synchrony ログファイルの出力先は、ファイルと同じ方法で変更できます。 

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

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

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

You can change the default log size and the number of log files to keep by editing the following values in <CONFLUENCE-INSTALL>/confluence/WEB-INF/classes/log4j.properties file. 

 

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


ログ レベルの変更

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

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

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

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

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

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

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

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

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

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

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

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

 

最終更新日 2017 年 11 月 1 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.