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

メトリック グループは、1 つ以上のメトリックの論理セットです。メトリック グループは、Enterprise Manager がそのエージェントから収集するデータ(メトリック)の大きなセットを並べ替えてフィルタします。より多くのエレメントで、メトリック グループを使用して、ダッシュボードおよびレポート テンプレートで、データを視覚的に監視します。他のエレメントでは、メトリック グループを使用して、アラートおよび永続コレクションで、データをプログラムで監視します。メトリック グループは、ユーザがアプリケーションのパフォーマンスの問題を迅速に識別し修正するのに役立ちます。
apmdevops102jp
メトリック グループは、1 つ以上のメトリックの論理セットです。メトリック グループは、Enterprise Manager がそのエージェントから収集するデータ(メトリック)の大きなセットを並べ替えてフィルタします。より多くのエレメントで、メトリック グループを使用して、ダッシュボードおよびレポート テンプレートで、データを視覚的に監視します。他のエレメントでは、メトリック グループを使用して、アラートおよび永続コレクションで、データをプログラムで監視します。メトリック グループは、ユーザがアプリケーションのパフォーマンスの問題を迅速に識別し修正するのに役立ちます。
メトリック グループを使用して、以下のタスクを実行します。
  • 複数のソースのメトリックを同時にグループ化する。
  • その他の管理モジュール エレメントが入力として使用するメトリック データのサブセットを定義します。
3
3
メトリック グループは、名前、管理モジュール、エージェント一致パターン、およびメトリック一致パターンを使用します。[エージェント一致パターン]および[メトリック一致パターン]フィールドには、グループ化するデータを記述します。両方のフィールドともに、正規表現を使用して情報を詳細に指定することができます。
管理者として、以下の手順を実行します。
  1. メトリック グループを作成します。
  2. メトリック グループを設定します。
  3. (オプション)エレメントを削除します。
メトリック グループの作成
メトリック グループは、1 つの名前のグループに同様のメトリックをグループ化します。グループ内のメトリックは、同じエージェントからのメトリックの場合と異なるエージェントからのメトリックの場合があります。メトリック グループのアラートを定義できます。また、ダッシュボードでメトリック グループを使用して、メトリック グラフを表示できます。
以下の手順に従います。
  1. WebView で、
    [管理]
    をクリックします。
  2. [エレメント]-[メトリック グループを新規作成]
    を選択します。
    [メトリック グループを新規作成]
    ダイアログ ボックスが表示されます。
  3. 以下のオプションに入力し、
    [OK]
    をクリックします。
    • 名前
      エレメントの名前を指定します。エレメントのソースを識別できるように、わかりやすい名前を使用します。
    • 強制的に一意にする
      同じ名前が管理モジュール内に存在する場合、名前に番号を付加します。
    • 管理モジュール
      エレメントを含める管理モジュールを指定します。
    メトリック グループが、手順 3 で指定した管理モジュールのメトリック グループ ノードの下に表示されます。[プレビュー]ペインにメトリック グループ エディタが表示されます。
メトリック グループの設定
メトリック グループの設定には、標準の Perl 正規表現を使用します。正規表現は検索パターンを記述するテキスト文字列です。ワイルドカードを使用すると、オブジェクトの集合を短い表現に簡略化できます。
以下の手順に従います。
  1. WebView で、
    [管理]
    をクリックします。
  2. 管理モジュール ツリーで、設定するメトリック グループが含まれる[メトリック グループ]ノードに移動します。
  3. メトリック グループをクリックします。
    [プレビュー]
    ペインに、折れ線グラフで、メトリック グループのステータスが表示されます。
    [警告]
    レベルと
    [危険]
    レベルには、実際の値が表示されます。
  4. 以下のオプションのうちの 1 つを選択します。以下のフィールドには説明が必要です。
    • 管理モジュール エージェント一致パターンを使用
      管理モジュール レベルで定義されているエージェント一致パターンの使用を定義します。
    • メトリック グループ エージェント一致パターンを使用
      メトリック グループ レベルでのエージェント一致パターンの使用を定義します。メトリック グループはそれぞれ、独自のエージェント一致パターンのセットを持つことができます。
  5. 正規表現を入力します。
    • メトリック グループ エージェント一致パターン
      メトリックへの入力をフィルタする、Perl 5 の正規表現を指定します。エージェント名を含むデータを指定します。
      この式一致パターンは、グループ化されたデータをどのエージェントに限定するかを決定します。たとえば、一致パターン (.*)\|WPS2-0[1,2] は、すべてのドメインで WPS2-01 または WPS2-02 という名前のエージェントを探します。複数の JVM が同じ Enterprise Manager にレポートするが、使用される目的が異なる場合、エージェント一致パターンは重要です。同じ会社の異なる Web サイトはその一例です。この場合、正規表現を使用して、メトリック グループがフィルタするエージェントを制限します。
      注:
      [管理モジュール エージェント一致パターンを使用]オプションを選択している場合、これらのフィールドは無効化されています。
    • メトリック一致パターン
      メトリックおよびリソースを指定する、Perl 5 の正規表現を指定します。リソースは、メトリックに至る一連のフォルダです)。たとえば、一致パターン
      LDAP\|([^|:]*)\|(.*):Response Time\(ms\)
      は、LDAP リソース フォルダ内のすべてのリソースを探します。この一致パターンは、それらのリソース内の Response Time (ms) メトリックを検索します。
  6. [追加]
    をクリックします。
    追加のフィールドが開き、[メトリック グループ エージェント一致パターン]と[メトリック一致パターン]の正規表現を入力できます。
  7. [削除]
    をクリックします。
    一致パターンのセットが複数ある場合、それらを削除できます。メトリック グループ定義には、1 つの一致パターンが存在する必要があります。この場合、[削除]は無効になります。
  8. [適用]
    をクリックします。
    メトリック グループが設定されます。
