管理主機代理程式

向 Instana 報告的所有主機代理程式都會顯示在代理程式視圖上。 此頁面提供所有代理程式、其重要內容及一般性能的快速概觀。 此外，每一個主機代理程式都有自己的「代理程式管理視圖」，它會顯示重要度量值的即時相關資訊，並可讓您以各種方式來配置代理程式。

代理程式管理儀表板

若要檢視「代理程式管理儀表板」，請在任何主機儀表板上按一下 開啟代理程式管理。

代理程式管理

此外，所有「代理程式管理儀表板」都可以透過 代理程式視圖來存取。

「代理程式管理儀表板」會顯示代理程式配置及現行執行時期度量。 在管理區域中，可以變更配置，並且可以執行重新啟動之類的作業。 會顯示進一步的關閉執行時期度量值，以及現行代理程式日誌。

代理程式橫線

變更代理程式模式

主機代理程式模式與主機型授權相關，並用來決定代理程式是否視為基礎架構或 APM 代理程式。 可以使用 Change Agent Mode 控制項來切換主機代理程式模式。

在 Change Agent Mode 對話框中，提供下列選項:

  • APM，對映至 APM 主機代理程式模式
  • Infrastructure，對映至 INFRASTRUCTURE 主機代理程式模式
  • Disabled，對映至 OFF 主機代理程式模式

變更記載層次

log level 定義代理程式日誌包含的詳細程度。

在 Change Agent Log Level 對話框中，提供下列選項:

  • INFO，一般詳細資料層次
  • DEBUG，用於疑難排解的延伸詳細資料
  • TRACE，用於進一步問題分析的大部分詳細資料

更新代理程式

此按鈕會手動觸發代理程式自動更新，如 動態主機代理程式更新中所述。

附註: 在更新期間，主機代理程式無法提供任何資料，因此您可能會看到短暫的間隙。

重設代理程式

重設代理程式類似於重新啟動代理程式處理程序，但現行處理程序仍保持作用中。 這表示 OS 層次監視器和服務 Script 將不會看到處理程序 ID (pid) 變更。

附註: 在重設期間，主機代理程式無法提供任何資料，因此您可能會看到短間隙。

重新開機代理程式

將代理程式重新開機會停止現行代理程式處理程序，並建立新的代理程式處理程序。 已使用啟動 Script 的處理程序維持不變，但作業系統層次監視器及服務 Script 可能會看到已變更的處理程序 ID (pid) ，視其監看目標而定。

附註: 在重新啟動期間，主機代理程式無法提供任何資料，導致間隙短暫。

感應器資訊

若要檢視代理程式所使用的感應器及主機代理程式元件清單，請按一下 Sensors Info。

配置管理

在配置管理區段中，可以啟用和配置 Git型配置管理 。

Git型配置管理 頁面上會說明這項特性的詳細資料，以及所用的命名法。

附註: 若要支援「配置管理」，至少需要 agent-bootstrap version 1.2.11 。

附註: 若要具有此特性的存取權，使用者必須具有具有 Configuration of agents 許可權的角色。 如需使用者、角色及許可權的相關資訊，請參閱 管理使用者文件。

代理程式性能檢視許可權

起始設定配置管理

如果沒有作用中的配置管理，則可以使用 Configuration Management 區段中的 Initialize 按鈕來起始設定。

起始設定配置管理

起始設定對話框提供下列設定:

  • Remote Name，名稱 Git 遠端應該設為
  • Remote Branch，要用於更新項目的分支名稱
  • Remote URI， Git 儲存庫的 URI

Initialize & Restart 會根據這些設定來配置代理程式，並重新啟動它以提取最新的配置。

更新配置管理

如果配置管理已在作用中，其詳細資料會顯示在 Configuration Management 區段中。 它包括已配置的遠端 (例如分支名稱和 URI) 以及目前使用的確定 (例如雜湊和確定訊息) 的相關資訊。

若要更新配置，可以使用區段中的 Update 按鈕來開啟 Configuration Management 對話框。

起始設定配置管理

與起始設定對話框類似，可以變更下列設定:

  • Remote Name，名稱 Git 遠端應該設為
  • Remote Branch，要用於更新項目的分支名稱
  • Remote URI， Git 儲存庫的 URI

