メトリック定義でのワイルドカードの使用
関連ページ：
カスタムのダッシュボードウィジェットまたは正常性ルールでは、ワイルドカードを使用して、複数のハードウェアエンティティやメモリプールなど、複数のエンティティにまたがって評価するメトリックを指定できます。
メトリック階層のモバイル、Hardware Resources、JVM、CLR の各ブランチ内のメトリックと、「拡張機能とカスタムメトリック」で説明されているモニタリング拡張機能を使用して作成されたカスタムメトリックは、ワイルドカード機能に対応しています。
ワイルドカードを使用するには、以下を行います。
- 表示したいメトリックの相対メトリックパスを定義します。そのためには、メトリックブラウザから完全なメトリックパスを取得してそのパスを切り取る必要があります。
- 相対メトリックパスに変更を加えて複数のエンティティに適用します。
- 構成しているウィジェットまたは正常性ルールのメトリックセレクタに、変更を加えた相対パスを貼り付けます。
相対メトリックパスの定義
メトリックパスは、特定のメトリックのパイプで区切られたパスです。コントローラ UI では、メトリックブラウザでメトリックにカーソルを合わせると完全なメトリックパスが表示されます。メトリックを右クリックすると、[フルパスのコピー（Copy Full Path）] オプションが表示されます。
相対メトリックパスを定義するには、完全なメトリックパスの左端部分を切り取ります。
特定のユースケースに対する切り取りの程度を確認するには、セットアップしているウィジェットまたは正常性ルール構成の [メトリックの選択（Metric Selection）] パネルで、埋め込みメトリックブラウザを確認します。このセレクタに到達する時点までに、選択したいメトリックのアプリケーション、ティア、またはノードは構成されているはずです。
相対メトリックパスの最初のセグメントとして [メトリックの選択（Metric Selection）] パネルのカテゴリを使用し、完全なメトリックパスのうち、そのセグメントより前に来るすべての部分を切り取ります。この例では、最初のセグメントは [分析データ収集時間（Analytics Data Collection Time）]、[分析方法評価時間（Analytics Method Evaluation Time）]、[分析スタックトレースキャプチャ時間（Analytics Stack Trace Capture Time）]、または [平均絵ンドツーエンド遅延（Average End to End Latency）] になります。
前出の例に従うと、メトリックブラウザからコピーした完全なメトリックパスは Application Infrastructure Performance|ECommerce Server|Hardware Resources|Disks|dev-dm-1|% CPU Time です。
埋め込みメトリックブラウザでの表示は [ハードウェアリソース（Hardware Resources）] から始まるため、[メトリックの選択（Metric Selection）] パネルで選択されているカテゴリ（この例では [ハードウェアリソース（Hardware Resources）]）より左に来るすべての部分を切り取ります。
相対メトリックパスは、Hardware Resources|Disks|dev-dm-1|% CPU Time です。
メトリックブラウザからコピーした完全なメトリックパスが Application Infrastructure Performance|ECommerce Server|Individual Nodes|ECommerceAppNode|Hardware Resources|Disks|dev-dm-1|% CPU Time である別の例を考えます。
Hardware Resources の左に来るすべての部分を切り取った後の相対メトリックパスは、Hardware Resources|Disks|dev-dm-1|% CPU Time です。
相対メトリックパスの修正
相対メトリックパスの単一のセグメントをアスタリスクに置換して、そのセグメントによって表されるすべてのエンティティに対してメトリックが評価されるべきであることを示します。
例：
相対メトリックパスが Hardware Resources|Disks|dev-dm-1|% CPU Time で、その階層またはノードのすべてのディスクについて CPU 時間の割合の正常性ルール条件を表示または作成したいとします。
ディスク名をアスタリスクに置き換えます。例：Hardware Resources|Disks|*|% CPU Time
複数のエンティティに対するメトリックの構成
ダッシュボードウィジェットまたは正常性ルールの [メトリックの選択（Metric Selection）] パネルで、複数の項目に対するメトリックを構成できます。
複数のエンティティに対するメトリックを構成するには、以下を行います。
- [メトリックの選択（Metric Selection）] パネルの下部にある [相対メトリックパスの指定（Specify Relative Metric Path）] を選択します。
- 変更を加えた、ワイルドカードを含む相対メトリックパスを貼り付けて、[Select Metric] をクリックします。
Enforce Strict Pattern Matching in Relative Path
In the Metric Selection Panel for a health rule, select the Exact match one wildcard * to one level of directory option to enforce a strict matching pattern in the relative metric path. By default, this option is not selected and the number of pipe symbols in the metric path is not considered. Therefore, all the results are fetched that matches the starting and ending path of the metric.
For example, if you specify the following relative metric:
Custom Metrics| WebsphereMQ-2|*|Status
The * wildcard replaces only one string between the two pipes in the actual metric path. The health rule evaluates only on the following actual metric path:
Custom Metrics| WebsphereMQ-2|UXSOAGWSG51.QM1|Status
and excludes the paths such as:
-
Custom Metrics| WebsphereMQ-2|UXSOAGWSG51.QM1|Channels|SOASG.TLMRP|Status -
Custom Metrics| WebsphereMQ-2|UXSOAGWSG51.QM2|Channels|SOASG.TLMRP2|OIRDFF.SEEP|Status
By default, you can use a maximum of four wildcards * in the relative metric path. For example, the metric path Hardware *| *|*|* represents the actual path such as Hardware Resources|Network|en0|Outgoing KB.
For increasing the default number of wildcards allowed in the relative metric path, configure the following flag in the admin.jsp page:
appdynamics.controller.alerting.max.wildcard.entries = 4
Contact Cisco Support to configure the flag.
Examples
The following table list a few examples of the allowed wildcard patterns in the relative path:
| Wildcard Pattern | Result |
|---|---|
|
Single wildcard:
|
|
|
Consecutive multiple wildcards:
|
|
|
Non-Consecutive multiple wildcards:
|
|
|
End of Path wildcard:
|
|
|
Start of path wildcard:
|
|
|
As a part of the string:
|
|
|
Four wildcards in the path:
|
|
メトリック指定の検証
カスタムダッシュボードで相対メトリック指定を複数の類似するエンティティに対して構成した場合、ウィジェットに複数のメトリックが表示されます。
ワイルドカードはパスセグメント全体を置換
アスタリスクはパスのセグメント全体を置換します。正規表現で使用されているため、文字列の一部のみを置換するために使用することはできません。
たとえば、次の使い方では、View で始まるすべてのビジネストランザクションに対する ART を取得しようとしていますが、これは無効でありサポートされていません。
Business Transaction Performance|Business Transactions|ECommerce Server|View*|Average Response Time (ms).
ECommerce Server のすべてのビジネストランザクションに対する ART を取得するには、Average Response Time (ms) を指定します。
メトリックパスに含まれるコロン
コロンがある場合、メトリックパスはパイプに変換されます。パイプとパイプの間には1つのセグメントしか存在できません。コロンとパイプは同義で使用できます。
例：
メトリックパスに含まれるコロン。Application Infrastructure Performance|ECommerce Server|JVM|Memory:Heap|Committed (MB) は、Application Infrastructure Performance|ECommerce Server|JVM|Memory|Heap|Committed (MB) に変換されます。
相対メトリックパスの場合、コミット済みヒープとコミット済み非ヒープの両方のメトリックを取得するには JVM|Memory|*|Committed (MB) と指定します。JVM|*|Committed (MB) と指定しないでください。