データベースの可視性は、モニタ対象のデータベースで実行する SQL クエリと通常のデータベースアクティビティ中に実行されたクエリを指定することによって、モニタリングを拡張します。これらのカスタムクエリを定期的に実行するようにスケジュールし、カスタムメトリックで結果を収集することができます。「データベースの Custom Metrics ウィンドウ」を参照してください。

実行するカスタムクエリを指定するには、次のようにします。

1. [Configuration > Custom Metrics > New] に移動します。 
2. 次のフィールドに入力します。
   1. Name：カスタムメトリックに付ける名前。カスタムメトリック/イベントを作成した後は、その名前を変更することはできません。
   2. Custom Query Metric Type：クエリから必要な結果のタイプ。 

      1. 正常性ルールを定義できるメトリックを生成するには、[Metric ] タイプを選択します。このタイプのメトリックは、Metric Browser または各コレクタの [Custom Metrics] タブに表示されます。

      2. カスタムクエリ出力が空でない場合は常にカスタムイベントを生成するには、[Event Data ] タイプを選択します。カスタムイベントが発生したときに通知されるようにするには、そのカスタムイベントによってトリガーされるポリシーを作成できます。カスタムイベントは [Events] タブに表示されます。カスタムクエリによって複数の行が出力される場合、最初の 40 行がイベントの詳細に含まれます。各行には、カラム区切り記号（|）を含め、最大 5000 文字が表示されます。
   3. Database Type：メトリックを実行するデータベース プラットフォーム。
   4. Databases：メトリックを実行するデータベースインスタンス。メトリックは、指定したデータベースタイプのすべてのデータベースインスタンス、または指定した特定のデータベースインスタンスに対して実行できます。

   5. Schedule：クエリを実行する時間間隔。メトリックタイプのカスタムクエリの場合、指定された間隔の間で報告されるメトリック値は、前のクエリ実行で確認された値です。
      設定されたカスタムメトリックのタイムアウトは、クエリの実行頻度によって異なります。次の表に、時間間隔に基づくタイムアウトの詳細を示します。

      間隔(分)	タイムアウト（秒）
      1	10
      5	15
      10	30
      30	60
      60	120
      360	180
      720	300
      1440	300

       

   6. Query Text：実行するクエリ。メトリックタイプのカスタムメトリックを作成する場合、クエリには次のいずれかの戻り値の型を指定する必要があります。

      1. 正の整数。たとえば、次のクエリは正の整数を返します。

         SELECT COUNT(*) FROM employees

         CODE

      2. 文字列と正の整数。たとえば、次のクエリは文字列と正の整数を返します。
         

         SELECT name, salary FROM employees

         CODE

カスタムクエリはすべてのコレクタで表示されますが、そのデータは作成したコレクタだけを反映します。クエリのセマンティクスをテストし、[Test Query] ボタンをクリックして結果を検証することもできます。

カスタムクエリの結果は、データベースエージェントが 4.5.5 以降の場合に検証されます。

次の点は、カスタムメトリックを設定する場合の制限の使用について説明しています。

• アカウントごとに作成できるカスタムメトリックまたはイベントの合計数は、total number of Collectors と dbmon.config.max.custommetric.
の積になります。デフォルトでは、dbmon.config.max.custommetric の値は 40 です。コントローラ設定の dbmon.config.max.custommetric プロパティを使用して、上限を 150 まで調整できます。
• 1 分あたりコレクタごとに最大 150 のカスタムメトリックを報告できます。
• キー、dbagent.custom.metric.reportable.per.server 、および Max 値 150 を使用して、エージェントの設定プロパティからカスタムメトリックの制限を増やすことができます。キー値については、「データベースエージェントの構成プロパティ」を参照してください。
• エージェントで設定された最大制限値が優先され、アカウントレベルおよびコントローラレベルで設定された最大制限値は上書きされます。したがって、優先順位は次のようになります。
  • エージェントレベルの設定
  • アカウントレベルの設定
  • コントローラレベルの設定

カスタムメトリックは、MySQL、Microsoft SQL Server、Oracle、PostgreSQL、DB2、および Sybase のすべてのリレーショナルデータベースでサポートされます。

カスタムメトリックの表示

カスタムメトリックは、次の場所で表示できます。

• [Databases >] [Metric Browser] で、カスタムメトリックを表示するデータベースを展開します。
  
• [Databases] で、データベースインスタンスを開き、[Custom Metrics] タブをクリックします。