IBM ITM との連携 V6 (パブリックプレビュー)

オンラインで編集する

IBM Tivoli Monitoring および V6 のエージェントを Instana と統合し、ITMセンサーを使用して、レガシーシステムと最新のインフラストラクチャを同時に監視します。

サマリー

IBM Tivoli Monitoring （ V6 ）と Instana の統合は、 Instana ホストエージェント用のITMセンサーを使用することで実現されます。 ITM V6 または ITCAM V7 のエージェントは、デュアルモードで通信するように設定されています。これにより、 IBM TEMS サーバーへのデータ送信を継続しながら、 Instana ホストエージェントへのデータ送信も行うことが可能になります。 Instana ホストエージェント内のITMセンサーは、ITMエージェントからメトリックペイロードを受信し、それらを Instana バックエンドに送信します。そこでペイロードが処理され、 Instana サーバーにエンティティが作成されるとともに、 Instana UIに表示するためにメトリックが保存されます。

重要： 以前の IBM Monitoring Instana 統合サービス（統合プロキシ）は、2026年3月に非推奨となり、サポートが終了しました。 すべてのユーザーは、 Instana ホストエージェント用にITMセンサーへ移行する必要があります。

前提条件

作業を始める前に、以下のものが揃っていることを確認してください：

  • ホストのオペレーティングシステムに直接インストールされた Instana ホストエージェント。 エージェントは、コンテナ内や Kubernetes/OpenShift 環境ではなく、ホストOS自体にインストールする必要があります。 詳細については、 「ホストエージェントのインストール」 を参照してください。
  • ITM V6 および ITCAM V7 のエージェントに、必要な TEMA（コアフレームワーク）パッチが適用されています：
    • HTTP 経由で接続するには：バージョン 以降のパッチ 6.3.0.7-TIV-ITM_TEMA-IF0003 を適用してください。
    • HTTPS 経由で接続するには：バージョン 以降のパッチ 6.3.0.7-TIV-ITM_TEMA-IF0008 を適用してください。

ITMサポートの有効化

ITMの V6 サポートを有効にするには、以下の手順を実行する必要があります：

  1. Instana ホストエージェントでITMセンサーを有効にしてください。
  2. ITMエージェント設定パックをダウンロードして設定してください。
  3. ITMの V6 エージェントを設定し、 Instana ホストエージェントに接続するようにします。

ITMセンサーを有効にする

ホストエージェントのITMセンサーを使用したメトリクスの取り込みは、デフォルトでは無効になっています。 ITMセンサーを有効にするには、エージェント設定ファイルの該当 com.instana.plugin.itm セクションを探し、センサーを設定してください。

編集 <agent_install_dir>/etc/instana/configuration.yaml：

# ITM Sensor
com.instana.plugin.itm:
  enabled: true
#  availabilityZone: 'My ITM zone' # default is 'ITM Remote Monitoring'

設定オプション：

  • enabled: ITMセンサーを有効にするには、[設定 true ] に設定してください。
  • availabilityZone: Instana で ITM エンティティをグループ化するための任意のカスタム名。 指定がない場合は、デフォルトで ITM Remote Monitoring. になります。

ストレージ要件の調整

ITMセンサーを使用する際、 Instana ホストエージェントのストレージ要件を調整するには、次のファイルを変更 /opt/instana/agent/bin/setenvしてください：

次に、以下の例に示すように、更新された値で以下の行を修正してください：

DEFAULT_AGENT_MAX_MEM='2048m'
DEFAULT_HEAP_MAX_MEM='320m'
注： 表示されている実際の設定は、メモリサイズを調整するために変更できますが、処理するデータ量によって異なる場合があります。 ホストエージェントのデフォルトのメモリ容量は512 MBです。

TLS または HTTPS との通信の設定

デフォルトでは、ITMエージェントは、ポート42699の HTTP 経由で Instana ホストエージェントと通信します。 安全な通信を行うために、ITMエージェントと Instana ホストエージェント間の TLS / HTTPS 接続を設定できます。

