ヘッダーをスキップ
Oracle® Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス
11gリリース1 (10.3.6)
B55569-05
  ドキュメント・ライブラリへ移動
ライブラリ
製品リストへ移動
製品
目次へ移動
目次

前
 
次
 

7 ロギング・カスタムWLSTコマンド

この章では、ロギング用のカスタムWLSTコマンド、およびそのコマンド構文、引数、コマンド例を詳細に説明します。ロギング・コマンドを使用して、ログ・ファイルの設定を構成、およびログ・ファイルを表示および検索します。

ログ・ファイルの構成および検索の詳細は、Oracle Fusion Middleware管理者ガイドの「ログ・ファイルと診断データの管理」を参照してください。


注意:

これらのロギング・カスタムWLSTコマンドを使用するには、Oracle共通ホームからWLSTスクリプトを呼び出す必要があります。『Oracle Fusion Middleware管理者ガイド』の「カスタムWLSTコマンドの使用」を参照してください。


表7-1では、ロギング・コマンドの各種カテゴリを説明します。

表7-1ロギング・コマンドのカテゴリ

コマンド・カテゴリ 説明

ログの構成コマンド


ファイルに書き込まれる情報レベルやファイルの最大サイズなどのログ・ファイルの設定を構成します。

検索および表示コマンド


Oracle Fusion Middlewareログ・ファイルを表示し、特定のメッセージのログ・ファイルを検索します。

選択的トレース・コマンド


選択的トレースを構成および使用します。選択的トレースでは、メッセージが特定のサーバー、ログ出力またはユーザーについてトレースされることが指定されます。


ログの構成コマンド

表7-2のコマンドを使用して、ファイルに書き込まれる情報レベルやファイルの最大サイズなどのログ・ファイルの設定を構成します。WLSTカラムで使用する場合は、オンラインとは、コマンドが実行中のサーバーに接続されている場合のみに使用されることを意味します。オフラインとは、コマンドが実行中のサーバーに接続されてない場合のみに使用されることを意味します。オンラインまたはオフラインとは、コマンドは両方の状況に使用できることを意味します。

表7-2ロギング構成のコマンド

コマンド 説明 WLSTの使用状況

configureLogHandler


既存のログ・ハンドラを構成し、新しいハンドラを追加または既存ハンドラを削除します。

オンライン

getLogLevel


指定したログ機能のレベルを取得します。

オンライン

listLoggers


ログ機能の一覧および各ログ機能のレベルを取得します。

オンライン

listLogHandlers


1つまたは複数のログ・ハンドラの構成を示します。

オンライン

setLogLevel


指定したログ機能のレベルを設定します。

オンライン


configureLogHandler

コマンド・カテゴリ:ログ構成

WLSTの使用状況:オンライン

説明

既存のJavaロギング・ハンドラを構成し、新しいハンドラを追加、既存のハンドラを削除します。ハンドラごとに1つのエントリを持つjava.util.Listを返します。各エントリは、ハンドラを記述するjavax.management.openmbean.CompositeDataオブジェクトです。

このコマンドを使用して、ログ・ファイルの場所、ログ・ファイルのローテーション頻度および他のログ・ファイルのプロパティを変更できます。

構文

configureLogHandler(options)
引数 定義
options

オプションのカンマ区切りのリスト。名前と値のペアで指定します。有効なオプションは次のとおりです。

  • target—WebLogic Serverインスタンスの名前、またはシステム・コンポーネントを記述する文字列。システム・コンポーネントの詳細は、コンポーネントのマニュアルを参照してください。

    デフォルト値はWLSTが接続しているサーバーです。

  • name —ログ・ハンドラの名前。このオプションは必須です。

  • maxFileSize—ODLハンドラの最大ファイル・サイズの値。この値は数値を表す文字列で、オプションとしてサイズ単位を示すサフィックス(キロバイトはk、メガバイトはm、ギガバイトはg)が付加されます。

    サフィックスを指定しない場合、値がバイト単位で返されます。

    このオプションはQuickTraceハンドラには適用されないことに注意してください。

  • maxLogSize—ODLハンドラの最大ログ・ファイル・サイズの値。この値は数値を表す文字列で、オプションとしてサイズ単位を示すサフィックス(キロバイトはk、メガバイトはm、ギガバイトはg)が付加されます。

    このオプションはQuickTraceハンドラには適用されないことに注意してください。

  • rotationFrequency — ODLハンドラのローテーション頻度の値。この値は数値を表す文字列で、オプションとして時間単位を示すサフィックス(分はm、時間はh、日はd)が付加されます。デフォルトの単位は分です。HOUR、HOURLY、DAY、DAILY、WEEK、WEEKLY、MONTH、MONTHLYの特定の値も使用でき、これらの値を分の数値に変換されます。

    このオプションはQuickTraceハンドラには適用されないことに注意してください。

  • baseRotationTime — rotationFrequencyオプションで使用する基本ローテーション時刻。値は、日付と時刻値を表す文字列である必要があります。これには、ISO 8601日付と時間フォーマットで完全な日付と時間、または時間数および分数のみが含まれる短縮形を使用できます。デフォルトのbaseRotationTimeは00:00です。

    このオプションはQuickTraceハンドラには適用されないことに注意してください。

