Core Frameworks
ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、 こちら までご連絡ください。

ログ

OSGi ログ サービス エクステンダーを使用すると、バンドルは埋め込みプロパティ ファイル META-INF/osgi-logging.properties または META-INF/osgi-logging-ext.propertiesを使用して OSGi ログ記録構成を提供できるようになります。 ファイルの各行は、ロガー名とログ レベルを含むキーと値のペアです。

com.foo=DEBUG
com.foo.bar=ERROR

Liferay は次の 4 つのログ レベルをサポートしています。

  • エラー - エラー状況に関する情報。
  • 警告 - ブロックされていない障害または望ましくない状況に関する情報。
  • INFO - 通常の操作に関する情報。
  • DEBUG - デバッグ操作の詳細な出力。

Gogo Shell のログコマンド

ログ レベルをリアルタイムで操作するための Gogo シェル コマンドが提供されています。 使用可能なコマンドは、 ログ記録 コマンド スコープ内にあります (構文 <scope>:<command>に従います)。

スコープとコロン (<scope>:) は通常、コマンドの実行時には省略でき、競合するコマンド名を明確にするためにのみ必要です。

使用可能なコマンドは 2 つあります。

  • logging:levels <context> は、特定のロガーコンテキストに関連付けられたレベルを一覧表示します。 <context> をロガーコンテキスト名に置き換えます。 次のいずれかの構文を使用する必要があります。

    • <Bundle-SymbolicName>
    • <Bundle-SymbolicName>|<Bundle-Version>
    • <Bundle-SymbolicName>|<Bundle-Version>|<location>
    • null - デフォルトのロガーコンテキストを返します

    たとえば、コンテキスト com.liferay.oauth2.provider.service内のレベルを一覧表示するには、次のようにします。

    g! levels org.apache.felix.configadmin
    
  • logging:level <context> <name> <level> は、指定されたロガーコンテキスト内の名前付きロガーのレベルを設定します。 <context> を、上記で指定した構文に従ってロガーコンテキスト名に置き換えます。 <name> をロガーの名前に置き換えます。 <level> を希望のレベル (ERRORWARNINFO、または DEBUG) に置き換えます。 ロガー レベルでは大文字と小文字は区別されません。

    コンテキスト com.liferay.oauth2.provider.service内の名前付きロガー com.liferay.oauth2.provider.service.persistence.impl のレベルを DEBUG に設定する方法は次のとおりです。

    g! level com.liferay.oauth2.provider.service com.liferay.oauth2.provider.service.persistence.impl debug
    

レガシー OSGi ログイベントのマッピング

OSGi ログ サービス バージョン 1.4 には、以前は分類されていなかったレガシー ログ イベントをマップし、それらを制御できる 4 つの追加のロガー名があります。

  • Events.Bundle - バンドルイベントのロガー名
  • Events.Service - サービスイベントのロガー名
  • Events.Framework - フレームワークイベントのロガー名
  • LogService - LogService イベントのロガー名

これらのロガー名を使用すると、プロパティ ファイルまたは Gogo シェル コマンドを使用して、バンドルのレガシー LogService イベントのレベルを調整できます。

com.foo=DEBUG
com.foo.bar=ERROR
LogService=DEBUG
g! level org.apache.felix.configadmin LogService DEBUG