コマンドライン Workstation の使用 › CLW コマンド リファレンス › トランザクション追跡セッションの開始 › List SNMP Collections › 出力

出力

トランザクション追跡の結果が、指定したファイルに出力されます。

コマンド オプション

このセクションでは、トランザクション追跡コマンドのオプションについて説明します。

追跡モード

CLW は、トランザクション追跡セッションの結果を、以下の 2 つのモードでキャプチャすることをサポートしています。

• 同期モード - デフォルトで、CLW はセッションの最後に、トランザクション イベント データベース、および TransactionTraceData-yyyyMMddhhmmss.xml という名前の単一の XML ファイルに、追跡結果を書き込みます。ファイル名の日付と時刻の文字列はセッションの開始日時を反映しています。
• 非同期モード - このモードでは、CLW は、各トランザクションの追跡結果を、レポート後すぐにトランザクション イベント データベース、およびそのトランザクション固有の XML ファイルに書き込みます。このファイルは、nnnn(sec)-TransactionTraceDatayyyyMMddhhmmss-<sequence number>.xml という名前で、nnnn は秒単位のトランザクションの存続期間、および日付と時刻の文字列はトランザクションの開始日時を反映しています。 自分でファイル名を付ける場合は、最後の「.」の前にシーケンス番号を追加します。 付けたファイル名に「.」が含まれない場合は、ファイル名の最後にシーケンス番号が付けられます。

同期モードで記録された結果は、すべてのデータが 1 つのファイルに含まれているので、簡単に表示できます。 ただし、セッションが終了するまでデータを表示することはできません。さらに、大量のトランザクション、または複雑なトランザクションの場合、同期キャプチャでは、多くのメモリを消費する可能性があります。

トランザクション データを非同期で記録すると、メモリの消費量が少なくなり、また、トランザクション追跡セッションが終了する前にトランザクション データを表示できます。

-Dintroscope.clw.tt.mode=(Synch|Asynch)

トランザクション イベント データベースのみへの出力

このオプションは、トランザクション追跡を実行し、その出力結果をトランザクション イベント データベースのみに保存する（XML ファイルには出力しない）場合に使用します。 このコマンドは、Introscope アラートがトリガされたときに、そのアラートによって自動的に追跡トランザクションを開始する場合に便利です。

以下のように、コマンドの最初に「quietly」を付けます。

quietly trace transactions exceeding 2 seconds in agents matching "(.*)" for 60 seconds

ヘッダ データのみの返還

場合によっては、CLW を使用して大量のトランザクション追跡データを抽出する際に、traces.db ファイルが際限なく大きくなる可能性があり、その結果、CLW が結果を返すのにかなりの時間がかかってしまうことがあります。 このプロパティを false に設定すると、Enterprise Manager が返すデータの量が減少するため、問題が解決します。

CLW は追跡データのヘッダ部分のみ返します。 デフォルトまたはこのプロパティを true に設定すると、CLW によって取得されるトランザクション追跡データには、ヘッダと本文両方が含まれます。

-Dwily.ps.workstation.clws.gettracebody

Transaction Tracer クランプ

デフォルトの設定では、個別のトランザクション追跡で抽出される追跡コンポーネントの数は 5000 までです。 そのサイズを超えるトランザクション追跡は、エージェントによって破棄され、以下のような警告メッセージがエージェント ログ ファイルに記録されます。

07/02/23 17:33:18 PST [WARN] [IntroscopeAgent] Transaction trace component limit of 5000 reached, recording will cease for this transaction.

トランザクション追跡で使用できるコンポーネントの最大数を変更するには、エージェント プロパティ

introscope.agent.transactiontrace.componentCountClamp=max_TT_components （デフォルトは 5000）を変更します。

たとえば、エージェントのプロファイルに以下の行があるとします。

introscope.agent.transactiontrace.componentCountClamp=30000

この行は、トランザクション追跡で使用できるコンポーネントの最大数を 30,000 に変更します。

