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で構成する必要があります。

インスタナは、 IBM Db2 Red Hat OpenShift Container Platform のローカルモニタリングをサポートしている。 コンテナ環境の 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 となる。

ポッドを再作成する場合は、同じサービス名を使用して、Instana のデータベース履歴を保持します。

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

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

configuration.yaml ファイルの lockAndLongQueryInterval プロパティを使用することで、Instana Db2 センサーのロック待ちと長時間実行クエリのカウントを取得する時間間隔をカスタマイズできます。 デフォルトでは、センサーがクエリやロック待ちを長時間実行と分類するのにかかる時間は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ウェブトークン（JWT）は、認証のために Db2 でサポートされているメカニズムで、 1.0.27 バージョン以降、 Db2 センサーでもサポートされるようになりました。 Instana エージェントが Db2 サーバーへの JWT 接続をサポートするようにするには、 <agent_install_dir>/etc/instana/configuration.yaml ファイルを以下のように設定する必要があります：

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

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

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 MON_GET_CONTAINER TO USER db2inst1;
• GRANT EXECUTE ON FUNCTION MON_GET_TRANSACTION_LOG TO USER db2inst1;
• GRANT EXECUTE ON FUNCTION MON_GET_DATABASE TO USER db2inst1;
• GRANT EXECUTE ON FUNCTION MON_GET_TABLESPACE TO USER db2inst1;
• GRANT EXECUTE ON FUNCTION MON_GET_PKG_CACHE_STMT TO USER db2inst1;
• GRANT EXECUTE ON FUNCTION MON_GET_AGENT TO USER db2inst1;
• GRANT EXECUTE ON FUNCTION MON_GET_HADR TO USER db2inst1;
• GRANT EXECUTE ON FUNCTION MON_GET_CONNECTION TO USER db2inst1;
• GRANT EXECUTE ON FUNCTION MON_GET_PKG_CACHE_STMT TO USER db2inst1;
• GRANT EXECUTE ON FUNCTION MON_GET_UTILITY TO USER db2inst1;
• GRANT EXECUTE ON FUNCTION MON_GET_WORKLOAD TO USER db2inst1;
• GRANT EXECUTE ON FUNCTION MON_GET_UNIT_OF_WORK TO USER db2inst1;
• GRANT EXECUTE ON FUNCTION MON_GET_INSTANCE TO USER db2inst1;
• GRANT EXECUTE ON FUNCTION MON_TRANSACTION_LOG_UTILIZATION TO USER db2inst1;
• GRANT EXECUTE ON FUNCTION PD_GET_DIAG_HIST TO USER db2inst1;
• GRANT EXECUTE ON FUNCTION PD_GET_LOG_MSGS 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 PROCEDURE SYSPROC.DB_GET_CFG TO USER db2inst1;
• GRANT EXECUTE ON PROCEDURE SYSPROC.DBM_GET_CFG TO USER db2inst1;
• GRANT EXECUTE ON PROCEDURE SYSPROC.ENV_GET_INST_INFO 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センサーのポーリング設定が有効。 この機能を使えば、必要な間隔で統計情報を取得するためのカスタム設定をしたり、無関係な統計情報を無効にしたりすることができる。
• カスタム・ポーリング設定を使用している場合、この設定はデフォルトのシステム設定よりも優先されます。
• ポールのカスタマイズは、「 設定可能な統計情報」 セクションの表に示されている統計情報に対してのみ有効です。 ポールのカスタマイズが有効になっていない統計は、収集頻度が低く、システムにとって重要である。 収集された統計情報およびデフォルトのポーリング間隔の詳細については、 設定可能な統計情報のセクションを参照してください。
• インターバル設定をデフォルト値より小さく設定することはできません。 誤った設定を行った場合、このエントリは次に利用可能な高いポール・レート・コンフィギュレーション・バケットに移動されます。
• 設定可能な項目から統計情報を省略した場合（統計情報が 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:
          poept ll_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 形式でエクスポートします。

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

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