メトリック定義でのワイルドカードの使用
関連ページ：
Custom Dashboard ウィジェットまたは Health Rule では、ワイルドカードを使用して、複数のハードウェアエンティティやメモリプールなど、複数のエンティティにまたがって評価するメトリックを指定できます。
メトリック階層のモバイル、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] をクリックします。
相対パスでの厳密なパターン一致の強制
正常性ルールの [Metric Selection] パネルで [Exact match one wildcard * to one level of directory] オプションを選択して、相対メトリックパスで厳密な一致パターンを強制します。デフォルトではこのオプションは選択されておらず、メトリックパスのパイプ記号の数は考慮されません。したがって、メトリックの開始パスと終了パスに一致するすべての結果が取得されます。
たとえば、次の相対メトリックを指定したとします。
Custom Metrics| WebsphereMQ-2|*|Status
* ワイルドカードは、実際のメトリックパスの 2 つのパイプ間の 1 つの文字列のみを置き換えます。正常性ルールは、次の実際のメトリックパスのみ評価します。
Custom Metrics| WebsphereMQ-2|UXSOAGWSG51.QM1|Status
次のようなパスは除外されます。
-
Custom Metrics| WebsphereMQ-2|UXSOAGWSG51.QM1|Channels|SOASG.TLMRP|Status -
Custom Metrics| WebsphereMQ-2|UXSOAGWSG51.QM2|Channels|SOASG.TLMRP2|OIRDFF.SEEP|Status
デフォルトでは、相対メトリックパスに最大 4 つのワイルドカード * を使用できます。たとえば、メトリックパス Hardware *| *|*|* は Hardware Resources|Network|en0|Outgoing KB などの実際のパスを表します。
相対メトリックパスで許可されるワイルドカードのデフォルト数を増やすには、admin.jsp ページで次のフラグを設定します。
appdynamics.controller.alerting.max.wildcard.entries = 4
例
次の表に、相対パスで許可されるワイルドカードパターンの例をいくつか示します。
| ワイルドカードパターン | 結果 |
|---|---|
|
単一のワイルドカード：
|
|
|
連続する複数のワイルドカード：
|
|
|
連続しない複数のワイルドカード：
|
|
|
パスの末尾のワイルドカード：
|
|
|
パスの最初のワイルドカード：
|
|
|
文字列の一部として：
|
|
|
パス内の 4 つのワイルドカード：
|
|
メトリック指定の検証
カスタムダッシュボードで相対メトリック指定を複数の類似するエンティティに対して構成した場合、ウィジェットに複数のメトリックが表示されます。
ワイルドカードはパスセグメント全体を置換
アスタリスクはパスのセグメント全体を置換します。正規表現で使用されているため、文字列の一部のみを置換するために使用することはできません。
たとえば、次の使い方では、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) と指定しないでください。