Dela via

Azure Performance Diagnostics (PerfInsights) VM-tillägg för Windows

  • Artikel

Gäller för: ✔️ Virtuella Windows-datorer

Azure Performance Diagnostics VM Extension hjälper till att samla in prestandadiagnostikdata från virtuella Windows-datorer. Tillägget utför analys och innehåller en rapport över resultat och rekommendationer för att identifiera och lösa prestandaproblem på den virtuella datorn. Det här tillägget installerar ett felsökningsverktyg med namnet PerfInsights.

Kommentar

Om du vill köra diagnostik på den virtuella datorn från Azure Portal för icke-klassiska virtuella datorer rekommenderar vi att du använder den nya upplevelsen. Mer information finns i Prestandadiagnostik för virtuella Azure-datorer.

Förutsättningar

Det här tillägget kan installeras på:

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

Tilläggsschema

Följande JSON visar schemat för AZURE Performance Diagnostics VM-tillägget. Det här tillägget kräver namn och nyckel för ett lagringskonto för att lagra diagnostikutdata och rapporter. Dessa värden är känsliga. Lagringskontonyckeln ska lagras i en konfiguration av skyddad inställning. Azure VM-tilläggsskyddade inställningsdata krypteras och dekrypteras endast på den virtuella måldatorn. Observera att storageAccountName och storageAccountKey är skiftlägeskänsliga. Andra obligatoriska parametrar visas i följande avsnitt.

{
     "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')]"       
       }
     }
   }

Egenskapsvärden

Name Värde/exempel Beskrivning
apiVersion 2015-06-15 Versionen av API:et.
förläggare Microsoft.Azure.Performance.Diagnostics Utgivarnamnområdet för tillägget.
type AzurePerformanceDiagnostics Typ av VM-tillägg.
typeHandlerVersion 1.0 Versionen av tilläggshanteraren.
performanceScenario grundläggande Prestandascenariot för vilket data ska samlas in. Giltiga värden är: basic, vmslow, azurefiles och custom.
enableContinuousDiagnostics Sant Aktivera kontinuerlig diagnostik. Giltiga värden är true och false. Om du vill aktivera kontinuerlig prestandadiagnostik måste du ange den här egenskapen.
traceDurationInSeconds 300 Varaktigheten för spårningarna, om något av spårningsalternativen har valts.
perfCounterTrace p Alternativ för att aktivera spårning av prestandaräknare. Giltiga värden är p eller tomt värde. Om du inte vill samla in den här spårningen lämnar du värdet som tomt.
networkTrace n Alternativ för att aktivera nätverksspårning. Giltiga värden är n eller tomt värde. Om du inte vill samla in den här spårningen lämnar du värdet som tomt.
xperfTrace x Alternativ för att aktivera XPerf-spårning. Giltiga värden är x eller tomt värde. Om du inte vill samla in den här spårningen lämnar du värdet som tomt.
storPortTrace s Alternativ för att aktivera StorPort Trace. Giltiga värden är s eller tomt värde. Om du inte vill samla in den här spårningen lämnar du värdet som tomt.
srNumber 123452016365929 Supportärendenumret, om det är tillgängligt. Lämna värdet som tomt om du inte har det.
requestTimeUtc 2017-09-28T22:08:53.736Z Aktuell datumtid i Utc. Om du använder portalen för att installera det här tillägget behöver du inte ange det här värdet.
resourceId /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} Den unika identifieraren för en virtuell dator.
storageAccountName mystorageaccount Namnet på lagringskontot för lagring av diagnostikloggar och resultat.
storageAccountKey lDuVvxuZB28NNP... hAiRF3voADxLBTcc== Nyckeln för lagringskontot.

Installera tillägget

Kommentar

Vi rekommenderar att du installerar tillägget via bladet prestandadiagnostik enligt beskrivningen i Installera och köra prestandadiagnostik på den virtuella datorn.

Följ de här anvisningarna för att installera tillägget på virtuella Windows-datorer:

  1. Logga in på Azure-portalen.

  2. Välj den virtuella dator där du vill installera det här tillägget.

    Skärmbild av Azure Portal med Virtuella datorer markerade.

  3. Välj bladet Tillägg + program och välj Lägg till.

    Skärmbild av bladet Tillägg med Lägg till markerat.

  4. Sök efter Azure Performance Diagnostics, klicka på tillägget, granska villkoren och välj Nästa.

    Skärmbild av skärmen Ny resurs med Azure Performance Diagnostics markerat.

  5. Ange parametervärdena för installationen och installera sedan tillägget. Mer information om scenarier som stöds finns i Använda PerfInsights.

    Skärmbild av dialogrutan Installera tillägg.

  6. När installationen har slutförts visar statusen för tillägget Att etableringen har slutförts.

    Skärmbild av meddelande om att etableringen lyckades.

    Kommentar

    Tillägget körs när etableringen har slutförts. Det tar minst två minuter att slutföra det grundläggande scenariot. I andra scenarier körs den under den tid som angetts under installationen.

