カスタムメトリックの構成

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

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

Configuration > Custom Metrics > New にアクセスします。

以下のフィールドに記入してください。

Name：カスタムメトリックに付ける名前。カスタムメトリック/イベントを作成した後は、その名前を変更することはできません。
Custom Query Metric Type：クエリから必要な結果のタイプ。
1. 正常性ルールを定義できるメトリックを生成するには、[Metric] タイプを選択します。このタイプのメトリックは、[Metric Browser] または各コレクタの [Custom Metrics] タブに表示されます。
2. カスタムクエリ出力が空でない場合は必ず、[Event Data] タイプを選択してカスタムイベントを生成します。カスタムイベントが発生したときに通知されるようにするには、そのカスタムイベントによってトリガーされるポリシーを作成できます。カスタムイベントは [Events] タブに表示されます。カスタムクエリによって複数の行が出力される場合、最初の 40 行がイベントの詳細に含まれます。各行には、カラム区切り記号（|）を含め、最大 5000 文字が表示されます。
Database Type：メトリックを実行するデータベースプラットフォーム。
Databases：メトリックを実行するデータベースインスタンス。メトリックは、指定したデータベースタイプのすべてのデータベースインスタンス、または指定した特定のデータベースインスタンスに対して実行できます。ただし、クラスタの場合、特定のデータベースインスタンスでメトリックを実行することはできません。

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


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

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

正の整数。たとえば、次のクエリは正の整数を返します。
```
SELECT COUNT(*) FROM employees
```
文字列と正の整数。たとえば、次のクエリは文字列と正の整数を返します。
```
SELECT name, salary FROM employees
```

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

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

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

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

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