合成トランザクションの検出の設定

合成トランザクションの監視設定は、introscope.agent.synthetic.header.names パラメータを使用して行います。

introscope.agent.synthetic.header.names パラメータの値には、監視対象の HTTP 要求が合成トランザクションの一部かどうかを判断するために使用する HTTP ヘッダパラメータをリストします。個々のパラメータ名はカンマで区切ります。このパラメータが未定義、または値が空の場合、合成トランザクションは検出されません。複数の HTTP ヘッダパラメータ名が定義されている場合、指定された順に検査されます。値を持つ最初の HTTP パラメータは、合成トランザクションを定義するために使用されます。

合成トランザクションがレポートされるノードは、以下のように、各トランザクションの検出に使用される特定の HTTP ヘッダパラメータに応じて異なります。

パラメータ値が lisaframeid または x-wtg-info 以外の場合は、HTTP パラメータの値自体がノード名として使用されます。有効なノード名が使用されるよう、適切な変更を行います。
パラメータ値が lisaframeid の場合、合成ノード名は CA LISA になります。
パラメータ値が x-wtg-info の場合、HTTP ヘッダパラメータの値には名前と値の組み合わせが使用されます。ペアは、アンパサンド記号で区切られます。各ペアの属性名と値は、等号で区切られます。合成トランザクションノード名は、group、name、ipaddress、request_id の値とノード区切り記号（|）で構成されます。

たとえば、以下のパラメータについて考えてみます。

introscope.agent.synthetic.header.names=Synthetic_Transaction,x-wtg-info,lisaframeid

以下の x-wtg-info ヘッダが、［SampleGroup|sample|192.168.193.1|start］ノードの下のメトリックにレポートされます。

clear synthetic=true&instance=ewing&name=sample&group=SampleGroup&version=4.1.0&ipaddress=192.168.193.1&sequencenumber=1&request_id=start&executiontime=1226455047

x-wtg-info HTTP ヘッダパラメータ値で定義されていない属性のデフォルト値は、以下のとおりです。

group=unknownGroup
name=unknownScript
ipaddress=0.0.0.0
request_id=Action

introscope.agent.synthetic.header.names が定義されていない場合、以下の設定パラメータは無視されます。

introscope.agent.synthetic.node.name=Synthetic Users

トランザクションが合成と認識されたノードにレポートされます。このノードは Frontends|Apps|<WebAppName> の下にあります。ここで <WebAppName> は Web アプリケーション名です。この値のデフォルトは、Synthetic Users です。

introscope.agent.non.synthetic.node.name=Real Users

トランザクションが合成と認識されていないノードにレポートされます。このノードは Frontends|Apps|<WebAppName> の下にあります。ここで <WebAppName> は Web アプリケーション名です。定義されていない場合、<WebAppName> の下に追加のノードは作成されません。

introscope.agent.synthetic.user.name=Synthetic_Trace_By_Vuser

値が合成ユーザ名として使用されている HTTP ヘッダパラメータの名前です。合成ユーザ名は、異なる合成トランザクションを区切るために使用されます。各合成ユーザ名のノードは、Synthetic User ノードの下に作成されます。この設定パラメータが定義され、この名前の HTTP ヘッダパラメータが存在する場合、合成トランザクションメトリックがレポートされます。トランザクションがレポートされるノードは、<Synthetic Users>|<Synthetic User> です。

<Synthetic Users> ノード名は、introscope.agent.synthetic.node.name 設定パラメータによって決定されます。
<Synthetic User> ノード名は、HTTP ヘッダパラメータ値によって決定されます。

注：これらのプロパティへの変更はただちに有効になります。管理対象アプリケーションを再起動する必要はありません。