Estensione macchina virtuale Diagnostica prestazioni di Azure (PerfInsights) per Windows

Articolo
11/20/2024

Si applica a: ✔️ macchine virtuali di Windows

L'estensione della macchina virtuale per la diagnostica delle prestazioni di Azure consente di raccogliere dati di diagnostica sulle prestazioni dalle macchine virtuali Windows. L'estensione esegue l'analisi e fornisce un report dei risultati e delle raccomandazioni per identificare e risolvere i problemi di prestazioni sulla macchina virtuale. Questa estensione installa uno strumento per la risoluzione dei problemi chiamato PerfInsights.

Note

Se si vuole eseguire la diagnostica nella macchina virtuale dal portale di Azure per le macchine virtuali non classiche, è consigliabile usare la nuova esperienza. Per altre informazioni, vedere Diagnostica delle prestazioni per macchine virtuali di Azure.

Prerequisiti

Questa estensione può essere installata su:

Windows Server 2019
Windows Server 2016
Windows Server 2012 R2
Windows Server 2012
Windows Server 2008 R2
Windows 10
Windows 8.1
Windows 8

Schema dell'estensione

Il codice JSON seguente mostra lo schema per l'estensione della macchina virtuale di Diagnostica delle prestazioni di Azure. Questa estensione richiede il nome e la chiave per un account di archiviazione per archiviare l'output e il report di diagnostica. Questi valori sono sensibili. La chiave dell'account di archiviazione deve essere archiviata all'interno di una configurazione di impostazioni protette. I dati delle impostazioni protette dell'estensione della macchina virtuale di Azure vengono crittografati e decrittografati solo nella macchina virtuale di destinazione. Tieni presente che storageAccountName e storageAccountKey fanno distinzione tra maiuscole e minuscole. Altri parametri obbligatori sono elencati nella sezione seguente.

{
     "name": "[concat(parameters('vmName'),'/AzurePerformanceDiagnostics')]",
     "type": "Microsoft.Compute/virtualMachines/extensions",
     "location": "[parameters('location')]",
     "apiVersion": "2015-06-15",
     "properties": {
       "publisher": "Microsoft.Azure.Performance.Diagnostics",
       "type": "AzurePerformanceDiagnostics",
       "typeHandlerVersion": "1.0",
       "autoUpgradeMinorVersion": true,
       "settings": {
         "storageAccountName": "[parameters('storageAccountName')]",
         "performanceScenario": "[parameters('performanceScenario')]",
         "enableContinuousDiagnostics": "[parameters('enableContinuousDiagnostics')]",
         "traceDurationInSeconds": "[parameter('traceDurationInSeconds')]",
         "perfCounterTrace": "[parameters('perfCounterTrace')]",
         "networkTrace": "[parameters('networkTrace')]",
         "xperfTrace": "[parameters('xperfTrace')]",
         "storPortTrace": "[parameters('storPortTrace')]",         
         "requestTimeUtc":  "[parameters('requestTimeUtc')]",
         "resourceId": "[resourceId('Microsoft.Compute/virtualMachines', parameters('vmName'))]"
       },
       "protectedSettings": {
           "storageAccountKey": "[parameters('storageAccountKey')]"       
       }
     }
   }

Valori delle proprietà