警告： このクランプのサイズを大きくすると、トランザクション追跡に必要なメモリも増えるため、JVM の最大ヒープ サイズを適切に調整する必要が生じる場合があります。調整しないと、Enterprise Manager のメモリが不足する可能性があります。

トランザクション追跡コマンドの例

このセクションでは、トランザクション追跡セッションを開始する CLW コマンドの例を示します。 以下の例の各コマンドは、600 秒間のセッションを開始します。 すべてのエージェントからの 5 秒を超えるトランザクションが追跡されます。

注： 例のコマンドはすべて、デフォルトのログイン設定を使用して Enterprise Manager に接続します。

トランザクション追跡セッションを実行するスクリプトの例については、「サンプル スクリプト」を参照してください。

デフォルトのオプション値を使用したトランザクション追跡

以下の CLW コマンドは、以下のデフォルト設定を使用してトランザクション追跡セッションを開始します。

• 追跡モード - トランザクション追跡データは同期的にキャプチャされます。したがって、すべての結果は 1 つの XML ファイルに書き込まれます。
• ディレクトリの場所 - Dintroscope.clw.tt.dirname が指定されていない場合、追跡結果は現在の作業ディレクトリに書き込まれます。

  java -jar CLWorkstation.jar trace transactions exceeding 5 seconds in agents matching "(.*)" for 600 seconds
  

非同期キャプチャを使用したトランザクション追跡

以下の CLW コマンドは、セッションの出力にデフォルト ディレクトリの場所を使用するトランザクション追跡セッションを開始します。

java -Dintroscope.clw.tt.mode=Asynch -jar CLWorkstation.jar trace transactions exceeding 5 seconds in agents matching "(.*)" for 600 seconds

データは非同期でキャプチャされます。したがって、各トランザクションに対して個別の XML ファイルが作成されます。

ユーザ定義ディレクトリに書き込まれるトランザクション追跡結果

以下の CLW コマンドは、追跡モードのデフォルト設定（トランザクション追跡データを同期的にキャプチャする）を使用して、トランザクション追跡セッションを開始します。 したがって、すべての結果は 1 つの XML ファイルに書き込まれます。

java -Dintroscope.clw.tt.dirname=C:¥mytraces -jar CLWorkstation.jar trace transactions exceeding 5 seconds in agents matching "(.*)" for 600 seconds

このコマンドでは、XML ファイルにデフォルト以外のディレクトリ C:¥mytraces を指定しています。

パラメータとエラー フィルタを使用するトランザクション追跡

ユーザは、実行する秒数を指定し、Workstation で利用可能なものと同じフィルタを使用するトランザクション追跡セッションを開始することができます。それらのフィルタには、ユーザ ID、URL、URL クエリ、セッション ID、リクエスト ヘッダ、リクエスト パラメータ、セッション属性、およびエラーなどがあります。

ユーザ ID、URL、URL クエリ、またはセッション ID に基づくフィルタリング

trace transactions where (userid|url|url query|sessionid) (equals|not equals|contains|not contains|starts with|ends with) [完全一致] in agents matching [正規表現] for [完全一致] (second|seconds|sec|secs|s)
trace transactions where (userid|url|url query|sessionid) (exists|not exists) in agents matching [正規表現] for [完全一致] (second|seconds|sec|secs|s)
quietly trace transactions where (userid|url|url query|sessionid) (equals|not equals|contains|not contains|starts with|ends with) [完全一致] in agents matching [正規表現] for [完全一致] (second|seconds|sec|secs|s)
quietly trace transactions where (userid|url|url query|sessionid) (exists|not exists) in agents matching [正規表現] for [完全一致] (second|seconds|sec|secs|s)

リクエスト ヘッダ、リクエスト パラメータ、またはセッション属性に基づくフィルタリング

