Use Wildcards in Metric Definitions

In a Custom Dashboard widget or Health Rule, you can use a wildcard to specify a metric that evaluates across several entities, such as multiple hardware entities or memory pools.

The wildcard feature is supported for metrics in the Mobile, Hardware Resources, JVM, and CLR branches of the metric hierarchy, and custom metrics that are created with a monitoring extension as described in Extensions and Custom Metrics.

To use wildcards:

Define the relative metric path to the metric that you want to display. This involves getting the full metric path in the Metric Browser and then trimming it.
Modify the relative metric path to apply to multiple entities.
Paste the modified relative path in the metric selector for the widget or health rule that you are configuring.

相対メトリックパスの定義

メトリックパスは、特定のメトリックのパイプで区切られたパスです。コントローラ 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）] になります。

メトリックの選択

埋め込みメトリックブラウザでの表示は [ハードウェアリソース（Hardware Resources）] から始まるため、[メトリックの選択（Metric Selection）] パネルで選択されているカテゴリ（この例では [ハードウェアリソース（Hardware Resources）]）より左に来るすべての部分を切り取ります。

相対メトリックパス：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

注: 相対パスの末尾のアスタリスクはサポートされていません。たとえば、"Hardware Resources|Disks|C|*" はサポートされていません。

複数のエンティティに対するメトリックの構成

ダッシュボードウィジェットまたは正常性ルールの [Metric Selection] パネルで、複数のエントリに対するメトリックを構成できます。

複数のエンティティに対するメトリックを構成するには、以下を行います。

[Metric Selection] パネルの下部にある [Specify Relative Metric Path] を選択します。
変更を加えた、ワイルドカードを含む相対メトリックパスを貼り付けて、[Select Metric] をクリックします。

Verify the Metric Specification

When you configure a relative metric specification for multiple similar entities in a custom dashboard, multiple metrics display in the widget.

ワイルドカードはパスセグメント全体を置換

アスタリスクはパスのセグメント全体を置換します。正規表現で使用されているため、文字列の一部のみを置換するために使用することはできません。

たとえば、次の使い方では、View で始まるすべてのビジネストランザクションに対する ART を取得しようとしていますが、これは無効でありサポートされていません。

Business Transaction Performance|Business Transactions|ECommerce Server|View*|Average Response Time (ms).

ECommerce Server のすべてのビジネストランザクションに対する ART を取得するには、Average Response Time (ms) を指定します。

メトリックパスに含まれるコロン

コロンがある場合、メトリックパスはパイプに変換されます。パイプとパイプの間には1つのセグメントしか存在できません。コロンとパイプは同義で使用できます。

例：