options (continued)
  • retentionPeriod—ログ・ファイルが保持される時間。この値は数値を表す文字列である必要があり、オプションとして時間単位を示すサフィックス(分はm、時間はh、日はd)が付加されます。デフォルトの単位は分です。HOUR、HOURLY、DAY、DAILY、WEEK、WEEKLY、MONTH、MONTHLYの特定の値も使用でき、これらの値を分の数値に変換されます。

    このオプションはQuickTraceハンドラには適用されないことに注意してください。

  • format — ODLハンドラの形式。有効な値は「ODL-Text」または「ODL-XML」のいずれかです。デフォルト形式はODL-Textです。

  • encoding —ログ・ファイルの文字エンコーディング。

  • path—ログ・ファイル・パス。

    このオプションはQuickTraceハンドラには適用されないことに注意してください。

  • handlerType —ハンドラ実装を提供するJavaクラスの名前。これは、java.util.logging.Handlerまたはoracle.core.ojdl.logging.HandlerFactoryのインスタンスである必要があります。

  • propertyName —追加または更新する詳細ハンドラ・プロパティの名前。プロパティ値は、propertyValueオプションで指定します。有効なプロパティについては、ハンドラのマニュアルを参照してください。

  • propertyValue — propertyNameオプションで定義されたハンドラのプロパティの新しい値。

  • addProperty — Jythonブール値。ハンドラに新しいプロパティが追加されることを定義するためにpropertyNameおよびpropertyValueオプションと組み合せて使用します。

  • removeProperty —削除する1つまたは複数のハンドラ・プロパティの一覧。

  • addHandler —ブール値。値がtrueの場合、指名されたハンドラが追加されます。

  • removeHandler —ブール値。値がtrueの場合、指名されたハンドラが削除されます。

  • level—JavaまたはODLレベル値。ハンドラ・レベルが指定のレベルに設定されます。

  • addToLogger —ログ機能名の一覧。ハンドラが指定したログ機能名に追加されます。

  • removeFromLogger —ログ機能名の一覧。指定したログ機能からハンドラが削除されます。

  • useParentHandlers—ブール値。addToLoggerまたはremoveFromLoggerオプションによって定義されるログ出力にuseParentHandlersフラグを設定します。


次の表では、quicktrace-handlerのプロパティを示します。このハンドラにより、特定のログ出力のメッセージをトレースし、メモリー内にそれらのメッセージを格納できます。詳細は、Oracle Fusion Middleware管理者ガイドのQuickTraceの構成に関する項を参照してください。

QuickTraceプロパティ 説明

bufferSize

循環QuickTraceバッファのおおよそのサイズ。ログ・レコードは、メモリー内のこのバッファに格納されます。実際のメモリー消費量は、この値より少なくなることはありますが、多くなることはありません。

enableDMSMetrics

trueに指定された場合、quicktrace-handlerに対してDMSメトリックが有効になります。デフォルトはtrueです。

enableUserBuffer

trueに指定された場合、ハンドラは、reserveBufferUserIDプロパティで指定されているユーザーごとに個別のバッファを維持します。reserveBufferUserIDプロパティでユーザーが定義されていない場合、メッセージはCOMMONバッファにキャッシュされます。

falseに指定された場合、ハンドラは、COMMONという1つのバッファのみを維持します。

デフォルトはfalseです。

flushOnDump

trueに指定された場合、executeDumpコマンドを実行すると、バッファがフラッシュされます。デフォルトはtrueです。

includeMessageArguments

trueに指定された場合、メッセージIDを持つフォーマット済ログ・メッセージにメッセージ引数が含まれます。デフォルトはfalseです。

maxFieldLength

メッセージ内の各フィールドの最大長(バイト単位)。フィールドには、メッセージ・テキスト、サプリメンタル属性、スレッド名、ソース・クラス名、ソース・メソッド名およびメッセージ引数が含まれます。

デフォルトは240バイトです。

小さい数値を指定すると、メッセージに対して戻される情報の量を制限することができます。非常に大きな数値を指定すると、各メッセージでより多くのバイトが使用されるため、バッファ内のログ・レコードの量を削減できます。

reserveBufferUserID

カンマで区切られた、ユーザーIDのリスト。enableUserBufferがtrueに指定された場合、そのユーザーに関連するすべてのログ・メッセージは別のバッファに書き込まれます。

supplementalAttributes

