共用方式為


在 Windows 電腦上安裝 Log Analytics 代理程式

本文提供如何使用下列方法在 Windows 電腦上安裝 Log Analytics 代理程式的相關資訊:

  • 使用安裝精靈或命令列手動安裝。
  • Azure 自動化期望狀態配置(DSC)。

本文所述的安裝方法通常用於內部部署或其他雲端中的虛擬機器。 如需可用於 Azure 虛擬機器的更有效率選項,請參閱 安裝選項

這很重要

舊版 Log Analytics 代理程式已於 2024 年 8 月 31 日取代。 Microsoft 將不再提供 Log Analytics 代理程式的任何支援。 如果您使用 Log Analytics 代理程式將資料內嵌至 Azure 監視器,請 立即移轉至 Azure 監視器代理程式

備註

安裝 Log Analytics 代理程式通常不需要您重新啟動電腦。

需求

支援的作業系統

如需 Log Analytics 代理程式支援的 Windows 版本清單,請參閱 Azure 監視器代理程式概觀

SHA-2 程式碼簽署支援需求

Windows 代理程式於 2020 年 8 月 17 日開始專門使用 SHA-2 簽署。 此變更會影響在舊版 OS 上使用 Log Analytics 代理程式作為任何 Azure 服務的一部分的客戶,例如 Azure 監視器、Azure 自動化、Azure 更新管理、Azure 變更追蹤、適用於雲端的 Microsoft Defender、Microsoft Sentinel 和 Windows Defender 進階威脅防護。

除非您在舊版 OS 版本上執行代理程式,例如 Windows 7、Windows Server 2008 R2 和 Windows Server 2008,否則變更不需要任何客戶動作。 在舊版 OS 版本上執行的客戶必須在 2020 年 8 月 17 日之前在其電腦上採取下列動作,否則其代理程式停止將資料傳送至其 Log Analytics 工作區:

  1. 安裝適用於您作業系統的最新 Service Pack。 所需的 Service Pack 版本包括:

    • Windows 7 SP1
    • Windows Server 2008 SP2
    • Windows Server 2008 R2 SP1
  2. 為您的 OS 安裝 SHA-2 簽署 Windows 更新,如 Windows 和 WSUS 的 2019 SHA-2 程式代碼簽署支援需求中所述。

  3. 更新至最新版本的 Windows 代理程式 (版本 10.20.18067)。

  4. 建議您將代理程式設定為 使用 TLS 1.2

網路需求

如需 Windows 代理程式的網路需求,請參閱 Log Analytics 代理程式概觀

將代理程式設定為使用 TLS 1.2

TLS 1.2 通訊協定可確保 Windows 代理程式與 Log Analytics 服務之間通訊的傳輸資料安全性。 如果您在預設未啟用 TLS 的作業系統上安裝,請使用下列步驟設定 TLS 1.2。

  1. 找出下列登錄子機碼: HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols

  2. Protocols 底下為 TLS 1.2 建立子機碼:HKLM\System\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2

  3. 在您稍早建立的 TLS 1.2 通訊協定版本子機碼下建立 用戶端 子機碼。 例如, HKLM\System\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Client

  4. HKLM\System\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Client 下建立下列 DWORD 值:

    • 已啟用 [值 = 1]
    • DisabledByDefault [值= 0]

設定 .NET Framework 4.6 或更新版本以支援安全加密,因為預設將其停用。 強加密使用更安全的網絡協議,如 TLS 1.2,並阻止不安全的協議。

  1. 找出下列登錄子機碼: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\v4.0.30319

  2. 在此子機碼下建立 DWORD 值 SchUseStrongCrypto ,值為 1

  3. 找出下列登錄子機碼: HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\.NETFramework\v4.0.30319

  4. 在此子機碼下建立 DWORD 值 SchUseStrongCrypto ,值為 1

  5. 重新啟動系統來使設定生效。

工作區 ID 和金鑰

不論使用何種安裝方法,您都需要代理程式將連線之 Log Analytics 工作區的工作區識別碼和金鑰。 從 Azure 入口網站的 Log Analytics 工作區 功能表中選取工作區。 然後在設定區段中,選取客服專員。

顯示工作區詳細資料的螢幕擷取畫面。

備註

您無法將代理程式設定為在初始設定期間向多個工作區報告。 安裝後,從控制台或 PowerShell 更新設定,新增或移除工作區

備註

雖然可以重新產生 Log Analytics 工作區共用金鑰,但這樣做的目的 並不是 要立即限制目前使用這些金鑰的任何代理程式的存取。 代理程式使用金鑰來產生三個月後到期的憑證。 重新產生共用金鑰只會防止代理程式更新其憑證,而不會繼續使用這些憑證,直到它們過期為止。

