透過使用者介面新增遙測診斷工具

本主題提供透過 的使用者介面,為您的 Presto ( Java ) 引擎 IBM® watsonx.data 新增遙測診斷工具的操作流程。

開始之前

請確保您擁有存取控制 watsonx.data 台及遙測工具(Instana 或 Prometheus )的憑證。

Instana 或 工具 Prometheus 必須根據需求,依照以下提供的指示進行安裝:

程序

  1. 登入 watsonx.data 主控台。

  2. 從導覽選單中,選擇「設定」,然後點擊 OpenTelemetry

  3. 在該 OpenTelemetry 頁面中,點擊診斷 +

  4. 在「新增遙測診斷」視窗中,請輸入以下詳細資訊:

    添加遙測診斷詳細資訊
    欄位 說明
    可用的遙測工具 從清單中選擇遙測診斷工具(Instana) Prometheus。
    遙測端點 輸入所選工具的 URL 終點。 格式:http://<host>:<port>/<path>https://<host>:<port>/<path>。 使用端口 4317 進行基於 GRPC 的 OTLP,以及 4318 進行基於 的 HTTP OTLP。
    主機名稱 若選取的遙測工具為 Instana,請輸入該工具的主機 ID。 請參閱「設定資源屬性」。
    PASSWORD 輸入 Instana 代理金鑰或 Prometheus 密碼。
    連線狀態 點擊「測試連線」以驗證終端點和憑證。
    相關診斷 勾選此核取方塊,即可將診斷類型(日誌、指標、追蹤)與遙測工具關聯。

    目前 Instana 僅提供指標與追蹤診斷資料。 Prometheus 僅提供計量診斷數據。

  5. 點擊「新增」以套用遙測工具整合功能。

    使用者可能需要稍候片刻,直至容器重新啟動。

  6. 透過下拉式選單存取並檢視您執行個體中受支援引擎的診斷指標清單,以執行以下操作:

    • 啟用:啟動診斷功能。
    • 停用:暫停資料收集。
    • 編輯:更新配置細節。
    • 檢視詳細資訊:檢查當前設定。
    • 解除關聯:將診斷工具從引擎上移除。

    當所有支援的診斷類型皆已成功與任一或兩項遙測工具建立關聯後,「新增診斷」按鈕將被停用。

    若要設定新的診斷工具或切換至其他工具,您必須執行以下任一操作:

    • 編輯現有的設定。
    • 停用當前診斷。
    • 解除關聯。

導航至診斷遙測數據

檢視診斷遙測資料(包含內部及合成呼叫):

  1. 登入 Instana 使用者介面。
  2. 導航至 「分析」→「應用程式」→「呼叫」。
  3. 在左側面板中,找到「隱藏通話」區段。
  4. 啟用下列選項:
    • 顯示綜合呼叫
    • 顯示內部呼叫

這確保所有與診斷相關的內部、系統生成及合成呼叫資料皆能在使用者介面中顯示。

使用CRN檢視特定查詢的追蹤記錄

  1. 前往 Analytics → 應用程式 → 呼叫
  2. 選擇「新增篩選條件」。
  3. 在篩選器搜尋欄中輸入 OpenTelemetry → 自訂 → crn。
  4. 選擇 crn 屬性並將其設定為所需值 <crn_value>
  5. 調整保留時間窗以聚焦於近期追蹤活動:
    • 持續 5 分鐘
    • 最後 10 分鐘
    • 前 30 分鐘

這些保留期限有助於確保近期查詢執行追蹤記錄清晰可見,同時排除較早呼叫產生的干擾。

在 Instana 中檢視 OpenTelemetry 指標

  1. 登入 Instana 使用者介面,並導航至「分析基礎架構」。
  2. 在資料來源選擇器中,選擇 OpenTelemetry 以檢視所有 OpenTelemetry 資源。
  3. 點擊「新增篩選條件」,選擇 OpenTelemetry「資源」→ otel.attribute「→ k8s.namespace.name」。 輸入 watsonx.data 所需的實例命名空間以篩選檢視。
  4. 從過濾後的結果中,選擇與您的執行個體相關的端點 metric-scraper-presto
  5. 使用「選取指標」瀏覽指標 Presto 抓取器所公開 OpenTelemetry 的所有可用指標。
  6. 選擇任何指標即可開啟其即時時間序列視覺化圖表,您可在其中分析當前數值、趨勢及屬性。

在使用者 Prometheus 介面中檢視指標

  1. 存取您環境的用戶 Prometheus 介面。
  2. 在「表達式」欄位中,開始輸入度量名稱(例如:presto_)。
  3. Prometheus 將自動顯示從 metric-scraper-presto 收集的所有指標。
  4. 選擇所需指標並點擊執行以查看結果。