データベース エージェント メトリックをモニタし、エージェントの正常性ルールを設定できます。正常性ルールを追加したり、エージェントのステータスとともにメトリックを表示したりするには、エージェントテレメトリのプロパティを有効にする必要があります。

データベース エージェント テレメトリの有効化

エージェントテレメトリのプロパティは、コントローラのアカウントレベルまたはエージェントレベルで有効にできます。コントローラでプロパティを設定すると、各データベースエージェントのすべてのメトリックが表示されます。一方、エージェント設定でプロパティを設定すると、設定されたエージェントのメトリックのみが表示されます。

コントローラのアカウントレベルでは、管理コンソールを使用して dbagent.telemetry.enabled 機能フラグを追加し、値を true に設定します。

Admin Console

同様に、特定のデータベースエージェントに対してのみ、-Ddbagent.telemetry.enabled=true システムプロパティを使用してデータベースエージェントを開始します。

各エージェントは、一意のホスト識別子と名前に関連付けられています。複数のエージェントが同じ名前と一意の識別子を持つ場合、エージェントは同じノードのメトリックを報告します。したがって、異なる名前と一意のホスト識別子を使用してデータベースエージェントを開始します。

一意のホスト識別子は、デフォルトではデータベース エージェント ホスト マシンのホスト名です。システムプロパティ -Dappdynamics.agent.uniqueHostId=<Some_unique_identifier_name> を使用して、一意のホスト識別子を上書きできます。「データベースエージェントの構成プロパティ」で一意のホスト ID を参照してください。

データベースエージェントの正常性ルールを設定するには、「データベースの正常性ルールとアラート」を参照してください。

データベース エージェント メトリックのモニタ

データベース エージェント メトリックは Metric Browser で確認できます。データベース エージェント テレメトリを有効にすると、メトリックツリーにデータベースエージェント名のリストとそのステータスが DB Agents の下に表示されます。各データベースエージェント名には、データベース エージェント メトリックのリストが含まれます。

JVM およびメモリのメトリック

次の表に、データベースエージェントの JVM およびメモリのメトリックを示します。

Metric Name

Description

DB AGENT | Memory | Heap | Committed（MB）

ヒープに使用される Java 仮想マシン（データベースエージェント）にコミットされたメモリを MB 単位で返します。

DB AGENT|Memory|Heap|Current Usage (MB)

使用済みメモリの量を MB 単位で返します。

DB AGENT | Memory | Heap | Max Available（MB）

メモリの管理に使用できるメモリの最大容量を MB 単位で返します。

DB AGENT | Memory | Heap | Used％

（現在の使用量/最大使用可能容量）X 100

DB AGENT | Memory | Non-Heap | Committed（MB）

非ヒープに使用される Java 仮想マシン（データベースエージェント）にコミットされたメモリを MB 単位で返します。

DB AGENT|Memory|Non-Heap|Current Usage (MB)

使用済みメモリの量を MB 単位で返します（非ヒープの場合）。

DB AGENT|JVM|Process CPU Burnt (ms/min)

このプロセスで消費する CPU 時間（ミリ秒）

DB AGENT | JVM | Process CPU Usage％

その 1 分の CPU 使用率。（その 1 分の CPU 時間/（その 1 分でのアップタイム X プロセッサ数））X 100

このメトリックは累積的です。

DB AGENT | JVM | Threads | Current No. of Threads

現在のライブスレッド数（デーモンと非デーモンを含む）

ガベージコレクションとメモリプールメトリック

次の表に、ガベージコレクション（GC）とメモリプールメトリックを示します。

Metric Name

Description

DB AGENT|Garbage Collection|Major Collection Time Spent Per Min (ms)

メトリック収集時にメジャー GC でかかった時間

DB AGENT|Garbage Collection|Number of Major Collections Per Min

メトリック収集時のメジャー GC 数

DB AGENT|Garbage Collection|Minor Collection Time Spent Per Min (ms)

メトリック収集時にマイナー GC でかかった時間

DB AGENT|Garbage Collection|Number of Minor Collections Per Min

メトリック収集時のマイナー GC 数

DB AGENT|Garbage Collection|GC Time Spent Per Min (ms)

メジャー GC 時間（存在する場合）+ マイナー GC 時間（存在する場合）

DB AGENT | Garbage Collection | Memory Pools | Code Cache | Committed（MB）非ヒープメモリプールに使用される Java 仮想マシン（データベースエージェント）にコミットされたメモリを MB 単位で返します。
DB AGENT | Garbage Collection | Memory Pools | Code Cache | Current Usage（MB）非ヒープメモリプールの使用済みメモリの量を MB 単位で返します。
DBエージェント|ガベージコレクション|メモリプール|コードキャッシュ|最大使用可能（MB）非ヒープメモリプールのメモリ管理に使用できるメモリの最大量を MB 単位で返します。
DB AGENT | Garbage Collection | Memory Pools | Compressed Class Space | Committed（MB）非ヒープメモリプールに使用される Java 仮想マシン（データベースエージェント）にコミットされたメモリを MB 単位で返します。
DB AGENT | Garbage Collection | Memory Pools | Compressed Class Space | Current Usage（MB）非ヒープメモリプールの使用済みメモリの量を MB 単位で返します。

DB AGENT | Garbage Collection | Memory Pools | Compressed Class Space | Max Available（MB）

