IBM DataPower のモニタリング

オンラインで編集する

Instana ホストエージェントをインストールすると、 IBM DataPower センサーは自動的にインストールされますが、このトピックで説明されている手順に従って、 IBM DataPower センサーを設定する必要があります。その後、 Instana のUIで、 IBM DataPower に関連するメトリクスを確認できます。

Instana （ DataPower ）のトレース機能を使用すると、 API Management の機能を監視し、 DataPower （ API Gateway ）におけるAPIの起動状況を調査することができます。 Instana の DataPower トレース機能を使用するには、まず IBM DataPower トレース機能をインストールして有効にする必要があります。詳細については、「 IBM DataPower のトレース」を参照してください。

サポート情報

オンラインで編集する

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

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

オンラインで編集する

「 IBM DataPower センサー」の対応OSについては、こちらをご覧ください。

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

オンラインで編集する

このセンサーは、 IBM DataPower、 2018.4、 10.0.1.x、 10.0.x、およびそれ以降のバージョンをサポートしています。

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


テクノロジー	サポート・ポリシー	最新バージョン	サポートされる最新バージョン
IBM DataPower	45 日間	11.0.0	10.6.0

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

追加のサポート情報

オンラインで編集する

IBM DataPower このセンサーは、ローカル監視とリモート監視の両方に対応しています。

前提条件

オンラインで編集する

Instana エージェントが IBM DataPower アプライアンスをモニターできるようにするには、REST 管理インターフェースおよび統計などのリソースのモニターを有効にする必要があります。

REST 管理インターフェースの有効化。詳細については、「REST管理インターフェースの有効化」を参照してください。
統計の有効化。詳細については、「統計情報の有効化」を参照してください。

の構成

オンラインで編集する

Instana リモートおよびローカルの IBM DataPower アプライアンスの両方の監視に対応しています。データを収集するには、エージェント構成ファイル <agent_install_dir>/etc/instana/configuration.yamlで以下のフィールドを構成する必要があります。

com.instana.plugin.ibmdatapower:
  enabled: true
  poll_rate: 60 # Default is 60 seconds
  instances: # Multiple DataPower instances can be specified
    DATAPOWER_INSTANCE_HOST_1: # Remote DataPower Host or IP address
      port: '<INSERT_PORT_HERE>' # DataPower instance REST management interface port
      username: '<INSERT_USERNAME_HERE>' # User account to connect to DataPower
      password: '<INSERT_PASSWORD_HERE>' # User password to connect to DataPower
      cluster: '<INSERT_CLUSTER_HERE>' # The cluster to group multiple DataPower instances (optional)
    DATAPOWER_INSTANCE_HOST_2: # Remote DataPower Host or IP address
      port: '<INSERT_PORT_HERE>' # DataPower instance REST management interface port
      username: '<INSERT_USERNAME_HERE>' # User account to connect to DataPower
      password: '<INSERT_PASSWORD_HERE>' # User password to connect to DataPower
      cluster: '<INSERT_CLUSTER_HERE>' # The cluster to group multiple DataPower instances (optional)
    local: # Local monitoring configuration
      port: '<INSERT_PORT_HERE>' # Local DataPower REST management interface port
      username: '<INSERT_USERNAME_HERE>' # User account to connect to DataPower
      password: '<INSERT_PASSWORD_HERE>' # User password to connect to DataPower

注:

この poll_rate 変数は、 IBM DataPower からのデータ取得頻度を表します。値は秒単位で表されます。デフォルトの poll_rate 値は 60 秒です。複数の DataPower アプライアンスが構成されている場合は、この値を大きくすることで poll_rate 、各データ取得間隔における DataPower センサーによるCPU使用率を低減できます。
cluster が構成されている場合、リモート DataPower インスタンスは、指定されたアベイラビリティー・ゾーンに別個のボックスとして表示されます。

ポーリングレートの設定

