Rozšíření virtuálního počítače agenta Log Analytics pro Windows

Protokoly služby Azure Monitor poskytují možnosti monitorování napříč cloudovými a místními prostředky. Microsoft publikuje a podporuje rozšíření virtuálního počítače s agentem Log Analytics pro Windows. Rozšíření nainstaluje agenta Log Analytics na virtuální počítače Azure a zaregistruje virtuální počítače do existujícího pracovního prostoru služby Log Analytics. Tento článek popisuje podporované platformy, konfigurace a možnosti nasazení pro rozšíření agenta Log Analytics pro Windows.

Požadavky

Projděte si následující požadavky pro použití rozšíření virtuálního počítače agenta Log Analytics pro Windows.

Operační systém

Podrobnosti o podporovaných operačních systémech Windows najdete v článku Přehled agentů služby Azure Monitor.

Verze rozšíření agenta a virtuálního počítače

Následující tabulka obsahuje mapování verze rozšíření virtuálního počítače s Windows Log Analytics a agenta Log Analytics pro každou verzi.

Microsoft Defender for Cloud

Microsoft Defender pro cloud automaticky zřídí agenta Log Analytics a připojí ho k výchozímu pracovnímu prostoru služby Log Analytics předplatného Azure.

Azure Arc

Servery s podporou Azure Arc můžete použít k nasazení, odebrání a aktualizaci rozšíření virtuálního počítače agenta Log Analytics na počítače s Windows a Linuxem mimo Azure. Tento přístup zjednodušuje správu hybridního počítače prostřednictvím jejich životního cyklu. Další informace najdete v tématu Správa rozšíření virtuálních počítačů pomocí serverů s podporou Azure Arc.

Připojení k internetu

Rozšíření virtuálního počítače agenta Log Analytics pro Windows vyžaduje, aby byl cílový virtuální počítač připojený k internetu.

Schéma rozšíření

Následující JSON ukazuje schéma pro rozšíření virtuálního počítače agenta Log Analytics pro Windows. Rozšíření vyžaduje ID pracovního prostoru a klíč pracovního prostoru z cílového pracovního prostoru služby Log Analytics. Tyto položky najdete v nastavení pracovního prostoru na webu Azure Portal.

Protože klíč pracovního prostoru by se měl považovat za citlivá data, měl by být uložen v konfiguraci chráněného nastavení. Data chráněného nastavení rozšíření virtuálního počítače Azure se šifrují a dešifrují se jenom na cílovém virtuálním počítači.

{
    "type": "extensions",
    "name": "OMSExtension",
    "apiVersion": "[variables('apiVersion')]",
    "location": "[resourceGroup().location]",
    "dependsOn": [
        "[concat('Microsoft.Compute/virtualMachines/', variables('vmName'))]"
    ],
    "properties": {
        "publisher": "Microsoft.EnterpriseCloud.Monitoring",
        "type": "MicrosoftMonitoringAgent",
        "typeHandlerVersion": "1.0",
        "autoUpgradeMinorVersion": true,
        "settings": {
            "workspaceId": "myWorkSpaceId"
        },
        "protectedSettings": {
            "workspaceKey": "myWorkspaceKey"
        }
    }
}

Hodnoty vlastností

Schéma JSON obsahuje následující vlastnosti.

* Vlastnost workspaceId schématu je určena consumerId jako vlastnost v rozhraní Log Analytics API.

Nasazení šablon

Rozšíření virtuálních počítačů Azure je možné nasadit pomocí šablon Azure Resource Manageru (ARM). Schéma JSON podrobně popsané v předchozí části můžete použít v šabloně ARM ke spuštění rozšíření virtuálního počítače agenta Log Analytics během nasazení šablony ARM. Ukázkovou šablonu, která obsahuje rozšíření virtuálního počítače agenta Log Analytics, najdete v galerii rychlých startů Azure.

Json pro rozšíření virtuálního počítače je možné vnořit do prostředku virtuálního počítače nebo umístit na kořenovou nebo nejvyšší úroveň šablony JSON ARM. Umístění JSON má vliv na hodnotu názvu a typu prostředku. Další informace naleznete v tématu Nastavení názvu a typu pro podřízené prostředky.

