Informix DB のモニター

オンラインで編集する

Instana を使用すれば、 IBM® Informix® のデータベースを包括的に監視できます。 Instana ホストエージェントをインストールした後、 Instana OTel センサーSDKデータベースをインストールする必要があります。 次に、 Informix データベースが実行されているホスト上で、 Instana OTel SDK for databases を実行する必要があります。

「 Informix 」データベースの構成」 セクションの手順に従って「 Informix 」データベースセンサーを設定すると、「 Instana 」UIで「 Informix 」データベースに関連するメトリクスを確認できるようになります。

サポート情報

オンラインで編集する

Informix のDBセンサーが現在の環境と互換性があるかどうかを確認するには、以下のサポート情報セクションをご確認ください：

サポート対象のオペレーティング・システム

オンラインで編集する

Informix DBセンサーの対応OSは、各ホストエージェントの要件と一致しています。これについては、各ホストエージェントの 「対応OS 」セクションで確認できます。例： Unix の対応OS。

対応バージョンとサポート方針

オンラインで編集する

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

テクノロジー サポート・ポリシー 最新バージョン サポートされる最新バージョン
Informix DB オンデマンド 15.0 14.0

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

Informix データベース用 OTel SDKのインストール

オンラインで編集する
注： このSDKを実行するには、 Java s 11が必要です。

Informix データベース用の OTel SDKをインストールするには、以下の手順を実行してください：

  1. Releasesから .tar ファイルをダウンロードします。

  2. 以下のコマンドを使用して、 .tar ファイルを解凍します。
    tar vxf otel-dc-rdb-X.Y.Z.tar

    これで、フォルダー otel-dc-rdb-X.Y.Z が作成されたことが分かります。

  3. Go otel-dc-rdb-X.Y.Z ディレクトリへ：
    cd otel-dc-rdb-X.Y.Z
  4. Go config ディレクトリに：
    cd config

  5. Informix DB の詳細を使用して、 config-informix.yaml ファイルを変更します。 詳細については、 GitHub をご覧ください。

    デフォルトの構成ファイルは config/config.yamlです。 また、環境変数を使用して DC_CONFIG 、次のように設定ファイルを指定することもできます：
    export DC_CONFIG=config/config-informix.yaml
  6. Go otel-dc-rdb-X.Y.Z ディレクトリに戻り、シェルから次のコマンドを実行して、 Informix DB用の Instana Otel SDK実行ファイルを実行します：
    ./bin/otel-dc-rdb

Informix データベースの設定

オンラインで編集する
Informix DB センサーは、ローカル・モニターとリモート・モニターの両方をサポートします。 Instana OTel のデータベース用 SDK が、 Informix DB と同じホスト上で実行されている場合、ローカルモニタリングが行われます。 リモート監視は、 Instana OTel のデータベース用 SDK が、 Informix データベースが実行されているホストとは異なるホスト上で実行されている場合に発生します。 Informix DBセンサーの性能を最大限に引き出すには、ローカル監視機能をご利用ください。 どちらの場合も、エージェントの configuration.yaml ファイルに以下の構成を追加してから、エージェントを開始します。
# OpenTelemetry Collector
com.instana.plugin.opentelemetry:
  enabled: true
  grpc:
    enabled: true # takes precedence over legacy settings above, defaults to true if "grpc:" is present
  http:
    enabled: true # allows to enable http endpoints, defaults to true if "http:" is present

ローカル・モニター

オンラインで編集する

ローカル・モニターを構成するには、以下の手順を実行します。

  1. Go 次のコマンドを使用して、その config フォルダに：
    cd config

  2. Informix DB の詳細を使用して、 config-informix.yaml ファイルを変更します。 詳細については、 GitHub をご覧ください。

    以下のサンプル構成ファイルを参照してください。
    db.system: informix #Keep as it is