HTTPS をセットアップするには、以下が必要です：

  1. Instana ホストエージェントで TLS 証明書を設定し、ポート42699での HTTPS を有効にする。
  2. Instana ホストエージェントの証明書を信頼するITMエージェント用に、 IBM GSK（Global Security Kit）キーリングファイルを作成します。
  3. ファイル env.properties を変更して、. を使用 protocol=httpsするようにします。

TLS / HTTPS の設定方法については、 「ITM V6 統合のための TLS / HTTPS の設定」 を参照してください。

構成パックのセットアップ

ITMの V6 エージェントを Instana ホストエージェントに接続するように設定するには、エージェント設定パックをダウンロードして使用する必要があります。

設定パックのダウンロード

  1. https://github.com/instana/ibm-monitoring-integration/releases から、最新リリースのエージェント設定パックをダウンロードしてください。
  2. ファイル instana-v6-configpack.zip または instana-v6-configpack.tar ファイルをダウンロードしてください。
  3. 設定パックを、設定を実行するシステム上の一時ディレクトリに解凍してください。

ITMエージェントの設定

ITM V6 エージェントの設定は、ローカル（エージェントがインストールされているシステム上）またはリモート（コマンド tacmd を使用）で行うことができます。

ローカル構成

「 V6 」エージェントをローカルで設定し、「 Instana 」ホストエージェントに接続するには、「 V6 」エージェントがインストールされているシステムで、以下の手順を実行してください：

  1. 解凍した設定パックのファイル env.properties を開き、 InstanaINSTANA_AGENT_HOST のホストエージェントが実行されているホスト名に置き換えてください。 例:
    hostname=instana.example.com
    注：HTTP の代わりに HTTPS を使用する場合は、 ITM V6 統合のための TLS / HTTPS の設定に関する完全なセットアップ手順を参照してください。
  2. スクリプト agent2server_itm を、 -c、および -e オプション -iを指定して実行します：

    AIX/Linux:

    ./agent2server_itm.sh -i <agent_install_dir> -c <connection_mode> -e env.properties

    Windows:

    agent2server_itm.bat -i <agent_install_dir> -c <connection_mode> -e env.properties

    ここで:

    • <agent_install_dir> エージェントのインストールディレクトリです。 例えば、/opt/IBM/ITMです。
    • <connection_mode> 次のいずれかです：
      • dual - エージェントは、TEMSと Instana のホストエージェントの両方に接続します。
      • instana - エージェントは、 Instana のホストエージェントにのみ接続します。
    注：Linux または AIX システムでは、リンク先のデフォルトのシステムシェルは sh、 bash/bin/sh 、または ksh でなければなりません。
    注： 現在実行中のエージェントはすべて、このスクリプトによって再起動されます。

リモート構成

V6 エージェントをリモートで設定し、 Instana ホストエージェントに接続するには、以下の手順を実行してください：

  1. 解凍した設定パックのファイル env.properties を開き、 InstanaINSTANA_AGENT_HOST のホストエージェントが実行されているホスト名に置き換えてください。 例:
    hostname=instana.example.com
    注：HTTP の代わりに HTTPS を使用する場合は、 ITM V6 統合のための TLS / HTTPS の設定に関する完全なセットアップ手順を参照してください。
  2. V6 エージェントがインストールされているリモートシステム上に、一時ディレクトリを作成します：

    Linux 例：

    tacmd executecommand -m kvm-011235:LZ -c "nohup /bin/sh -c 'mkdir /tmp/configpack > /tmp/output'"

    Windows 例：

    tacmd executecommand -m Primary:IMG-WINDOWS2008:NT -c "md C:\IBM\ITM\configpack"
  3. エージェント設定パックのファイルをリモートシステムに転送します：

    Linux 例（抽出されたファイル）：

    tacmd putfile -m kvm-011235:LZ -s /mnt/configpacks/instana-v6-configpack/agent2server_itm.sh -d /tmp/configpack/agent2server_itm.sh -t text