trace transactions where (request header|request parameter|session attribute) [完全一致] (equals|not equals|contains|not contains|starts with|ends with) [完全一致] in agents matching [正規表現] for [完全一致] (second|seconds|sec|secs|s)
trace transactions where (request header|request parameter|session attribute) [完全一致] (exists|not exists) in agents matching [正規表現] for [完全一致] (second|seconds|sec|secs|s)
quietly trace transactions where (request header|request parameter|session attribute) [完全一致] (equals|not equals|contains|not contains|starts with|ends with) [完全一致] in agents matching [正規表現] for [完全一致] (second|seconds|sec|secs|s)
quietly trace transactions where (request header|request parameter|session attribute) [完全一致] (exists|not exists) in agents matching [正規表現] for [完全一致] (second|seconds|sec|secs|s)

エラーに基づくフィルタリング

trace transactions with errors containing [完全一致] in agents matching [正規表現] for [完全一致] (second|seconds|sec|secs|s)
quietly trace transactions with errors containing [完全一致] in agents matching [正規表現] for [完全一致] (second|seconds|sec|secs|s)

トランザクション イベント データベース内のトランザクション追跡結果のクエリ

トランザクション追跡結果は、自動的にトランザクション イベント データベースに保存されます。 そのデータは、ここで説明する CLW コマンドで取得できます。

Get Historical Events Matching <値>

このコマンドは、トランザクション イベント データベースからフル イベント XML 出力ファイルを取得します。 フル イベント（以下のサマリ イベントに対して）は、トランザクション イベント ビューアの下部 3 分の 2 で利用できるフル データです。

java -Dintroscope.clw.tt.mode=Asynch -jar CLWorkstation.jar trace transactions get historical events matching "localhost"

出力例を以下に示します。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<TransactionTracerSession Duration="78" Version="0.1" EndDate="2005-06-20T17:40:24.146-08:00" StartDate="2005-06-20T17:40:24.068-08:00" User="Admin">
<TransactionTrace Domain="SuperDomain" Duration="78" Process="UnknownProcess" Host="maddleman-dt2" AgentName="Tomcat" StartDate="2005-06-20T17:40:24.068-08:00" EndDate="2005-06-20T17:40:24.146-08:00">
<CalledComponent RelativeTimestamp="0" Duration="78" ComponentType="Browser" ComponentName="Browser" MetricPath="Browser">
<CalledComponents>
<CalledComponent RelativeTimestamp="0" Duration="0" ComponentType="JNDI" ComponentName="ProxyDirContext" MetricPath="JNDI|Context|ProxyDirContext">
<Parameters>
<Parameter Value="lookup" Name="Method"/>
</Parameters>
</CalledComponent>
<CalledComponent RelativeTimestamp="0" Duration="0" ComponentType="JNDI" ComponentName="ProxyDirContext" MetricPath="JNDI|Context|ProxyDirContext">
<Parameters>
<Parameter Value="lookup" Name="Method"/>
</Parameters>
</CalledComponent>
<CalledComponent RelativeTimestamp="0" Duration="62" ComponentType="Servlets" ComponentName="HelloWorldExample" MetricPath="Servlets|HelloWorldExample">
<CalledComponents>
<CalledComponent RelativeTimestamp="0" Duration="0" ComponentType="JNDI" ComponentName="ProxyDirContext" MetricPath="JNDI|Context|ProxyDirContext">
<Parameters>
<Parameter Value="lookup" Name="Method"/>
</Parameters>
</CalledComponent>
<CalledComponent RelativeTimestamp="0" Duration="0" ComponentType="JNDI" ComponentName="ProxyDirContext" MetricPath="JNDI|Context|ProxyDirContext">
<Parameters>
<Parameter Value="lookup" Name="Method"/>
</Parameters>
</CalledComponent>
</CalledComponents>
</TransactionTrace>
</TransactionTracerSession>

Get Summaries Matching <VALUE>

このコマンドは、トランザクション イベント データベースからイベント サマリ XML のみを取得して、XML ファイルを出力します。 イベント サマリは、トランザクション イベント ビューアの上部ペインで利用できる情報です。 このコマンドは、たとえば、トランザクション イベント データベースからデータをエクスポートして、システムでその日に発生したエラー数についてのレポートを生成する場合に便利です。

