Monitoring IBM API Connect 應用程式

IBM API Connect 應用程式執行時期監視著重於監視正式作業中的重要應用程式效能度量值，特別是透過 DataPower API Gateway的交易。 Instana 代理程式可以自動收集基礎架構資源度量值，但若要讓代理程式能夠從 IBM API Connect收集追蹤資訊，您必須完成本主題中概述的其他步驟。

DataPower API Gateway

Instana DataPower 感應器用來監視 DataPower API Gateway。 安裝 Instana 主機代理程式之後，會自動安裝 IBM DataPower 感應器，但您需要配置 IBM DataPower 感應器。 如需相關資訊，請參閱 監視 IBM DataPower。

追蹤 DataPower API Gateway

Instana DataPower追蹤特性可以監視 API Management 功能，並檢查如何在 DataPower API Gateway中啟動 API。

Instana DataPower Tracing 僅支援在 Red Hat OpenShift 中透過 API Connect Operator 部署 DataPower 實例，且 API Connect 版本為 10.0.5.5 或更新版本的實務範例。 對應的 API Connect 操作器版本必須是 3.5.0 或更新版本， IBM DataPower Gateway 操作器版本必須是 1.6.10 或更新版本。

對於 VMware上的 IBM API Connect 部署，您需要部署 DataPower Gateway 應用裝置。 通常， DataPower 實體應用裝置或 DataPower 虛擬應用裝置用作 API Gateway。 Instana 不支援追蹤 DataPower 實體或虛擬應用裝置。

若要啟用 DataPower API Gateway的追蹤，您必須安裝並配置 DataPower Tracing 代理程式。

安裝 DataPower 追蹤代理程式

如果您已啟用 DataPower的 Jaeger 追蹤，請編輯 GatewayCluster 自訂資源，以將 Jaeger 追蹤代理程式映像檔取代為 Instana DataPower 追蹤代理程式映像檔。 不過，如果您未針對 DataPower啟用 Jaeger 追蹤，請編輯 GatewayCluster 自訂資源以新增 jaegerTracing 內容，然後將映像檔屬性設為 Instana DataPower Tracing 代理程式映像檔 URL。

若要配置並執行 Instana Tracing 代理程式 Sidecar 儲存器，請編輯 GatewayCluster 自訂資源，方法是在下列 YAML 檔中新增或編輯 jaegerTracing 內容:

spec:
  jaegerTracing:
    samplingType: const
    propagationFormat: w3c
    samplingRate: '1'
    agentImage: 'icr.io/instana/instana-dp-agent-image:latest'
    tls:
      disabled: true
      skipHostVerify: false
    env:
      - name: INSTANA_AGENT_HOST
        valueFrom:
          fieldRef:
            apiVersion: v1
            fieldPath: status.hostIP

如需 jaegerTracing的相關資訊，請參閱 DataPower 操作員文件。

在 Red Hat OpenShift 主控台上驗證結果，如下列範例所示:

關閉問題

您可以在 Instana 使用者介面中檢視 IBM API Connect API Gateway 的追蹤資料。 DataPower Tracing 的預設服務名稱是 datapower:<datapower pod name>，例如 datapower:apis-minimum-gw-0。

如需相關資訊，請參閱 在 Kubernetes中安裝主機代理程式的 Instana 代理程式需求。

取消配置 DataPower 追蹤代理程式

若要取消配置 DataPower Tracing 代理程式，請從 YAML 檔中對應的 GatewayCluster 自訂資源移除 jaegerTracing 內容。

已知限制

  • DataPower 追蹤僅支援 API 閘道，不支援其他服務，例如多重通訊協定閘道及 Web 服務 Proxy。

建立應用程式視景

若要建立應用程式視景，以檢視從 IBM API Connect 應用程式執行時期收集的追蹤資訊，請完成下列步驟:

  1. 以下列其中一種方式開啟應用程式視景精靈:
    • 從 Instana 儀表板的 應用程式 清單中，按一下 新建應用程式視景 。
    • 移至 Instana 儀表板導覽畫面中的 應用程式 ，然後按一下「應用程式」頁面上的 新增 > 新建應用程式視景 。
  2. 選取 服務或端點，然後按 下一步。
  3. 按一下 新增過濾器，然後選取服務名稱。 可以使用 OR 條件來選取多個服務和端點。 對於 DataPower 服務，服務名稱類似於 datapower:<datapower-appliance-name>，例如 datapower:apis-minimum-gw-0。
  4. 在 應用程式視景名稱 欄位中，輸入 IBM API Connect 應用程式視景的名稱，然後按一下 建立。

疑難排解

遺漏 DataPower Instana 使用者介面中的追蹤呼叫

如果 DataPower 追蹤呼叫未如預期顯示在 Instana 使用者介面中，請完成下列步驟:

  1. 啟用 Instana DataPower 追蹤的除錯:
    1. 存取 DataPower Pod ，並移至 jaeger-tracing-agent 儲存器中的 /app/libs 目錄。
    2. 將 <root level="info"> 變更為 <root level="debug">，以編輯 logback.xml 檔案。 變更將在一分鐘內生效。
  2. 使用 oc logs <datapower-pod-name> -c jaeger-tracing-agent 指令來收集 Instana DataPower Tracing 代理程式的除錯資訊。