メトリックグループの構成

メトリックグループは以下の情報を保存する管理モジュールオブジェクトです。

エージェント一致パターン -- エージェント名の一部またはすべてを含むデータを指定することにより、メトリックへの入力をフィルタする Perl 5 の正規表現。
メトリック一致パターン -- リソース（メトリックに至るまでの一連のフォルダ）およびメトリックを指定する Perl 5 の正規表現。
メトリックグループが属する管理モジュール。

メトリックグループの例

サポータビリティ管理モジュールからのこの例を説明します。 ディスク使用状況（mb）メトリックグループは、次を使用します。

メトリックグループエージェント一致パターン：

(.*)¥|Custom Metric Process ¥(Virtual¥)¥|(.*)

メトリック一致パターン子：

Enterprise Manager¥|Data Store¥|(.*)Disk Usage ¥(mb¥)

メトリックグループ用の一致パターンの指定

これらのフィールドに情報を指定するには、Perl 5 の正規表現言語を使用してその情報を入力するか、Investigator のメトリックとエージェントを選択してこれらのフィールドにドラッグします。

エージェント記述子は、管理モジュール単位で定義できます。このようにして定義したエージェント記述子は、管理モジュール内のメトリックグループにも適用されます。

デフォルトでは、どのメトリックグループでも、メトリックグループ別のエージェント一致パターンを使用してエージェントの検索が行われます。または、管理モジュール別のエージェント一致パターンを使用する場合は、メトリックグループの設定ペインで、そのためのオプションを選択する必要があります。このオプションを選択した場合は、管理モジュールのエージェント一致パターンが変更されたときに、検索されるエージェントが自動的に変わります。

メトリック名の構造

メトリックの完全修飾名は、以下のようになっています。

Domain|Hostname|Process|AgentName|Resource:Metric

たとえば、いずれか 1 つのリソースに含まれているメトリックの完全修飾名は、以下のようになります。

Acme|c1737019-a|AcmeUSA|AcmeWest|GC Heap:Bytes In Use

メトリックの上位にリソースが 2 つ存在する場合は、以下のような名前になります。

Acme|c1737019-a|AcmeUSA|AcmeWest|Servlets|FileServlet:Responses Per Second

リソースの階層がさらに深い場合は、各リソースがパイプ文字（|）で区切られます。

メトリック名の構造の詳細については、「変数の使用」を参照してください。

注：スーパードメイン以外のドメインのユーザに対しては、以下の構文のように、ドメイン情報のないメトリック名が表示されます。Hostname|Process|AgentName|Resource:Metric 例：

c1737019|AcmeUSA|AcmeWest|GC Heap:Bytes In Use

新しいメトリックグループの作成

以下の操作を行うことができます。

注：新しく作成した管理モジュールエレメントでは、作成して保存した直後に履歴の時間範囲を使用してデータを表示しようとすると、データが正しく表示されないことがあります。正しい履歴データを表示させるには、数分待つ必要があります。

メトリック名でマルチバイト文字を使用する際の注意事項

エージェントによってキャプチャされたデータはローカライズされません。したがって、ロケール設定がマルチバイトのマシンでは、メトリックがマルチバイト文字で作成されている場合でも、ブラウズツリーのメトリック名はマルチバイト文字では表示されません。この問題を回避するには、英字を使用して、メトリックを作成してください。

既存のメトリックからの新しいメトリックグループの作成

既存のメトリックから新しいメトリックグループを作成する方法

メトリックを右クリックし、メニューから［メトリック「<メトリック名>」からメトリックグループを新規作成］を選択します。
デフォルトのメトリックグループ名はそのままにしておきます。
メトリックグループを含める管理モジュールを、以下のいずれかの方法で選択します。
- ドロップダウンリストから管理モジュールを選択します。
- ［選択］をクリックして、リストから管理モジュールを選択し、再び［選択］をクリックします。
［OK］をクリックします。
作成した新しいメトリックグループが、管理モジュールエディタツリー内（保存先に指定した管理モジュールの下）で強調表示されます。

注：このメトリックグループは、作成時点ですでにアクティブであり、非アクティブにすることはできません。

メトリックグループの設定ペインで、メトリックグループの［エージェント一致パターン］フィールドおよび［メトリック一致パターン］フィールドには、すでにメトリック情報が含まれています。

エージェント名に基づくフィルタには、プロパティintroscope.agent.perfmon.agentExpression が使用されます。有効なエージェント一致パターンは、以下のようになります。
```
ProcessName|AgentName 
```
または
```
*|MyAgent
```
［説明］タブを選択し、メトリックグループに関する説明テキストと重要な情報を［説明テキスト］フィールドに入力します。
このフィールドには最大 64 KB のデータを入れられます。このデータは、適用後、管理モジュールの jar ファイルに保持されます。
以下のいずれかの操作を行って、使用するエージェント一致パターンを選択します。
- 管理モジュールに対して定義されたエージェント一致パターンを使用する場合は、［管理モジュールエージェント一致パターンを使用］を選択します。
- 現在のメトリックグループに対して定義されたエージェント一致パターンを使用する場合は、［メトリックグループエージェント一致パターンを使用］を選択します。
［適用］をクリックします。

［エレメント］メニューでの新しいメトリックグループの作成

［エレメント］メニューから新しいメトリックグループを作成する方法

