Show Menu
トピック×

ログ

AEM では、次の設定が可能です。
  • 中央のログサービスのグローバルパラメーター
  • 要求データのログ(要求情報用の特殊なログ設定)
  • 個々のサービスに特有の設定(個々のログファイルおよびログメッセージの書式など)
これらはすべて、 OSGi の設定 です。
AEM のログは、Sling の原則に基づいています。詳しくは、 Sling のログ を参照してください。

グローバルログ

ルートロガーを設定するには、 Apache Sling Logging Configuration を使用します。これにより、AEM のログのグローバル設定が定義されます。
  • ログレベル
  • 主要なログファイルの場所
  • 保存するバージョンの数
  • バージョンのローテーション(最大サイズまたは期間)
  • ログメッセージを書き込むときに使用する形式
この ナレッジベースの記事 では、request.log ファイルと access.log ファイルのローテーション方法について説明します。

個々のサービス用のロガーとライター

グローバルログ設定に加えて、AEM では個々のサービス用に具体的な設定をおこなうことができます。
  • 具体的なログレベル
  • 個々のログファイルの場所
  • 保存するバージョンの数
  • バージョンのローテーション(最大サイズまたは期間)
  • ログメッセージを書き込むときに使用する形式
  • ロガー(ログメッセージを提供する OSGi サービス)
これにより、単一のサービスに関するログメッセージを別個のファイルに送ることができます。これは、開発やテストの際、例えば特定のサービスのログレベルを上げる必要がある場合などに特に便利です。
AEM では、以下の手順でログメッセージをファイルに書き込みます。
  1. OSGi サービス (ロガー)がログメッセージを書き込みます。
  2. Logging Logger がこのメッセージを受け取り、仕様に従って書式設定します。
  3. Logging Writer が、これらすべてのメッセージを、定義済みの物理ファイルに書き込みます。
これらの要素は、該当する要素の次のパラメーターによってリンクされます。
  • Logger(Logging Logger)
    メッセージを生成するサービスを定義します。
  • ログファイル(Logging Logger)
    ログメッセージを保存する物理ファイルを定義します。
    これは、Logging LoggerとLogging writerをリンクするために使用します。 接続を行うには、ログライター設定の同じパラメーターと値が同じである必要があります。
  • ログファイル(ログライタ)
    ログメッセージの書き込み先となる物理ファイルを定義します。
    これは、Logging Writer設定の同じパラメーターと同じである必要があります。同じでないと、一致は行われません。 一致がない場合は、暗黙的なWriterがデフォルト設定(日次ログローテーション)で作成されます。

標準のロガーおよびライター

標準の AEM インストールには、特定のロガーおよびライターが含まれています。
1 つ目は特殊なケースで、 request.log ファイルと access.log ファイルの両方を制御します。
  • ロガー:
    • Apache Sling Customizable Request Data Logger
      (org.apache.sling.engine.impl.log.RequestLoggerService)
    • 要求コンテンツに関するメッセージを request.log に書き込みます。
  • リンク先:
    • Apache Sling Request Logger
      (org.apache.sling.engine.impl.log.RequestLogger)
    • Writes the messages to either request.log or access.log .
これらは必要に応じてカスタマイズできますが、ほとんどのインストールには標準設定が適しています。
その他のペアは、標準設定に従います。
  • ロガー:
    • Apache Sling Logging Loggerの設定
      (org.apache.sling.commons.log.LogManager.factory.config)
    • にメッセージ Information を書き込みま logs/error.log す。
  • リンク先のライター:
    • Apache Slingログライタの設定
      (org.apache.sling.commons.log.LogManager.factory.writer)
  • ロガー:
    • Apache Sling Logging Logger Configuration(org.apache.sling.commons.log.LogManager.factory.config.649d51b7-6425-45c9-81e6-2697a03d6be7)
    • サービス Warning のメッセージ ../logs/error.log をに書き込みま org.apache.pdfbox す。
  • 特定のライターにリンクしないので、デフォルト設定で暗黙のライターを作成して使用します(毎日のログローテーション)。

独自のロガーおよびライターの作成

次の手順で、独自のロガーとライターのペアを定義できます。
  1. ファクトリ設定の Apache Sling Logging Logger Configuration の新しいインスタンスを作成します。
    1. ログファイルを指定します。
    2. ロガーを指定します。
    3. 必要に応じてその他のパラメーターを設定します。
  2. ファクトリ設定の Apache Sling Logging Writer Configuration の新しいインスタンスを作成します。
    1. ログファイルを指定します。ロガーに指定したものと同じファイルを指定する必要があります。
    2. 必要に応じてその他のパラメーターを設定します。
状況によっては、 カスタムログファイル を作成する必要があります。