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

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

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

[Configuration > Custom Metric > New] に移動します。

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

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

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


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

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

正の整数。たとえば、次のクエリは正の整数を返します。
```
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 のすべてのリレーショナルデータベースでサポートされます。