Estensione macchina virtuale OMS per WindowsOMS virtual machine extension for Windows

In Operations Management Suite (OMS) sono disponibili funzionalità di monitoraggio, avviso e correzione tramite avvisi in risorse cloud e locali.Operations Management Suite (OMS) provides monitoring, alerting, and alert remediation capabilities across cloud and on-premises assets. L'estensione macchina virtuale agente OMS per Windows è pubblicata e supportata da Microsoft.The OMS Agent virtual machine extension for Windows is published and supported by Microsoft. L'estensione installa l'agente OMS in macchine virtuali di Azure e registra le macchine virtuali in un'area di lavoro OMS.The extension installs the OMS agent on Azure virtual machines, and enrolls virtual machines into an existing OMS workspace. Questo documento descrive in dettaglio le piattaforme, le configurazioni e le opzioni di distribuzione supportate per l'estensione macchina virtuale OMS per Windows.This document details the supported platforms, configurations, and deployment options for the OMS virtual machine extension for Windows.

PrerequisitiPrerequisites

Sistema operativoOperating system

L'estensione agente OMS per Windows può essere eseguita in Windows Server 2008 R2, 2012, 2012 R2 e 2016.The OMS Agent extension for Windows can be run against Windows Server 2008 R2, 2012, 2012 R2, and 2016 releases.

Centro sicurezza di AzureAzure Security Center

Il Centro sicurezza di Azure effettua automaticamente il provisioning dell'agente OMS e lo connette all'area di lavoro predefinita di Log Analytics della sottoscrizione di Azure.Azure Security Center automatically provisions the OMS agent and connects it with the default log analytics workspace of the Azure subscription. Se si usa il Centro sicurezza di Azure, non completare i passaggi inclusi in questo documento.If you are using Azure Security Center, do not run through the steps in this document. In caso contrario, si sovrascriverà l'area di lavoro configurata e si interromperà la connessione al Centro sicurezza di Azure.Doing so overwrites the configured workspace and break the connection with Azure Security Center.

Connettività InternetInternet connectivity

Per distribuire l'estensione agente OMS per Windows, è necessario che la macchina virtuale di destinazione sia connessa a Internet.The OMS Agent extension for Windows requires that the target virtual machine is connected to the internet.

Schema dell'estensioneExtension schema

Il codice JSON riportato di seguito mostra lo schema dell'estensione OMS Agent.The following JSON shows the schema for the OMS Agent extension. L'estensione richiede che siano indicati l'ID e la chiave dell'area di lavoro presenti nell'area di lavoro OMS di destinazione. Questi valori sono disponibili nel portale OMS.The extension requires the workspace Id and workspace key from the target OMS workspace, these can be found in the OMS portal. Poiché la chiave dell'area di lavoro deve essere tratta come i dati sensibili, deve essere memorizzata in una configurazione protetta.Because the workspace key should be treated as sensitive data, it should be stored in a protected setting configuration. I dati della configurazione protetta dell'estensione macchina virtuale di Azure vengono crittografati, per essere poi decrittografati solo nella macchina virtuale di destinazione.Azure VM extension protected setting data is encrypted, and only decrypted on the target virtual machine. Tenere presente che workspaceId e workspaceKey distinguono tra maiuscole e minuscole.Note that workspaceId and workspaceKey are case-sensitive.

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

Valori delle proprietàProperty values

NomeName Valore/EsempioValue / Example
apiVersionapiVersion 2015-06-152015-06-15
publisherpublisher Microsoft.EnterpriseCloud.MonitoringMicrosoft.EnterpriseCloud.Monitoring
typetype MicrosoftMonitoringAgentMicrosoftMonitoringAgent
typeHandlerVersiontypeHandlerVersion 1.01.0
workspaceId (esempio)workspaceId (e.g) 6f680a37-00c6-41c7-a93f-1437e34625746f680a37-00c6-41c7-a93f-1437e3462574
workspaceKey (esempio)workspaceKey (e.g) z4bU3p1/GrnWpQkky4gdabWXAhbWSTz70hm4m2Xt92XI+rSRgE8qVvRhsGo9TXffbrTahyrwv35W0pOqQAU7uQ==z4bU3p1/GrnWpQkky4gdabWXAhbWSTz70hm4m2Xt92XI+rSRgE8qVvRhsGo9TXffbrTahyrwv35W0pOqQAU7uQ==

