IBM Db2 のモニタリング

このセンサーは、 IBM Db2、 10.5、およびそれ以降のバージョンをサポートしています。

以下の表は、最新のサポート対象バージョンとサポート方針を示しています：

サポートポリシーに関する詳細については、 「センサーのサポート戦略」 を参照してください。

このセンサーは、認証 DATA_ENCRYPT セキュリティメカニズムを使用する Db2 インスタンスの監視には対応していません。

この技術において、 Instana は以下の言語およびランタイムのクライアントサイドトレースをサポートしています：

• Java
• Node.js
• PHP
• .NET Framework
• .Net Core

カスタム・ポート、データベース、ユーザー、パスワード、インスタンス、またはポーリング・レートを使用するには、エージェント構成ファイル <agent_install_dir>/etc/instana/configuration.yamlで以下のフィールドを構成する必要があります。

InstanaエージェントをDb2 サーバーに安全に接続するには、<agent_install_dir>/etc/instana/configuration.yamlで構成する必要があります。

Instana Red Hat OpenShift Container Platform における IBM Db2 のローカル監視をサポートします。 コンテナ環境内の IBM Db2 データベースインスタンスは、 StatefulSets として作成されます。 これらは、カスタム・リソース (CR) を使用して、同じポッド・テンプレートからレンダリングされます。 IBM Db2 の設定例を以下に示します：

com.instana.plugin.db2:
  local:
    - host: 'c-db2ucluster-sample-one-db2u.openshift-operators.svc'
      instance: 'db2inst1'
      port: '50000'
      environment: 'OCP'
      tabschema: 'SYSTOOLS'
      user: 'db2inst1'
      password: 'db2inst1'
      availabilityZone: 'DB2 Monitoring'
      poll_rate: 5 # seconds
      databases:
        - 'BLUDB'
    - host: 'c-db2ucluster-sample-two-db2u.openshift-operators.svc'
      instance: 'db2inst1'
      port: '50000'
      environment: 'OCP'
      tabschema: 'SYSTOOLS'
      user: 'db2inst1'
      password: 'db2inst1'
      availabilityZone: 'DB2 Monitoring'
      poll_rate: 5 # seconds
      databases: # multiple databases are supported
        - 'database1'
        - 'database2'
 

同じワーカーノードに複数の IBM Db2 インスタンスが存在する場合、それらを同じ設定ファイルに追加することができます。

IBM Db2 サービスのホスト URL は、サービス名と、データベースインスタンスが作成される OpenShift Container Platform クラスタ上のネームスペースを組み合わせたものです。 URL は通常、次のような形式になっています *serviceName*.*namespace*.svc。 たとえば、がサービス名 c-db2ucluster-sample-one で openshift-operators 、が名前空間の場合、ホスト URL は となります c-db2ucluster-sample-one-db2u.openshift-operators.svc。

Podを再作成する場合は、 Instana 内のデータベースの履歴を保持するために、同じサービス名を使用してください。

ログイン・タイムアウトは、センサーがデータベースへの接続を待機する最大時間 (秒) を定義します。 Instana の「 Db2 」センサーでは、ファイル configuration.yaml 内の loginTimeout プロパティを使用して、ログインタイムアウトを設定できます。 指定された loginTimeout 間隔内に接続が取得されない場合は、接続エラーが表示されます。 このプロパティーのデフォルト値は 5 秒です。 このプロパティーはオプションであり、ローカル構成とリモート構成の両方に適用できます。 以下の例は、loginTimeout プロパティーをカスタマイズする方法を示しています。

      port: '50000'
      tabschema: 'SYSTOOLS'
      user: 'db2inst1'
      password: 'db2inst1'
      poll_rate: 5 # seconds
      loginTimeout: 20 #value in seconds
 