Workstation のいずれかのウィンドウで、［Workstation］ > ［管理モジュールエディタ］を順に選択します。
管理モジュールエディタウィンドウで、［エレメント］-［メトリックグループを新規作成］を選択します。
［名前］フィールドに、メトリックグループ名を入力します。
メトリックグループを含める管理モジュールを、以下のいずれかの方法で選択します。
- ドロップダウンリストから管理モジュールを選択します。
- ［選択］をクリックして、リストから管理モジュールを選択し、再び［選択］をクリックします。
［OK］をクリックします。
作成したメトリックグループが Investigator ツリー内で強調表示され、そのメトリックグループの設定内容が設定ペインに表示されます。

注：このメトリックグループは、作成時点ですでにアクティブであり、非アクティブにすることはできません。
［メトリックグループエージェント一致パターン］フィールドと［メトリック一致パターン］フィールドに、エージェントとメトリックを特定する情報を入力します。
情報は、以下のいずれかの方法で入力できます。
- 正規表現を使用して、その情報を入力します。
- 別の Investigator ウィンドウを開いて、メトリックを選択し、元のメトリックグループのウィンドウにドラッグします。このとき、以下のように、［メトリックグループエージェント一致パターン］フィールドと［メトリック一致パターン］フィールドの周囲に青色の線が表示されます。
ドラッグした項目をここでドロップすると、選択したメトリックの情報が、［メトリックグループエージェント一致パターン］フィールドと［メトリック一致パターン］フィールドに自動的に入力されます。
以下のいずれかの操作を行って、使用するエージェント一致パターンを選択します。
- 管理モジュールに対して定義されたエージェント一致パターンを使用する場合は、［管理モジュールエージェント一致パターンを使用］を選択します。
- ［メトリックグループエージェント一致パターンを使用］を選択し、このメトリックグループに定義したエージェント記述子を使用します。
［適用］をクリックします。

メトリックグループへの別のメトリックの追加

既存のメトリックグループに別のメトリックを追加する方法

メトリックグループの設定ペインで、［追加］をクリックします。
追加のメトリックの情報を指定するための、［エージェント一致パターン］/［メトリック一致パターン］という 1 対のフィールドが追加されます。
別の Investigator ウィンドウを開きます。
後から開いた Investigator ウィンドウで、メトリックグループに追加するメトリックを選択します。次に、そのメトリックを元のウィンドウの設定ペインにドラッグします。ここでは［メトリックグループエージェント一致パターン］フィールドにドロップしてください。
2 番目の Investigator ウィンドウで同じメトリックをもう一度選択し、［メトリック一致パターン］フィールドにドラッグします。

メトリックグループのカスタマイズ

データのドラッグアンドドロップで得られる情報よりもカスタム化された情報を設定する必要がある場合は、メトリックグループの正規表現をカスタマイズできます。これを行うには、［メトリックグループエージェント一致パターン］フィールドと［メトリック一致パターン］フィールドの内容を編集して、検索するメトリックを指定します。

メトリックグループをカスタマイズする方法

定義を編集するには、以下のルールに従ってください。
- Investigator ツリーの一連の階層を指定するときは、円記号を前に付けたパイプ記号で階層間を区切ります。円記号はエスケープ文字の役割を果たします。
  - Investigator ウィンドウ例（［メトリックグループエージェント一致パターンを使用］フィールドの構文）： Host¥|Process¥|AgentName
- 任意の 1 つのリソースセグメントを指定するときは、([^¥|:]*) を使用します。
  - 例： Servlets¥|([^¥|:]*):Average Response Time ¥(ms¥)
- エスケープ文字（円記号）を、区切り文字と丸かっこに付加する必要があります。¥|、¥ （、および ¥）の形で使用します。
  - 例： Servlets¥|Servlet1:Average Response Time ¥(ms¥)
- 1 つの記述子で複数の一致条件を表すには、複数の文字列をパイプ文字で区切って並べたリストを、丸かっこで囲みます。
  - 例： Servlets¥|Servlet(1|14|18):Average Response Time ¥(ms¥)
- エージェント名とメトリックの間にリソースフォルダがない場合は、メトリック名のみを入力します。それ以外の場合は、円記号を前に付けたパイプ記号で各リソースフォルダを区切り、さらにメトリック名の前にコロン（:）を挿入します。
  - 例（［メトリック一致パターン］フィールドの構文）： resource¥|subresource:Metric
  - 例（［メトリック一致パターン］フィールドの構文）： resource:Metric
  - 例（［メトリック一致パターン］フィールドの構文）： Metric
  たとえば、OptionReport というサーブレットの平均 JDBC クエリ時間を［メトリック一致パターン］フィールドに指定する場合は、「Servlets¥|OptionReport¥|JDBC:Average Query Time」と入力します。
- すべての文字列を指定するときは、「(.*)」を使用します。
  - たとえば、「Cherubim¥|PhoneHome¥|(.*)」と入力し、さらに「Sockets:Output Bandwidth」と入力した場合には、ホスト Cherubim で実行中のプロセス PhoneHome のインスタンスの各ソケットの出力帯域幅を、インスタンスを限定しないで指定したことになります。
  - ［メトリック一致パターン］フィールドに「File System:(.*)」と入力した場合、これによって表示対象になるデータは、Investigator の［ファイルシステム］フォルダにあるファイル入力メトリックとファイル出力メトリックです。一方、「File System:File Input Rate」と入力すると、表示対象はファイル入力速度のみになります。
  - メトリックグループを使用して表示するデータのサーバ、プロセス、およびエージェントを限定しないときは、［エージェント］フィールドに「(.*)¥|(.*)¥|(.*)」と指定します。それ以外の場合は、この文字列の一部またはすべての代わりに特定のホスト名、プロセス名、エージェント名、またはこれらの組み合わせを指定すると、それに一致するエージェントを検索できます。
必要に応じ、［追加］をクリックしてメトリックグループに追加するメトリックを指定します。
［適用］をクリックします。