監視 IBM DataPower

安裝 Instana 主機代理程式之後，會自動安裝 IBM DataPower 感應器，但您需要依照這個主題所概述來配置 IBM DataPower 感應器。 然後，您可以在 Instana 使用者介面中檢視與 IBM DataPower 相關的度量值。

支援的資訊

支援的作業系統

請參閱 IBM DataPower 感應器支援的作業系統。

支援的 DataPower 版本

Instana 支援 IBM DataPower 2018.4、 10.0.1.x、 10.0.x 以及更新版本 (安裝在下列平台中) 的度量及配置資料:

附註: IBM DataPower 感應器支援本端監視及遠端監視。

作業系統 硬體
AIX 7.1 POWER 系統-大序排列法
macOS Big Sur 11.0 x86-64
Solaris 10 SPARC
Solaris 11 SPARC
Windows Server 2012 Standard Edition x86-64
Amazon Linux 1 x86-64
Amazon Linux 2 x86-64
CentOS 6.0 x86-32
CentOS 6.0 x86-64
CentOS 7 POWER 系統-小序排列法
CentOS 7 x86-32
CentOS 7 x86-64
CentOS 8 x86-64
Debian 10 x86-32
Debian 10 x86-64
Debian 9.0 x86-32
Debian 9.0 x86-64
Red Hat Enterprise Linux (RHEL) 8 IBM z Systems
Red Hat Enterprise Linux (RHEL) 8 POWER 系統-小序排列法
Red Hat Enterprise Linux (RHEL) 8 x86-64
Red Hat Enterprise Linux (RHEL) Server 6 IBM z Systems
Red Hat Enterprise Linux (RHEL) Server 6 x86-64
Red Hat Enterprise Linux (RHEL) Server 7 IBM z Systems
Red Hat Enterprise Linux (RHEL) Server 7 x86-64
SUSE Linux Enterprise Server (SLES) 12 IBM z Systems
SUSE Linux Enterprise Server (SLES) 12 POWER 系統-小序排列法
SUSE Linux Enterprise Server (SLES) 12 x86-64
SUSE Linux Enterprise Server (SLES) 15 IBM z Systems
SUSE Linux Enterprise Server (SLES) 15 POWER 系統-小序排列法
SUSE Linux Enterprise Server (SLES) 15 x86-64
Ubuntu 14.04 LTS POWER 系統-小序排列法
Ubuntu 14.04 LTS x86-32
Ubuntu 14.04 LTS x86-64
Ubuntu 16.04 LTS IBM z Systems
Ubuntu 16.04 LTS POWER 系統-小序排列法
Ubuntu 16.04 LTS x86-32
Ubuntu 16.04 LTS x86-64
Ubuntu 18.04 LTS IBM z Systems
Ubuntu 18.04 LTS POWER 系統-小序排列法
Ubuntu 18.04 LTS x86-32
Ubuntu 18.04 LTS x86-64
Ubuntu 20.04 LTS IBM z Systems
Ubuntu 20.04 LTS POWER 系統-小序排列法
Ubuntu 20.04 LTS x86-64

必要條件

為了讓 Instana 代理程式能夠監視 IBM DataPower 軟體驅動裝置，需要啟用資源監視，例如 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 實例會在指定的可用性區域中顯示為個別方框。

IBM DataPower 監視的支援矩陣

下表概述 IBM DataPower 監視的支援矩陣:

支援矩陣 虛擬機器中的 Instana 代理程式 Kubernetes 叢集中的 Instana 代理程式 Docker 儲存器中的 Instana 代理程式
虛擬機器中的DataPower 備受支援 不支援 備受支援
Kubernetes 叢集中的DataPower 備受支援 備受支援 備受支援
Docker 儲存器中的DataPower 備受支援 不支援 備受支援

虛擬機器中的 Monitoring 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 叢集中的 Monitoring 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 代理程式在不同的虛擬機器中執行時，會進行遠端監視。 此配置與 遠端監視 區段中所概述的相同。

檢視度量值

若要檢視度量值，請完成下列步驟:

  1. 在 Instana 使用者介面的資訊看板中，選取 基礎架構。
  2. 按一下特定的受監視主機。

然後，您可以查看包含所有已收集度量及受監視處理程序的主機儀表板。

效能度量

軟體驅動裝置