正規表現
正規表現は、メトリック グループに含めるメトリックを定義します。正規表現(Perl の正規表現)は、検索パターンを記述するテキスト文字列です。
エージェント
一致パターンで、メトリック グループがデータを取得するエージェントを定義します。たとえば、エージェント一致パターンは、すべてのドメイン内で「WPS2-01」または「WPS2-02」という名前のエージェントのみにメトリック グループを適用します。複数の JVM が同じ Enterprise Manager にレポートするが、使用される目的が異なる場合、エージェント一致パターンは便利です。同じ会社内で異なる Web サイトを実行することは、その一例です。この場合、正規表現を使用してそのフィルタを作成することで、メトリック グループが適用されるエージェントを制限します。管理モジュール レベルでエージェント一致パターンを定義することもできます。エージェント一致パターンは、その管理モジュールに定義されているすべてのメトリック グループに適用されます。
エージェント一致パターンは以下を使用します。
  1. 監視するプロセスを実行するホストの名前。
  2. データの収集元となる、アプリケーションまたは管理対象 Java アプリケーション インスタンス内の特定のプロセスの名前
  3. データの収集を行うエージェント。
メトリック
一致パターンで、メトリック グループに含めるメトリックを定義します。メトリック一致パターンは、エージェントがエージェント一致パターンに従って送信するデータをすべてフィルタします。フィルタされたメトリックの数がエージェントの数を超えるため、メトリック一致パターンについてはエージェント一致パターンよりも慎重に検討する必要があります。
メトリック一致パターンは以下を使用します。
  1. メトリックに至るまでのリソース
  2. メトリック名
一致パターンの構造
エージェント一致パターンとメトリック一致パターンの組み合わせは、Enterprise Manager 内で一意のメトリック名識別子を形成します。この識別子は完全修飾メトリック名と呼ばれます。以下のパターンを使用して、完全修飾メトリック名を指定します。
  • エージェント一致パターンにはホスト名、プロセス名、およびエージェント名を含めます。
    Domain|Hostname|Process|AgentName|Resource:Metric
  • メトリック一致パターンには、1 つ以上のメトリック カテゴリを含めます。
    Hostname|Process|AgentName|Category|SubCategory|...|SubCategory:Metric
正規表現で使用する文字の一部を以下に示します。
  • パイプ(|)は、リソースの階層およびカテゴリのメトリックを区切ります。
  • コロン(:)は、Average Response Time (ms) または Stall Count などのメトリック名を示します。
  • ワイルドカードは、正規表現の機能の一部にすぎません。しかし、ワイルドカードは、オブジェクトの集合を短い表現に簡略化するという同じ目的を提供します。
例: エージェントにおける GC ヒープの使用中のバイト数の追跡
以下の例は、Acme Company がその
AcmeWest
エージェント上の GC ヒープに対して
[使用中のバイト数]
をどのように追跡するかを示しています。エージェント一致パターンは以下のとおりです。
AcmeHost|AcmeUSAProcess|AcmeWestAgent|GC Heap:Bytes In Use
 
例: GC ヒープ メトリックを追跡するための一致パターンの使用
この例では、エージェント一致パターンとメトリック一致パターンを使用して、Acme Company がすべての GC ヒープ メトリックを追跡する方法を示しています。このメトリックはすべてのエージェント、および
AcmeUSAProcess
を実行するすべてのホスト用です。1 つのメトリック グループ内では、一致パターンは以下のとおりです。
  • エージェント一致パターン:
    ([^\|:]*)\|AcmeUSAProcess\|([^\|:]*)
  • メトリック一致パターン:
    GC Heap:(.*)
エレメントの削除
管理モジュールで、エレメントを削除することができます。たとえば、アラートまたはメトリック グループがもう使用されなくなった場合に、それらを削除します。エレメントを削除するには、読み取りおよび書き込み権限が必要です。
以下のメトリック グループまたはそれぞれの対応するアラートは、削除、名前変更、および移動することができません。
  • APM BT Average Response Time (ms)
  • APM BT Errors and Stalls
  • APM Frontends Average Response Time
  • APM Frontends Errors and Stalls
  • APM Resources_Backend Calls
  • APM Resources_% CPU Utilization (Host)
  • APM Resources_%Time Spent in GC
  • APM Resources_JDBC Connections in Use
  • APM Resources_Threads in Use
以下の手順に従います。
  1. WebView で、
    [管理]
    をクリックします。
  2. 管理モジュール ツリーで、削除するエレメントをクリックします。
    [プレビュー]
    ペインにエレメントの設定が表示されます。
  3. [削除]
    をクリックします。
    [削除の確認]
    ダイアログ ボックスが表示されます。
  4. [はい]
    をクリックします。
    エレメントが削除されます。