ログ logging

CAUTION
AEM 6.4 の拡張サポートは終了し、このドキュメントは更新されなくなりました。 詳細は、 技術サポート期間. サポートされているバージョンを見つける ここ.

AEMでは、次の項目を設定できます。

  • central ログサービスのグローバルパラメーター
  • リクエストデータログ;要求情報用の特別なログ設定
  • 個々のサービス固有の設定例えば、個々のログファイルとログメッセージの形式などです。

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

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

グローバルログ global-logging

Apache Sling Logging Configuration を使用してルートロガーを設定します。 これは、AEMにログインする際のグローバル設定を定義します。

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

個々のサービス用のロガーとライター loggers-and-writers-for-individual-services

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

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

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

AEMでは、次の情報を使用してログメッセージをファイルに書き込みます。

  1. An OSGi サービス (logger) はログメッセージを書き込みます。
  2. A Logging Logger はこのメッセージを取り込み、仕様に従って書式設定します。
  3. A ログライター は、定義した物理ファイルにこれらのメッセージをすべて書き込みます。

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

  • ロガー(Logging Logger)

    メッセージを生成するサービスを定義します。

  • Log File(Logging Logger)

    ログメッセージを保存する物理ファイルを定義します。

    これは、Logging Logger を Logging Writer とリンクするために使用します。接続を確立するには、Logging Writer 設定の同じパラメーターと値が同じである必要があります。

  • Log File(Logging Writer)

    ログメッセージの書き込み先の物理ファイルを定義します。

    これは Logging Writer 設定の同じパラメーターと同一でなければなりません。そうでない場合、照合は行われません。一致がない場合は、暗黙のライターがデフォルトの設定で作成されます(毎日のログローテーション)。

標準のロガーおよびライター standard-loggers-and-writers

特定のロガーとライターは、標準の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 に書き込みます。

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

独自のロガーおよびライターの作成 creating-your-own-loggers-and-writers

次の手順で、独自のロガーとライターのペアを定義できます。

  1. ファクトリ設定の Apache Sling Logging Logger Configuration の新しいインスタンスを作成します。

    1. ログファイルを指定します。
    2. ロガーを指定します。
    3. 必要に応じて、その他のパラメーターを設定します。
  2. ファクトリ設定の新しいインスタンスを作成します Apache Sling Logging Writer Configuration.

    1. ログファイルを指定します。これは、ロガーに指定されたファイルと一致する必要があります。
    2. 必要に応じて、その他のパラメーターを設定します。
NOTE
特定の状況で、 カスタムログファイル.
recommendation-more-help
6a71a83d-c2e0-4ce7-a6aa-899aa3885b56