Instana の Db2 センサーにおいて、ロック待機や長時間実行中のクエリの件数を取得するための時間間隔は、ファイル configuration.yaml 内の lockAndLongQueryInterval プロパティを使用してカスタマイズできます。 デフォルトでは、照会またはロック待機を長時間実行として分類するためにセンサーが要した時間は 100 秒です。 このメトリックは、アラートまたはイベントの構成に使用できます。 lockAndLongQueryInterval プロパティーはオプションであり、ローカル構成とリモート構成の両方に適用できます。 以下の例は、このプロパティーをカスタマイズする方法を示しています。

      port: '50000'
      tabschema: 'SYSTOOLS'
      user: 'db2inst1'
      password: 'db2inst1'
      poll_rate: 5 # seconds
      lockAndLongQueryInterval: 60 # value in seconds
 

runstats および reorg メトリックを収集するための時間間隔をカスタマイズできるようになりました。 時間間隔をカスタマイズするには、 configuration.yaml ファイルの customRunStatsPollRate プロパティーを使用します。 デフォルトでは、メトリックは 180 分ごとに収集されます。 customRunStatsPollRate プロパティーはオプションであり、ローカル構成とリモート構成の両方に適用できます。 以下の例は、このプロパティーをカスタマイズする方法を示しています。

      port: '50000'
      tabschema: 'SYSTOOLS'
      user: 'db2inst1'
      password: 'db2inst1'
      poll_rate: 5 # seconds
      customRunStatsPollRate: 30 # value in minutes
 

スキーマごとに表サイズとして表示される行数をカスタマイズできるようになりました。 行数をカスタマイズするには、 configuration.yaml ファイルの tableSizeRowsLimit プロパティーを使用します。 デフォルトでは、スキーマごとにサイズごとに最初の 50 個の表のみが表示されます。 tableSizeRowsLimit プロパティーはオプションであり、ローカル構成とリモート構成の両方に適用できます。 以下の例は、このプロパティーをカスタマイズする方法を示しています。

      port: '50000'
      tabschema: 'SYSTOOLS'
      user: 'db2inst1'
      password: 'db2inst1'
      poll_rate: 5 # seconds
      tableSizeRowsLimit: 100 # number of rows to fetch
 

JSON Web Tokens（JWT）は、 Db2 がサポートする認証メカニズムであり、 1.0.27 以降のバージョンから、 Db2 センサーでもサポートされるようになりました。 Instana エージェントが Db2 サーバーへのJWT接続をサポートするようにするには、次のとおり`.conf` <agent_install_dir>/etc/instana/configuration.yaml ファイルを設定する必要があります：

複数インスタンスのモニターは、ローカル・モニターとリモート・モニターの両方でサポートされます。 configuration.yamlファイル内で構成する方法の例を以下に示します。

Db2 pureScale インスタンスは、ローカルとリモートの両方でモニターできます。 以下の例は、 configuration.yaml ファイルで Db2 pureScale インスタンスのローカル・モニターとリモート・モニターを構成する方法を示しています。

Instana が使用する「 Db2 」ユーザーアカウントに対して、以下の権限を付与する必要があります：

GRANT DBADM ON DATABASE TO USER db2inst1;

または

GRANT DATAACCESS ON DATABASE TO USER db2inst1;
GRANT SQLADM ON DATABASE TO USER db2inst1;
 

または、以下の表関数/ビューまたはプロシージャーに対する EXECUTE 特権:

GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_CONTAINER TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_TRANSACTION_LOG TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_DATABASE TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_TABLESPACE TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_PKG_CACHE_STMT TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_AGENT TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_HADR TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_CONNECTION TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_UTILITY TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_WORKLOAD TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_UNIT_OF_WORK TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_INSTANCE TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.PD_GET_DIAG_HIST TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.PD_GET_LOG_MSGS TO USER db2inst1;
GRANT SELECT ON SYSIBMADM.MON_TRANSACTION_LOG_UTILIZATION TO USER db2inst1;
GRANT SELECT ON TABLE SYSCAT.INDEXES TO USER db2inst1;
GRANT SELECT ON TABLE SYSCAT.TABLES TO USER db2inst1;
GRANT SELECT ON TABLE SYSIBMADM.MON_CURRENT_SQL TO USER db2inst1;
GRANT SELECT ON TABLE SYSIBMADM.DB_HISTORY TO USER db2inst1;
GRANT SELECT ON TABLE SYSIBMADM.DBCFG TO USER db2inst1;
GRANT SELECT ON TABLE SYSIBMADM.MON_CONNECTION_SUMMARY TO USER db2inst1;
GRANT SELECT ON TABLE SYSIBMADM.MON_DB_SUMMARY TO USER db2inst1;
GRANT SELECT ON TABLE SYSIBMADM.MON_LOCKWAITS TO USER db2inst1;
GRANT SELECT ON TABLE SYSIBMADM.SNAP_REORG TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.DB_GET_CFG() TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.DBM_GET_CFG TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.ENV_GET_INST_INFO TO USER db2inst1;