get historical event summaries matching [正規表現]

出力例を以下に示します。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<TransactionTracerSession Duration="78" Version="0.1" EndDate="2005-06-20T17:40:24.146-08:00" StartDate="2005-06-20T17:40:24.068-08:00" User="Admin">
<TransactionTrace Domain="SuperDomain" Duration="78" Process="UnknownProcess" Host="maddleman-dt2" AgentName="Tomcat" StartDate="2005-06-20T17:40:24.068-08:00" EndDate="2005-06-20T17:40:24.146-08:00">
<CalledComponent RelativeTimestamp="0" Duration="78" ComponentType="Browser" ComponentName="Browser" MetricPath="Browser">
<Parameters>
<Parameter Value="" Name="URL"/>
<Parameter Value="Normal" Name="Trace Type"/>
<Parameter Value="¥20050620¥17¥1119314425302" Name="Trace ID"/>
<Parameter Value="" Name="User ID"/>
</Parameters>
</CalledComponent>
</TransactionTrace>
</TransactionTracerSession>

アプリケーション問題切り分けマップのコマンド

問題切り分けマップ アラートは、アプリケーション マップおよびアプリケーション マップ エンティティに関連付けられた特別なアラートです。 問題切り分けマップ アラートの格納場所は、TriageMapConfigurationsManagementModule.jar ファイルの Triage Map Configuration 管理モジュール内です。

以下のコマンドは、この管理モジュールで利用できます。

List Management Modules

Query State of Management Modules

List Triage Map Alerts

Query State of Management Modules

List Triage Map Entity Metric Groups

Query the State of Triage Map Entity Metric Groups

List Management Modules

このコマンドは、問題切り分けマップ管理モジュールの名前を一覧表示します。

構文

list management modules matching <正規表現>

例

list management modules matching (Triage Map.*)

このコマンドは、名前が Triage Map で始まる管理モジュールを一覧表示します。

出力

各管理モジュールの名前および状態が一覧表示されます。 この場合、Triage Map Configuration 管理モジュールは正規表現に一致し、以下のように一覧表示されます。

Triage Map Configurations

Query State of Management Modules

このコマンドは、問題切り分けマップ管理モジュールのステータスを一覧表示します。

構文

query state of management modules matching [正規表現]

例

query state of management modules matching (.*)

このコマンドは、すべての管理モジュールの名前と状態を返します。

出力

お使いのシステムについて設定された各管理モジュールの名前と状態を一覧表示します。 例：

Supportability:Active
Trade Application Definitions:Active
Triage Map Configurations:Active
Browser Response Time Adapter:Active
Sample:Active
MOM Infrastructure Monitoring:Active
Reports Unit Tests:Active
Collector - 1:Active
ChangeDetector:Active
CEM BT Stats:Active

List Triage Map Alerts

このコマンドは、問題切り分けマップ アラートを一覧表示します。

構文

list triage map alerts matching [正規表現] in management modules matching [正規表現]

例

list triage map alerts matching (.*) in management modules matching (Triage Map .*)

このコマンドは、名前が Triage Map で始まる管理モジュール内のすべての問題切り分けマップ アラートを一覧表示しようとします。

出力

システムで設定されたすべての問題切り分けマップ アラートの名前を一覧表示します。 例：