Update & Restart 會根據這些設定來配置代理程式，並重新啟動它以提取最新的配置。

自我監視

主機代理程式不僅會監視主機上執行的其他軟體，還會持續執行輕量型自我監視。 收集的度量值可用來觀察主機代理程式效能及資源耗用:

代理程式度量值

代理程式視圖

「代理程式」視圖位於主要導覽列的 其他 > 代理程式下，提供向 Instana 租戶單元報告之所有主機代理程式的概觀。

當您使用頁面上的搜尋列時，可以使用 動態焦點查詢將視圖縮小為代理程式子集。

代理程式性能視圖

大量代理程式管理

附註: 若要具有此特性的存取權，使用者需要具有具有 Configuration of agents 許可權的角色。 如需使用者、角色及許可權的相關資訊，請參閱 管理使用者文件。

代理程式性能檢視許可權

「代理程式」視圖容許快速存取下列特性:

  • 更新所有代理程式: 將所有報告代理程式更新至最新版本。
  • 重設所有代理程式: 重設所有報告代理程式。
  • Instana 代理程式安裝: 所有受支援平台的代理程式安裝指示。

主機代理程式性能狀態

主機代理程式性能監視表格包含下列資訊:

  • 代理程式實體鏈結，其鏈結至 代理程式管理儀表板
  • 代理程式版本
  • 代理程式開機版本
  • 安裝來源
  • 更新模式
  • 模式 (Disabled、 Infrastructure或 APM)
  • 記載層次
  • JVM 名稱和版本
  • 報告狀態

已報告代理程式

如同 Instana 中的大部分特性，主機代理程式性能監視視圖在很大程度上取決於現行時間配置。

有兩個重要事項需要瞭解:

  1. 此表格呈現在現行時間範圍內報告的所有代理程式。
  2. 狀態 (reporting 或 not reporting) 基於選取的時間。

下列概念性影像顯示報告指示器的行為方式。

代理程式性能視圖概念

在此範例影像中，已設定時間範圍，以便列出三個代理程式。 所選取時間範圍的結尾是設定在大約 6:20am的某處。 代理程式表格現在會指出代理程式 1 不報告，因為它會在 6:00am停止報告，因此在 6:20am之前。 其他兩個代理程式當時報告。

除錯

建立主機代理程式資料堆傾出

若要建立主機代理程式的資料堆傾出，請執行下列指令:

TS=`date +%s` && /opt/instana/agent/jvm/bin/jmap -dump:file=/tmp/agent-dump-$TS.hprof `cat /opt/instana/agent/agent.pid` && gzip /tmp/agent-dump-$TS.hprof

疑難排解

在某些情況下，您的設定一開始可能無法運作。 如果此疑難排解區段未回答您的問題，請聯絡我們的支援團隊並讓我們知道，以便我們可以協助您並相應地更新我們的文件。

Instana 代理程式包含有漏洞的 Log4j 程式庫

監視問題類型: agent_log4j_vulnerability

由於在 Apache Log4j (CVE-2021-44228 和 CVE-2021-45046) 中探索到漏洞，我們已提供代理程式元件的更新。 它是根據代理程式套件所使用的「Pax 記載」程式庫。

建議將您的 Instana 代理程式安裝套件更新為 (重新-) 安裝最新的代理程式版本，如這裡所述: 安裝主機代理程式。 最新套件包含已升級的「Pax 記載」程式庫，可緩解這些 CVE 的狀況。 請造訪我們的 事件頁面 ，以取得 Instana 如何降低 Apache Log4j CVE-2021-44228 及 CVE-2021-45046風險的詳細資料。

遺漏對 Instana 代理程式的 TLSv1.3 支援

監視問題類型: agent_jvm_tls_1_3_missing

Instana 代理程式在已安裝的主機上需要 TLSv1.3 支援。 如果不支援 TLSv1.3 ，則監視功能會欠佳。

建議您將 Instana 代理程式 TLS 版本更新為 TLSv1.3。 已啟用下列 TLS 版本: TLSv1、 TLSv1.1、 TLSv1.2、 TLSv1.3。 如需相關資訊，請參閱 設定代理程式端點的 TLS 加密。