サプリメンタル属性名のリスト。属性は、logging.xmlファイルにリストされます。

サプリメンタル属性の設定には、追加のメモリーまたはCPU時間が必要になります。

useDefaultAttributes

trueに指定された場合、デフォルトの属性値が各ログ・メッセージに追加されます。デフォルト属性は、HOST_ID、HOST_NWADDRおよびUSER_IDです。

useLoggingContext

trueに指定された場合、ログ・メッセージにはDMSロギング・コンテキスト属性が含まれます。デフォルトはfalseです。

このオプションを有効にした場合、トレースでは追加のCPU時間が必要になります。

useRealThreadID

trueに指定された場合、ハンドラは、jave.util.logging.logRecordによって提供されるスレッドIDではなく、実際のスレッドIDを使用しようとします。デフォルトはfalseです。

このオプションを有効にした場合、トレースでは追加のCPU時間が必要になります。

useThreadName

trueに指定された場合、ログ・メッセージにはスレッドIDではなく、スレッド名が含まれます。デフォルトはfalseです。


次の例では、odlハンドラの最大ファイル・サイズを指定します。

configureLogHandler(name="odl-handler", maxFileSize="5M")

次の例では、odlハンドラのローテーション頻度を指定します。

configureLogHandler(name="odl-handler", rotationFrequency="daily")

次の例では、odlハンドラのローテーション頻度および保存期間を指定します。また、maxFileSizeプロパティとmaxLogSizeプロパティも削除します。

configureLogHandler(name="odl-handler", rotationFrequency="daily", 
         retentionPeriod="week", removeProperty=['maxFileSize','maxLogSize'])

次の例では、quicktrace-handlerを構成します。ログ出力oracle.adf.facesを追加し、user1およびuser2に対してユーザー・バッファを有効にします。

configureLogHandler(name="quicktrace-handler", addToLogger="oracle.adf.faces",
       propertyName="enableUserBuffer", propertyValue="true",
      propertyName="reserveBufferUserID", propertyValue="user1, user2")

oracle.adfログ出力は、ハンドラodl-handler、wls-domainおよびconsole-handlerに関連付けられています。ログ出力のレベルを設定すると、これらのハンドラは、ログ出力oracle.adfに対して同じレベル(TRACE:1)を使用します。結果として、ログ・ファイルに多くの情報が書き込まれ、リソースが消費されることになります。リソースの消費を避けるためには、ハンドラのレベルを、WARNINGまたはINFORMATIONなど、より低いレベルに設定します。次に例を示します。

configureLogHandler(name="odl-handler", level="WARNING:1")
configureLogHandler(name="wls-domain", level="WARNING:1")
configureLogHandler(name="console-handler", level="WARNING:1")

getLogLevel

コマンド・カテゴリ:ログ構成

WLSTの使用状況:オンライン

説明

特定のJavaログ機能のレベルを返します。

戻り値は、ログ機能のレベルを示す文字列で、ログ機能が存在しない場合はNoneです。空の文字列は、ログ機能レベルがNullになることを示します。

構文

getLogLevel(options)
引数 定義
options

オプションのカンマ区切りのリスト。名前と値のペアで指定します。有効なオプションは次のとおりです。

  • target—WebLogic Serverインスタンスの名前、またはシステム・コンポーネントを記述する文字列。システム・コンポーネントの詳細は、コンポーネントのマニュアルを参照してください。

    デフォルト値はWLSTが接続しているサーバーです。

  • logger —ログ機能名。空の文字列はルート・ログ機能を示します。

    このオプションは必須で、デフォルト値はありません。

  • runtime —オペレーションは実行時ログ機能または構成ログ機能をリストするかを決定するJythonブール値(0または1)。デフォルト値は1 (実行時)です。


次の例では、ログ機能Oracleのレベルを返します。

getLogLevel(logger='oracle')

次の例では、ラインタイム・ログ出力ではなく、構成ログ出力のみを指定して、ログ出力Oracleのレベルを戻します。

getLogLevel(logger='oracle', runtime=0)

次の例では、Oracle WebLogic Server server2上のログ機能Oracleのレベルを返します。

getLogLevel(logger='oracle', target='server2')

listLoggers

コマンド・カテゴリ:ログ構成

WLSTの使用状況:オンライン

説明

Javaログ機能およびそれらのレベルを示します。このコマンドは、キーはログ機能名であり、関連付けられた値はログ機能レベルであるPyDictionaryオブジェクトを返します。空のレベルは、ログ機能にレベル・セットはないことを示すために使用されます。

構文

listLoggers([options])
引数 定義
options