オンラインで編集する

注：Instana、 IBM DataPower センサー、および 1.0.20 以降のバージョンでは、データ取り込み量を削減するためにポーリングレートを設定できるようになっています。この機能は、セルフホスト型の Instana バックエンド311以降でサポートされています。

次の例に示すように、agent configuration.yaml ファイル poll_rate 内のパラメータを使用して、 Instana が IBM DataPower からデータやメトリクスを収集するためにポーリングを行う頻度を設定できます

com.instana.plugin.ibmdatapower:
  poll_rate: 60 # Default is 60 seconds

IBM DataPower の監視に関するサポートマトリックス

オンラインで編集する

以下の表は、 IBM DataPower の監視に関するサポートマトリックスをまとめたものです：


サポート・マトリックス	Instana 仮想マシン内のエージェント	Instana Kubernetes クラスタ内のエージェント	Instana Docker コンテナ内のエージェント
仮想マシン内のDataPower	サポート対象	サポートされていません	サポート対象
Kubernetes クラスター内のDataPower	サポート対象	サポート対象	サポート対象
Docker コンテナー内のDataPower	サポート対象	サポートされていません	サポート対象

仮想マシンでの IBM DataPower の監視

オンラインで編集する

ローカル・モニター

オンラインで編集する

Instana エージェントと IBM DataPower の両方が同じ仮想マシン上で実行されている場合、ローカル監視が行われます。このようなシナリオでは、 DataPower ホストまたは IP アドレスを構成する必要はなく、エージェント構成ファイルで local として指定するだけです。その後、 IBM DataPower センサーが DataPower アプライアンスのIPアドレスを自動的に検出します。次の構成例を参照してください。

com.instana.plugin.ibmdatapower:
  enabled: true
  poll_rate: 60
  instances:
    local:
      port: '5554'       # DataPower instance REST management interface port (required)
      username: 'admin'  # User account to connect to DataPower (required)
      password: 'admin'  # User password to connect to DataPower (required)

リモート監視

オンラインで編集する

Instana エージェントと IBM DataPower が別々の仮想マシン上で実行されている場合、リモート監視が行われます。このようなシナリオでは、 DataPower ホストまたは IP アドレスを構成する必要があります。次の構成例を参照してください。

com.instana.plugin.ibmdatapower:
  enabled: true
  poll_rate: 60
  instances:                   # Multiple DataPower instances can be specified
    10.0.0.1:                  # Remote DataPower Host or IP address
      port: '5554'             # DataPower instance REST management interface port (required)
      username: 'dpUser'       # User account to connect to DataPower (required)
      password: 'dpPassword'   # User password to connect to DataPower (required)
      cluster: 'clusterName'   # The cluster to group multiple DataPower instances (optional)
    datapower-inst.ibm.com:    # Remote DataPower Host or IP address
      port: '443'              # DataPower instance REST management interface port (required)
      username: 'dpUser'       # User account to connect to DataPower (required)
      password: 'dpPassword'   # User password to connect to DataPower (required)
      cluster: 'clusterName'   # The cluster to group multiple DataPower instances (optional)

Kubernetes クラスタにおける IBM DataPower の監視

オンラインで編集する

ローカル・モニター

オンラインで編集する

Instana エージェントと IBM DataPower の両方が同じ仮想マシン上で実行されている場合、ローカル監視が行われます。このようなシナリオでは、 DataPower ホストまたは IP アドレスを構成する必要はなく、エージェント構成ファイルで local として指定するだけです。構成は、「ローカル・モニター」セクションで概説されているものと同じです。

注：IBM DataPower センサーは、 DataPower アプライアンスのIPアドレスを自動的に検出します。その結果、センサーは各 DataPower アプライアンスを区別できません。したがって、 Kubernetes クラスターで実行されているすべての DataPower アプライアンスのポート、ユーザー名、およびパスワードは同じでなければなりません。