db.driver: com.informix.jdbc.IfxDriver #Keep as it is
instances:
  - db.address: xxx.xxx.xxx.xxx #IP Address
    db.port: 9088 #Port on which DB is running
    db.serverName: ol_informix1410
    db.username: Informix_User_Name
    ### Either use password with Base 64 encoding or use vault configuration.
    db.password: BASE64_Encoded_Password
    #db.password:
    # vault_secret.path: #path to the vault secret. Example: /kv/instana/informix
    # vault_secret.key: #Provide the VaultSecretKey name
    db.name: InformixDB
    db.path: /opt/IBM/Informix_Software_Bundle

    #OTel properties:
    otel.service.name: InformixDB #Keep as it is

    #Data collector properties:
    #Either use `poll.interval` or `custom.poll.interval`
    #poll.interval: 30
    #All three category value is Mandatory if leveraging Custom Poll Rate
    custom.poll.interval:
      high: 300 #polling_value_in_sec
      medium: 45 #polling_value_in_sec
      low: 20 #polling_value_in_sec
    callback.interval: 20 #Keep as it is
    otel.backend.url: http://127.0.0.1:4317 #Point to the running agent

    #Custom Input
    custom.input: # Optional
      #Time Frame for which you want to get the expensive query. Default value 900 Sec
      db.sql.elapsed.timeframe: 900   # Values should be in Seconds
      db.sequential.scan.count: 0
      db.sql.trace.enabled: false #Default is false. Make it true only if `SqlTrace` is enabled for the DB.
    ### Uncomment the below section in case you are using Vault to retrieve the password.
    # vault:
    #  connection_url: #Vault Address URL
    #  token: #Vault Token
    #  #Use the pem file path in case you are using TLS/SSL connection for vault.
    #  #path_to_pem_file: auth/web-cert.pem
    #  kv_version: 2 #It is the vault version. Please crosscheck your configuration.
注： 平文のパスワードを指定する必要がある場合、 db.password の値は Base64 でエンコードされたものでなければなりません。 text.The ボールト設定の詳細は、 case.The では無効にする必要があります。また、この SDK はボールトベースの認証もサポートしています。 mechanism.When パスワードはボールト設定を通じて指定する必要があり、それらを db.password フィールドに追加する必要があります。

以下のVault構成の詳細をお客様に提供します。 db.password分野 ：

  1. vault_secret.path:このフィールドにボールト シークレットのパスを指定します。
  2. vault_secret.key:このフィールドにボールトベースの認証キーを指定します。

また、 Vault 認証メカニズムを使用する際は、設定内の「vault」キーを有効にする必要があります。 次のフィールドも有効にする必要があります。

  1. connection_url: Vault の URL
  2. token: 「 Vault 」トークンの値
  3. path_to_pem_file: Vaultで TLS または SSL 接続を使用する場合のpemファイルへのパス。
  4. kv_version: Vault のバージョン

Vault の設定に関する詳細については、 Vault の公式ドキュメントを参照してください。

リモート監視

オンラインで編集する

エージェントのシステムとは異なるシステムで SDK を実行するには、以下の構成を /instana-agent/etc/instana/com.instana.agent.main.config.Agent.cfg内の backend.cfg ファイルに追加します。

#If your DC is in a different host from your Instana Agent

http.listen=*

リモート監視では、 Instana （ OTel ）のSDKは、 Informix データベースとは別のホスト上で実行されます。

