JDBCデータ収集

最終更新日 - 13年2026月XNUMX日

Java Database Connectivity (JDBC) データ収集機能を使用すると、SQL を使用してリレーショナルデータベースに直接クエリを実行できます。この収集方法により、MySQL、Oracle、SQL Server などのサポートされているデータベースに対してクエリを実行することで、カウント、ステータス、パフォーマンス指標などのメトリックを取得できます。

JDBCデータ収集は、以下の条件が当てはまる環境に最適です。

• メトリクスをAPIやSNMP経由で公開するのではなく、データベースに保存する
• カスタム、クエリベースの監視
• SQLクエリから派生した特定の値を返す

データソースで収集方法としてJDBCを選択すると、データベース接続とクエリ動作を設定できるフィールドがUIに表示されます。

JDBCデータ収集を設定するには、以下の属性を定義します。

• JDBC URL—データベース接続文字列を指定します
• JDBCクレデンシャル—データベースアクセスの認証を定義します
• クエリー—LogicMonitorがデータベースに対して実行するSQLステートメントを指定します。
• 結果処理クエリ結果の解釈方法とデータポイントへのマッピング方法を決定します。

これらの属性は、LogicMonitorがデータベースに接続してデータを取得する方法を制御します。

JDBCデータ収集の要件

JDBCデータ収集を設定するには、以下のものが必要です。

• ロール権限でモジュールの管理権限を持つLogicMonitorユーザー
• JDBCをサポートするデータベース（例：MySQL、Oracle、SQL Server）
• アクセス可能なデータベースエンドポイント（例えば、コレクターからアクセス可能なホスト名とポート番号）
• 有効なJDBC URL
  詳細については、JDBC URLを参照してください。
• 有効なデータベース認証情報
  詳細については、「JDBC認証情報」を参照してください。
• 結果セットを返すSQLクエリ

JDBC URL

JDBC URLは、LogicMonitorがデータベースに接続する方法を定義します。データベースの種類によって異なる有効なJDBC接続文字列を入力する必要があります。

以下の要素を使用してURLを構築できます。

• ホスト名
• ポート
• データベース名
• オプションの接続パラメータ

LogicMonitorのプロパティトークンを使用すると、URLを複数のリソース間で再利用できるようになります。

一般的なトークンには、以下のようなものがあります。

Next	詳細説明	使用例
##HOSTNAME##	監視対象デバイスのホスト名に置き換えられます	jdbc:mysql://##HOSTNAME##:3306/##DBNAME##
##WILDVALUE##	Active Discoveryで使用され、一般的にはポートを表します。	jdbc:postgresql://##HOSTNAME##:##WILDVALUE##/##DBNAME##
##DBNAME##	データベース名を指定します	jdbc:mysql://##HOSTNAME##:3306/##DBNAME##
##DBPORT##	データベースポートを指定します	jdbc:sqlserver://##HOSTNAME##:##DBPORT##;databaseName=##DBNAME##

JDBCクレデンシャル

LogicMonitorがデータベースに対して認証できるようにするには、認証情報を設定する必要があります。

認証情報は、以下のいずれかの方法で提供できます。LogicMonitor プロパティを使用する（推奨）か、データソースに直接認証情報を入力します。プロパティを使用すると、リソースまたはグループレベルで認証情報を定義し、複数のデータソースで再利用できます。

一般的なプロパティ形式には、以下のものがあります。

• ##jdbc.mysql.user##
• ##jdbc.mysql.pass##
• ##jdbc.oracle.user##
• ##jdbc.oracle.pass##

以下の条件に該当する場合、データソースに認証情報を直接入力することが適切です。

• 認証情報は単一のデータソースに固有のものです
• 複数のリソース間で認証情報を再利用する必要はありません

JBDCクエリ構成

クエリフィールドは、LogicMonitorがデータ収集のために実行し、返すSQLステートメントを定義します。

クエリが結果セットを返すことを確認してください。JDBCデータ収集は、INSERT、UPDATE、DELETE、ALTER、CREATE、DROP、RENAME、TRUNCATEなど、データを返さないステートメントをサポートしていません。

設定を簡素化するために、クエリは単一の行と単一の値（または明確な名前の列）を返すように設計してください。この方法により、追加処理なしで結果を直接抽出できます。次の例を参照してください。

SELECT COUNT(*) AS active_sessions FROM sessions WHERE status = 'active'

クエリが目的の結果を返した後、LogicMonitorがその出力をどのように解釈するかを設定できます。データポイントを設定する際に、以下の結果解釈オプションから選択できます。

• クエリ実行時間—クエリの実行にかかる時間を計測します
• クエリステータス—クエリが成功したかどうかを示します
• クエリ結果結果セットから値を抽出します

クエリ結果を使用する場合は、以下のいずれかの方法で値を抽出してください。

• 列の値（推奨）—最初の行の値を返す列名を指定します。
• 正規表現（上級編）クエリが複数の行を返す場合は、正規表現を使用してください。結果は、次の例に示すように、キーと値のペアの形式で表示されます。
  application=websales,count=42
application=phonesales,count=12
application=storefront,count=33
  次のような正規表現パターンを使用して値を抽出できます。
  phonesales,count=(\d+)
  

• テキスト一致指定された文字列が存在する場合は 1 を、存在しない場合は 0 を返します。

JDBCデータポイントの設定

1. LogicMonitorで、次の場所に移動します モジュール次に、新しいデータソースを追加するか、JDBCデータ収集を設定するデータソースを選択します。
   詳細については、を参照してください。 カスタム モジュールの作成 or モジュール管理.
2. 必要に応じてデータソースを構成または変更し、 収集方法 ドロップダウンメニュー。
   詳細については、を参照してください。 データソース構成.
   
3. コレクションセクションで、以下のフィールドを入力してください。
   • URL フィールドに、JDBC URLを追加します。
   • フィールドに、JDBCユーザー名を入力してください。
   • パスワード フィールドに、JDBCパスワードを入力してください。
   • クエリー フィールドに、収集したいデータを返すSQL文を入力してください。
     クエリが結果セットを返すようにし、可能な限り単一の行と値を返すように設計してください。
     
4. データポイントのセクションで、データポイントを追加します。
   データポイントの設定フォームが表示されます。
   詳細については、を参照してください。 データポイントの概要。
5. ノーザンダイバー社の データポイントソース ドロップダウン メニューで、次のいずれかを選択します。
   • クエリによって返された値を取得するには、「クエリ結果」を選択します。
   • クエリの実行時間を測定するには、「クエリ実行時間（ミリ秒）」を選択してください。
   • クエリが成功したかどうかを示すステータスコード（成功または認証失敗など）を返すには、「クエリステータス」を選択します。
     
6. (オプションクエリ結果を選択した場合は、以下のフィールドを設定してください。
   • 出力を次のように解釈します フィールドで、「結果の最初の行の特定の列の値を使用する」を選択します。
   • 列名 フィールドには、クエリによって返される、収集したい値を含む列の名前を入力します。
7. (オプションクエリが複数の行を返す場合、または追加の解析が必要な場合は、正規表現やテキストマッチなどの後処理を構成してください。
8. 選択する Save.

設定を保存したら、データソースをリソースに割り当て、データが収集されていることを確認します。