Estensione macchina virtuale OMS per LinuxOMS virtual machine extension for Linux

PanoramicaOverview

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 Linux è pubblicata e supportata da Microsoft.The OMS Agent virtual machine extension for Linux 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 esistente.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 Linux.This document details the supported platforms, configurations, and deployment options for the OMS virtual machine extension for Linux.

PrerequisitiPrerequisites

Sistema operativoOperating system

L'estensione agente OMS può essere eseguita in queste distribuzioni di Linux.The OMS Agent extension can be run against these Linux distributions.

DistribuzioneDistribution VersioneVersion
CentOS LinuxCentOS Linux 5, 6 e 75, 6, and 7
Oracle LinuxOracle Linux 5, 6 e 75, 6, and 7
Red Hat Enterprise Linux ServerRed Hat Enterprise Linux Server 5, 6 e 75, 6 and 7
Debian GNU/LinuxDebian GNU/Linux 6, 7 e 86, 7, and 8
UbuntuUbuntu 12.04 LTS, 14.04 LTS, 15.04, 15.10, 16.04 LTS12.04 LTS, 14.04 LTS, 15.04, 15.10, 16.04 LTS
SUSE Linux Enterprise ServerSUSE Linux Enterprise Server 11 e 1211 and 12

Connettività InternetInternet connectivity

Per distribuire l'estensione agente OMS per Linux, è necessario che la macchina virtuale di destinazione sia connessa a Internet.The OMS Agent extension for Linux 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 values 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": "2015-06-15",
  "location": "<location>",
  "dependsOn": [
    "[concat('Microsoft.Compute/virtualMachines/', <vm-name>)]"
  ],
  "properties": {
    "publisher": "Microsoft.EnterpriseCloud.Monitoring",
    "type": "OmsAgentForLinux",
    "typeHandlerVersion": "1.4",
    "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 OmsAgentForLinuxOmsAgentForLinux
typeHandlerVersiontypeHandlerVersion 1.41.4
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. I modelli rappresentano la scelta migliore quando si distribuiscono una o più macchine virtuali per cui è necessaria una configurazione post-distribuzione, ad esempio il caricamento in OMS.Templates are ideal when deploying one or more virtual machines that require post deployment configuration such as onboarding to OMS. Un esempio di modello di Resource Manager che include l'estensione macchina virtuale Agente OMS è disponibile nella raccolta di avvio rapido di Azure.A sample Resource Manager template that includes the OMS Agent VM extension can be found on the Azure Quick Start Gallery.

La configurazione JSON per un'estensione macchina virtuale può essere annidata nella risorsa della macchina virtuale o posizionata nel livello radice o nel livello superiore di un modello JSON di Gestione risorse.The JSON configuration 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 della configurazione JSON influisce sul valore del nome e del tipo di risorsa.The placement of the JSON configuration 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": "2015-06-15",
  "location": "<location>",
  "dependsOn": [
    "[concat('Microsoft.Compute/virtualMachines/', <vm-name>)]"
  ],
  "properties": {
    "publisher": "Microsoft.EnterpriseCloud.Monitoring",
    "type": "OmsAgentForLinux",
    "typeHandlerVersion": "1.4",
    "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": "2015-06-15",
  "location": "<location>",
  "dependsOn": [
    "[concat('Microsoft.Compute/virtualMachines/', <vm-name>)]"
  ],
  "properties": {
    "publisher": "Microsoft.EnterpriseCloud.Monitoring",
    "type": "OmsAgentForLinux",
    "typeHandlerVersion": "1.4",
    "settings": {
      "workspaceId": "myWorkspaceId"
    },
    "protectedSettings": {
      "workspaceKey": "myWorkSpaceKey"
    }
  }
}

Distribuzione dell'interfaccia della riga di comando di AzureAzure CLI deployment

L'interfaccia della riga di comando di Azure può essere usata per distribuire l'estensione macchina virtuale Agente OMS in una macchina virtuale esistente.The Azure CLI can be used to deploy the OMS Agent VM extension to an existing virtual machine. Sostituire la chiave OMS e l'ID OMS con i dati presenti nello spazio di lavoro OMS.Replace the OMS key and OMS ID with those from your OMS workspace.

az vm extension set \
  --resource-group myResourceGroup \
  --vm-name myVM \
  --name OmsAgentForLinux \
  --publisher Microsoft.EnterpriseCloud.Monitoring \
  --version 1.4 --protected-settings '{"workspaceKey": "omskey"}' \
  --settings '{"workspaceId": "omsid"}'

Risoluzione dei problemi e supportoTroubleshoot and support

Risoluzione dei problemiTroubleshoot

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

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

L'output dell'esecuzione dell'estensione viene registrato nel file seguente:Extension execution output is logged to the following file:

/opt/microsoft/omsagent/bin/stdout

Codici di errore e relativi significatiError codes and their meanings

Codice di erroreError Code SignificatoMeaning Azione possibilePossible Action
1010 La macchina virtuale è già connessa a un'area di lavoro OMSVM is already connected to an OMS workspace Per connettere la macchina virtuale all'area di lavoro specificata nello schema dell'estensione, impostare stopOnMultipleConnections su false nelle impostazioni pubbliche o rimuovere questa proprietà.To connect the VM to the workspace specified in the extension schema, set stopOnMultipleConnections to false in public settings or remove this property. Questa macchina virtuale viene fatturata una volta per ogni area di lavoro a cui è connessa.This VM gets billed once for each workspace it is connected to.
1111 Configurazione non valida generata per l'estensioneInvalid config provided to the extension Seguire l'esempio precedente per impostare tutti i valori della proprietà necessari alla distribuzione.Follow the preceding examples to set all property values necessary for deployment.
1212 La gestione di pacchetti dpkg è bloccataThe dpkg package manager is locked Assicurarsi che tutte le operazioni di aggiornamento dpkg sul computer siano state completate e riprovare.Make sure all dpkg update operations on the machine have finished and retry.
2020 Chiamata Enable anomalaEnable called prematurely Aggiornare l'agente Linux di Azure all'ultima versione disponibile.Update the Azure Linux Agent to the latest available version.
5151 Questa estensione non è supportata sul sistema operativo della macchina virtualeThis extension is not supported on the VM's operation system
5555 Non è possibile connettersi al servizio Microsoft Operations Management SuiteCannot connect to the Microsoft Operations Management Suite service Verificare che il sistema disponga dell'accesso a Internet o che sia stato fornito un proxy HTTP valido.Check that the system either has Internet access, or that a valid HTTP proxy has been provided. Verificare anche la correttezza dell'ID dell'area di lavoro.Additionally, check the correctness of the workspace ID.

Altre informazioni sulla risoluzione dei problemi possono essere consultate nella Guida alla risoluzione dei problemi per l'agente OMS per Linux.Additional troubleshooting information can be found on the OMS-Agent-for-Linux Troubleshooting Guide.

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.