安裝代理程式

這很重要

舊版 Log Analytics 代理程式已於 2024 年 8 月 31 日取代。 Microsoft 將不再提供 Log Analytics 代理程式的任何支援。 如果您使用 Log Analytics 代理程式將資料內嵌至 Azure 監視器,請 立即移轉至 Azure 監視器代理程式

下列步驟會使用電腦上代理程式的安裝精靈,在 Azure 和 Azure 政府雲端中安裝和設定 Log Analytics 代理程式。 如果您想要瞭解如何將代理程式設定為同時報告給 System Center Operations Manager 管理群組,請參閱使用 代理程式安裝精靈部署 Operations Manager 代理程式

  1. 在您的 Log Analytics 工作區中,從您稍早流覽至的 [Windows Server ] 頁面中,根據 Windows 作業系統的處理器架構,選取適當的 [下載 Windows 代理程式 ] 版本進行下載。

  2. 執行安裝程式以在您的電腦上安裝代理程式。

  3. 請在歡迎頁面,按一下[下一步]

  4. 「授權條款」頁面上,閱讀授權,然後按一下「我同意」。

  5. [目的地資料夾 ] 頁面上,變更或保留預設安裝資料夾,然後按一下 [下一步]。

  6. 在 [ 代理程式安裝選項 ] 頁面上,選擇將代理程序連線到 Azure Log Analytics,然後按 [ 下一步]。

  7. [Azure Log Analytics ] 頁面上,執行下列動作:

    1. 貼上您先前複製的工作區 ID工作區金鑰 (主索引鍵)。 如果電腦應該向 Azure 政府雲端中的 Log Analytics 工作區報告,請從 [Azure 雲端] 下拉式清單中選取 [Azure 美國政府]。
    2. 如果電腦需要透過 Proxy 伺服器與 Log Analytics 服務通訊,請按一下 [ 進階 ],並提供 Proxy 伺服器的 URL 和埠號碼。 如果您的 Proxy 伺服器需要驗證,請輸入使用者名稱和密碼以向 Proxy 伺服器進行驗證,然後按一下 下一步
  8. 按一下 下一步 完成提供必要的組態設定之後。

    螢幕擷取畫面,顯示在設定期間貼上工作區識別碼和主索引鍵的位置。

  9. 在 [ 準備安裝 ] 頁面上,檢閱您的選擇,然後按兩下 [ 安裝]。

  10. 在 [設定成功完成] 頁面上,按一下 [完成]。

完成時, Microsoft監視代理程式 會出現在 [控制面板] 中。 若要確認它正在向 Log Analytics 報告,請檢閱 驗證代理程式與 Log Analytics 的連線能力

確認代理程式與 Azure 監視器的連線能力

代理程式安裝完成後,您可以確認它已成功連線,並以兩種方式進行報告。

控制台系統和安全性中,找到 Microsoft Monitoring Agent 項目。 選取它,然後在 [Azure Log Analytics ] 索引標籤上,代理程式應該會顯示一則訊息,指出 Microsoft 監視代理程式已成功連線到 Microsoft Operations Management Suite 服務。

螢幕擷取畫面,顯示 Log Analytics 訊息的 MMA 連線狀態。

您也可以在 Azure 入口網站 中執行記錄查詢:

  1. 在 Azure 入口網站中,搜尋並選取 [監視]。

  2. 選擇功能表上的記錄

  3. [記錄] 窗格的查詢欄位中,輸入:

    Heartbeat 
    | where Category == "Direct Agent" 
    | where TimeGenerated > ago(30m)
    

在傳回的搜尋結果中,您應該會看到電腦的心跳記錄,指出它已連線並回報給服務。

快取資訊

來自 Log Analytics 代理程式的資料會快取在本機電腦上的 C:\Program Files\Microsoft Monitoring Agent\Agent\Health Service State ,然後再傳送至 Azure 監視器。 代理程式嘗試每 20 秒上傳一次。 如果失敗,它將等待指數級增加的時間長度,直到成功為止。 它會在第二次嘗試前等待 30 秒,在下一次嘗試之前等待 60 秒,依此類推,重試之間最多等待 8.5 小時,直到再次成功連線為止。 此等待時間會稍微隨機化,以避免所有代理程式同時嘗試連線。 當達到最大緩衝區時,會捨棄最舊的資料。

預設快取大小為 50 MB,但可以設定為最小 5 MB 至最大 1.5 GB。 它儲存在登錄機碼 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\HealthService\Parameters\Persistence Cache Maximum中。 此值代表頁數,每頁 8 KB。

後續步驟