tacmd putfile -m kvm-011235:LZ -s /mnt/configpacks/instana-v6-configpack/env.properties -d /tmp/configpack/env.properties -t text
# Make the script executable
tacmd executecommand -m kvm-011235:LZ -c "chmod +x /tmp/configpack/agent2server_itm.sh"

    Windows 例（抽出されたファイル）：

    tacmd putfile -m Primary:IMG-WINDOWS2008:NT -s C:\temp\instana-v6-configpack\agent2server_itm.bat -d C:\IBM\ITM\configpack\agent2server_itm.bat -t text
tacmd putfile -m Primary:IMG-WINDOWS2008:NT -s C:\temp\instana-v6-configpack\env.properties -d C:\IBM\ITM\configpack\env.properties -t text
  4. リモートシステムでスクリプト agent2server_itm を実行します：

    Linux 例（デュアルモード）：

    tacmd executecommand -m kvm-011235:LZ -c "nohup /bin/sh -c 'sleep 10; /tmp/configpack/agent2server_itm.sh -i /opt/IBM/ITM -c dual -e /tmp/configpack/env.properties > /tmp/output' &" -w /tmp/configpack

    Windows 例（デュアルモード）：

    tacmd executecommand -m Primary:IMG-WINDOWS2016:NT -c "START /B C:\IBM\ITM\configpack\agent2server_itm.bat -i C:\IBM\ITM -e C:\IBM\ITM\configpack\env.properties -c dual" -w C:\IBM\ITM\configpack

    エージェントを Instana のホストエージェントにのみ接続させたい場合は、 -c instana を に -c dual 置き換えてください。

    注： この tacmd executecommand コマンドは即座に終了しますが、スクリプトはリモートシステム上でバックグラウンドで実行され続けます。 結果を確認するには、しばらく待ってから出力ファイルを確認してください：
    • Linux: tacmd executecommand -m kvm-011235:LZ -c "cat /tmp/output"
    • Windows: tacmd executecommand -m Primary:IMG-WINDOWS2016:NT -c "type C:\IBM\ITM\configpack\output.log"
    注：AIX または Linux システムでは、リモートシステム上で agent2server_itm スクリプトを実行するには、sh、 bash、または ksh シェルが必要です。

カスタムエージェントの設定（ Agent Builder またはAgent Factory）

Agent Builder またはAgent Factoryを使用してカスタムITMエージェントを構築している場合は、 Instana との適切な連携を有効にするために、SDA（Self Describing Agent）のJARファイルを含める必要があります。 オプション -j を使用して、SDA JAR ファイルの保存場所を指定してください。

構文:

-j "productcode=path_to_support_directory"

ここで:

  • productcode は2文字のITM製品コードです（例：カスタムエージェント 01 の場合は）。
  • path_to_support_directory SDA JAR ファイルが含まれているディレクトリです。

supportディレクトリには、パターン k{productcode}_sda_*.jar または に一致するJARファイルが含ま {productcode}_sda_*.jarれている必要があります。 SDA対応のカスタムエージェントの作成方法については、 ITMの「 Agent Builder 」および「 XML 」の「SDAの設定」 を参照してください。

ローカル設定の例：

AIX/Linux:

./agent2server_itm.sh -i /opt/IBM/ITM -c dual -j "01=/tmp/k01/support"

Windows:

agent2server_itm.bat -i C:\IBM\ITM -c dual -j "01=C:\Downloads\k01\support"

複数のカスタムエージェント：

複数のカスタムエージェントを設定するには、マッピングをコンマで区切ってください：

-j "01=/path/to/k01/support,11=/path/to/k11/support"

このスクリプトの機能：

