本文提供如何使用下列方法在 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 工作區:
安裝適用於您作業系統的最新 Service Pack。 所需的 Service Pack 版本包括:
- Windows 7 SP1
- Windows Server 2008 SP2
- Windows Server 2008 R2 SP1
為您的 OS 安裝 SHA-2 簽署 Windows 更新,如 Windows 和 WSUS 的 2019 SHA-2 程式代碼簽署支援需求中所述。
更新至最新版本的 Windows 代理程式 (版本 10.20.18067)。
建議您將代理程式設定為 使用 TLS 1.2。
網路需求
如需 Windows 代理程式的網路需求,請參閱 Log Analytics 代理程式概觀 。
將代理程式設定為使用 TLS 1.2
TLS 1.2 通訊協定可確保 Windows 代理程式與 Log Analytics 服務之間通訊的傳輸資料安全性。 如果您在預設未啟用 TLS 的作業系統上安裝,請使用下列步驟設定 TLS 1.2。
找出下列登錄子機碼: HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols。
在 Protocols 底下為 TLS 1.2 建立子機碼:HKLM\System\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2。
在您稍早建立的 TLS 1.2 通訊協定版本子機碼下建立 用戶端 子機碼。 例如, HKLM\System\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Client。
在 HKLM\System\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Client 下建立下列 DWORD 值:
- 已啟用 [值 = 1]
- DisabledByDefault [值= 0]
設定 .NET Framework 4.6 或更新版本以支援安全加密,因為預設將其停用。 強加密使用更安全的網絡協議,如 TLS 1.2,並阻止不安全的協議。
找出下列登錄子機碼: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\v4.0.30319。
在此子機碼下建立 DWORD 值 SchUseStrongCrypto ,值為 1。
找出下列登錄子機碼: HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\.NETFramework\v4.0.30319。
在此子機碼下建立 DWORD 值 SchUseStrongCrypto ,值為 1。
重新啟動系統來使設定生效。
工作區 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 代理程式。
在您的 Log Analytics 工作區中,從您稍早流覽至的 [Windows Server ] 頁面中,根據 Windows 作業系統的處理器架構,選取適當的 [下載 Windows 代理程式 ] 版本進行下載。
執行安裝程式以在您的電腦上安裝代理程式。
請在歡迎頁面,按一下[下一步]。
在「授權條款」頁面上,閱讀授權,然後按一下「我同意」。
在 [目的地資料夾 ] 頁面上,變更或保留預設安裝資料夾,然後按一下 [下一步]。
在 [ 代理程式安裝選項 ] 頁面上,選擇將代理程序連線到 Azure Log Analytics,然後按 [ 下一步]。
在 [Azure Log Analytics ] 頁面上,執行下列動作:
- 貼上您先前複製的工作區 ID 和工作區金鑰 (主索引鍵)。 如果電腦應該向 Azure 政府雲端中的 Log Analytics 工作區報告,請從 [Azure 雲端] 下拉式清單中選取 [Azure 美國政府]。
- 如果電腦需要透過 Proxy 伺服器與 Log Analytics 服務通訊,請按一下 [ 進階 ],並提供 Proxy 伺服器的 URL 和埠號碼。 如果您的 Proxy 伺服器需要驗證,請輸入使用者名稱和密碼以向 Proxy 伺服器進行驗證,然後按一下 下一步。
按一下 下一步 完成提供必要的組態設定之後。
在 [ 準備安裝 ] 頁面上,檢閱您的選擇,然後按兩下 [ 安裝]。
在 [設定成功完成] 頁面上,按一下 [完成]。
完成時, Microsoft監視代理程式 會出現在 [控制面板] 中。 若要確認它正在向 Log Analytics 報告,請檢閱 驗證代理程式與 Log Analytics 的連線能力。
確認代理程式與 Azure 監視器的連線能力
代理程式安裝完成後,您可以確認它已成功連線,並以兩種方式進行報告。
從控制台的系統和安全性中,找到 Microsoft Monitoring Agent 項目。 選取它,然後在 [Azure Log Analytics ] 索引標籤上,代理程式應該會顯示一則訊息,指出 Microsoft 監視代理程式已成功連線到 Microsoft Operations Management Suite 服務。
您也可以在 Azure 入口網站 中執行記錄查詢:
在 Azure 入口網站中,搜尋並選取 [監視]。
選擇功能表上的記錄。
在 [記錄] 窗格的查詢欄位中,輸入:
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。
後續步驟
- 檢閱管理和 維護適用於 Windows 和 Linux 的 Log Analytics 代理程式 ,以瞭解如何從虛擬機器重新設定、升級或移除代理程式。
- 請檢閱 Windows 代理程式的疑難排解 ,如果您在安裝或管理代理程式時遇到問題。