ログ

最終更新日： 2024年7月15日

作成対象：

  • 管理者

AEM では、以下の設定が可能です。

  • 中央のログサービスのグローバルパラメーター
  • リクエストデータのログ（リクエスト情報用の特殊なログ設定）
  • 個々のサービスに特有の設定（個々のログファイルおよびログメッセージの書式など）

これらはすべて、OSGi の設定です。

NOTE
AEM でのログ作成は、Sling の原則に基づいています。詳しくは Sling でのログ作成を参照してください。

グローバルログ

Apache Sling Logging Configuration を使用してルートロガーを設定します。AEM にログインする際の次のようなグローバル設定を定義します。

  • ログレベル
  • 主要なログファイルの場所
  • 保存するバージョンの数
  • バージョンのローテーション（最大サイズまたは期間）
  • ログメッセージを書き込むときに使用する形式
NOTE
このナレッジベースの記事では、request.log ファイルと access.log ファイルのローテーション方法について説明します。

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

グローバルログ設定に加えて、AEM では個々のサービス用に具体的な設定を行うことができます。

  • 具体的なログレベル
  • 個々のログファイルの場所
  • 保存するバージョンの数
  • バージョンのローテーション（最大サイズまたは期間）
  • ログメッセージを書き込むときに使用する形式
  • ロガー（ログメッセージを提供する OSGi サービス）

これにより、単一のサービスに関するログメッセージを個別のファイルに送ることができます。これは、開発やテストの際、例えば特定のサービスのログレベルを上げる必要がある場合などに特に便利です。

AEM では、以下の手順でログメッセージをファイルに書き込みます。

  1. OSGi サービス（ロガー）がログメッセージを書き込みます。
  2. Logging Logger がこのメッセージを受け取り、仕様に従って書式設定します。
  3. Logging Writer が、これらすべてのメッセージを、定義済みの物理ファイルに書き込みます。

これらの要素は、該当する要素の次のパラメーターによってリンクされます。

  • ロガー（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 Request Logger

      (org.apache.sling.engine.impl.log.RequestLogger)

    • メッセージを request.log または access.log に書き込みます。

これらは必要に応じてカスタマイズできますが、ほとんどのインストールには標準設定が適しています。

その他のペアは、標準設定に従います。

  • ロガー：

    • Apache Sling Logging Logger Configuration

      (org.apache.sling.commons.log.LogManager.factory.config)

    • logs/error.log にメッセージ Information を書き込みます。

  • リンク先のライター：

    • Apache Sling Logging Writer Configuration

      (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）

    • サービス org.apache.pdfbox のメッセージ Warning を ../logs/error.log に書き込みます。

  • 特定のライターにリンクしないので、デフォルト設定で暗黙のライターを作成して使用します（毎日のログローテーション）。