Distribuzione del modelloTemplate deployment

Le estensioni macchina virtuale di Azure possono essere distribuite con i modelli di Azure Resource Manager.Azure VM extensions can be deployed with Azure Resource Manager templates. Lo schema JSON indicato nella sezione precedente può essere usato in un modello di Azure Resource Manager per eseguire l'estensione agente OMS durante la distribuzione di un modello di Azure Resource Manager.The JSON schema detailed in the previous section can be used in an Azure Resource Manager template to run the OMS Agent extension during an Azure Resource Manager template deployment. Un esempio di modello che include l'estensione macchina virtuale Agente OMS è disponibile nella raccolta di avvio rapido di Azure.A sample template that includes the OMS Agent VM extension can be found on the Azure Quick Start Gallery.

Il codice JSON per un'estensione della macchina virtuale può essere nidificato nella risorsa della macchina virtuale o posizionato nel livello radice o nel livello superiore di un modello JSON di Resource Manager.The JSON for a virtual machine extension can be nested inside the virtual machine resource, or placed at the root or top level of a Resource Manager JSON template. Il posizionamento di JSON influisce sul valore del nome e tipo di risorsa.The placement of the JSON affects the value of the resource name and type. Per altre informazioni, vedere Set name and type for child resources (Impostare il nome e il tipo per le risorse figlio).For more information, see Set name and type for child resources.

L'esempio seguente presuppone che l'estensione OMS sia annidata all'interno della risorsa della macchina virtuale.The following example assumes the OMS extension is nested inside the virtual machine resource. Quando la risorsa di estensione viene nidificata, JSON viene inserito nell'oggetto "resources": [] della macchina virtuale.When nesting the extension resource, the JSON is placed in the "resources": [] object of the virtual machine.

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

Quando si posiziona l'estensione JSON nella radice del modello, il nome della risorsa include un riferimento alla macchina virtuale padre e il tipo riflette la configurazione annidata.When placing the extension JSON at the root of the template, the resource name includes a reference to the parent virtual machine, and the type reflects the nested configuration.

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

Distribuzione PowerShellPowerShell deployment

Il comando Set-AzureRmVMExtension consente di distribuire l'estensione macchina virtuale OMS a una macchina virtuale esistente.The Set-AzureRmVMExtension command can be used to deploy the OMS Agent virtual machine extension to an existing virtual machine. Prima di eseguire il comando, le configurazioni pubbliche e private devono essere archiviate in una tabella hash di PowerShell.Before running the command, the public and private configurations need to be stored in a PowerShell hash table.

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

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

Risoluzione dei problemi e supportoTroubleshoot and support

Risolvere problemiTroubleshoot

I dati sullo stato delle distribuzioni dell'estensione possono essere recuperati nel portale di Azure e tramite il modulo Azure PowerShell.Data about the state of extension deployments can be retrieved from the Azure portal, and by using the Azure PowerShell module. Per visualizzare lo stato di distribuzione delle estensioni per una determinata VM, eseguire questo comando nel modulo Azure PowerShell.To see the deployment state of extensions for a given VM, run the following command using the Azure PowerShell module.

Get-AzureRmVMExtension -ResourceGroupName myResourceGroup -VMName myVM -Name myExtensionName

L'output dell'esecuzione dell'estensione viene registrato nei file presenti nella directory seguente:Extension execution output is logged to files found in the following directory:

C:\WindowsAzure\Logs\Plugins\Microsoft.EnterpriseCloud.Monitoring.MicrosoftMonitoringAgent\

SupportoSupport

Per ricevere assistenza in relazione a qualsiasi punto di questo articolo, contattare gli esperti di Azure nei forum MSDN e Stack Overflow relativi ad Azure.If you need more help at any point in this article, you can contact the Azure experts on the MSDN Azure and Stack Overflow forums. In alternativa, è possibile archiviare un evento imprevisto di supporto tecnico di Azure.Alternatively, you can file an Azure support incident. Accedere al sito del supporto di Azure e selezionare l'opzione desiderata per ottenere supporto.Go to the Azure support site and select Get support. Per informazioni sull'uso del supporto di Azure, leggere le Domande frequenti sul supporto di Azure.For information about using Azure Support, read the Microsoft Azure support FAQ.