與 IBM APM V8

安裝 Instana 代理程式之後，會自動部署並安裝 IBM APM V8 感應器。

啟動 IBM APM V8 支援

依預設會取消啟動主機代理程式中透過 IBM APM V8 Proxy 感應器的度量汲取。 若要在主機代理程式中啟用 IBM APM V8 資料的接收，請參閱 感應器配置 一節，如下所示。

支援的版本

已確認支援具有下列 APM 代理程式的 IBM Application Performance Monitoring V8.1.4 IF 10 的度量值:

  • Linux OS 代理程式 V8.1.4.0.14; 在 xLinux、zLinux、pLinux 上受支援
  • Datapower 代理程式 V8.1.4.0.14
  • Windows OS 代理程式 V8.1.4.0.14
  • Unix OS 代理程式 V8.1.4.0.14; 在 AIX
  • MQ 代理程式 V8.1.4.0.14
  • ACE 代理程式 V8.1.4.0.14 (先前稱為 IIB 代理程式)
  • WebSphere Application Server (WAS) 代理程式 V7.3.0.14.16

附註: WAS 代理程式的支援是透過下載並套用新版本的 APM V8 Instana Integration Proxy .tgz 檔案，並將它套用至 APM V8 伺服器來達成。 如需相關資訊，請參閱 相依關係。 此外， WAS 支援需要在 WAS 代理程式執行所在的相同系統上安裝並執行 OS 代理程式。

平台及必要條件

這裡所記載的 IBM Cloud Application Performance Management 伺服器平台支援將 APM V8 與 Instana 整合: https://www.ibm.com/docs/en/capmp/8.1.4?topic=deployment-system-requirements

此支援旨在套用至下列任何層次的 IBM Cloud Application Performance Management 伺服器軟體:

IBM Cloud Application Performance Management Base Private 8.1.4.0版， IF 10 或更高版本，僅限內部部署 IBM Cloud Application Performance Management Advanced Private版， 8.1.4.0版， IF 10 或更高版本，僅限內部部署

可在這裡找到針對 APM V8.1.4.0 伺服器套用臨時修正程式 10 的指示: https://supportcontent.ibm.com/support/pages/ibm-application-performance-management-814-8140-ibm-apm-server-if0010-readme

配置

相依關係

為了讓感應器能夠從 APM V8 伺服器收集度量值，需要對 APM V8 伺服器進行更新。 若要取得必要的檔案，請遵循下列步驟。

  1. 登入 Instana ，按一下 其他-> 代理程式-> Instana 代理程式安裝-> IBM。

  2. 從下拉清單中，選取 IBM APM V8 Instana 整合 Proxy。

  3. 使用下載按鈕下載 APM V8 Instana Integration Proxy tgz 檔案。

  4. 將檔案從預設瀏覽器下載位置傳送至 APM V8 伺服器。

  5. 將 tgz 解壓縮至暫時位置。

  6. 切換至子目錄，並尋找 eba 檔案。

  7. 將 eba 檔案複製到 APM V8 Min 伺服器的 dropins 目錄 (預設位置是 /opt/ibm/wlp/usr/servers/min/dropins)。 Min 伺服器將自動載入 eba。

感應器配置

若要啟用 ibm-apmproxy 感應器，請尋找代理程式配置檔的 ibmapmproxy 區段，並解除註解感應器的行。 在對應欄位中提供 APM V8 伺服器的主機、通訊協定及埠資訊: <agent_install_dir>/etc/instana/configuration.yaml:

com.instana.plugin.ibmapmproxy:
  enabled: true
  # host: Provide the hostname or IP address of the system where the APM V8 server is running.  No quotation marks are needed.
  host: '<INSERT_HOST_HERE>' # APM-Proxy host
  # port: provide the port defined for contacting the APM V8 server. No quotation marks are needed.
  port: 443 # APM-Proxy port Default
  datainterval: 1 # Default
  heartbeatinterval: 15 # Default  
  # protocol: indicate whether to connect with the APM V8 server using the secure (SSL) port or the insecure port.  Values are either "http" or "https".  Default is "https".  No quotation marks are needed. Ensure the value provided for the "port" variable is the appropriate port for your server.
  protocol: https # Default

