| Oracle® Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス 11gリリース2 (11.1.2.2.0) B71704-04 |
|
 前 |
 次 |
| Oracle® Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス 11gリリース2 (11.1.2.2.0) B71704-04 |
|
前 |
次 |
ロギング・コマンドを使用して、ログ・ファイルの設定を構成、およびログ・ファイルを表示および検索します。表7-1では、ロギング・コマンドの各種カテゴリを説明します。
ログ・ファイルの構成および検索の詳細は、Oracle Fusion Middleware管理者ガイドのログ・ファイルと診断データの管理に関する項を参照してください。
|
注意: これらのロギング・カスタムWLSTコマンドを使用するには、Oracle共通ホームからWLSTスクリプトを呼び出す必要があります。Oracle Fusion Middleware管理者ガイドのカスタムWLSTコマンドの使用に関する項を参照してください。 |
表7-1 ロギング・コマンドのカテゴリ
| コマンド・カテゴリ | 説明 |
|---|---|
|
|
ファイルに書き込まれる情報レベルやファイルの最大サイズなどのログ・ファイルの設定を構成します。 |
|
|
Oracle Fusion Middlewareログ・ファイルを表示し、特定のメッセージのログ・ファイルを検索します。 |
|
|
選択的トレースを構成および使用します。選択的トレースでは、メッセージが特定のサーバー、ロガーまたはユーザーについてトレースされることが指定されます。 |
表7-2のコマンドを使用して、ファイルに書き込まれる情報レベルやファイルの最大サイズなどのログ・ファイルの設定を構成します。WLST列で使用する場合は、オンラインとは、コマンドが実行中のサーバーに接続されている場合のみに使用されることを意味します。オフラインとは、コマンドが実行中のサーバーに接続されてない場合のみに使用されることを意味します。オンラインまたはオフラインとは、コマンドは両方の状況に使用できることを意味します。
表7-2 ロギング構成のコマンド
| このコマンドを使用します... | 次を行うには... | WLSTの使用... |
|---|---|---|
|
|
既存のログ・ハンドラを構成し、新しいハンドラを追加または既存ハンドラを削除します。 |
オンライン |
|
|
指定したロガーのレベルを取得します。 |
オンライン |
|
|
ロガーの一覧および各ロガーのレベルを取得します。 |
オンライン |
|
|
1つまたは複数のログ・ハンドラの構成を示します。 |
オンライン |
|
|
指定したロガーのレベルを設定します。 |
オンライン |
コマンド・カテゴリ: ログ構成
WLSTでの使用: オンライン
既存のJavaロギング・ハンドラを構成し、新しいハンドラを追加、既存のハンドラを削除します。ハンドラごとに1つのエントリを持つjava.util.Listを返します。各エントリは、ハンドラを記述するjavax.management.openmbean.CompositeDataオブジェクトです。
このコマンドを使用して、ログ・ファイルの場所、ログ・ファイルのローテーション頻度および他のログ・ファイルのプロパティを変更できます。
configureLogHandler(options)
| 引数 | 定義 |
|---|---|
options
|
オプションのカンマ区切りのリスト。名前と値のペアで指定します。有効なオプションは次のとおりです:
|
options (continued)
|
|
次の表では、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")
コマンド・カテゴリ: ログ構成
WLSTでの使用: オンライン
getLogLevel(options)
| 引数 | 定義 |
|---|---|
options
|
オプションのカンマ区切りのリスト。名前と値のペアで指定します。有効なオプションは次のとおりです:
|
コマンド・カテゴリ: ログ構成
WLSTでの使用: オンライン
Javaロガーおよびそれらのレベルを示します。このコマンドは、キーはロガー名であり、関連付けられた値はロガー・レベルであるPyDictionaryオブジェクトを返します。空のレベルは、ロガーにレベル・セットはないことを示すために使用されます。
listLoggers([options])
| 引数 | 定義 |
|---|---|
options
|
オプションのカンマ区切りのリスト(オプション)。名前と値のペアで指定します。有効なオプションは次のとおりです:
|
コマンド・カテゴリ: ログ構成
WLSTでの使用: オンライン
Javaログ・ハンドラ構成を示します。このコマンドは、ハンドラごとに1つのエントリを持つjava.util.Listを返します。各エントリは、ハンドラを記述するjavax.management.openmbean.CompositeDataオブジェクトです。
listLogHandlers([options])
| 引数 | 定義 |
|---|---|
options
|
オプションのカンマ区切りのリスト(オプション)。名前と値のペアで指定します。有効なオプションは次のとおりです:
|
コマンド・カテゴリ: ログ構成
WLSTでの使用: オンライン
setLogLevel(options)
| 引数 | 定義 |
|---|---|
options
|
オプションのカンマ区切りのリスト。名前と値のペアで指定します。有効なオプションは次のとおりです:
|
次の例では、ロガー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の使用... |
|---|---|---|
|
|
1つまたは複数のログを表示します。 |
オンラインまたはオフライン |
|
|
ログ・ファイルの内容を検索し、表示します。 |
オンラインまたはオフライン |
コマンド・カテゴリ: 検索および表示
WLSTでの使用: オンラインまたはオフライン
診断ログ・ファイルの内容を検索し、表示します。コマンドは、returnDataオプションをtrueに設定した場合のみ値を返します。デフォルトでは、このコマンドによってデータは返されません。戻り値は使用するオプションによって異なります。
displayLogs([searchString,][options])
| 引数 | 定義 |
|---|---|
searchString
|
オプションの検索文字列。指定した文字列(大文字と小文字は区別されない)を含むメッセージのみが返されます。 displayLogsコマンドでは、複数のフォーマットでログを読み込むことができ、ODLフォーマットにメッセージを変換できます。検索は、できるだけネイティブ・フォーマットで実行されます。それ以外の場合、検索がメッセージ・コンテンツ内に実行され、マークアップを除外する場合もあります。したがって、検索文字列でマークアップ文字の使用を避ける必要があります。 |
options
|
オプションのカンマ区切りのリスト(オプション)。名前と値のペアで指定します。有効なオプションは次のとおりです:
|
options (continued)
|
|
options (continued)
|
|
次の例では、ドメインのすべてのログ・ファイルから最後の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")
コマンド・カテゴリ: 検索および表示
WLSTでの使用: オンラインまたはオフライン
Oracle Fusion Middlewareコンポーネントのログ・ファイルの一覧を表示します。このコマンドは、ログごとに1つの要素を含むPyArrayを返します。配列の要素は、各ログを記述するjavax.management.openmbean.CompositeDataオブジェクトです。
listLogs([options]
| 引数 | 定義 |
|---|---|
options
|
オプションのカンマ区切りのリスト(オプション)。名前と値のペアで指定します。有効なオプションは次のとおりです:
|
次の例では、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の使用... |
|---|---|---|
|
|
選択的トレースに対する1つ以上のロガーを構成します。 |
オンライン |
|
|
アクティブなトレースを一覧表示します。 |
オンライン |
|
|
選択的トレースをサポートしているロガーを一覧表示します。 |
オンライン |
|
|
選択的トレース・セッションを開始します。 |
オンライン |
|
|
1つ以上の選択的トレース・セッションを停止します。 |
オンライン |
コマンド・カテゴリ: トレース
WLSTでの使用: オンライン
configureTracingLoggers([options])
| 引数 | 定義 |
|---|---|
options
|
オプションのカンマ区切りのリスト。名前と値のペアで指定します。有効なオプションは次のとおりです:
|
コマンド・カテゴリ: トレース
WLSTでの使用: オンライン
listActiveTraces([options])
| 引数 | 定義 |
|---|---|
options
|
オプションのカンマ区切りのリスト。名前と値のペアで指定します。有効なオプションは次のとおりです:
|
次の例では、アクティブなトレースを一覧表示します。
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 | |
コマンド・カテゴリ: トレース
WLSTでの使用: オンラインまたはオフライン
選択的トレースをサポートしているロガーを一覧表示します。このコマンドは、ロガー名およびそのトレース・ステータスの表を表示します。ステータスenabledは、すべてのサーバー上のトレースでロガーが有効であることを意味します。ステータスdisabledは、すべてのサーバー上のトレースでロガーが無効であることを意味します。ステータスmixedは、一部のサーバー上のトレースではロガーが有効であり、他のサーバー上のトレースではロガーが無効であることを意味します。
listTracingLoggers([options])
| 引数 | 定義 |
|---|---|
options
|
オプションのカンマ区切りのリスト。名前と値のペアで指定します。有効なオプションは次のとおりです:
|
次の例では、oracle.securityで始まるすべてのトレース・ロガーを一覧表示します。
listTracingLoggers(pattern="oracle.security.*")
------------------------------------------------------------------+--------
Logger | Status
------------------------------------------------------------------+--------
oracle.security | enabled
oracle.security.audit.logger | enabled
oracle.security.jps.az.common.util.JpsLock | enabled
.
.
.
コマンド・カテゴリ: トレース
WLSTでの使用: オンライン
startTracing([options])
| 引数 | 定義 |
|---|---|
options
|
オプションのカンマ区切りのリスト。名前と値のペアで指定します。有効なオプションは次のとおりです:
|
コマンド・カテゴリ: トレース
WLSTでの使用: オンライン
stopTracing([options])
| 引数 | 定義 |
|---|---|
options
|
オプションのカンマ区切りのリスト。名前と値のペアで指定します。有効なオプションは次のとおりです:
|