単一データベース用のサンプル構成ファイルは、以下のとおりです。
db.system: informix #Keep as it is
db.driver: com.informix.jdbc.IfxDriver #Keep as it is
instances:
  - db.address: xxx.xxx.xxx.xxx #IP Address
    db.port: 9088 #Port on which DB is running
    db.serverName: ol_informix1410
    db.username: Informix_User_Name
    ### Either use password with Base 64 encoding or use vault configuration.
    db.password: BASE64_Encoded_Password
    #db.password:
    #  vault_secret.path: #path to the vault secret. Example: /kv/instana/informix
    #  vault_secret.key: #Provide the VaultSecretKey name
    db.name: InformixDB
    db.path: /opt/IBM/Informix_Software_Bundle

    #OTel properties:
    otel.service.name: InformixDB #Keep as it is

    #Data collector properties:
    #Either use `poll.interval` or `custom.poll.interval`
    #poll.interval: 30
    #All three category value is Mandatory if leveraging Custom Poll Rate
    custom.poll.interval:
      high: 300 #polling_value_in_sec
      medium: 45 #polling_value_in_sec
      low: 20 #polling_value_in_sec
    callback.interval: 20 #Keep as it is
    otel.backend.url: http://<ip_of_host_having_instana_otel_sdk>:4317 #Point to the running agent

    #Custom Input
    custom.input: # Optional
      #Time Frame for which you want to get the expensive query. Default value 900 Sec
      db.sql.elapsed.timeframe: 900   # Values should be in Seconds
      db.sequential.scan.count: 0
      db.sql.trace.enabled: false #Default is false. Make it true only if `SqlTrace` is enabled for the DB.
     ### Uncomment the below section in case you are using Vault to retrieve the password.
     # vault:
        #  connection_url: #Vault Address URL
        #  token: #Vault Token
        #  #Use the pem file path in case you are using TLS/SSL connection for vault.
        #  #path_to_pem_file: auth/web-cert.pem
        #  kv_version: 2 #It is the vault version. Please crosscheck your configuration.
複数のデータベース用のサンプル構成ファイルは、以下のとおりです。
db.system: informix #Keep as it is
db.driver: com.informix.jdbc.IfxDriver #Keep as it is
instances:
  - db.address: xxx.xxx.xxx.xxx #IP Address
    db.port: 9088 #Port on which DB is running
    db.serverName: ol_informix1410
    db.username: Informix_User_Name
    ### Either use password with Base 64 encoding or use vault configuration.
    db.password: BASE64_Encoded_Password
    #db.password:
    #  vault_secret.path: #path to the vault secret. Example: /kv/instana/informix
    #  vault_secret.key: #Provide the VaultSecretKey name
    db.name: InformixDB
    db.path: /opt/IBM/Informix_Software_Bundle

    #OTel properties:
    otel.service.name: InformixDB #Keep as it is

    #Data collector properties:
    #Either use `poll.interval` or `custom.poll.interval`
    #poll.interval: 30
    #All three category value is Mandatory if leveraging Custom Poll Rate
    custom.poll.interval:
      high: 300 #polling_value_in_sec
      medium: 45 #polling_value_in_sec
      low: 20 #polling_value_in_sec
    callback.interval: 20 #Keep as it is
    otel.backend.url: http://127.0.0.1:4317 #Point to the running agent

    #Custom Input
    custom.input: # Optional
      #Time Frame for which you want to get the expensive query. Default value 900 Sec
      db.sql.elapsed.timeframe: 900   # Values should be in Seconds
      db.sequential.scan.count: 0

  - db.address: xxx.xxx.xxx.xxx #IP Address
    db.port: 9088 #Port on which DB is running
    db.serverName: ol_informix1410
    db.username: Informix_User_Name
    ### Either use password with Base 64 encoding or use vault configuration.
    db.password: BASE64_Encoded_Password
    #db.password:
    #  vault_secret.path: #path to the vault secret. Example: /kv/instana/informix
    #  vault_secret.key: #Provide the VaultSecretKey name
    db.name: InformixDB
    db.path: /opt/IBM/Informix_Software_Bundle

    #OTel properties:
    otel.service.name: InformixDB #Keep as it is

    #Data collector properties:
    #Either use `poll.interval` or `custom.poll.interval`
    #poll.interval: 30
    #All three category value is Mandatory if leveraging Custom Poll Rate
    custom.poll.interval:
      high: 300 #polling_value_in_sec
      medium: 45 #polling_value_in_sec
      low: 20 #polling_value_in_sec
    callback.interval: 20 #Keep as it is
    otel.backend.url: http://127.0.0.1:4317 #Point to the running agent

    #Custom Input
    custom.input: # Optional
      #Time Frame for which you want to get the expensive query. Default value 900 Sec
      db.sql.elapsed.timeframe: 900   # Values should be in Seconds
      db.sql.trace.enabled: false #Default is false. Make it true only if `SqlTrace` is enabled for the DB.
    ### Uncomment the below section in case you are using Vault to retrieve the password.
     # vault:
        #  connection_url: #Vault Address URL
        #  token: #Vault Token
        #  #Use the pem file path in case you are using TLS/SSL connection for vault.
        #  #path_to_pem_file: auth/web-cert.pem
        #  kv_version: 2 #It is the vault version. Please crosscheck your configuration.