オプションのカンマ区切りのリスト(省略可能)。名前と値のペアで指定します。有効なオプションは次のとおりです。

  • target—WebLogic Serverインスタンスの名前、またはシステム・コンポーネントを記述する文字列。システム・コンポーネントの詳細は、コンポーネントのマニュアルを参照してください。

    デフォルト値はWLSTが接続しているサーバーです。

  • pattern —ログ機能名をフィルタするために使用する正規表現パターン。デフォルト値はすべてのログ機能名を返します。

  • runtime —オペレーションは実行時ログ機能または構成ログ機能をリストするかを決定するJythonブール値(0または1)。デフォルト値は1 (実行時)です。


次の例では、すべてのログ機能を示します。

listLoggers()

次の例では、「oracle.*」という名前で開始するすべてのログ機能を表示します。

listLoggers(pattern="oracle.*")

次の例では、すべての構成ログ機能を表示します。

listLoggers(runtime=0)

次の例では、WebLogic Server server1のすべてのログ出力を一覧表示します。

listLoggers(target="server1")

listLogHandlers

コマンド・カテゴリ:ログ構成

WLSTの使用状況:オンライン

説明

Javaログ・ハンドラ構成を示します。このコマンドは、ハンドラごとに1つのエントリを持つjava.util.Listを返します。各エントリは、ハンドラを記述するjavax.management.openmbean.CompositeDataオブジェクトです。

構文

listLogHandlers([options])
引数 定義
options

オプションのカンマ区切りのリスト(省略可能)。名前と値のペアで指定します。有効なオプションは次のとおりです。

  • target—WebLogic Serverインスタンスの名前、またはシステム・コンポーネントを記述する文字列。システム・コンポーネントの詳細は、コンポーネントのマニュアルを参照してください。

    デフォルト値はWLSTが接続しているサーバーです。

  • name —ログ・ハンドラの名前。名前を指定しない場合、すべてのハンドラを表示します。


次の例では、すべてのログ・ハンドラの一覧を表示します。

listLogHandlers()

次の例では、「odl-handler」という名前のログ・ハンドラをすべて表示します。

listLogHandlers(name="odl-handler")

次の例では、WebLogic Server server1のすべてのログ・ハンドラを一覧表示します。

listLogHandlers(target="server1")

setLogLevel

コマンド・カテゴリ:ログ構成

WLSTの使用状況:オンライン

説明

特定のJavaログ機能によってログ・ファイルに書き込まれた情報のレベルを設定します。

構文

setLogLevel(options)
引数 定義
options

オプションのカンマ区切りのリスト。名前と値のペアで指定します。有効なオプションは次のとおりです。

  • target—WebLogic Serverインスタンスの名前、またはシステム・コンポーネントを記述する文字列。システム・コンポーネントの詳細は、コンポーネントのマニュアルを参照してください。

    デフォルト値はWLSTが接続しているサーバーです。

  • logger —ログ機能名。空の文字列はルート・ログ機能を示します。

    このオプションは必須で、デフォルト値はありません。addLoggerオプションを使用しないかぎり、ログ機能が存在しない場合このコマンドによって例外が送出されます。

  • addLogger —ログ機能が存在しない場合、ログ機能を作成するかを決定するJythonブール値(0または1)。このオプションは、ランタイム・モードに対しては非推奨です。ログ出力はガベージ・コレクションされる可能性があるため、ランタイム・ログ出力の追加が何の効果もないことがあります。まだ作成されていないログ出力のレベルを設定する必要がある場合は、永続モードを使用します。

  • level —レベル名。これは、JavaレベルまたはODLレベルのどちらかです。有効なJavaレベルは次のとおりです。SEVERE、WARNING、INFO、CONFIG、FINE、FINERまたはFINEST。有効なODLレベルには、コロンおよびメッセージ・レベルを付加したメッセージ・タイプが含まれます。有効なODLメッセージ・タイプは次のとおりです。INCIDENT_ERROR、ERROR、WARNING、NOTIFICATION、TRACEおよびUNKNOWN。メッセージ・レベルは、メッセージ・タイプを修飾する整数値で表現されます。指定できる値は、1 (最高の重大度)から32 (最低の重大度)までです。

    空の文字列を使用すると、レベルをnullに設定できます(親から継承)。

    このオプションは必須で、デフォルト値はありません。

  • runtime —オペレーションは実行時ログ機能または構成ログ機能をリストするかを決定するJythonブール値(0または1)。デフォルト値は1 (実行時)です。ターゲットが、変化するランタイム・ログ出力をサポートしないシステム・コンポーネントである場合、このオプションは無視されます。

    注意: ランタイム・ログ出力はガベージ・コレクションされる可能性があるため、ランタイム・ログ出力のレベルの変更は、ログ出力が存在しており、かつそのログ出力への強参照があることがわかっている場合にのみ行うようにしてください。ログ出力がガベージ・コレクションされた場合、ランタイム・モードでログ出力レベルに加えられた永続的ではない変更は、すべて失われる可能性があります。

  • persist —レベルを構成ファイルに保存する必要があるかを決定するJythonブール値(0または1)。デフォルト値は1です。