Triage Map Configurations.By Frontend|TradeService|Health:Average Response Time (ms)_Summary_MetricAlert
Triage Map Configurations.By Business Service|MedRecBS|loginAdmin.action|loginAdmin.action:Errors Per Interval_Summary_MetricAlert
Triage Map Configurations.By Frontend|ReportingService|Backend Calls|WebServices:Average Response Time (ms)_Location_MetricAlert
Triage Map Configurations.By Business Service|MedRecBS|viewNewlyRegisteredPatients.action|viewNewlyRegisteredPatients.action:Average Response Time (ms)_Location_MetricAlert
Triage Map Configurations.By Frontend|PatientFacadeServiceWebApp|Backend Calls|//localhost%9082/medrec(POINTBASE DB):Alert
Triage Map Configurations.By Frontend|ReportingEngine|Backend Calls|jdbc%hsqldb%file%report-records:Stall Count_Summary_MetricAlert
Triage Map Configurations.By Business Service|MedRecBS|viewNewlyRegisteredPatients.action|viewNewlyRegisteredPatients.action:Stall Count_Location_MetricAlert
Triage Map Configurations.Business Service|MedRecBS|Business Transactions|home.action:Alert
Triage Map Configurations.By Frontend|/medrec|Health:Errors Per Interval_Location_MetricAlert
Triage Map Configurations.Business Service|Trading Service|Business Transactions|View Orders:Total Defects Per Interval_Summary_MetricAlert
Triage Map Configurations.By Frontend|AuthenticationService|Health:Errors Per Interval_Summary_MetricAlert
Triage Map Configurations.By Business Service|Trading Service|Options Trading|Check Options:Concurrent Invocations_Summary_MetricAlert
Triage Map Configurations.By Business Service|MedRecBS|index.action|index.action:Stall Count_Location_MetricAlert
Triage Map Configurations.By Business Service|MedRecBS|index.action|index.action:Concurrent Invocations_Summary_MetricAlert
Triage Map Configurations.Business Service|MedRecBS|Business Transactions|viewPatients.action:Total Defects Per Interval_Summary_MetricAlert
Triage Map Configurations.By Business Service|MedRecBS|index.action|index.action:Average Response Time (ms)_Summary_MetricAlert

Query State of Management Modules

このコマンドは、問題切り分けマップ アラートのステータスを一覧表示します。

構文

query state of triage map alerts matching [正規表現] in management modules matching [正規表現]

例

query state of triage map alerts matching (.*) in management modules matching (Triage Map .*)

このコマンドは、名前が Triage Map で始まる管理モジュール内のすべての問題切り分けマップ アラートとその状態を一覧表示します。

出力

システムで設定されたすべての問題切り分けマップ アラートの名前と状態を一覧表示します。 例：

Triage Map Configurations.By Frontend|TradeService|Health:Average Response Time (ms)_Summary_MetricAlert:Active
Triage Map Configurations.By Business Service|MedRecBS|loginAdmin.action|loginAdmin.action:Errors Per Interval_Summary_MetricAlert:Active
Triage Map Configurations.By Frontend|ReportingService|Backend Calls|WebServices:Average Response Time (ms)_Location_MetricAlert:Active
Triage Map Configurations.By Business Service|MedRecBS|viewNewlyRegisteredPatients.action|viewNewlyRegisteredPatients.action:Average Response Time (ms)_Location_MetricAlert:Active
Triage Map Configurations.By Frontend|PatientFacadeServiceWebApp|Backend Calls|//localhost%9082/medrec(POINTBASE DB):Alert:Active
Triage Map Configurations.By Frontend|ReportingEngine|Backend Calls|jdbc%hsqldb%file%report-records:Stall Count_Summary_MetricAlert:Active
Triage Map Configurations.By Business Service|MedRecBS|viewNewlyRegisteredPatients.action|viewNewlyRegisteredPatients.action:Stall Count_Location_MetricAlert:Active
Triage Map Configurations.Business Service|MedRecBS|Business Transactions|home.action:Alert:Active
Triage Map Configurations.By Frontend|/medrec|Health:Errors Per Interval_Location_MetricAlert:Active
Triage Map Configurations.Business Service|Trading Service|Business Transactions|View Orders:Total Defects Per Interval_Summary_MetricAlert:Active
Triage Map Configurations.By Frontend|AuthenticationService|Health:Errors Per Interval_Summary_MetricAlert:Active
Triage Map Configurations.By Business Service|Trading Service|Options Trading|Check Options:Concurrent Invocations_Summary_MetricAlert:Active
Triage Map Configurations.By Business Service|MedRecBS|index.action|index.action:Stall Count_Location_MetricAlert:Active

