ResourceMetricMap.properties

目次
apmdevops97jp
目次
さまざまなエージェントから収集されたリソース メトリック カテゴリは、Workstation 内でレポートされます。 リソース メトリック カテゴリは事前に定義されています。 事前に定義されたリソース メトリック グループの追加や削除はできませんが、管理者権限がある場合は、各リソース メトリック グループに関してレポートされるデータを指定するリソース メトリック マッピングを追加、変更、削除できます。
リソース メトリックをリソース メトリック カテゴリにマップする方法
  1. エージェント上で JMX レポートが有効であることを確認します。 詳細については、「
    CA APM Java エージェント実装ガイド
    」の「
    JMX レポートの有効化
    」を参照してください。
  2. MOM 上の
    <EM_Home>/Config
    ディレクトリにある
    ResourceMetricMap.properties
    ファイルを編集して、リソース メトリックをリソース メトリック カテゴリにマップします。 リソース メトリックのマッピングの詳細については、アプリケーション サーバのマニュアルを参照してください。
    1. <categoryName>.Path<recordID>:<agentMetricPath>
      形式を使用してメトリックのエントリを追加します。 たとえば、以下のように追加します。
      threads.used.path.1=Tomcat|ThreadPool|getCurrentThreadsBusy.path.1=CPU:Processor Count
      ここで、
      memory.utilization
      はメトリックの名前であり、
      CPU:Processor Count
      はそのデフォルトのメトリック パスです。
    2. 数値を使った増分レコード ID メトリックを追加します。 たとえば、以下のように追加します。
      cpu.utilization.path.1=Non Existent metric cpu.utilization.path.2=CPU|Processor 0:Utilization % (aggregate)
      同じメトリック グループ内で複数のパスを使用することにより、同じ名前で異なるパスを持つメトリックを設定します。 これにより、たとえば、フロントエンドをデプロイした異なるアプリケーション サーバから同じメトリックを取得できます。
  3. MOM とコレクタを再起動します。
    新しくマップされたリソース メトリック値が Workstation 内でレポートされます。
同じメトリックの複数のインスタンス用に設定された ResourceMetricMap.properties ファイルの例
Threads in Use メトリックの複数のインスタンスがクラスタ内の 3 つのコレクタを指すように設定されている ResourceMetricMap.properties ファイルのセクションを以下に示します。
#CPU Utilization cpu.utilization.path.1=CPU:Utilization % (process) #Time Spent in GC memory.utilization.path.1=GC Monitor|Percentage of Time Spent in GC during last 15 minutes #Threads in Use threads.used.path.1=WebSpherePMI|threadPoolModule|WebContainer:ActiveCount threads.used.path.2=WebLogic|JMX Aggregate|Thread Pool:Waiting Request Count threads.used.path.3=Tomcat|ThreadPool|default thread pool:getCurrentThreadsBusy #JDBC Connections in Use connections.used.path.1=WebSpherePMI|connectionPoolModule:WaitingThreadCount connections.used.path.2=WebLogic|JMX Aggregate|JDBC Connection Pool:Waiting Thread Count
CPU Utilization
CPU Utilization は、使用中の CPU のサイズを測定します。
マッピングの例
cpu.utilization.path.1=CPU:Utilization % (process) cpu.utilization.path.2=Some other metrics path
Time Spent in GC
Time Spent in GC は、ガベージ コレクタで費やされた時間を測定します。これは、その作業量がアプリケーションのパフォーマンスを大きく左右しているかどうかを理解するのに役立ちます。
マッピングの例
memory.utilization.path.1=memory utilization path
Threads in Use
Threads in Use は、使用中のスレッドの数を測定します。
マッピングの例
threads.used.path.1=threads used path
JDBC Connections in Use
JDBC Connections in Use は、アクティブな Java Database Connectivity インスタンスの数を測定します。
マッピングの例
connections.used.path.1=connections used path