バックエンド パス グループの設定

パス グループは、バックエンド URL パスのプレフィックスに関して定義する Web サービス HTTP クライアント要求の名前付きグループです。
apmdevops102jp
パス グループ
は、バックエンド URL パスのプレフィックスに関して定義する Web サービス HTTP クライアント要求の名前付きグループです。
3
2
バックエンド パス グループの使用
各パス グループのメトリックは、Investigator メトリック ブラウザ ツリーの、
Backends|WebService at <
protocol
>_//<
host
>_<
port
>|Paths
ノードの下に集約されます。デフォルトでは、すべてのバックエンド URL パスは "default" グループに割り当てられます。パス グループを使用すると、バックエンドおよび診断のパフォーマンスの問題から呼び出されている要求の数を判断できます。
以下の例は、メトリック ブラウザ ツリーに表示される可能性がある 3 つのバックエンド URL パスを示しています。
Backends|WebService at http_//host_port|Paths|alphaHTTPClientPost
Backends|WebService at http_//host_port|Paths|betaHTTPClientGet
Backends|WebService at http_//host_port|Paths|Default
この例では、3 つのパス グループがどのようにエージェント プロファイルで定義されているかを示しています。
introscope.agent.backendpathgroup.keys=alphaHTTPClientPost,betaHTTPClientGet,default
introscope.agent.backendpathgroup.group.alphaHTTPClientPost.pathprefix=/testWar/helloWorld/alphaHTTPClientPost
introscope.agent.backendpathgroup.group.alphaHTTPClientPost.format=alphaHTTPClientPost
introscope.agent.backendpathgroup.group.betaHTTPClientGet.pathprefix=/testWar/helloWorld/betaHTTPClientGet
introscope.agent.backendpathgroup.group.betaHTTPClientGet.format=betaHTTPClientGet
introscope.agent.backendpathgroup.group.default.pathprefix=*
introscope.agent.backendpathgroup.group.default.format=Default
パス グループのキーの定義
エージェント プロファイル内の
introscope.agent.backendpathgroup.keys
区切り文字は、すべてのパス グループのキーのリストを定義します。パス グループのキーは、パス グループの属性を宣言するほかのプロパティ定義で参照されます。
introscope.agent.backendpathgroup.keys=alpha,beta,default
各エントリには、2 つのプロパティがあり、これはパスを定義して出力結果を以下のように照合します。
introscope.agent.backendpathgroup.group.[
Key
].pathprefix
introscope.agent.backendpathgroup.group.[
Key
].format
[
Key
] エントリは、指定されたプロパティの特定に使用されます。
[
Key
]
の値は、以下のように、キー プロパティに対応します。
introscope.agent.backendpathgroup.keys=key_one,key_two,key_three
introscope.agent.backendpathgroup.group.key_one.pathprefix
introscope.agent.backendpathgroup.group.key_one.format
introscope.agent.backendpathgroup.group.key_two.pathprefix
introscope.agent.backendpathgroup.group.key_two.format
introscope.agent.backendpathgroup.group.key_three.pathprefix
introscope.agent.backendpathgroup.group.key_thress.format
 複数のグループに分類されるパスをいくつか含んでいるパス グループを定義する場合は、プロパティでそのパス グループのキーをリストした順序が重要になります。絞り込んだメンバシップを持つパス グループは、幅広いメンバシップを持つパス グループに先行します。
各パス グループのメンバシップの定義
introscope.agent.backendpathgroup.group.default.pathprefix
プロパティは、パスのパス プレフィックスと照合するパターンを指定して、パス グループ内に含める要求を定義します。
例: パス プレフィックスに対するグループ キーのマッピング
以下のプロパティ定義では、パスのパス部分が
/testWar
で始まるすべての要求を、キーが
alphaHTTPClientPost
のパス グループに割り当てています。
introscope.agent.backendpathgroup.group.alphaHTTPClientPost.pathprefix=/testWar
たとえば、以下の要求は、指定した
パスのプレフィックス
と一致します。
http://backend.ca.com:1234/testWar/example/post.htm
pathprefix
プロパティでは、アスタリスク記号(*)をワイルドカードとして使用できます。
パス グループの名前の定義
introscope.agent.backendpathgroup.group.<key>.format
プロパティは、パスグループのレスポンス時間メトリックが生成される名前を決定します。
通常、
introscope.agent.backendpathgroup.group.<key>.format
プロパティは、テキスト文字列をパスの名前として割り当てるために使用されます。以下の例では、キー
alpha
を持つパス グループのメトリックが、
Alpha Group
という名前でメトリック ブラウザ ツリーに表示されます。
introscope.agent.backendpathgroup.group.alpha.format=Alpha Group
(オプション)パス グループの高度な名前付け手法
必要に応じて、パス グループ名を、プロトコルなどの要求エレメント、または要求パスのサブ文字列から派生させることができます。このセクションでは、i
ntroscope.agent.backendpathgroup.group.
<key>.format
プロパティの高度な形式について説明します。
パス グループ名に要求パスのサブ文字列を使用
パス グループの統計情報を要求パスのパス部分のサブ文字列を反映した名前でまとめることができます。
introscope.agent.backendpathgroup.group.<key>
.format
 を以下のように定義します。
introscope.agent.backendpathgroup.group.
alpha
.format=
{path_substring:
m
:
n
}
ここで、「
m
」は、最初の文字のインデックスで、「
n
」は、最後の文字のインデックス +1 です。文字列の選択は、
java.lang.String.substring()
 メソッドのように機能します。たとえば、以下の設定の場合:
introscope.agent.backendpathgroup.group.alpha.format=
{path_substring:0:3}
この URL を使用します。
http://www.buyitall.com/userid,sessionid/pageid
統計は次の下に表示されます:
/us
パスのグループ化は、URL のパス部分でのみ機能します。上記の例では
/testWar/helloWorld/alphaHTTPClientPost
です。
パス グループ名に要求パスの区切り文字列部分を使用
パス グループの統計情報を要求パスの文字区切りの部分を反映した名前でまとめるには、
format
パラメータを以下のように定義します。
introscope.agent.backendpathgroup.group.
alpha
.format=
{path_delimited:delim_char:m:n}
ここで、
delim_char
は、パス内のセグメントを区切る文字です。「
m
」 は、選択する最初のセグメントのインデックスです。「
n
」は、選択する最後のセグメントのインデックス +1 です。たとえば、以下のように設定されているとします。
introscope.agent.backendpathgroup.group.
alpha
.format={path_delimited:/:2:4}
以下の形式の要求に対する統計情報を考えます。
http://www.buyitall.com/userid,sessionid/pageid
これは、メトリック名
/pageid
で表示されます。
以下のルールに従います。
  • 区切り文字はセグメントとしてカウントされます。前の例では、区切り文字はスラッシュ(/)です。
  • セグメントのカウントは 0 から始まります。
  • パスのグループ化は、URL のパス部分でのみ機能します。前の例では、URL のパス部分は
    /userid,sessionid/pageid
     です
パスの例で、スラッシュ文字で区切られたセグメントを以下に示します。
0=
/
、1=
userid,sessionid
、2=
/
、および 3=
pageid
必要に応じて、複数の区切り文字を指定できます。たとえば、以下のように設定されているとします。
introscope.agent.backendpathgroup.group.
alpha
.format={path_delimited:/,:3:4}
上記の例の形式の要求に対する統計情報は、メトリック名
sessionid
の下に表示されます。パスの例でスラッシュおよびカンマで区切られたセグメントを以下に示します。
0=
/
、1=
userid
、2=„
3=
sessionid
、4=
/
、および 5=
pageid