Následující příklad předpokládá, že rozšíření virtuálního počítače agenta Log Analytics je vnořené do prostředku virtuálního počítače. Při vnoření prostředku rozšíření se JSON umístí do "resources": [] objektu virtuálního počítače.

{
    "type": "extensions",
    "name": "OMSExtension",
    "apiVersion": "[variables('apiVersion')]",
    "location": "[resourceGroup().location]",
    "dependsOn": [
        "[concat('Microsoft.Compute/virtualMachines/', variables('vmName'))]"
    ],
    "properties": {
        "publisher": "Microsoft.EnterpriseCloud.Monitoring",
        "type": "MicrosoftMonitoringAgent",
        "typeHandlerVersion": "1.0",
        "autoUpgradeMinorVersion": true,
        "settings": {
            "workspaceId": "myWorkSpaceId"
        },
        "protectedSettings": {
            "workspaceKey": "myWorkspaceKey"
        }
    }
}

Když umístíte JSON rozšíření do kořenového adresáře šablony ARM, prostředek name obsahuje odkaz na nadřazený virtuální počítač a type odráží vnořenou konfiguraci.

{
    "type": "Microsoft.Compute/virtualMachines/extensions",
    "name": "<parentVmResource>/OMSExtension",
    "apiVersion": "[variables('apiVersion')]",
    "location": "[resourceGroup().location]",
    "dependsOn": [
        "[concat('Microsoft.Compute/virtualMachines/', variables('vmName'))]"
    ],
    "properties": {
        "publisher": "Microsoft.EnterpriseCloud.Monitoring",
        "type": "MicrosoftMonitoringAgent",
        "typeHandlerVersion": "1.0",
        "autoUpgradeMinorVersion": true,
        "settings": {
            "workspaceId": "myWorkSpaceId"
        },
        "protectedSettings": {
            "workspaceKey": "myWorkspaceKey"
        }
    }
}

Nasazení PowerShellu

Tento Set-AzVMExtension příkaz lze použít k nasazení rozšíření virtuálního počítače agenta Log Analytics do existujícího virtuálního počítače. Před spuštěním příkazu uložte veřejné a privátní konfigurace do hashtable PowerShellu.

$PublicSettings = @{"workspaceId" = "myWorkspaceId"}
$ProtectedSettings = @{"workspaceKey" = "myWorkspaceKey"}

Set-AzVMExtension -ExtensionName "MicrosoftMonitoringAgent" `
    -ResourceGroupName "myResourceGroup" `
    -VMName "myVM" `
    -Publisher "Microsoft.EnterpriseCloud.Monitoring" `
    -ExtensionType "MicrosoftMonitoringAgent" `
    -TypeHandlerVersion 1.0 `
    -Settings $PublicSettings `
    -ProtectedSettings $ProtectedSettings `
    -Location WestUS 

Řešení potíží

Tady je několik návrhů, jak řešit problémy s nasazením.

Zobrazení stavu rozšíření

Zkontrolujte stav nasazení rozšíření na webu Azure Portal nebo pomocí PowerShellu nebo Azure CLI.

Pokud chcete zobrazit stav nasazení rozšíření pro daný virtuální počítač, spusťte následující příkazy.

• Azure PowerShell:

  Get-AzVMExtension -ResourceGroupName <myResourceGroup> -VMName <myVM> -Name <myExtensionName>
  

• The Azure CLI:

  az vm get-instance-view --resource-group <myResourceGroup> --name <myVM> --query "instanceView.extensions"
  

Kontrola výstupních protokolů

Zobrazení výstupních protokolů pro rozšíření virtuálního počítače agenta Log Analytics pro Windows v části C:\WindowsAzure\Logs\Plugins\Microsoft.EnterpriseCloud.Monitoring.MicrosoftMonitoringAgent\.

Získání podpory

Tady jsou některé další možnosti, které vám pomůžou vyřešit problémy s nasazením:

• Pokud potřebujete pomoc, obraťte se na odborníky na Azure na fórech Q&A a Stack Overflow.

• Můžete také kontaktovat podpora Microsoftu. Informace o používání podpora Azure najdete v podpora Azure nejčastějších dotazech.