この -j オプションを指定すると、スクリプトは：

  • 指定されたサポートディレクトリ内にSDA JARファイルが存在することを確認します。
  • JARファイルをターゲットシステムの適切なITMエージェントサポートディレクトリにコピーします。
  • JARファイルの命名規則として、 k{productcode}_sda_*.jar または {productcode}_sda_*.jar. を使用することを想定しています。

たとえば、製品コード の場合 01、スクリプトは指定されたディレクトリ内で 01_sda_*.jar または k01_sda_*.jar を検索します。

カスタムエージェントを使用したリモート設定：

でリモート設定 tacmdを行う場合、コマンド executecommand に オプション -j を含めることができます：

Linux 例：

tacmd executecommand -m kvm-011235:LZ -c "nohup /bin/sh -c 'sleep 10; /tmp/configpack/agent2server_itm.sh -i /opt/IBM/ITM -c dual -e /tmp/configpack/env.properties -j "01=/tmp/k01/support" > /tmp/output' &" -w /tmp/configpack

Windows 例：

tacmd executecommand -m Primary:IMG-WINDOWS2016:NT -c "START /B C:\IBM\ITM\configpack\agent2server_itm.bat -i C:\IBM\ITM -e C:\IBM\ITM\configpack\env.properties -c dual -j "01=C:\temp\k01\support"" -w C:\IBM\ITM\configpack
注： 設定スクリプトを実行する前に、SDAサポートディレクトリをリモートシステムに転送しておく必要があります。

設定結果

設定完了後、ITM V6 エージェントは、指定したモードに基づいて接続します：

  • デュアルモード (-c dual): エージェントは、TEMSと Instana ホストエージェントの両方に接続します。 監視データは、TEPおよび Instana のユーザーインターフェースの両方で確認できます。
  • Instana モード (-c instana): エージェントは、 Instana のホストエージェントにのみ接続します。 監視データは、 Instana のユーザーインターフェースでのみ利用可能です。

TEMSへの再接続のみ

エージェントをTEMSにのみ再接続する必要がある場合は、次のコマンドを実行してください：

AIX/Linux:

./agent2server_itm.sh -i <agent_install_dir> -c itm

Windows:

agent2server_itm.bat -i <agent_install_dir> -c itm

はエージェントのインストール <agent_install_dir> ディレクトリです。

注： この -c itm オプションは必須です。オプションを -c 指定しない場合、スクリプトはデフォルトで instana モードになります。 エージェントをTEMSに再接続するには、[ -c itm Use] を使用してください。

対応しているITMエージェントのバージョン

このITMセンサーは、必要なTEMA（コアフレームワーク）パッチが適用された、ITM V6 エージェントのバージョン 6.3.0.7 以降に対応しています。 具体的なパッチの要件については、 「前提条件」 を参照してください。

データの視覚化

Instana における監視データの表示方法は、ITM エージェントの種類によって異なります：

Instana のネイティブエンティティ型

ネイティブの Instana エンティティタイプ用の組み込みダッシュボードでは、以下のITMエージェントタイプが表示されます：

  • Linux OSエージェント、 Windows OSエージェント、 Unix OSエージェント ( AIX ) - 収集されたメトリクスについては、ホストセンサー を参照してください。
  • IBM MQ agent - 収集されたメトリクスについては、「 IBM MQ 」センサー を参照してください。

OpenTelemetry エンティティ型

その他のすべてのITMエージェントタイプ（ DataPower,、 App Connect Enterprise （ACE）、 WebSphere Application Server （ WAS ）、および Agent Builder /Agent Factoryで構築されたカスタムエージェントなど）は、 Instana において OpenTelemetry エンティティとして表示されます。

SDAのカスタムエージェント対応

Agent Builder /Agent Factory を使用して構築されたカスタムエージェントが、 Instana に SDA（Self Describing Agent）コンテンツを提供するには、エージェントのビルドに SDA JAR ファイルを含める必要があります。 設定の詳細については、 ITM Agent Builder XML の「SDAの設定」 を参照してください。

