Estensione della macchina virtuale Diagnostica prestazioni di Azure (PerfInsights) per 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.
Nota
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 di 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 della 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. |
| ID risorsa | /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. |
Installa l'estensione
Nota
È consigliabile installare l'estensione tramite il pannello di 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:
Accedere 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.
Nota
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
Nota
È consigliabile disinstallare l'estensione tramite il pannello di 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 del modello
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 di PowerShell
Usare il comando per distribuire l'estensione Set-AzVMExtension della macchina virtuale di 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.
Visualizza e condividi i risultati
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.
Nota
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 trovati nella seguente directory:
C:\WindowsAzure\Logs\Plugins\Microsoft.Azure.Performance.Diagnostics.AzurePerformanceDiagnostics\<version>
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.
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per