非ヒープメモリプールのメモリ管理に使用できるメモリの最大量を MB 単位で返します。
DB AGENT | Garbage Collection | Memory Pools | Metaspace | Committed（MB）非ヒープメモリプールに使用される Java 仮想マシン（データベースエージェント）にコミットされたメモリを MB 単位で返します。
DB AGENT | Garbage Collection | Memory Pools | Metaspace | Current Usage（MB）非ヒープメモリプールの使用済みメモリの量を MB 単位で返します。
DB AGENT | Garbage Collection | Memory Pools | PS Eden Space | Committed（MB）ヒープメモリプールに使用される Java 仮想マシン（データベースエージェント）にコミットされたメモリを MB 単位で返します。
DB AGENT | Garbage Collection | Memory Pools | PS Eden Space | Current Usage（MB）ヒープメモリプールの使用済みメモリ量を MB 単位で返します。
DB AGENT | Garbage Collection | Memory Pools | PS Eden Space | Max Available（MB）ヒープメモリプールのメモリ管理に使用できるメモリの最大量を MB 単位で返します。
DB AGENT | Garbage Collection | Memory Pools | PS Old Gen | Committed（MB）ヒープメモリプールに使用される Java 仮想マシン（データベースエージェント）にコミットされたメモリを MB 単位で返します。
DB AGENT | Garbage Collection | Memory Pools | PS Old Gen | Current Usage（MB）ヒープメモリプールの使用済みメモリ量を MB 単位で返します。
DB AGENT | Garbage Collection | Memory Pools | PS Old Gen | Max Available（MB）ヒープメモリプールのメモリ管理に使用できるメモリの最大量を MB 単位で返します。
DB AGENT | Garbage Collection | Memory Pools | PS Survivor Space | Committed（MB）ヒープメモリプールに使用される Java 仮想マシン（データベースエージェント）にコミットされたメモリを MB 単位で返します。
DB AGENT | Garbage Collection | Memory Pools | PS Survivor Space | Current Usage（MB）ヒープメモリプールの使用済みメモリ量を MB 単位で返します。
DB AGENT | Garbage Collection | Memory Pools | PS Survivor Space | Max Available（MB）ヒープメモリプールのメモリ管理に使用できるメモリの最大量を MB 単位で返します。

リストされているメトリックは、Java HotSpot（TM）64 ビットサーバ JVM および 1.8.0_212 Java バージョン用です。これらのメトリックは、JVM によって異なる場合があります。

キャッシュ使用メトリック

次の表に、データベースエージェントによってモニタされるすべてのコレクタの累積メトリックであるキャッシュ使用メトリックを示します。

次の詳細は、表に記載されているメトリックについて理解する際に便利です。

  • entitiesすべてのエンティティとそのハッシュおよび ID を保存します。
  • unregQueryCacheすべての未登録クエリエンティティを登録するまで保存します。
  • unregCachesすべての未登録エンティティ（サーバ、クエリ、クエリプランを除く）を登録するまで保存します。
  • unregQueryPlanCacheすべての未登録クエリプランエンティティを登録するまで保存します。
  • counters未登録のすべての待機状態を、DTO に変換され、コントローラ/ES にアップロードされるまで保存します。
  • catalog未登録のすべてのクエリ統計情報を、DTO に変換され、コントローラ/ES にアップロードされるまで保存します。

MetricName

Description

DB AGENT | Entity Cache | Total Entities

EntityCache に保存されているすべてのタイプのエンティティの合計

次を除くすべてのエンティティタイプが考慮されます。 Server

DB AGENT | Entity Cache | Registered Entities

その 1 分で登録されたエンティティの数

Server を除くすべてのエンティティタイプが考慮されます。

DB AGENT | Entity Cache | Pending Entities

unRegCache、unRegQueryCache、または unRegQueryPlanCache で登録を待機している保留中のエンティティの数

次を除くすべてのエンティティタイプが考慮されます。 Server

DB AGENT | Entity Cache | Duplicate Entities

再登録対象のエンティティ数

次を除くすべてのエンティティタイプが考慮されます。 Server

DB AGENT | Entity Cache | Unregistered Query Cache Size（KB）

キャッシュ（unregQueryCache）に存在する、登録を待機中のクエリの合計クエリサイズ（KB）

Query エンティティタイプのみが考慮されます。

DB AGENT | ES Data | Cache Usage | Number Of Wait Counters

キャッシュに存在し、アップロードを待機している待機カウンタの数

DB AGENT | ES Data | Cache Usage | Number of Query Stats

キャッシュに存在し、アップロードを待機しているクエリ統計情報の数

DB AGENT | ES Data | Successful ES Uploads | Number of Wait Counters

その 1 分に ES にアップロードされた待機カウンタの数

DB AGENT | ES Data | Successful ES Uploads | Number of Query Stats

その 1 分に ES にアップロードされたクエリ統計情報の数

データベース カスタム ダッシュボードでのデータベース エージェント メトリックのモニタ

Custom Dashboard でデータベース エージェント メトリックをモニターできます。

カスタムダッシュボードの作成

  1. [Dashboards & Reports > Create Dashboard] をクリックします。 
  2. ウィジェットを追加します。 
  3. データソースを Database Agents として選択し、データを追加します。詳細については、「カスタムダッシュボード」を参照してください。