メトリックの表示

オンラインで編集する

メトリックを表示するには、以下のステップを実行します。

  1. Instana のUIにあるナビゲーションメニューから、 「インフラストラクチャ」 を選択します。

  2. 特定のモニター対象ホストをクリックします。

収集されたすべてのメトリックとモニター対象プロセスを含むホスト・ダッシュボードを表示できます。

Informix DB センサーごとに、以下のメトリックが使用可能です。

メトリック 説明 オンサイトまたはリモートでのサポート 調査間隔の区分
インスタンス数 Informix DBインスタンス数 リモート（SQL） 短
アクティブ・インスタンス数 アクティブなInformix DBインスタンスの数 リモート（SQL） 短
セッション数 Informix DB セッション数 ローカル (CMD) 短
アクティブなセッション数 アクティブになっている Informix DB セッションの数 ローカル (CMD) 短
トランザクション数 Informix DB トランザクションの数 ローカル (CMD) 中間
トランザクション待ち時間カウント トランザクションの遅延 ローカル (CMD) 中間
SQL数 実行された照会の数 ローカル (CMD) 中間
1秒当たりのSQL 1秒間に実行されるクエリー数 ローカル (CMD) 中間
入出力読み取り数 入出力読み取り数 ローカル (CMD) 短
IO書き込み回数 IOライト数 ローカル (CMD) 短
SQL経過時間 最も時間のかかる照会とその実行時間 リモート（SQL） 中間
ディスク書き込み数 ディスク書き込み数 ローカル (CMD) 短
ディスク読み取り ディスク読み取り数 ローカル (CMD) 短
スキャン すべての表の順次スキャンの数 リモート（SQL） 短
TABLE SCANS Informix DBセッションのシーケンシャルスキャン数 リモート（SQL） 短
オーバーフロー-ロック ロックが使用できなかったときにスレッドがロックを獲得しようとした回数 ローカル (CMD) 短
オーバーフロー-ユーザー ロックが使用不可のときにユーザー・スレッドがロックを獲得しようとした回数 ローカル (CMD) 短
オーバーフロー - トランザクション 共用メモリー・テーブル内の項目が使用できなかったときに、スレッドがトランザクション・テーブル内の項目を割り振ろうとした回数 ローカル (CMD) 短
メモリー使用状況 使用メモリ量 ローカル (CMD) 短
バッファキャッシュ比率（読み取り） キャッシュされたページ画像によって満たされたページ閲覧の割合 ローカル (CMD) 短
バッファキャッシュ比率（書き込み） キャッシュされたページイメージによって満たされたページ書き込みの割合 ローカル (CMD) 短
LRUライト LRU（Least Recently Used）書き込み回数 ローカル (CMD) 短
データベース・ロック待機 ロックを待っているスレッド数 ローカル (CMD) 短
表スペース データベースの上位20テーブルの使用可能ストレージと使用済みストレージに関する情報 リモート（SQL） ロング
  • ローカルでのサポート ：メトリクスは、コマンド onstat を使用してシステムから直接収集されます。
  • リモートサポート ：メトリクスは を通じて収集されます SQL queries。これは、ローカルまたはリモートで実行可能です。 したがって、これらの指標は、ローカルおよびリモートでの監視の両方でサポートされています。
  • ポーリング間隔のカテゴリ ：各メトリクスは、「短」、「中」、「長」のいずれかのポーリング間隔カテゴリに分類されます。 ポーリング間隔は、メトリクスの抽出に使用される頻度または時間を決定します。
  • デフォルトのポーリング間隔は次のように設定されています：
    • ショート - 20秒
    • 中 - 45秒
    • 長め - 300秒。