Monitoring IBM MQ Managed File Transfer (技術預覽)
安裝 Instana 主機代理程式之後，會自動安裝 IBM MQ Managed File Transfer (MFT) 感應器，但您需要如本主題所述配置 IBM MQ MFT 感應器。 然後，您可以在 Instana 使用者介面中檢視與 IBM MQ MFT 相關的度量值。
支援的資訊
支援的作業系統
IBM MQ MFT 感應器的受支援作業系統與主機代理程式需求一致，您可以在每一個主機代理程式的 受支援作業系統 區段中檢查這些需求，例如 Linux。
支援 IBM MQ MFT 版本及平台
Instana 支援 IBM MQ MFT 9.0.0 或更新版本的度量及配置資料，這些資料安裝在 IBM MQ MFT 支援的所有平台中。 請參閱 IBM MQ 元件和特性。
附註：
- Instana 僅支援單一實例及多個實例的遠端監視。 每一個實例都適用於可以來自傳統 IBM MQ 環境或 OpenShift中 IBM Cloud Pak for Integration 部署的每一個「協調佇列管理程式」。
- 不支援追蹤。
配置
若要收集 IBM MQ MFT 的遠端監視資料，您需要在代理程式配置檔 <agent_install_dir>/etc/instana/configuration.yaml 中配置下列欄位，如下所示:
MFT 感應器實例會使用伺服器連線通道連接至協調佇列管理程式及指令佇列管理程式。 請確定配置正確。 您可以從 IBM MQ 探險家新增遠端佇列管理程式來驗證，並確定連線可以成功。 The instance name needs to follow <COORDINATION_QUEUE_MANAGER_NAME>-
請參閱 <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
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)
附註: 當您連接至 IBM MQ 佇列管理程式時， IBM MQ MFT 感應器不支援本端連結。 如果 configuration.yaml 檔中未指定任何使用者和密碼，則使用的使用者取決於 IBM MQ 佇列管理程式配置。 如需伺服器連線通道所使用使用者 ID 的相關資訊，請參閱 用戶端的存取控制。
檢視度量值
若要檢視度量，請在 Instana 主控台的資訊看板中選取 基礎架構 ，並找到 IBM MQ Managed File Transfer 區域。
若要檢視度量值，請完成下列步驟:
- 在 Instana 使用者介面的資訊看板中，選取 基礎架構。
- 按一下 IBM MQ Managed File Transfer 區域。
然後，如果您的配置正確，您可以找到已配置協調佇列管理程式的受監視受管理檔案傳送 (MFT) 實例。
協調佇列管理程式
配置資料
| 協調佇列管理程式詳細資料 | 說明 |
|---|---|
| 協調佇列管理程式 | 協調佇列管理程式的名稱 |
| 主機 | 協調佇列管理程式的主機 |
效能度量
| 協調佇列管理程式度量 | 說明 |
|---|---|
| 現行傳送 | 啟動此感應器實例之後的現行傳送計數 |
| 傳送總數 | 啟動此感應器實例之後的現行傳送計數 |
| 順利完成的傳送數 | 前次輪詢間隔內成功傳送的計數 |
| 失敗的傳送數 | 前次輪詢間隔內失敗傳送的計數 |
| 局部成功傳送數 | 前次輪詢間隔內局部成功傳送的計數 |
MFT 代理程式
配置資料
| MFT 代理程式詳細資料 | 說明 |
|---|---|
| 類型 | 代理程式類型 |
| 時區 | 代理程式時區 |
| 來源傳送數上限 | 來源代理程式在任何時間點處理的並行傳送數目上限 |
| 目的地傳送數上限 | 目的地代理程式在任何時間點處理的並行傳送數目上限 |
| 佇列傳送數上限 | 在代理程式拒絕新的傳送要求之前，代理程式可以排入佇列的擱置傳送數目上限 |
| 名稱 | MFT 代理程式的名稱 |
| 佇列管理程式 | MFT 代理程式所連接的佇列管理程式名稱 |
| 開始時間 (UTC) | 代理程式啟動時的已啟動時間戳記 (UTC) |
效能度量
| MFT 代理程式度量 | 說明 |
|---|---|
| 來源傳送 | 透過代理程式的來源傳送計數。 |
| 目的地傳送 | 透過代理程式的目的地傳送計數。 |
| 狀態 | MFT 代理程式的狀態。 |
| 執行中傳送 | 目前透過代理程式執行的傳送計數。 |
| 現行傳送總數 | 透過代理程式執行的傳送總數。 |
| 逾時傳送總數 | 透過代理程式的逾時傳送總數。 |
| 重試傳送總數 | 透過代理程式重試傳送的總數。 |
| 等待代理程式容量的傳送總數 | 等待代理程式容量的傳送總數。 |
現行檔案傳送
配置資料
| MFT 傳送詳細資料 | 說明 |
|---|---|
| 傳送 ID | 傳送 ID |
| 開始時間 | 傳送開始時的時間戳記 |
| 來源代理程式 | 來源檔案所在系統上代理程式的名稱 |
| 來源 QueueManager | 來源代理程式所連接的佇列管理程式名稱 |
| 目的地代理程式 | 系統上您要將檔案傳送至其中的代理程式名稱 |
| 目的地 QueueManager | 目的地代理程式所連接的佇列管理程式名稱 |
| 發起者 | 觸發傳送的發送端 |
| 狀態 | 傳送的現行狀態 |
| 現行檔案 | 正在傳送之檔案的來源路徑 |
| 進度 | 傳送進度。 例如，需要傳送 2 個檔案。 如果已傳送第一個檔案，則進度會顯示為 1/2。 然後，如果第一個檔案傳送已完成，且第二個檔案傳送開始，則進度會顯示為 2/2。 |
效能度量
| MFT 傳送度量值 | 使用者介面顯示 | 說明 |
|---|---|---|
| elapsedSeconds | 經歷時間（秒） | 傳送那些位元組所花費的秒數 |
| statsTransferred位元組 | 轉移 (b) | 到目前為止已複製的位元組數 |
| bytesSent | 傳送的位元組數 | 到目前為止已複製的位元組數 |
| currentItem | 請參閱附註 1 | 正在傳送的現行項目索引 |
| totalItems | 請參閱附註 1 | 正在傳送的項目總數 |
| currentItem大小 | 總計 (b) | 現行項目的位元組總數 |
MFT 監視器
配置資料
| MFT 監視器詳細資料 | 說明 |
|---|---|
| 監視者 | 監視器的名稱，對於此代理程式而言是唯一的 |
| 代理程式 | 在其中定義資源監視器的代理程式名稱 |
| 狀態 | 監視器的狀態 |
| 資源 | 受監視的資源 |
| 觸發事件 | 觸發與監視器相關聯的傳送時的條件 |
| 檔案型樣 | 檔名的相符型樣 |
| 批次大小 | 單一批次中包含的觸發相符數上限 |
| 輪詢間隔 | 每次針對觸發條件檢查資源之間的時間間隔 |
內建事件
您可能會看到下列事件:
IBM MQ MFT 代理程式未啟動或無法呼叫到
當代理程式未處於
Ready或Active狀態時，會觸發此事件並與對應的代理程式相關聯。IBM MQ MFT 監視器未啟動
當 MFT 資源監視器未處於
started狀態時，會觸發此事件並與對應的監視器相關聯。IBM MQ 檔案傳送失敗
當檔案傳送因任何原因而失敗時，會觸發此事件並顯示在對應的協調佇列管理程式中。