AEM では、次の設定が可能です。
- 中央のログサービスのグローバルパラメーター
- 要求データのログ(要求情報用の特殊なログ設定)
- 個々のサービスに特有の設定(個々のログファイルおよびログメッセージの書式など)
これらはすべて、OSGi の設定です。
注意:
AEM のログは、Sling の原則に基づいています。詳しくは、Sling のログを参照してください。
ルートロガーを設定するには、Apache Sling Logging Configuration を使用します。これにより、AEM のログのグローバル設定が定義されます。
- ログレベル
- 主要なログファイルの場所
- 保存するバージョンの数
- バージョンのローテーション(最大サイズまたは期間)
- ログメッセージを書き込むときに使用する形式
注意:
このナレッジベースの記事では、request.log ファイルと access.log ファイルのローテーション方法について説明します。
- 具体的なログレベル
- 個々のログファイルの場所
- 保存するバージョンの数
- バージョンのローテーション(最大サイズまたは期間)
- ログメッセージを書き込むときに使用する形式
- ロガー(ログメッセージを提供する OSGi サービス)
AEM では、以下の手順でログメッセージをファイルに書き込みます。
- OSGi サービス(ロガー)がログメッセージを書き込みます。
- Logging Logger がこのメッセージを受け取り、仕様に従って書式設定します。
- Logging Writer が、これらすべてのメッセージを、定義済みの物理ファイルに書き込みます。
これらの要素は、該当する要素の次のパラメーターによってリンクされます。
- Logger(Logging Logger)
メッセージを生成するサービスを定義します。 - Log File(Logging Logger)
ログメッセージを格納する物理ファイルを定義します。
これは、Logging Logger と Logging Writer をリンクさせる際に使用します。接続をおこなうには、Logging Writer 設定の同じパラメーターと同一の値を使用する必要があります。 - Log File(Logging Writer)
ログメッセージの書き込み先の物理ファイルを定義します。
これが Logging Writer 設定の同じパラメーターと同一でない場合は、照合はおこなわれません。一致がない場合は、暗黙のライターがデフォルトの設定で作成されます(毎日のログローテーション)。
標準の AEM インストールには、特定のロガーおよびライターが含まれています。
1 つ目は特殊なケースで、request.log ファイルと access.log ファイルの両方を制御します。
- ロガー:
- Apache Sling Customizable Request Data Logger
(org.apache.sling.engine.impl.log.RequestLoggerService) - 要求コンテンツに関するメッセージを request.log に書き込みます。
- Apache Sling Customizable Request Data Logger
- リンク先:
- Apache Sling Request Logger
(org.apache.sling.engine.impl.log.RequestLogger) - メッセージを request.log または access.log に書き込みます。
- Apache Sling Request Logger
これらは必要に応じてカスタマイズできますが、ほとんどのインストールには標準設定が適しています。
その他のペアは、標準設定に従います。
- ロガー:
- Apache Sling Logging Logger Configuration
(org.apache.sling.commons.log.LogManager.factory.config) - Information メッセージを logs/error.log に書き込みます。
- Apache Sling Logging Logger Configuration
- リンク先のライター:
- Apache Sling Logging Writer Configuration
(org.apache.sling.commons.log.LogManager.factory.writer)
- Apache Sling Logging Writer Configuration
- ロガー:
- Apache Sling Logging Logger Configuration
(org.apache.sling.commons.log.LogManager.factory.config.649d51b7-6425-45c9-81e6-2697a03d6be7) - Warning メッセージを、org.apache.pdfbox サービス用の ../logs/error.log に書き込みます。
- Apache Sling Logging Logger Configuration
- 特定のライターにリンクしないので、デフォルト設定で暗黙のライターを作成して使用します(毎日のログローテーション)。
次の手順で、独自のロガーとライターのペアを定義できます。
- ファクトリ設定の Apache Sling Logging Logger Configuration の新しいインスタンスを作成します。
- ログファイルを指定します。
- ロガーを指定します。
- 必要に応じてその他のパラメーターを設定します。
- ファクトリ設定の Apache Sling Logging Writer Configuration の新しいインスタンスを作成します。
- ログファイルを指定します。ロガーに指定したものと同じファイルを指定する必要があります。
- 必要に応じてその他のパラメーターを設定します。
注意:
状況によっては、カスタムログファイルを作成する必要があります。