適用於 Linux 的 Log Analytics 虛擬機器擴充功能

概觀

對於雲端和內部部署資產，Azure 監視器記錄提供監視、警示和警示補救功能。 Microsoft 已發佈並支援適用於 Linux 的 Log Analytics 虛擬機器擴充功能。 擴充功能會在 Azure 虛擬機器上安裝 Log Analytics 代理程式，並且在現有的 Log Analytics 工作區中註冊虛擬機器。 本文件詳述適用於 Linux 的 Log Analytics 虛擬機器擴充功能所支援的平台、組態和部署選項。

必要條件

作業系統

如需所支援 Linux 發行版本的詳細資訊，請參閱 Azure 監視器代理程式概觀一文。

代理程式和 VM 擴充功能版本

下表針對每個版本提供 Log Analytics VM 擴充功能和 Log Analytics 代理程式套件組合的版本對應。 隨附 Log Analytics 代理程式套件組合版本的版本資訊連結。 版本資訊包含錯誤修正和適用於指定代理程式版本的新功能詳細資料。

適用於雲端的 Microsoft Defender

適用於雲端的 Microsoft Defender 會自動佈建 Log Analytics 代理程式，並且將其連線至 Azure 訂用帳戶中適用於雲端的 Defender 建立的預設 Log Analytics 工作區。 如果您使用的是適用於雲端的 Microsoft Defender，請不要執行此文件中的步驟。 這樣做會覆寫已設定的工作區，並中斷與適用於雲端的 Microsoft Defender 的連線。

網際網路連線能力

適用於 Linux 的 Log Analytics 代理程式延伸模組會要求目標虛擬機器連線到網際網路。

擴充功能結構描述

下列 JSON 顯示 Log Analytics 代理程式擴充功能的結構描述。 此擴充功能需要來自目標 Log Analytics 工作區的工作區 ID 和工作區金鑰，這些值可於 Azure 入口網站中在 Log Analytics 工作區尋找。 由於工作區金鑰應視為敏感性資料，因此應儲存在受保護的設定組態中。 Azure VM 擴充功能保護的設定資料會經過加密，只會在目標虛擬機器上解密。 請注意，workspaceId 和 workspaceKey 區分大小寫。

{
  "type": "Microsoft.Compute/virtualMachines/extensions",
  "name": "OMSExtension",
  "apiVersion": "2018-06-01",
  "location": "<location>",
  "dependsOn": [
    "[concat('Microsoft.Compute/virtualMachines/', <vm-name>)]"
  ],
  "properties": {
    "publisher": "Microsoft.EnterpriseCloud.Monitoring",
    "type": "OmsAgentForLinux",
    "typeHandlerVersion": "1.16",
    "autoUpgradeMinorVersion": true,
    "settings": {
      "workspaceId": "myWorkspaceId",
      "skipDockerProviderInstall": true
    },
    "protectedSettings": {
      "workspaceKey": "myWorkSpaceKey"
    }
  }
}

屬性值

範本部署

也可以使用 Azure Resource Manager 範本部署 Azure VM 擴充功能。 如果部署一或多部虛擬機器之後需要設定 (例如上架至 Azure 監視器記錄)，就很適合使用範本。 Azure 快速入門資源庫中有一個範例 Resource Manager 範本包含 Log Analytics 代理程式 VM 延伸模組。

虛擬機器擴充功能的 JSON 設定可以巢狀方式置於虛擬機器資源內部，或放在 Resource Manager JSON 範本的根目錄或最上層。 JSON 設定的放置會影響資源名稱和類型的值。 如需詳細資訊，請參閱設定子資源的名稱和類型。

下列範例假設 VM 擴充功能以巢狀方式置於虛擬機器資源內部。 在巢狀處理擴充資源時，JSON 會放在虛擬機器的 "resources": [] 物件中。

{
  "type": "extensions",
  "name": "OMSExtension",
  "apiVersion": "2018-06-01",
  "location": "<location>",
  "dependsOn": [
    "[concat('Microsoft.Compute/virtualMachines/', <vm-name>)]"
  ],
  "properties": {
    "publisher": "Microsoft.EnterpriseCloud.Monitoring",
    "type": "OmsAgentForLinux",
    "typeHandlerVersion": "1.16",
    "settings": {
      "workspaceId": "myWorkspaceId",
      "skipDockerProviderInstall": true
    },
    "protectedSettings": {
      "workspaceKey": "myWorkSpaceKey"
    }
  }
}

