Estensione macchina virtuale Dependency Agent di Monitoraggio di Azure per Windows

La funzionalità di mappa di Monitoraggio di Azure per le macchine virtuali ottiene i dati da Microsoft Dependency Agent. L'estensione macchina virtuale Dependency Agent della macchina virtuale di Azure per Windows installa Dependency Agent nelle macchine virtuali di Azure. Questo documento illustra in dettaglio le piattaforme, le configurazioni e le opzioni di distribuzione supportate per l'estensione macchina virtuale Dependency Agent di macchine virtuali di Azure per Windows.

Sistema operativo

L'estensione Dependency Agent della macchina virtuale di Azure per Windows può essere eseguita nei sistemi operativi supportati elencati nella sezione Sistemi operativi supportati dell'articolo sulla distribuzione di Monitoraggio di Azure per le macchine virtuali.

Schema dell'estensione

Il codice JSON seguente illustra lo schema per l'estensione Dependency Agent della macchina virtuale di Azure in una macchina virtuale Windows di Azure.

{
  "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "vmName": {
      "type": "string",
      "metadata": {
        "description": "The name of existing Azure VM. Supported Windows Server versions:  2008 R2 and above (x64)."
      }
    }
  },
  "variables": {
    "vmExtensionsApiVersion": "2017-03-30"
  },
  "resources": [
    {
      "type": "Microsoft.Compute/virtualMachines/extensions",
      "name": "[concat(parameters('vmName'),'/DAExtension')]",
      "apiVersion": "[variables('vmExtensionsApiVersion')]",
      "location": "[resourceGroup().location]",
      "dependsOn": [],
      "properties": {
          "publisher": "Microsoft.Azure.Monitoring.DependencyAgent",
          "type": "DependencyAgentWindows",
          "typeHandlerVersion": "9.10",
          "autoUpgradeMinorVersion": true,
          "settings": {
                "enableAMA": "true"
		    }
      }
    }
  ],
    "outputs": {
    }
}

Valori delle proprietà

Nome	Valore/Esempio
apiVersion	01-01-2015
publisher	Microsoft.Azure.Monitoring.DependencyAgent
type	DependencyAgentWindows
typeHandlerVersion	9.10
autoUpgradeMinorVersion	vero
settings	"enableAMA": "true"

Importante

Assicurarsi di aggiungere enableAMA al modello se si usa l'agente di Monitoraggio di Azure. In caso contrario, Dependency Agent tenta di inviare dati all'agente di Log Analytics legacy.

Distribuzione del modello

È possibile distribuire le estensioni di macchina virtuale di Azure con i modelli di Azure Resource Manager. È possibile usare lo schema JSON descritto nella sezione precedente in un modello di Azure Resource Manager per eseguire l'estensione Dependency Agent VM di Azure durante la distribuzione di un modello di Azure Resource Manager.

Il modello JSON per un'estensione macchina virtuale può essere annidato nella risorsa della macchina virtuale. In alternativa, è possibile posizionarlo al livello radice o al livello superiore di un modello JSON di Resource Manager. Il posizionamento di JSON influisce sul valore del nome e tipo di risorsa. Per altre informazioni, vedere Set name and type for child resources (Impostare il nome e il tipo per le risorse figlio).

L'esempio seguente presuppone che l'estensione Dependency Agent sia annidata nella risorsa della macchina virtuale. Quando si annida la risorsa di estensione, l'elemento JSON viene inserito nell'oggetto "resources": [] della macchina virtuale.

{
	"type": "extensions",
	"name": "DAExtension",
	"apiVersion": "[variables('apiVersion')]",
	"location": "[resourceGroup().location]",
	"dependsOn": [
		"[concat('Microsoft.Compute/virtualMachines/', variables('vmName'))]"
	],
	"properties": {
      "publisher": "Microsoft.Azure.Monitoring.DependencyAgent",
      "type": "DependencyAgentWindows",
      "typeHandlerVersion": "9.10",
      "autoUpgradeMinorVersion": true,
      "settings": {
            "enableAMA": "true"
    		    }
    }
}

Quando si inserisce il codice JSON dell'estensione nella radice del modello, il nome della risorsa include un riferimento alla macchina virtuale padre. Il tipo riflette la configurazione nidificata.