Nome	Valore/Esempio	Descrizione
apiVersion	2015-06-15	La versione dell'API.
editore	Microsoft.Azure.Performance.Diagnostics	Lo spazio dei nomi dell'editore per l'estensione.
tipo	AzurePerformanceDiagnostics	Il tipo di estensione VM.
typeHandlerVersion	1.0	La versione del gestore dell'estensione.
performanceScenario	di base	Lo scenario delle prestazioni per il quale acquisire i dati. I valori validi sono: basic, vmslow, azurefiles e custom.
enableContinuousDiagnostics	Vero	Abilitare la diagnostica continua. I valori validi sono true o false. Per abilitare la diagnostica delle prestazioni continue, è necessario specificare questa proprietà.
traceDurationInSeconds	300	La durata delle tracce, se è selezionata una delle opzioni di traccia.
perfCounterTrace	p	Opzione per abilitare il Contatore delle prestazioni della traccia. I valori validi sono p o un valore vuoto. Se non vuoi acquisire questa traccia, lascia vuoto il valore.
networkTrace	n	Opzione per abilitare Network Trace. I valori validi sono n o un valore vuoto. Se non vuoi acquisire questa traccia, lascia vuoto il valore.
xperfTrace	x	Opzione per abilitare XPerf Trace. I valori validi sono x o un valore vuoto. Se non vuoi acquisire questa traccia, lascia vuoto il valore.
storPortTrace	s	Opzione per abilitare StorPort Trace. I valori validi sono s o un valore vuoto. Se non vuoi acquisire questa traccia, lascia vuoto il valore.
srNumber	123452016365929	Il numero del ticket di supporto, se disponibile. Lascia il valore vuoto se non ce l'hai.
requestTimeUtc	9/28/2017 10:08:53 PM	Data e ora corrente in UTC. Se utilizzi il portale per installare questa estensione, non è necessario fornire questo valore.
resourceId	/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}	L'identificatore univoco di una macchina virtuale.
storageAccountName	mystorageaccount	Nome dell'account di archiviazione in cui archiviare i log e i risultati di diagnostica.
storageAccountKey	lDuVvxuZB28NNP…hAiRF3voADxLBTcc==	Chiave per l'account di archiviazione.

Installare l'estensione

Note

È consigliabile installare l'estensione tramite il pannello diagnostica delle prestazioni, come descritto in Installare ed eseguire la diagnostica delle prestazioni nella macchina virtuale.

Segui queste istruzioni per installare l'estensione su macchine virtuali Windows:

Accedi al portale di Azure.
Seleziona la macchina virtuale in cui desideri installare questa estensione.
Selezionare il pannello Applicazioni estensioni e selezionare Aggiungi.
Cerca Diagnostica delle prestazioni di Azure, fai clic sull'estensione, rivedi i termini e le condizioni e seleziona Avanti.
Fornire i valori dei parametri per l'installazione, quindi installare l'estensione. Per ulteriori informazioni sugli scenari supportati, vedere Come utilizzare PerfInsights.
Quando l'installazione è stata eseguita correttamente, lo stato dell'estensione mostra Provisioning riuscito.

Note

L'estensione viene eseguita quando il provisioning ha esito positivo. Ci vogliono due minuti o meno per completare lo scenario di base. Per altri scenari, viene eseguito per la durata specificata durante l'installazione.

Rimuovere l'estensione

Note

È consigliabile disinstallare l'estensione tramite il pannello diagnostica delle prestazioni, come descritto in Disinstallare la diagnostica delle prestazioni.

Per rimuovere l'estensione da una macchina virtuale, attenersi alla seguente procedura:

Accedi al Portale di Azure, seleziona la macchina virtuale da cui vuoi rimuovere questa estensione, quindi seleziona il pannello Applicazioni estensioni.
Selezionare l'estensione Performance Diagnostics, quindi Disinstalla.

Distribuzione modelli

Le estensioni delle macchine virtuali di Azure possono essere distribuite con i modelli di Azure Resource Manager. Lo schema JSON descritto in dettaglio nella sezione precedente può essere usato in un modello di Azure Resource Manager. Viene eseguita l'estensione della macchina virtuale di diagnostica delle prestazioni di Azure durante la distribuzione di un modello di Azure Resource Manager. Ecco un modello di esempio:

{
 "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
 "contentVersion": "1.0.0.0",
 "parameters": {
   "vmName": {
     "type": "string",
     "defaultValue": "yourVMName"
   },
   "location": {
     "type": "string",
     "defaultValue": "southcentralus"
   },
   "storageAccountName": {
     "type": "securestring",
     "defaultValue": "yourStorageAccount"
   },
   "storageAccountKey": {
     "type": "securestring",
     "defaultValue": "yourStorageAccountKey"
   },
   "performanceScenario": {
     "type": "string",
     "defaultValue": "basic"
   },
 
"enableContinuousDiagnostics": {
     "type": "boolean",
     "defaultValue": "false"
  },
  "traceDurationInSeconds": {
   "type": "int",
   "defaultValue": 300
 },
   "perfCounterTrace": {
     "type": "string",
     "defaultValue": "p"
   },
   "networkTrace": {
     "type": "string",
     "defaultValue": ""
   },
   "xperfTrace": {
     "type": "string",
     "defaultValue": ""
   },
   "storPortTrace": {
     "type": "string",
     "defaultValue": ""
   },
   "requestTimeUtc": {
     "type": "string",
     "defaultValue": "10/2/2017 11:06:00 PM"
   }       
 },
 "resources": [
   {
     "name": "[concat(parameters('vmName'),'/AzurePerformanceDiagnostics')]",
     "type": "Microsoft.Compute/virtualMachines/extensions",
     "location": "[parameters('location')]",
     "apiVersion": "2015-06-15",
     "properties": {
       "publisher": "Microsoft.Azure.Performance.Diagnostics",
       "type": "AzurePerformanceDiagnostics",
       "typeHandlerVersion": "1.0",
       "autoUpgradeMinorVersion": true,
       "settings": {
         "storageAccountName": "[parameters('storageAccountName')]",
         "performanceScenario": "[parameters('performanceScenario')]",
"enableContinuousDiagnostics" : "[parameters('enableContinuousDiagnostics')]",
         "traceDurationInSeconds": "[parameters('traceDurationInSeconds')]",
         "perfCounterTrace": "[parameters('perfCounterTrace')]",
         "networkTrace": "[parameters('networkTrace')]",
         "xperfTrace": "[parameters('xperfTrace')]",
         "storPortTrace": "[parameters('storPortTrace')]",         
         "requestTimeUtc":  "[parameters('requestTimeUtc')]",
         "resourceId": "[resourceId('Microsoft.Compute/virtualMachines', parameters('vmName'))]"
       },
       "protectedSettings": {
           "storageAccountKey": "[parameters('storageAccountKey')]"
       }
     }
   }
 ]
}

Distribuzione PowerShell

Usare il comando per distribuire l'estensione Set-AzVMExtension macchina virtuale Diagnostica prestazioni di Azure in una macchina virtuale esistente:

$PublicSettings = @{ "storageAccountName"="mystorageaccount";"performanceScenario"="basic"; "enableContinuousDiagnostics" : $False;"traceDurationInSeconds"=300;"perfCounterTrace"="p";"networkTrace"="";"xperfTrace"="";"storPortTrace"="";"srNumber"="";"requestTimeUtc"="2017-09-28T22:08:53.736Z";"resourceId"="VMResourceId" }
$ProtectedSettings = @{"storageAccountKey"="mystoragekey" }
 
Set-AzVMExtension -ExtensionName "AzurePerformanceDiagnostics" -ResourceGroupName "myResourceGroup" -VMName "myVM" -Publisher "Microsoft.Azure.Performance.Diagnostics" -ExtensionType "AzurePerformanceDiagnostics" -TypeHandlerVersion 1.0 -Settings $PublicSettings -ProtectedSettings $ProtectedSettings -Location WestUS

Informazioni sui dati acquisiti

Lo strumento PerfInsights raccoglie vari dati di registro, configurazione e diagnostica, a seconda dello scenario selezionato. Per ulteriori informazioni, consulta la documentazione di PerfInsights.