度量 說明
系統負載 測量間隔期間，裝置上總負載百分比。
CPU 使用率 受監視 DataPower 設備在前 10 秒的平均 CPU 使用率。
記憶體用量 即時記憶體用量（以總記憶體百分比表示）。
加密檔案系統使用情形 裝置上已加密儲存體空間的使用率。
已接受連線 TCP 接受連線數。
工作清單 在佇列中要由設備處理，包含內部通訊的擱置工作項目數。
已靜止網域 指出網域的靜止狀態。
非作用中物件 裝置上所部署的非作用中物件數目。
TCP 摘要已建立 處於已建立狀態的 TCP 連線數目。
TCP 摘要同步傳送 處於同步傳送狀態的 TCP 連線數目。
TCP 摘要同步接收 處於同步接收狀態的 TCP 連線數目。
TCP 摘要 Fin Wait1 處於 fin-wait-1 狀態的 TCP 連線數目。
TCP 摘要 Fin Wait2 處於 fin-wait-2 狀態的 TCP 連線數目。
TCP 摘要已關閉 處於已關閉狀態的 TCP 連線數目。
TCP 摘要關閉等待 處於關閉等待狀態的 TCP 連線數目。
TCP 摘要時間等待 處於關閉等待狀態的 TCP 連線數目。
TCP 摘要前次確認 處於 last-ack 狀態的 TCP 連線數目。
TCP 摘要接聽 處於接聽狀態的 TCP 連線數目。
TCP 摘要關閉中 處於正在關閉狀態的 TCP 連線數目。

網域

度量 說明
現行記憶體用量 即時記憶體用量佔此網域內總記憶體的百分比。
XML 名稱
度量 說明
已用 目前在此網域中使用的 XML 名稱數目。
可用百分比 此網域中目前可用的 XML 名稱百分比。
對等作業狀態
度量 說明
擱置更新項目 此成員上未執行的指令數。 如需相關資訊，請參閱 show gateway-peering-status。
抄寫偏移 成員的抄寫偏移。 當成員共用資料抄寫時，成員的抄寫偏移會符合主要成員的偏移。

乙太網路介面

度量 說明
RX 位元組數 接收的資料流量位元組數。
RX 捨棄 捨棄的已接收封包數目。
TX 位元組數 傳輸的資料流量位元組數。
TX 捨棄數 傳輸期間捨棄的封包數目。
每秒接收 網路介面上每秒接收的封包數。
每秒傳輸 每秒在傳輸介面上接收的封包數。

MQ 佇列管理程式

度量 說明
後端作用中連線數 後端的作用中連線數。
前端作用中連線數 前端作用中連線數目。

服務

度量 說明
現行記憶體用量 服務在 1 到 5 分鐘之間的間隔之前的現行記憶體用量。
平均交易時間 前 10 分鐘的平均交易時間。
傳輸量 前 10 分鐘的交易速率。

SQL 資料來源

度量 說明
作用中連線 SQL 資料來源的名稱。

性能簽章

每一個感應器都有一個精選的性能簽章知識庫，可以根據送入的度量對性能簽章進行持續評估，並根據使用者影響來觸發問題或發生事件。

內建事件 會根據實體上的性能簽章失敗來觸發問題或突發事件，而 自訂事件 會根據任何給定實體的個別度量值臨界值來觸發問題或突發事件。

如需 Datapower 感應器之內建事件的相關資訊，請參閱 內建事件參照。

疑難排解

DataPower 實例未顯示在使用者介面中

在「監視問題」清單上，找出 DataPower 相關事件，並根據問題類型檢查解決方案。

未定義變數

監視問題類型: ibmdatapower_var_not_defined

配置中遺漏一或多個必要項目。 確保在 configuration.yaml中設定 DataPower 實例埠、使用者名稱及密碼。

變數具有無效值

監視問題類型: ibmdatapower_var_invalid_value

一或多個必要項目在配置中具有無效值。 請確定已在 configuration.yaml中正確設定 DataPower 實例埠、使用者名稱及密碼。

連線錯誤

監視問題類型: ibmdatapower_connection_error

「 DataPower 感應器」無法在多次重試之後連接至 DataPower 實例。 請確定已在 configuration.yaml中正確設定 DataPower 實例埠、使用者名稱及密碼。

其他異常狀況

監視問題類型: ibmdatapower_exception_error

「 DataPower 感應器」發現未記載的不常見異常狀況。 這可能表示 Instana 代理程式或 DataPower有問題。