SYSIBMADM.SNAP_REORG

GRANT SELECT ON TABLE SYSIBMADM.SNAPTAB_REORG TO USER db2inst1;

例:

db2 connect to db
 

db2 "grant dataaccess, sqladm on database to user db2inst1"
 

db2 "grant execute on FUNCTION SYSPROC.MON_GET_DATABASE to USER db2inst1"
 

注:

• IBM Db2 LUWセンサーのポーリング設定が有効になっています。 この機能を使用すると、必要な間隔で統計をフェッチするためのカスタム構成を設定できます。また、無関係な統計を無効にすることもできます。
• カスタム・ポーリング構成を使用している場合、この設定はデフォルトのシステム設定よりも優先されます。
• ポーリングのカスタマイズは、 「構成可能な統計 (Configurable stats)」 セクションの表に概要が示されている統計に対してのみ有効になります。 ポーリング・カスタマイズが有効になっていない統計は、収集される頻度が少なく、システムにとって不可欠です。 収集される統計およびデフォルトのポーリング間隔について詳しくは、「 構成可能な統計 」セクションを参照してください。
• 間隔構成をデフォルト値より小さく設定することはできません。 正しくない構成を行った場合、このエントリーは、使用可能な次に高いポーリング・レート構成バケットに移動されます。
• 構成可能項目から統計を省略すると (統計は poll_intervals バケットまたは disabled_metrics バケットのいずれにも追加されません)、次に使用可能な上位のバケットに自動的に追加されます。 ただし、そのようなバケットが存在しない場合は、使用不可のメトリック・リストに移動されます。
• ポーリング間隔は、ローカル・モニターとリモート・モニターの両方についてカスタマイズできます。 すべてのポーリング間隔を秒単位で設定します。
• 統計名とバケット名 (disabled_metrics、 poll_rate_1、 poll_rate_2、 poll_rate_3、および poll_rate_4) は固定されています。 これらには、 「構成統計」 セクションの表に示されているように、または以下のサンプル構成のように名前を付ける必要があります。

ローカル・モニターとリモート・モニターの両方のポーリングをカスタマイズするには、以下のように構成します。

      poll_rate: 5 # seconds
      custom_polling:
        disabled_metrics:
          metrics: DBM_CONFIG_STATS, AGENT_STATS #Stats that you don't want to be monitored
        poll_rate_1:
          poll_interval: 30
          metrics: TOP_QUERIES_STATS, TABLE_SPACE_STATS
        poll_rate_2:
          poll_interval: 200
          metrics: ELAPSED_TIME_STATS, WORKLOAD_STATS, TOP_TOTAL_STMT_IDS_STATS
        poll_rate_3:
          poll_interval: 900
          metrics: LOG_DISK_WAIT_STATS, DB_CONFIG_STATS, UNIT_OF_WORK_STATS
        poll_rate_4:
          poll_interval: 2000
          metrics: HADR_STATS, VMON_LOCK_STATS
      databases:
        - 'database1'
 

DB2 のテーブル関数を使用することで、標準メトリクス以外のカスタムメトリクスを収集することができます。 収集したいテーブル関数とメトリクスを指定すると、センサーは設定に基づいて適切なSQLクエリを自動的に生成し、すべてのメトリクスを Prometheus 形式でエクスポートします。

IBM Db2 のローカルおよびリモート監視用のカスタムメトリクスの設定は、エージェントの設定ファイルで <agent_install_dir>/etc/instana/configuration.yaml 次のように設定できます：

• プロセス ID
• ポート
• バージョン
• 開始時刻/稼働時間