{
	"type": "Microsoft.Compute/virtualMachines/extensions",
	"name": "<parentVmResource>/DAExtension",
	"apiVersion": "[variables('apiVersion')]",
	"location": "[resourceGroup().location]",
	"dependsOn": [
		"[concat('Microsoft.Compute/virtualMachines/', variables('vmName'))]"
	],
	"properties": {
      "publisher": "Microsoft.Azure.Monitoring.DependencyAgent",
      "type": "DependencyAgentWindows",
      "typeHandlerVersion": "9.10",
      "autoUpgradeMinorVersion": true,
      "settings": {
            "enableAMA": "true"
    		    }
	}
}

Distribuzione PowerShell

È possibile usare il Set-AzVMExtension comando per distribuire l'estensione macchina virtuale Dependency Agent in una macchina virtuale esistente. Prima di eseguire il comando, è necessario archiviare le configurazioni pubbliche e private in una tabella hash di PowerShell.

Set-AzVMExtension -ExtensionName "Microsoft.Azure.Monitoring.DependencyAgent" `
    -ResourceGroupName "myResourceGroup" `
    -VMName "myVM" `
    -Publisher "Microsoft.Azure.Monitoring.DependencyAgent" `
    -ExtensionType "DependencyAgentWindows" `
    -TypeHandlerVersion 9.10 `
    -Location WestUS

Aggiornamento automatico delle estensioni

È ora disponibile una nuova funzionalità per aggiornare automaticamente le versioni secondarie dell'estensione Dependency.

Per abilitare l'aggiornamento automatico dell'estensione per un'estensione, è necessario assicurarsi che la proprietà enableAutomaticUpgrade sia impostata true su e aggiunta al modello di estensione. Questa proprietà deve essere abilitata singolarmente in ogni macchina virtuale o set di scalabilità di macchine virtuali. Usare uno dei metodi descritti nella sezione abilitazione abilitare la funzionalità per la macchina virtuale o il set di scalabilità di macchine virtuali.

Quando l'aggiornamento automatico dell'estensione è abilitato in una macchina virtuale o in un set di scalabilità di macchine virtuali, l'estensione viene aggiornata automaticamente ogni volta che il server di pubblicazione dell'estensione rilascia una nuova versione per tale estensione. L'aggiornamento viene applicato in modo sicuro seguendo i principi di disponibilità-primo livello, come descritto qui.

La enableAutomaticUpgrade funzionalità dell'attributo è diversa da quella di autoUpgradeMinorVersion. L'attributo autoUpgradeMinorVersion non attiva automaticamente un aggiornamento della versione secondaria quando il server di pubblicazione dell'estensione rilascia una nuova versione. L'attributo autoUpgradeMinorVersion indica se l'estensione deve usare una versione secondaria più recente, se disponibile in fase di distribuzione. Dopo la distribuzione, tuttavia, l'estensione non aggiornerà le versioni secondarie a meno che non venga ridistribuibile, anche con questa proprietà impostata su true.

Per mantenere aggiornata la versione dell'estensione, è consigliabile usare enableAutomaticUpgrade con la distribuzione dell'estensione.

Importante

Se si aggiunge al enableAutomaticUpgrade modello, assicurarsi di usare in API versione 2019-12-01 o successiva.

Risoluzione dei problemi e supporto

Risoluzione dei problemi

I dati sullo stato delle distribuzioni di estensioni possono essere recuperati dalla portale di Azure e usando il modulo Azure PowerShell. Per visualizzare lo stato di distribuzione delle estensioni per una determinata macchina virtuale, eseguire il comando seguente tramite il modulo di Azure PowerShell:

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

L'output dell'esecuzione dell'estensione viene registrato nei file presenti nella directory seguente:

C:\WindowsAzure\Logs\Plugins\Microsoft.Azure.Monitoring.DependencyAgent\

Supporto

Per altre informazioni in qualsiasi punto di questo articolo, è possibile contattare gli esperti di Azure nei forum di Microsoft Q & A e Stack Overflow. È anche possibile registrare un evento imprevisto del supporto tecnico di Azure. Accedere al sito del supporto di Azure e selezionare Ottenere supporto. Per informazioni sull'uso del supporto di Azure, leggere le Domande frequenti sul supporto di Azure.