メトリック収集

ITM V6 エージェントから収集されたメトリクスを確認するには、 Instana のユーザーインターフェースのサイドバーで [Infrastructure] を選択し、監視対象の特定のホストまたはエンティティをクリックします。すると、収集されたすべてのメトリクスが表示されたダッシュボードが表示されます。

注： この連携では、メトリクスのみが収集されます。 この経路を通じて、ITMエージェントからのデータは収集されません。

指標の収集方法

  1. サブスクリプション・ファイルの管理： ITMセンサーは、ITM V6 エージェントからの要求に応じて、サブスクリプション・ファイルを提供します。 これらのファイルでは、各テーブルについて、収集するメトリクスと収集間隔（SUBINTERVALの値）が定義されています。
  2. ITMエージェントによるデータ収集： ITM V6 エージェントは、サブスクリプションファイルで定義されたSUBINTERVAL値（通常は1～5分）に基づいて、テーブルのメトリクスを収集します。 各テーブルごとに異なる収集間隔を設定できます。
  3. 接続モードに基づくデータ転送：
    • デュアルモード (-c dual): 収集後、ITMエージェントは、TEMS（TEPの表示用）と Instana ホストエージェント（ Instana UIの表示用）の両方にメトリクスを送信します。
    • Instana mode (-c instana): 収集後、ITMエージェントはメトリクスを Instana ホストエージェント（ Instana UIでの表示用）にのみ送信します。
  4. ITMセンサーの処理：Instana ホストエージェント内のITMセンサーは、ITMエージェントから受信したデータを処理し、 Instana バックエンドに転送します。
  5. メトリクスの利用状況： この統合機能は、ITMエージェントから主要なパフォーマンスメトリクスを収集します。 TEPで利用可能な一部の専門的または歴史的な指標は、 Instana では利用できない場合があります。これは、統合が主要なパフォーマンス指標に重点を置いているためです。

トラブルシューティング

接続の問題

ITMエージェントが Instana ホストエージェントに接続していない場合：

  1. Instana のホストエージェント設定で、ITMセンサーが有効になっていることを確認してください。
  2. Instanaenv.properties ホストエージェントのホスト名がファイルに正しく設定されていることを確認してください。
  3. ITMエージェントに必要なTEMAフレームワークのパッチが適用されていることを確認してください。
  4. ネットワーク接続を確認してください：
    • 接続を確認する： telnet <instana_host> 42699
    • Instana のホストエージェントシステムで、ポート42699が開いていることを確認してください。
    • ITMエージェントシステムからのトラフィックが許可されているか、ファイアウォールのルールを確認してください。
  5. ログを確認する：
    • ITMエージェントのログ： $CANDLEHOME/logs/<hostname>_<product_code>_*.log.
    • Instana ホストエージェントのログ： /opt/instana/agent/data/log/agent.log.

Instana のホストエージェントへの接続に失敗しました

ITMエージェントが Instana のホストエージェントに接続できない場合は、ホストエージェントが利用可能なネットワークインターフェースでリスニングするように設定する必要があるかもしれません。 詳細については、 「一般リファレンス - ネットワーク」 を参照してください。

ITMエージェントは、ポート42699（ファイル env.properties で定義されている通り）を介して、 Instana ホストエージェントにデータを送信します。 ITMエージェントが実行されているシステムから、このポートにアクセスできることを確認してください。

欠落しているメトリクス

Instana にメトリクスが表示されない場合：

  1. ITMエージェントがデュアルモードで実行されていることを確認してください。
  2. Instana のホストエージェントがITMセンサーからデータを受信していることを確認してください。
  3. Instana のホストエージェントのログを確認し、ITMセンサーに関連するエラーがないか確認してください。
  4. ITMエージェントが、想定されるメトリクスを収集するように設定されていることを確認してください。