Ta bort tillägget

Kommentar

Vi rekommenderar att du avinstallerar tillägget via bladet prestandadiagnostik enligt beskrivningen i Avinstallera prestandadiagnostik.

Följ dessa steg för att ta bort tillägget från en virtuell dator:

  1. Logga in på Azure Portal, välj den virtuella dator som du vill ta bort tillägget från och välj sedan bladet Tillägg + program.

  2. Välj tillägget Prestandadiagnostik och välj sedan Avinstallera.

    Skärmbild av bladet Tillägg med Avinstallera markerat.

Malldistribution

Tillägg för virtuella Azure-datorer kan distribueras med Azure Resource Manager-mallar. JSON-schemat som beskrivs i föregående avsnitt kan användas i en Azure Resource Manager-mall. Detta kör azure performance diagnostics VM-tillägget under en Azure Resource Manager-malldistribution. Här är en exempelmall:

{
 "$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')]"
       }
     }
   }
 ]
}

PowerShell-distribution

Set-AzVMExtension Använd kommandot för att distribuera Azure Performance Diagnostics VM-tillägget till en befintlig virtuell dator:

$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

Information om de data som samlas in

Verktyget PerfInsights samlar in olika loggar, konfigurations- och diagnostikdata, beroende på det valda scenariot. Mer information finns i Dokumentationen om PerfInsights.

Visa och dela resultaten

Utdata från tillägget finns i en zip-fil som laddades upp till lagringskontot som angavs under installationen och delas i 30 dagar med hjälp av signaturer för delad åtkomst (SAS). Den här zip-filen innehåller diagnostikloggar och en rapport med resultat och rekommendationer. En SAS-länk till zip-filen för utdata finns i en textfil med namnet zipfilename_saslink.txt under mappen C:\Packages\Plugins\Microsoft.Azure.Performance.Diagnostics.AzurePerformanceDiagnostics\<version>. Alla som har den här länken kan ladda ned zip-filen.

För att hjälpa supportteknikern att arbeta med din supportbegäran kan Microsoft använda den här SAS-länken för att ladda ned diagnostikdata.

Om du vill visa rapporten extraherar du zip-filen och öppnar filen PerfInsights Report.html .

Du bör också kunna ladda ned zip-filen direkt från portalen genom att välja tillägget.

Skärmbild av detaljerad status för prestandadiagnostik och nedladdningslänken för tillägget.

Kommentar

SAS-länken som visas i portalen kanske inte fungerar ibland. Detta kan orsakas av en felaktigt formaterad URL under kodnings- och avkodningsåtgärderna. Du kan i stället hämta länken direkt från filen *_saslink.txt från den virtuella datorn.

Felsökning och support

  • Distributionsstatus för tillägg (i meddelandefältet) kan visa "Distribution pågår" även om tillägget har etablerats.

    Det här problemet kan ignoreras på ett säkert sätt, så länge tilläggets status anger att tillägget har etablerats.

  • Du kan åtgärda vissa problem under installationen med hjälp av tilläggsloggarna. Utdata för körning av tillägg loggas i filer som finns i följande katalog:

    C:\WindowsAzure\Logs\Plugins\Microsoft.Azure.Performance.Diagnostics.AzurePerformanceDiagnostics\<version>

  • Om du ser följande fel i loggarna för Azure Portal- eller prestandadiagnostiktillägget (AzPerfDiagExtension.log eller PerfInsights.log) innebär det vanligtvis att HTTPS-certifikatkedjan är bruten:

    • Etableringen misslyckades – meddelande: Det gick inte att ladda upp PerfInsights-resultatet till Azure-lagringskontot.

    • PerfInsights-processen avslutades med kod 1700.

    • Det gick inte att upprätta förtroenderelationen för den säkra SSL/TLS-kanalen. Fjärrcertifikatet är ogiltigt enligt valideringsproceduren.

    Lös felen genom att se till att du inte har en nätverkssäkerhetsgrupp (NSG) som blockerar åtkomsten till url:erna för certifikatutfärdare som beskrivs i den här listan. Eller se till att du inte har något SSL-inspektionsverktyg i din virtuella nätverksinstallation eller brandvägg.

Kontakta oss för att få hjälp

Om du har frågor eller behöver hjälp skapar du en supportförfrågan eller frågar Azure community support. Du kan också skicka produktfeedback till Azure-feedbackcommunityn.