次の例では、ログ機能oracle.my.loggerのためにログ・レベルをNOTIFICATION:1に設定します。

setLogLevel(logger="oracle.my.logger", level="NOTICATION:1")

次の例では、ログ機能oracle.my.loggerのためにログ・レベルをTRACE:1に設定し、レベルは構成ファイルに保存する必要があることを指定します。

setLogLevel(logger="oracle.my.logger", level="TRACE:1", persist=0)

次の例では、WebLogic Server server1上の構成ログ出力oracle.my.loggerに対するログ・レベルをWARNINGに設定します。

setLogLevel(target="server1", logger="oracle.my.logger", level="WARNING", runtime=0)

検索および表示コマンド

表7-3のコマンドを使用して、Oracle Fusion Middlewareログ・ファイルを表示し、特定のメッセージのログ・ファイルを検索します。

表7-3検索および表示コマンド

コマンド 説明 WLSTの使用状況

displayLogs


1つまたは複数のログを表示します。

オンラインまたはオフライン

listLogs


ログ・ファイルの内容を検索し、表示します。

オンラインまたはオフライン


displayLogs

コマンド・カテゴリ:検索および表示

WLSTの使用状況:オンラインまたはオフライン

説明

診断ログ・ファイルの内容を検索し、表示します。コマンドは、returnDataオプションをtrueに設定した場合のみ値を返します。デフォルトでは、このコマンドによってデータは返されません。戻り値は使用するオプションによって異なります。

構文

displayLogs([searchString,][options])
引数 定義
searchString

省略可能な検索文字列。指定した文字列(大文字と小文字は区別されない)を含むメッセージのみが返されます。

displayLogsコマンドでは、複数のフォーマットでログを読み込むことができ、ODLフォーマットにメッセージを変換できます。検索は、できるだけネイティブ・フォーマットで実行されます。それ以外の場合、検索がメッセージ・コンテンツ内に実行され、マークアップを除外する場合もあります。したがって、検索文字列でマークアップ文字の使用を避ける必要があります。

options

オプションのカンマ区切りのリスト(省略可能)。名前と値のペアで指定します。有効なオプションは次のとおりです。

  • target—WebLogic Serverインスタンスまたはシステム・コンポーネントの名前。

    システム・コンポーネントの場合、ターゲットの構文は次のとおりです。

    opmn:instance-name/component-name
    

    接続モードでは、デフォルトのターゲットはWebLogicドメインです。接続解除モードでは、デフォルト値がない、ターゲット・オプションは必須です。

  • oracleInstance—ORACLE_INSTANCEまたはWebLogicドメイン・ホームへのパスを定義します。このパラメータを使用すると、コマンドは接続解除モードで実行されます。

  • log —ログ・ファイルのパス。コマンドは、指定したログ・ファイルからメッセージを読み込みます。ログ・ファイルのパスを指定しない場合、コマンドは、指定したターゲットに関連付けられるすべてのログを読み込みます。

options (continued)
  • last —整数値。時間制限に達する数分前にログされたメッセージに検索を制限します。値にサフィックス(秒はs、分はm、時間はhまたは日はd)を付加することで、異なる時間単位を指定することができます。(たとえば、last='2h'は最後の2時間として解釈されます)。

  • tail —整数値。検索を各ログ・ファイルからの最後のnメッセージに制限し、nに表示されるメッセージ数を制限します。

  • pattern —正規表現パターン。特定のパターンを含むメッセージのみが返されます。パターン・オプションの使用は、searchString引数の使用と同様ですが、正規表現を使用できる点が異なります。

    正規表現パターンの検索では大文字と小文字が区別されます。(パターンの大文字と小文字は区別されないフラグを明示的に有効にしないかぎり)。パターンはjava.util.regex構文に従う必要があります。

  • ecid —ログ・メッセージのフィルタとして使用する1つまたは複数の実行コンテキストID (ECID)値を含む文字列または文字列の系列。

  • component —ログ・メッセージのフィルタとして使用する1つまたは複数のコンポーネントID値を含む文字列または文字列の系列。

  • module —ログ・メッセージのフィルタとして使用する1つまたは複数のモジュールID値を含む文字列または文字列の系列。

  • type —ログ・メッセージのフィルタとして使用する1つまたは複数のメッセージ・タイプ値を含む文字列または文字列の系列。

  • app —ログ・メッセージのフィルタとして使用する1つまたは複数のアプリケーション値を含む文字列または文字列の系列。

  • query —ログ・メッセージのコンテンツをフィルタするために使用する式を指定する文字列。

    単純な式の形式は次のとおりです。

    field-name operator value
    

    field-nameはログ・レコード・フィールド名で、operatorはフィールド・タイプに適する演算子です(たとえば、文字列フィールドのためにequals、startsWith、containsまたはmatchesを指定できます)。

    フィールド名は、標準ODL属性名のいずれか(COMPONENT_ID、MSG_TYPE、MSG_TEXT、SUPPL_DETAILなど)、またはSUPPL_ATTRというプレフィックスが付いたアプリケーション固有のサプリメンタル属性名(SUPPL_ATTR.myAttributeなど)のいずれかです。

    いくつかの一般的なサプリメンタル属性は、プレフィックスなしで使用できます。たとえば、APPを使用して、アプリケーション名でフィルタ処理することができます。

    ブール演算子andorおよびnotを使用し複数の単純な式を組み合せて複雑な式を作成することができます。そして、丸括弧を使用して式をグループ化できます。

    クエリー構文の詳細は、『Oracle Fusion Middleware管理者ガイド』を参照してください。

  • groupBy —文字列のリスト。groupByオプションを使用する場合、出力は文字列リストに定義された属性でグループしたログ・メッセージの数です。

  • orderBy —結果のソート順を定義する文字列のリスト。値はログ・メッセージ属性の名前です。必要に応じて、名前に:ascまたは:descのサフィックスを追加することで昇順または降順のソートを指定できます。デフォルトのソート順を昇順です。

    デフォルトでは、結果は時間でソートされます。

  • returnData — Jythonブール値(0または1)。値がtrueの場合、コマンドによってデータが返されます。(たとえば、スクリプトで使用するデータ)。デフォルト値がfalseで、コマンドによってデータが表示されるが、返されません。

