IBM MQ Managed File Transfer の監視
Instana ホストエージェントをインストールすると、 IBM MQ Managed File Transfer (MFT)センサーが自動的にインストールされますが、このトピックで説明されている手順に従って、 IBM MQ MFTセンサーを設定する必要があります。 その後、 Instana のUIで、 IBM MQ MFTに関連するメトリクスを確認できます。
サポート情報
IBM MQ Managed File Transfer センサーが現在の環境と互換性があるかどうかを確認するには、以下のサポート情報セクションをご確認ください:
サポート対象のオペレーティング・システム
IBM MQ のMFTセンサーがサポートするオペレーティングシステムは、各ホストエージェントの要件と一致しています。これについては、各ホストエージェントの 「サポート対象のオペレーティングシステム 」セクションで確認できます。例: Linux のサポート対象オペレーティングシステム。
対応バージョンとサポート方針
このセンサーは、 IBM MQ MFT 9.0.0 以降に対応しており、これらは IBM MQ MFT がサポートするすべてのプラットフォームにインストールされています。 詳細については、 「 IBM MQ のコンポーネントと機能」 を参照してください。
以下の表は、最新のサポート対象バージョンとサポート方針を示しています:
| テクノロジー | サポート・ポリシー | 最新技術バージョン | サポートされる最新バージョン |
|---|---|---|---|
| IBM MQ MFT | オンデマンド | 9.4.2.1 | 9.4.0.5 |
サポートポリシーに関する詳細については、 「センサーのサポート戦略」 を参照してください。
追加のサポート情報
- Instana 単一インスタンスおよび複数インスタンスのリモート監視のみをサポートしています。 各インスタンスは、従来の IBM MQ 環境、または OpenShift における IBM Cloud Pak for Integration の展開環境にある各Coordination Queue Managerに対応しています。
- トレースはサポートされていません。
の構成
IBM MQ MFT のリモート監視データを収集するには、エージェント設定ファイル内の以下の <agent_install_dir>/etc/instana/configuration.yaml フィールドを次のように設定する必要があります:
MFT センサー・インスタンスは、サーバー接続チャネルを使用して調整キュー・マネージャーとコマンド・キュー・マネージャーに接続します。 構成が正しいことを確認してください。 IBM MQ エクスプローラーからリモートキューマネージャーを追加し、接続が正常に行えることを確認してください。 インスタンス名は、 <COORDINATION_QUEUE_MANAGER_NAME>-<HOST> の形式に従う必要があります。 それ以外の場合、インスタンスは無視され、モニターされません。
<agent_install_dir>/etc/instana/configuration.yamlの以下の構成を参照してください。
# IBM MQ Managed File Transfer
com.instana.plugin.ibmmqmft:
enabled: true
poll_rate: 10 # Default is 10 seconds
instances:
<INSERT_INSTANCE_NAME_HERE>: # Your MFT instance name must be in <COORDINATION_QUEUE_MANAGER_NAME>-<HOST> format
# transfer_expired_interval: 10 # How long recent completed transfers are retained in minutes.(optional)
coordinationQueueManager:
name: '<INSERT_COORDINATION_QUEUE_MANAGER_NAME_HERE>' # Coordination queue manager name
host: '<INSERT_HOST_HERE>' # Coordination Queue Manager host
port: <INSERT_PORT_HERE> # Remote server connection channel port
channel: '<INSERT_CHANNEL_HERE>' # Remote server connection channel
username: '<INSERT_USERNAME_HERE>' # User ID to connect to the remote queue manager (optional)
password: '<INSERT_PASSWORD_HERE>' # User password to connect to remote queue manager (optional)
keystore: '<INSERT_KEYSTORE_PATH_HERE>' # Keystore path for TLS connection (required only when TLS is enabled)
keystorePassword: '<INSERT_KEYSTORE_PASSWORD_HERE>' # Keystore password for TLS connection (required only when TLS is enabled)
cipherSuite: '<INSERT_CIPHER_SUITE_HERE>' # TLS cipher suite for TLS connection (required only when TLS is enabled)
commandQueueManager:
name: '<INSERT_COMMAND_QUEUE_MANAGER_NAME_HERE>' # Command queue manager name
host: '<INSERT_HOST_HERE>' # Command Queue Manager host
port: <INSERT_PORT_HERE> # Remote server connection channel port
channel: '<INSERT_CHANNEL_HERE>' # Remote server connection channel
username: '<INSERT_USERNAME_HERE>' # User ID to connect to the remote queue manager (optional)
password: '<INSERT_PASSWORD_HERE>' # User password to connect to remote queue manager (optional)
keystore: '<INSERT_KEYSTORE_PATH_HERE>' # Keystore path for TLS connection (required only when TLS is enabled)
keystorePassword: '<INSERT_KEYSTORE_PASSWORD_HERE>' # Keystore password for TLS connection (required only when TLS is enabled)
cipherSuite: '<INSERT_CIPHER_SUITE_HERE>' # TLS cipher suite for TLS connection (required only when TLS is enabled)
configuration.yaml にユーザー名とパスワードが指定されていない場合、使用されるユーザーは IBM MQ キューマネージャの設定によって決まります。 サーバー接続チャネルで使用されるユーザー ID の詳細については、 「クライアントのアクセス制御」 を参照してください。メトリックの表示
メトリクスを表示するには、 Instana コンソールのサイドバーで 「Infrastructure」 を選択し、「 IBM MQ Managed File Transfer Zone 」を探してください。
メトリックを表示するには、以下のステップを実行します。
- Instana のUIのサイドバーで、 「インフラストラクチャ」 を選択します。
- 「 IBM MQ Managed File Transfer Zone 」をクリックしてください。
その後、構成が正しい場合は、構成済みの調整キュー・マネージャーのモニター対象の Managed File Transfer (MFT) インスタンスを見つけることができます。
調整キュー・マネージャー
構成データ
| 調整キュー・マネージャーの詳細 | 説明 |
|---|---|
| 調整キュー・マネージャー | 調整キュー・マネージャーの名前 |
| ホスト | 調整キュー・マネージャーのホスト |
パフォーマンス・メトリック
| 調整キューマネージャーのメトリクス | 説明 |
|---|---|
| 現在アクティブな転送 | このセンサーインスタンスが有効化された後の、現在アクティブな転送の件数 |
| 合計転送数 | このセンサーインスタンスが有効化された後の転送総数 |
転送統計
| 転送統計 | 説明 |
|---|---|
| 成功した転送数 | 直近のポーリング間隔内での転送成功数 |
| 失敗した転送数 | 前回のポーリング間隔内の転送失敗回数 |
| 部分的に成功した転送数 | 直近のポーリング間隔内における部分的に成功した転送の件数 |
| キャンセル済み | 直近のポーリング間隔内での転送キャンセル件数 |
MFTエージェント
構成データ
| MFT エージェントの詳細 | 説明 |
|---|---|
| タイプ | エージェント・タイプ |
| タイム・ゾーン | エージェント・タイム・ゾーン |
| ソース転送の最大数 | 任意の時点においてソース・エージェントが処理する同時転送の最大数 |
| 宛先転送の最大数 | 任意の時点において宛先エージェントが処理する同時転送の最大数 |
| キューに入れられた転送の最大数 | エージェントが新しい転送要求を拒否するまでにキューに入れることができる保留中の転送の最大数 |
| 名前 | MFT エージェントの名前 |
| キュー・マネージャー | MFT エージェントの接続先のキュー・マネージャー名 |
| 開始時刻 (UTC) | エージェント開始時の開始タイム・スタンプ (UTC) |
パフォーマンス・メトリック
| MFT エージェント・メトリック | 説明 |
|---|---|
| ソース転送 | エージェントを介したソース転送の数。 |
| 宛先転送 | エージェントを介した宛先転送の数。 |
| 状況 | MFT エージェントの状況です。 |
| 転送の実行 | エージェントを介して現在実行中の転送の数。 |
| 現在の転送の合計 | エージェントを介した実行中の転送の合計数。 |
| タイムアウト転送の合計 | エージェントを介した Tmedout 転送の合計数。 |
| 再試行中の転送の合計 | エージェントを介した再試行の合計転送数。 |
| エージェント・キャパシティー待ちの合計転送数 | エージェント・キャパシティーを待機している合計転送数。 |
現在のファイル転送
構成データ
| MFT 転送の詳細 | 説明 |
|---|---|
| 転送 ID | 転送 ID |
| 開始時刻 | 転送開始時のタイム・スタンプ |
| ソース・エージェント | ソース・ファイルが配置されているシステム上のエージェントの名前 |
| ソース QueueManager | ソース・エージェントが接続するキュー・マネージャーの名前 |
| 宛先エージェント | ファイルの転送先となるシステム上のエージェントの名前。 |
| 宛先 QueueManager | 宛先エージェントの接続先のキュー・マネージャーの名前 |
| オリジネーター | 転送をトリガーした発信元 |
| 状況 | 転送の現在の状況 |
| 現在のファイル | 転送されているファイルのソース・パス |
| 進行状態 | 転送の進行状況。 例えば、2 つのファイルを転送する必要があります。 最初のファイルが転送された場合、進行状況は 1/2と表示されます。 その後、最初のファイル転送が終了し、2 番目のファイル転送が開始されると、進行状況が 2/2として表示されます。 |
パフォーマンス・メトリック
| MFT 転送メトリック | UI 表示 | 説明 |
|---|---|---|
| elapsedSeconds | 経過時間 (秒) | これらのバイトの転送にかかった秒数 |
| statsTransferredBytes | 転送 (b) | これまでにコピーされたバイト数 |
| bytesSent | 送信バイト数 | これまでにコピーされたバイト数 |
| currentItem | 注 1 を参照 | 転送されている現在の項目の索引 |
| totalItems | 注 1 を参照 | 転送されている項目の総数 |
| currentItemSize | 合計 (b) | 現在の項目の合計バイト数 |
MFTモニター
構成データ
| MFT モニターの詳細 | 説明 |
|---|---|
| モニター | モニターの名前。このエージェントに固有の名前です。 |
| エージェント | リソース・モニターが定義されているエージェントの名前 |
| 状況 | モニターの状態。 |
| リソース | モニター対象の 1 つ以上のリソース |
| トリガー・イベント | モニターに関連付けられている転送がトリガーされたときの条件 |
| ファイル・パターン | ファイル名のマッチング・パターン |
| バッチ・サイズ | 1 つのバッチに含まれるトリガー一致の最大数 |
| ポーリング間隔 | トリガー条件に対するリソースの各検査間の時間間隔 |
組み込みイベント
以下のイベントが表示される場合があります。
IBM MQ MFTエージェントが起動していないか、接続できません
エージェントが
Ready状態でもActive状態でもない場合、このイベントがトリガーされ、対応するエージェントに関連付けられます。IBM MQ MFTモニターが起動していません
MFT リソース・モニターが
started状態でない場合、このイベントがトリガーされ、対応するモニターに関連付けられます。IBM MQ ファイル転送に失敗しました
何らかの理由でファイル転送が失敗すると、このイベントがトリガーされ、対応する調整キュー・マネージャーに表示されます。