將擴充 JSON 置於範本的根目錄時，資源名稱包含父系虛擬機器的參考，而類型可反映巢狀的組態。

{
  "type": "Microsoft.Compute/virtualMachines/extensions",
  "name": "<parentVmResource>/OMSExtension",
  "apiVersion": "2018-06-01",
  "location": "<location>",
  "dependsOn": [
    "[concat('Microsoft.Compute/virtualMachines/', <vm-name>)]"
  ],
  "properties": {
    "publisher": "Microsoft.EnterpriseCloud.Monitoring",
    "type": "OmsAgentForLinux",
    "typeHandlerVersion": "1.16",
    "settings": {
      "workspaceId": "myWorkspaceId",
      "skipDockerProviderInstall": true
    },
    "protectedSettings": {
      "workspaceKey": "myWorkSpaceKey"
    }
  }
}

Azure CLI 部署

Azure CLI 可以用來將 Log Analytics 代理程式 VM 擴充功能部署到現有的虛擬機器。 請將下方的 myWorkspaceKey 值換成您的工作區金鑰，將 myWorkspaceId 值換成您的工作區識別碼。 在 Azure 入口網站中的 [進階設定] 下，您可以在 Log Analytics 工作區中找到這些值。 以 Log Analytics Linux VM 擴充功能版本取代 latestVersion 值。

az vm extension set \
  --resource-group myResourceGroup \
  --vm-name myVM \
  --name OmsAgentForLinux \
  --publisher Microsoft.EnterpriseCloud.Monitoring \
  --protected-settings '{"workspaceKey":"myWorkspaceKey"}' \
  --settings '{"workspaceId":"myWorkspaceId","skipDockerProviderInstall": true}' \
  --version latestVersion

Azure PowerShell 部署

Azure Powershell Cmdlet 可以用來將 Log Analytics 代理程式 VM 擴充功能部署到現有的虛擬機器。 請將下方的 myWorkspaceKey 值換成您的工作區金鑰，將 myWorkspaceId 值換成您的工作區識別碼。 在 Azure 入口網站中的 [進階設定] 下，您可以在 Log Analytics 工作區中找到這些值。 以 Log Analytics Linux VM 擴充功能版本取代 latestVersion 值。

Set-AzVMExtension \
  -ResourceGroupName myResourceGroup \
  -VMName myVM \
  -ExtensionName OmsAgentForLinux \
  -ExtensionType OmsAgentForLinux \
  -Publisher Microsoft.EnterpriseCloud.Monitoring \
  -TypeHandlerVersion latestVersion \
  -ProtectedSettingString '{"workspaceKey":"myWorkspaceKey"}' \
  -SettingString '{"workspaceId":"myWorkspaceId","skipDockerProviderInstall": true}'

疑難排解與支援

疑難排解

使用 Azure CLI 或 Azure PowerShell 模組，就可以從 Azure 入口網站擷取有關延伸模組部署狀態的資料。 若要查看指定 VM 的擴充功能部署狀態，請執行下列命令 (如使用 Azure CLI)。

az vm extension list --resource-group myResourceGroup --vm-name myVM -o table

擴充功能執行輸出會記錄至下列檔案︰

/var/log/azure/Microsoft.EnterpriseCloud.Monitoring.OmsAgentForLinux/extension.log

若要擷取 VM 上安裝的 OMS 延伸模組版本，請執行下列命令 (如使用 Azure CLI)。

az vm extension show --resource-group myResourceGroup --vm-name myVM --instance-view

若要擷取 VM 上安裝的 OMS 延伸模組版本，請執行下列命令 (如使用 Azure PowerShell)。

Get-AzVMExtension -ResourceGroupName my_resource_group  -VMName my_vm_name -Name OmsAgentForLinux -Status

錯誤碼及其意義

如需其他疑難排解資訊，請參閱 Log Analytics-Agent-for-Linux 疑難排解指南。

支援

如果您在本文中有任何需要協助的地方，您可以連絡 MSDN Azure 和 Stack Overflow 論壇上的 Azure 專家。 或者，您可以提出 Azure 支援事件。 請移至 Azure 支援網站，然後選取 [取得支援]。 如需使用 Azure 支援的資訊，請參閱 Microsoft Azure 支援常見問題集。