options (continued)
  • format —出力形式を定義する文字列。有効な値は、ODL-Text、ODL-XML、ODL-completeおよびsimpleです。デフォルト形式はODL-Textです。

  • exportFile —コマンドの出力が書き込まれるファイル名。デフォルトでは、出力は標準出力に書き込まれます。

  • follow (f)—ログに新しいメッセージが追加されるとき、ログを引き続き読み込んでメッセージを表示するために、コマンドをfollowモードに設定します(UNIXのtail -fコマンドと同様)。fオプションを使用すると、コマンドは値を戻しません。現在、このオプションは、システム・コンポーネントではサポートされていません。


次の例では、ドメインのすべてのログ・ファイルから最後の100メッセージを表示します。

displayLogs(tail=100)

次の例では、最後の15分にログされるすべてのメッセージを表示します。

displayLogs(last='15m')

次の例では、指定した文字列を含むログ・メッセージを表示します。

displayLogs('Exception')

次の例では、指定したECIDを含むログ・メッセージを表示します。

displayLogs(ecid='0000Hl9TwKUCslT6uBi8UH18lkWX000002')

次の例では、ERRORまたはINCIDENT_ERRORタイプのログ・メッセージを表示します。

displayLogs(type=['ERROR','INCIDENT_ERROR'])

次の例では、指定したJava EEアプリケーションのログ・メッセージを表示します。

displayLogs(app="myApplication")

次の例では、システム・コンポーネントohs1のメッセージを表示します。

displayLogs(target="opmn:instance1/ohs1")

次の例では、コンポーネントとタイプでメッセージ概要を表示します。

displayLogs(groupBy=['COMPONENT_ID', 'MSG_TYPE'])

次の例では、特定の時間間隔のメッセージを表示します。

displayLogs(query="TIME from 11:15 and TIME to 11:20")

次の例では、詳細なクエリーを示します。

displayLogs(query="TIME from 11:15 and TIME to 11:20 and ( MSG_TEXT contains 
   exception or SUPPL_DETAIL contains exception )")

同じクエリーを次のように記述することができます。

displayLogs("exception", query="TIME from 11:15 and TIME to 11:20")

listLogs

コマンド・カテゴリ:検索および表示

WLSTの使用状況:オンラインまたはオフライン

説明

Oracle Fusion Middlewareコンポーネントのログ・ファイルの一覧を表示します。このコマンドは、ログごとに1つの要素を含むPyArrayを返します。配列の要素は、各ログを記述するjavax.management.openmbean.CompositeDataオブジェクトです。

構文