リモート監視

オンラインで編集する

リモート監視は、 IBM DataPower が Kubernetes クラスタ上で実行され、 Instana エージェントが別の仮想マシン上で実行されている場合に発生します。構成は、「リモート・モニター」セクションで概説されているものと同じです。

Docker における IBM DataPower の監視

オンラインで編集する

ローカル・モニター

オンラインで編集する

ローカル監視は、 Instana エージェントと IBM DataPower が、同じ仮想マシン内の異なる Docker コンテナで実行されている場合に発生します。このようなシナリオでは、 DataPower ホストまたは IP アドレスを構成する必要はなく、エージェント構成ファイルで local として指定するだけです。構成は、「ローカル・モニター」セクションで概説されているものと同じです。

リモート監視

オンラインで編集する

IBM DataPower が Docker コンテナ内で実行され、 Instana エージェントが別の仮想マシン内で実行されている場合、リモート監視が行われます。構成は、「リモート・モニター」セクションで概説されているものと同じです。

IBM DataPower 物理アプライアンスの監視

オンラインで編集する

リモート監視

オンラインで編集する

必要な認証情報をエージェントに設定することで、 IBM Datapower 物理アプライアンスをリモートで監視できます。構成は、「リモート・モニター」セクションで概説されているものと同じです。

Instana Datapower Physical Appliance 10.5.x 以降を監視します。

メトリックの表示

オンラインで編集する

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

Instana のUIのサイドバーで、 「インフラストラクチャ」 を選択します。
特定のモニター対象ホストをクリックします。

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

パフォーマンス・メトリック

オンラインで編集する

アプライアンス

オンラインで編集する


メトリック	説明
システム負荷	測定間隔中の、デバイス上の合計負荷のパーセンテージ。
CPU 使用率	モニター対象の DataPower アプライアンスの CPU 使用率の、直近 10 秒間での平均値。
メモリー使用率	メモリー合計量に対するパーセンテージで表した瞬間メモリー使用量。
暗号化済みファイル・システムの使用量	デバイスでの暗号化ストレージ・スペースの使用率。
受け入れられた接続	受け入れられた TCP 接続の数。
ワーク・リスト	アプライアンスによる処理のためにキューに入っている内部通信を含む、保留中の作業項目の数。
静止ドメイン	ドメインの静止状態を示します。
非アクティブ・オブジェクト	デバイスにデプロイされている非アクティブ・オブジェクトの数。
TCP サマリー Established	ESTABLISHED 状態の TCP 接続数。
TCP サマリー Syn Sent	SYN-SENT 状態の TCP 接続数。
TCP サマリー Syn Received	SYN-RECEIVED 状態の TCP 接続数。
TCP サマリー Fin Wait1	FIN-WAIT-1 状態の TCP 接続数。
TCP サマリー Fin Wait2	FIN-WAIT-2 状態の TCP 接続数。
TCP サマリー Closed	CLOSED 状態の TCP 接続数。
TCP サマリー Close Wait	CLOSE-WAIT 状態の TCP 接続数。
TCP サマリー Time Wait	CLOSE-WAIT 状態の TCP 接続数。
TCP サマリー Last Ack	LAST-ACK 状態の TCP 接続数。
TCP サマリー Listen	LISTEN 状態の TCP 接続数。
TCP サマリー Closing	CLOSING 状態の TCP 接続数。

ドメイン

オンラインで編集する


メトリック	説明
現在のメモリー使用量	このドメイン内のメモリー合計量に対するパーセンテージで表した瞬間メモリー使用量。

XML 名

オンラインで編集する


メトリック	説明
使用中	このドメインで現在使用されている XML の名称の数。
空きパーセンテージ	このドメイン内で現在利用可能な XML のドメイン名の割合。

ピアリング状況

オンラインで編集する