L'output dell'estensione è disponibile in un file ZIP caricato nell'account di archiviazione specificato durante l'installazione e condiviso per 30 giorni tramite firme di accesso condiviso (SAS). Questo file zip contiene registri diagnostici e un report con risultati e consigli. Un collegamento SAS al file zip di output è disponibile all'interno di un file di testo denominato zipfilename_saslink.txt nella cartella C:\Pacchetti\Plugins\Microsoft.Azure.Performance.Diagnostics.AzurePerformanceDiagnostics\<versione>. Chiunque abbia questo link è in grado di scaricare il file zip.

Per assistere il tecnico del supporto che lavora al tuo ticket di supporto, Microsoft potrebbe usare questo collegamento SAS per scaricare i dati di diagnostica.

Per visualizzare il report, estrai il file zip e apri il file PerfInsights Report.html.

Dovresti anche essere in grado di scaricare il file zip direttamente dal portale selezionando l'estensione.

Screenshot dello stato dettagliato della diagnostica delle prestazioni e del collegamento per il download dell'estensione.

Note

Il collegamento SAS visualizzato nel portale potrebbe non funzionare a volte. Ciò può essere causato da un URL non valido durante le operazioni di codifica e decodifica. Puoi invece ottenere il link direttamente dal file *_saslink.txt dalla VM.

Risoluzione dei problemi e supporto

Lo stato di distribuzione dell'estensione (nell'area di notifica) potrebbe mostrare "Distribuzione in corso" anche se il provisioning dell'estensione è stato eseguito correttamente.

Questo problema può essere tranquillamente ignorato, purché lo stato dell'estensione indichi che il provisioning dell'estensione è stato eseguito correttamente.
È possibile risolvere alcuni problemi durante l'installazione utilizzando i log dell'estensione. L'output dell'esecuzione dell'estensione viene registrato nei file presenti nella directory seguente:

C:\WindowsAzure\Logs\Plugins\Microsoft.Azure.Performance.Diagnostics.AzurePerformanceDiagnostics\<version>
Se vengono visualizzati gli errori seguenti nei log dell'estensione portale di Azure o diagnostica delle prestazioni (AzPerfDiagExtension.log o PerfInsights.log), in genere la catena di certificati HTTPS è interrotta:
- Provisioning non riuscito- messaggio: non è stato possibile caricare il risultato di PerfInsights nell'account di archiviazione di Azure.
- Il processo di PerfInsights è stato chiuso con il codice 1700.
- Impossibile stabilire una relazione di trust per il canale sicuro SSL/TLS. Il certificato remoto non è stato ritenuto valido dalla procedura di convalida.
Per risolvere gli errori, assicurarsi di non disporre di un gruppo di sicurezza di rete (NSG) che blocca l'accesso agli URL dell'autorità di certificazione descritti in questo elenco. In alternativa, assicurarsi di non disporre di alcuno strumento di ispezione SSL nell'appliance virtuale di rete o nel firewall.

Contattaci per ricevere assistenza

In caso di domande o bisogno di assistenza, creare una richiesta di supporto tecnico oppure formula una domanda nel Supporto della community di Azure. È possibile anche inviare un feedback sul prodotto al feedback della community di Azure.

Condividi tramite

Estensione macchina virtuale Diagnostica prestazioni di Azure (PerfInsights) per Windows

Prerequisiti

Schema dell'estensione

Valori delle proprietà

Installare l'estensione

Rimuovere l'estensione

Distribuzione modelli

Distribuzione PowerShell

Informazioni sui dati acquisiti

Risoluzione dei problemi e supporto

Contattaci per ricevere assistenza

Commenti e suggerimenti

Risorse aggiuntive

Condividi tramite

Estensione macchina virtuale Diagnostica prestazioni di Azure (PerfInsights) per Windows

Prerequisiti

Schema dell'estensione

Valori delle proprietà

Installare l'estensione

Rimuovere l'estensione

Distribuzione modelli

Distribuzione PowerShell

Informazioni sui dati acquisiti

Visualizza e condividi i risultati

Risoluzione dei problemi e supporto

Contattaci per ricevere assistenza

Commenti e suggerimenti

Risorse aggiuntive