List Triage Map Entity Metric Groups

このコマンドは、問題切り分けマップ エンティティ メトリック グループの名前を一覧表示します。

構文

list triage map entity metric groups matching [正規表現] in management modules matching [正規表現]

例

list triage map entity metric groups matching (.*) in management modules matching (Triage Map .*)

このコマンドは、名前が Triage Map で始まる管理モジュール内のすべての問題切り分けマップ エンティティ グループを一覧表示します。

出力

システムで設定されたすべての問題切り分けマップ エンティティ グループの名前と状態を一覧表示します。 例：

Triage Map Configurations.By Frontend|/medrec|Health:Average Response Time (ms)_Summary
Triage Map Configurations.By Frontend|AuthenticationEngine|Health:Average Response Time (ms)_Summary
Triage Map Configurations.Business Service|MedRecBS|Business Transactions|index.action:Total Defects Per Interval_Summary
Triage Map Configurations.By Business Service|Trading Service|View Orders|View my order:Concurrent Invocations_Location
Triage Map Configurations.By Frontend|PatientFacadeServiceWebApp|Health:Errors Per Interval_Summary
Triage Map Configurations.By Business Service|Trading Service|Transaction Summary|Request Transaction Summary:Average Response Time (ms)_Summary
Triage Map Configurations.By Frontend|ReportingEngine|Health:Errors Per Interval_Summary
Triage Map Configurations.By Business Service|Trading Service|Options Trading|Check Options:Errors Per Interval_Summary
Triage Map Configurations.By Frontend|AuthenticationEngine|Backend Calls|jdbc%hsqldb%file%customer-records:Average Response Time (ms)_Summary
Triage Map Configurations.By Frontend|OrderEngine|Health:Average Response Time (ms)_Location
Triage Map Configurations.Business Service|MedRecBS|Business Transactions|viewPatients.action:Total Transactions Per Interval_Summary
Triage Map Configurations.By Business Service|Trading Service|Options Trading|Check Options:Stall Count_Summary

Query the State of Triage Map Entity Metric Groups

このコマンドは、問題切り分けマップ エンティティ メトリック グループのステータスを一覧表示します。

構文

query state of triage map entities matching [正規表現] in management modules matching [正規表現]

例

query state of triage map entities matching (.*) in management modules matching (Triage Map .*)

このコマンドは、名前が Triage Map で始まる管理モジュール内のすべての問題切り分けマップ エンティティとその状態を一覧表示しようとします。

出力

システムで設定されたすべての問題切り分けマップ エンティティの名前を一覧表示します。 例：

Triage Map Configurations.By Frontend|OrderEngine|Backend Calls:Active
Triage Map Configurations.By Business Service|MedRecBS|viewRecordSummary.action|kmuerxnjasdfgdfhjwerhgiusadfoiuoherg:Active
Triage Map Configurations.By Frontend|/medrec|Backend Calls|System localhost on port 9082:Active
Triage Map Configurations.By Business Service|MedRecBS|viewPatient.action|viewPatient.action:Active
Triage Map Configurations.By Frontend|Apache-Axis:Active
Triage Map Configurations.By Business Service|Trading Service:Active
Triage Map Configurations.By Business Service|Trading Service|Balances:Active
Triage Map Configurations.By Frontend|AuthenticationEngine:Active
Triage Map Configurations.By Frontend|AuthenticationService|Backend Calls|WebServices:Active
Triage Map Configurations.By Frontend|AuthenticationService|Health:Active
Triage Map Configurations.By Business Service|MedRecBS|viewRecordSummary.action:Active
Triage Map Configurations.By Business Service|MedRecBS|viewNewlyRegisteredPatients.action|kmuerxnjasdfgdfhjwerhgiusadfoiuoherg:Active
Triage Map Configurations.By Business Service|Trading Service|Place Order:Active
Triage Map Configurations.Business Service|Trading Service|Business Transactions|Login:Active
Triage Map Configurations.Business Service|MedRecBS|Business Transactions|index.action:Active