度量值集合

若要檢視度量值，請在「Instana 使用者」介面的資訊看板中選取 基礎架構 ，按一下特定的受監視主機，然後您可以看到具有所有已收集度量值及受監視處理程序的主機儀表板。

請參閱 Instana 主機感應器 ，以取得從 Linux OS 代理程式、Windows OS 代理程式及 Unix OS 代理程式收集的度量值清單。 請參閱 Instana IBM Datapower 感應器，以取得從 IBM Datapower 代理程式收集的度量值清單。 請參閱 Instana IBM MQ 感應器，以取得從 IBM MQ 代理程式收集的度量值清單。 請參閱 Instana ACE 感應器 ，以取得從 IBM ACE 代理程式收集的度量值清單。 請參閱 Instana WAS 感應器 ，以取得從 IBM WAS 代理程式收集的度量值清單。

附註: 若要透過此整合支援 IBM Datapower 度量值， Instana 伺服器必須為「建置 201」或更高版本。

附註 :APM V8 代理程式目前未收集 Instana 主機及 Datapower 相關實體中預期的數個度量值。 在 Instana 使用者介面中，這些度量值將為空白或空值。

從連接至 APM V8 伺服器的受支援 V8 代理程式收集度量，並轉遞至 Instana ，導致在 Instana 使用者介面上建立主機和 Datapower 實體。

附註 :APM V8 代理程式會依其現有訂閱檔案所定義的間隔來收集度量值。 當所有受支援代理程式的可用度量在 V8 伺服器上變成可用時， apmproxy 感應器會每秒擷取這些度量。

性能簽章

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

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

將 APM V8 度量轉遞至 Instana 伺服器，可能會針對建立的「主機」或 Datapower 實體引發事件。 請參閱主機實體 內建事件參照 或 Datapower 實體 內建事件參照的可能事件。 也可以針對代理程式引發事件，以指出感應器遺漏配置或發生連線問題 (請參閱「監視問題」，如下所示)。

監視問題

遺漏配置

監視問題類型: apmproxy_missing_config

配置中遺漏一或多個必要項目。 確定已在 configuration.yaml中設定您的主機。

連線錯誤

監視問題類型: apmproxy_connection_error

IBM-APMProxy 感應器無法在多次重試之後連接至 APM-Proxy 伺服器。 請確定已在 configuration.yaml中正確設定配置內容。 請確定通訊協定及埠值已對齊 (例如，埠 80 與通訊協定 http 或埠 443 與通訊協定 https 搭配使用)。

其他異常狀況

監視問題類型: apmproxy_exception_error

IBM-APMProxy 感應器發現未記載的異常狀況。 這可能表示 Instana 代理程式或 APM-Proxy 伺服器有問題。

其他資訊

建議將 Instana 代理程式直接安裝在 APM V8 伺服器上，但不需要這樣做。 如果 Instana 代理程式安裝在遠端伺服器上，請確定可從遠端伺服器呼叫到 APM V8 伺服器 IP 位址。 此外，最好停用代理程式配置檔中列出的其他感應器，只啟用 ibm-apmproxy 感應器，以停用 APM V8 伺服器系統本身的監視。

效能考量

如果要整合的 APM V8 代理程式數量超過數百個代理程式，則應該增加已啟用 ibm-apmproxy 感應器的 Instana 主機代理程式可用的 JVM 記憶體。
如需如何增加 Instana 主機代理程式的 JVM 記憶體的相關資訊，請參閱 設定主機代理程式 CPU 及記憶體 。 建議將主機代理程式的記憶體上限增加 256m ，超出現行設定。