listLogs([options]
引数 定義
options

オプションのカンマ区切りのリスト(省略可能)。名前と値のペアで指定します。有効なオプションは次のとおりです。

  • target—WebLogic ServerインスタンスまたはOracle Fusion Middlewareシステム・コンポーネントの名前。

    システム・コンポーネントの場合、ターゲットの構文は次のとおりです。

    opmn:instance-name/component-name
    

    接続モードでは、デフォルトのターゲットはWebLogicドメインです。

    接続解除モードでは、デフォルト値がない、ターゲット・オプションは必須です。

  • oracleInstance—ORACLE_INSTANCEまたはWebLogicドメイン・ホームへのパスを定義します。このパラメータを使用すると、コマンドは接続解除モードで実行されます。

  • unit —ファイル・サイズの表示に使用する単位を定義する。有効な値は、B(バイト)、K(キロバイト)、M(メガバイト)、G(ギガバイト)またはH(判読可能な形式でサイズを表示するもので、UNIXのls -hオプションに似ています)です。デフォルト値はHです。

  • fullTime — Jythonブール値。trueの場合は、ログ・ファイルの最終更新日時の全時間をレポートします。それ以外の場合、時間の短いバージョンを表示します。デフォルト値はfalseです。


次の例では、WebLogicドメインのすべてのログ・ファイルの一覧を表示します。

listLogs()

次の例では、WebLogic Server server1のログ・ファイルを一覧表示します。

listLogs(target="server1")

次の例では、Oracle HTTP Server ohs1用のログ・ファイルの一覧を表示します。

listLogs(target="opmn:instance1/ohs1")

接続解除モードで使用される次の例では、WebLogic Server server1のログ・ファイルを一覧表示します。

listLogs(oracleInstance="/middleware/user_projects/domains/base_domain",
           target="server1")

選択的トレース・コマンド

表7-4のコマンドを使用して、選択的トレースを構成および使用します。選択的トレースにより、指定されたユーザーまたはリクエストの他のプロパティに対するきめ細かいロギングを実行することができます。WLSTカラムで使用する場合は、オンラインとは、コマンドが実行中のサーバーに接続されている場合のみに使用されることを意味します。

表7-4 トレース・コマンド

コマンド 説明 WLSTの使用状況

configureTracingLoggers


選択的トレースに対する1つ以上のログ出力を構成します。

オンライン

listActiveTraces


アクティブなトレースを一覧表示します。

オンライン

listTracingLoggers


選択的トレースをサポートしているログ出力を一覧表示します。

オンライン

startTracing


選択的トレース・セッションを開始します。

オンライン

stopTracing


1つ以上の選択的トレース・セッションを停止します。

オンライン


configureTracingLoggers

コマンド・カテゴリ: トレース

WLSTの使用状況:オンライン

説明

選択的トレースに対する1つ以上のログ出力を構成します。このコマンドはまた、選択的トレースに対するログ出力を有効または無効にします。

構文

configureTracingLoggers([options])
引数 定義
options

オプションのカンマ区切りのリスト。名前と値のペアで指定します。有効なオプションは次のとおりです。

  • target—オプション。WebLogic Serverインスタンスの名前、または1つ以上のターゲット名を含む文字列の配列。デフォルトでは、ドメイン内の、JRFが有効なすべての実行中のサーバー・インスタンス上のログ出力がトレースに対して構成されます。

  • pattern —ログ機能名をフィルタするために使用する正規表現パターン。デフォルト値は、すべてのトレース・ログ出力名に一致します。

  • action---トレースに対するすべてのログ出力を有効または無効にします。有効な値は、enableおよびdisableです。このオプションは必須で、デフォルト値はありません。


次の例では、oracle.securityで始まるすべてのログ出力について選択的トレースを構成します。

configureTracingLoggers(pattern='oracle.security.*', action="enable")
Configured 62 loggers

次の例では、すべてのログ出力について選択的トレースを無効にします。

configureTracingLoggers(action="disable")
Configured 1244 loggers

listActiveTraces

コマンド・カテゴリ: トレース

WLSTの使用状況:オンライン

説明

アクティブなトレースを一覧表示します。

構文

listActiveTraces([options])
引数 定義
options

オプションのカンマ区切りのリスト。名前と値のペアで指定します。有効なオプションは次のとおりです。

  • target—オプション。WebLogic Serverインスタンスの名前、または1つ以上のターゲット名を含む文字列の配列。デフォルトでは、ドメイン内の、JRFが有効なすべての実行中のサーバー・インスタンス上のログ出力が一覧表示されます。


次の例では、アクティブなトレースを一覧表示します。

listActiveTraces()
-------------------------------------+----------+-----------+------+-----------+-----------
Trace ID                             |Attr. Name|Attr. Value| Level| Exp. Time |Description
-------------------------------------+----------+-----------+------+-----------+-----------
a9580e65-13c4-420b-977e-5ba7dd88ca7f |USER_ID   |user1      | FINE |           |           
a04b47f7-2830-4d80-92ee-ba160cdacf6b |USER_ID  | user2     | FINE |           |           

listTracingLoggers

コマンド・カテゴリ: トレース

WLSTの使用状況:オンラインまたはオフライン

説明

選択的トレースをサポートしているログ出力を一覧表示します。このコマンドは、ログ出力名およびそのトレース・ステータスの表を表示します。ステータスenabledは、すべてのサーバー上のトレースでログ出力が有効であることを意味します。ステータスdisabledは、すべてのサーバー上のトレースでログ出力が無効であることを意味します。ステータスmixedは、一部のサーバー上のトレースではログ出力が有効であり、他のサーバー上のトレースではログ出力が無効であることを意味します。

構文

listTracingLoggers([options])
引数 定義
options

オプションのカンマ区切りのリスト。名前と値のペアで指定します。有効なオプションは次のとおりです。

  • target—オプション。WebLogic Serverインスタンスの名前、または1つ以上のターゲット名を含む文字列の配列。デフォルトでは、ドメイン内の、JRFが有効なすべての実行中のサーバー・インスタンス上のログ出力が一覧表示されます。

  • pattern —ログ機能名をフィルタするために使用する正規表現パターン。デフォルト値は、すべてのトレース・ログ出力名に一致します。


次の例では、oracle.securityで始まるすべてのトレース・ログ出力を一覧表示します。

listTracingLoggers(pattern="oracle.security.*")
------------------------------------------------------------------+--------
Logger                                                            | Status 
------------------------------------------------------------------+--------
oracle.security                                                   | enabled
oracle.security.audit.logger                                      | enabled
oracle.security.jps.az.common.util.JpsLock                        | enabled
 .
 .
 .

startTracing

コマンド・カテゴリ: トレース

WLSTの使用状況:オンライン

説明

指定されたユーザーまたはDMSコンテキスト属性に対する新しい選択的トレース・セッションを、指定されたトレース・レベルで開始します。

構文

startTracing([options])
引数 定義
options

オプションのカンマ区切りのリスト。名前と値のペアで指定します。有効なオプションは次のとおりです。

  • target—オプション。WebLogic Serverインスタンスの名前、または1つ以上のターゲット名を含む文字列の配列。デフォルトでは、ドメイン内の、JRFが有効なすべての実行中のサーバー・インスタンス上のログ出力がトレースに含まれます。

  • traceId—オプション。トレース・セッションの識別子。traceIdが指定されない場合、コマンドは一意のtraceIdを生成します。

  • attrName—user引数が指定されない場合を除いて、オプション。有効な値は、USER _ID、APP、CLIENT_HOST、CLIENT_ADDR、composite_name、WEBSERVICE.name、WEBSERVICE_PORT.nameです。

  • attrValue—attrNameが指定された場合は必須。属性の値。

  • user—ユーザー名。このユーザーに関連付けられているメッセージが戻されます。これは、attrNameおよびAttrValueオプションを指定してUSER_IDを渡すことと同じです。

  • level—必須。トレース・レベル。このレベルは、有効なJavaまたはODLレベルであることが必要です。Oracle Fusion Middleware管理者ガイドの「ODL、Oracle WebLogic ServerおよびJava間のログ・レベルのマッピング」の表を参照してください。

  • desc—オプション。トレース・セッションの説明。


次の例では、user1に関連付けられているメッセージのトレースを開始し、情報のレベルをFINEに設定します。

startTracing(user="user1",level="FINE")
Started tracing with ID: 885649f7-8efd-4a7a-9898-accbfc0bbba3 

stopTracing

コマンド・カテゴリ: トレース

WLSTの使用状況:オンライン

説明

1つ以上の選択的トレース・セッションを停止します。

構文

stopTracing([options])
引数 定義
options

オプションのカンマ区切りのリスト。名前と値のペアで指定します。有効なオプションは次のとおりです。

  • target—オプション。WebLogic Serverインスタンスの名前、または1つ以上のターゲット名を含む文字列の配列。デフォルトでは、ドメイン内の、JRFが有効なすべての実行中のサーバー・インスタンス上のログ出力が操作に含まれます。

  • stopAll---アクティブなトレースをすべて停止するかどうかを決定するJythonブール値(0または1)。traceId、user、またはattrNameおよびattrValue引数が指定されていない場合は必須。デフォルト値は0(false)です。

  • traceId---停止するトレース・セッションの識別子。stopAll、user、またはattrNameおよびattrValue引数が指定されていない場合は必須。

  • attrName---有効な値は、USER _ID、APP、CLIENT_HOST、CLIENT_ADDR、composite_name、WEBSERVICE.name、WEBSERVICE_PORT.nameです。traceId、user、stopAll引数が指定されていない場合は必須。

  • attrValue---attrNameが指定された場合は必須。属性の値。

  • user---ユーザー名。このユーザーに関連付けられているすべてのトレース・セッションが停止されます。stopAll、traceId、またはattrNameおよびattrValue引数が指定されていない場合は必須。


次の例では、指定されたtraceIdを持つトレース・セッションを停止します。

stopTracing(traceId="a04b47f7-2830-4d80-92ee-ba160cdacf6b")
Stopped 1 traces

次の例では、すべてのトレース・セッションを停止します。

stopTracing(stopAll=1)
Stopped 1 traces