Related Pages:

このページでは、AppDynamics のワイルドカードの概要について説明します。カスタムのダッシュボードウィジェットまたは正常性ルールでは、ワイルドカードを使用して、複数のハードウェアエンティティやメモリプールなど、複数のエンティティにまたがって評価するメトリックを指定できます。

ワイルドカード機能は、メトリック階層の Hardware Resources、JVM、CLR の各ブランチ内のメトリックに対応しています。ワイルドカード機能は、「拡張機能とカスタムメトリック」で説明されているように、モニタリング拡張で作成されたカスタムメトリックでのみサポートされます。

ワイルドカードを使用するには、以下を行います。

  1. 表示したいメトリックの相対メトリックパスを定義します。そのためには、メトリックブラウザから完全なメトリックパスを取得してそのパスを切り取る必要があります。
  2. 相対メトリックパスに変更を加えて複数のエンティティに適用します。
  3. 構成しているウィジェットまたは正常性ルールのメトリックセレクタに、変更を加えた相対パスを貼り付けます。

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

メトリックパスは、特定のメトリックのパイプで区切られたパスです。コントローラ UI では、メトリックブラウザでメトリックにカーソルを合わせると完全なメトリックパスが表示されます。メトリックを右クリックすると [Copy Full Path ] オプションが表示されます。 

相対メトリックパスを定義するには、完全なメトリックパスの左端部分を切り取ります。

特定のユースケースに対してどの程度切り取るかを知るには、セットアップしているウィジェットまたは正常性ルール構成の [Metric Selection] パネルで埋め込みメトリックブラウザを確認します。このセレクタに到達する時点までに、選択したいメトリックのアプリケーション、ティア、またはノードは構成されているはずです。

相対メトリックパスの最初のセグメントとして [Metric Selection] パネルのカテゴリを使用し、完全なメトリックパスのうち、そのセグメントより前に来るすべての部分を切り取ります。この例では、Agent、Hardware Resources、JVM、CLR のいずれかが最初のセグメントになります。

Metric Selection Category

前出の例に従うと、メトリックブラウザからコピーした完全なメトリックパスは 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] パネルで、複数のエントリに対するメトリックを構成できます。

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

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

メトリック指定の検証

カスタムダッシュボードで相対メトリック指定を複数の類似するエンティティに対して構成した場合、ウィジェットに複数のメトリックが表示されます。

Metric Specification

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

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

たとえば、次の使い方では、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) と指定しないでください。