メトリック	説明
保留中の更新	このメンバーの未処理コマンドの数。詳細については、 `show gateway-peering-status` を参照してください。
複製オフセット	メンバーのレプリケーション・オフセット。メンバーの複製オフセットは、データ複製を共有するときの 1 次のオフセットと一致します。

イーサネット・インターフェース

オンラインで編集する


メトリック	説明
受信パケットのバイト数	受信したトラフィックのバイト数。
除去された受信パケット数	除去された受信パケットの数。
送信パケットのバイト数	送信したトラフィックのバイト数。
除去された送信パケット数	送信中に除去されたパケットの数。
1 秒当たりの受信パケット数	ネットワーク・インターフェースで受信された 1 秒当たりのパケット数。
1 秒当たりの送信パケット数	ネットワーク・インターフェースで送信された 1 秒当たりのパケット数。

MQ キューマネージャー（非推奨）

オンラインで編集する


メトリック	説明
バックエンドのアクティブな接続	バックエンド側のアクティブな接続の数。
フロントエンドのアクティブな接続	フロントエンド・サイドのアクティブな接続の数。
状況	MQ キューマネージャーオブジェクトの稼働状態。

IBM MQ キューマネージャー V9+

オンラインで編集する


メトリック	説明
バックエンドのアクティブな会話	MQ キューマネージャーとバックエンドシステム間のライブセッション数。
フロントエンドでの活発な対話	MQ キューマネージャーとクライアント間のライブセッション数。
状況	MQ キューマネージャーの V9+ オブジェクトの動作状態。

サービス

オンラインで編集する


メトリック	説明
現在のメモリー使用量	このサービスによる、5 分前から 1 分前までの間隔での現在のメモリー使用量。
平均トランザクション時間	直近 10 分間における平均トランザクション時間。
スループット	直近 10 分間におけるトランザクション率。

SQL データ・ソース

オンラインで編集する


メトリック	説明
アクティブな接続	SQL データ・ソースの名前。

正常性シグニチャー

オンラインで編集する

センサーごとに、着信メトリックに対して継続的に評価され、ユーザーへの影響に応じて問題またはインシデントを提起するために使用される正常性シグニチャーのキュレーション済み知識ベースがあります。

組み込みイベントは、エンティティのヘルスシグネチャに異常が検出されたことを受けて課題やインシデントをトリガーし、 カスタムイベントは、任意のエンティティの個別のメトリクスのしきい値に基づいて課題やインシデントをトリガーします。

Datapower センサーの組み込みイベントについては、組み込みイベントのリファレンスを参照してください。

トラブルシューティング

オンラインで編集する

DataPower インスタンスが UI に表示されない

オンラインで編集する

「問題のモニター」リストで、 DataPower 関連のイベントを見つけ、問題のタイプに従ってソリューションを確認します。

変数が定義されていない

オンラインで編集する

監視対象の種類： ibmdatapower_var_not_defined

構成で 1 つ以上の必須項目が欠落しています。「 configuration.yaml 」で、 DataPower インスタンスのポート、ユーザー名、およびパスワードが正しく設定されていることを確認してください。

変数に無効値が指定されている

オンラインで編集する

監視対象の種類： ibmdatapower_var_invalid_value

構成で 1 つ以上の必須項目に無効な値があります。 configuration.yaml において、 DataPower インスタンスのポート、ユーザー名、およびパスワードが正しく設定されていることを確認してください。

接続エラー

オンラインで編集する

監視対象の種類： ibmdatapower_connection_error

何度も再試行した後、DataPower センサーを DataPower インスタンスに接続できませんでした。 configuration.yaml において、 DataPower インスタンスのポート、ユーザー名、およびパスワードが正しく設定されていることを確認してください。

その他の例外

オンラインで編集する

監視対象の種類： ibmdatapower_exception_error

DataPower センサーで、まだ文書化されていないまれな例外が検出されました。これは、 Instana エージェントまたは DataPower に問題があることを示している可能性があります。