VM-Erweiterung für den Protokollanalyse-Agents für Windows

Azure Monitor-Protokolle bieten Überwachungsfunktionen für cloudbasierte und lokale Ressourcen. Microsoft veröffentlicht und unterstützt die Erweiterung für virtuelle Computer (VM) für den Protokollanalyse-Agents für Windows. Die Erweiterung installiert den Protokollanalyse-Agent auf Azure VMs und registriert VMs in einem vorhandenen Log Analytics-Arbeitsbereich. Dieser Artikel beschreibt die unterstützten Plattformen, Konfigurationen und Bereitstellungsoptionen für die VM-Erweiterung des Protokollanalyse-Agents für Windows.

Voraussetzungen

Überprüfen Sie die folgenden Voraussetzungen für die Verwendung der VM-Erweiterung des Protokollanalyse-Agents für Windows.

Betriebssystem

Ausführliche Informationen zu den unterstützten Windows-Betriebssystemen finden Sie im Artikel Übersicht über Azure Monitor-Agents.

Version des Agents und der VM-Erweiterung

Die folgende Tabelle enthält eine Zuordnung der Version der Log Analytics-VM-Erweiterung für Windows und des Log Analytics-Agent für jedes Release.

Microsoft Defender für Cloud

Microsoft Defender für Cloud stellt den Log Analytics-Agent automatisch bereit und verbindet ihn mit dem standardmäßigen Log Analytics-Arbeitsbereich für das Azure-Abonnement.

Azure Arc

Sie können Azure Arc-fähige Server verwenden, um die VM-Erweiterung für den Protokollanalyse-Agent auf Nicht-Azure-Windows- und Linux-Computern bereitzustellen, zu entfernen oder zu aktualisieren. Dieser Ansatz vereinfacht die Verwaltung Ihres Hybridcomputers über ihren Lebenszyklus hinweg. Weitere Informationen finden Sie unter Verwaltung von Erweiterungen für virtuelle Maschinen mit Azure-Arc-fähigen Servern.

Internetkonnektivität

Die VM-Erweiterung des Protokollanalyse-Agents für Windows erfordert, dass die Ziel-VM mit dem Internet verbunden ist.

Erweiterungsschema

Der folgende JSON-Code zeigt das Schema für die VM-Erweiterung des Protokollanalyse-Agents für Windows. Für die Erweiterung werden die Arbeitsbereichs-ID und der Arbeitsbereichsschlüssel aus dem Log Analytics-Zielarbeitsbereich benötigt. Diese Elemente können in den Einstellungen für den Arbeitsbereich im Azure-Portal gefunden werden.

Da der Arbeitsbereichsschlüssel als vertrauliche Information behandelt werden muss, sollte er in einer geschützten Einstellungskonfiguration gespeichert werden. Die geschützten Einstellungsdaten der Azure-VM-Erweiterung sind verschlüsselt und werden nur auf der Ziel-VM entschlüsselt.

{
    "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"
        }
    }
}

Eigenschaftswerte

Das JSON-Schema enthält die folgenden Eigenschaften.

* Die workspaceId-Schemaeigenschaft wird als consumerId-Eigenschaft in der Protokollanalyse-API angegeben.

Bereitstellung von Vorlagen

Azure VM-Erweiterungen können mithilfe von Azure Resource Manager-Vorlagen (ARM-Vorlagen) bereitgestellt werden. Das im vorherigen Abschnitt erläuterte JSON-Schema kann in einer ARM-Vorlage zum Ausführen der VM-Erweiterung des Protokollanalyse-Agents während einer ARM-Bereitstellung verwendet werden. Eine Beispielvorlage mit der Log Analytics-Agent-VM-Erweiterung finden Sie im Azure-Schnellstartkatalog.

Das JSON für eine VM-Erweiterung kann innerhalb der VM-Ressource geschachtelt oder im Stamm bzw. auf der obersten Ebene einer JSON ARM-Vorlage platziert werden. Die Platzierung des JSON-Codes wirkt sich auf den Wert von Name und Typ der Ressource aus. Weitere Informationen finden Sie unter Set name and type for child resources (Festlegen von Name und Typ für untergeordnete Ressourcen).

Im folgenden Beispiel wird davon ausgegangen, dass die VM-Erweiterung des Protokollanalyse-Agents in der VM-Ressource geschachtelt ist. Wenn Sie die Erweiterungsressource schachteln, wird das JSON im "resources": []-Objekt der VM platziert.

{
    "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"
        }
    }
}

Wenn Sie das Erweiterungs-JSON im Stamm der ARM-Vorlage platzieren, enthält der name der Ressource einen Verweis auf die übergeordnete VM, und type spiegelt die geschachtelte Konfiguration wider.

{
    "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"
        }
    }
}

PowerShell-Bereitstellung

Der Set-AzVMExtension-Befehl kann verwendet werden, um die VM-Erweiterung des Protokollanalyse-Agents in einer vorhandenen VM bereitzustellen. Speichern Sie vor dem Ausführen des Befehls die öffentlichen und privaten Konfigurationen in einer PowerShell-Hashtabelle.

$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 

Behandeln von Problemen

Hier finden Sie einige Vorschläge für die Behandlung von Bereitstellungsproblemen.

Anzeigen des Erweiterungsstatus

Überprüfen Sie den Status Ihrer Erweiterungsbereitstellung im Azure-Portal oder mithilfe von PowerShell oder der Azure CLI.

Führen Sie den folgenden Befehl aus, um den Bereitstellungsstatus von Erweiterungen für eine bestimmte VM anzuzeigen.

• Azure PowerShell:

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

• Azure CLI:

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

Überprüfen der Ausgabeprotokolle

Anzeigen von Ausgabeprotokollen für die VM-Erweiterung des Protokollanalyse-Agents für Windows unter C:\WindowsAzure\Logs\Plugins\Microsoft.EnterpriseCloud.Monitoring.MicrosoftMonitoringAgent\.

Support

Im Folgenden finden Sie einige weitere Optionen, mit denen Sie Bereitstellungsprobleme beheben können:

• Über das Q&A-Forum oder das Stack Overflow-Forum können Sie sich mit Azure-Expert*innen in Verbindung setzen, um Unterstützung zu erhalten.

• Sie können auch den Microsoft-Support kontaktieren. Informationen zur Nutzung von Azure-Support finden Sie unter Häufig gestellte Fragen zum Azure-Support.