Delen via

Vm-extensie voor Azure Performance Diagnostics (PerfInsights) voor Windows

  • Artikel

Van toepassing op: ✔️ Windows-VM's

Azure Performance Diagnostics VM-extensie helpt bij het verzamelen van diagnostische prestatiegegevens van Windows-VM's. De extensie voert een analyse uit en geeft een rapport met bevindingen en aanbevelingen om prestatieproblemen op de virtuele machine te identificeren en op te lossen. Met deze extensie wordt een hulpprogramma voor probleemoplossing geïnstalleerd met de naam PerfInsights.

Notitie

Als u diagnostische gegevens wilt uitvoeren op uw virtuele machine vanuit Azure Portal voor niet-klassieke VM's, is het raadzaam om de nieuwe ervaring te gebruiken. Zie Prestatiediagnose voor virtuele Azure-machines voor meer informatie.

Vereisten

Deze extensie kan worden geïnstalleerd op:

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

Extensieschema

In de volgende JSON ziet u het schema voor de VM-extensie prestatiediagnose van Azure. Deze extensie vereist de naam en sleutel voor een opslagaccount om de diagnostische uitvoer en het rapport op te slaan. Deze waarden zijn gevoelig. De sleutel van het opslagaccount moet worden opgeslagen in een configuratie van een beveiligde instelling. Beveiligde instellingsgegevens voor azure-VM-extensies worden versleuteld en worden alleen ontsleuteld op de virtuele doelmachine. Houd er rekening mee dat storageAccountName en storageAccountKey hoofdlettergevoelig zijn. Andere vereiste parameters worden weergegeven in de volgende sectie.

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

Eigenschapswaarden

Naam Waarde/voorbeeld Beschrijving
apiVersion 2015-06-15 De versie van de API.
uitgever Microsoft.Azure.Performance.Diagnostics De naamruimte van de uitgever voor de extensie.
type AzurePerformanceDiagnostics Het type VM-extensie.
typeHandlerVersion 1.0 De versie van de extensie-handler.
performanceScenario basisch Het prestatiescenario waarvoor gegevens moeten worden vastgelegd. Geldige waarden zijn: basic, vmslow, azurefiles en aangepast.
ContinuousDiagnostics inschakelen Waar Schakel continue diagnostische gegevens in. De geldige waarden zijn waar of onwaar. Als u Continue prestatiediagnose wilt inschakelen, moet u deze eigenschap opgeven.
traceDurationInSeconds 300 De duur van de traceringen, als een van de traceringsopties is geselecteerd.
perfCounterTrace nm Optie voor het inschakelen van tracering van prestatiemeteritems. Geldige waarden zijn p of lege waarde. Als u deze tracering niet wilt vastleggen, laat u de waarde leeg.
networkTrace n Optie voor het inschakelen van netwerktracering. Geldige waarden zijn n of lege waarde. Als u deze tracering niet wilt vastleggen, laat u de waarde leeg.
xperfTrace x Optie voor het inschakelen van XPerf Trace. Geldige waarden zijn x of lege waarde. Als u deze tracering niet wilt vastleggen, laat u de waarde leeg.
storPortTrace s Optie voor het inschakelen van StorPort Trace. Geldige waarden zijn een of lege waarde. Als u deze tracering niet wilt vastleggen, laat u de waarde leeg.
srNumber 123452016365929 Het nummer van het ondersteuningsticket, indien beschikbaar. Laat de waarde leeg als u deze niet hebt.
requestTimeUtc 2017-09-28T22:08:53.736Z Huidige datum/tijd in Utc. Als u de portal gebruikt om deze extensie te installeren, hoeft u deze waarde niet op te geven.
resourceId /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} De unieke id van een virtuele machine.
storageAccountName mystorageaccount De naam van het opslagaccount voor het opslaan van de diagnostische logboeken en resultaten.
storageAccountKey lDuVvxuZB28NNP... hAiRF3voADxLBTcc== De sleutel voor het opslagaccount.

De extensie installeren

Notitie

U wordt aangeraden de extensie te installeren via de blade Prestatiediagnose, zoals wordt beschreven in De installatie en het uitvoeren van prestatiediagnose op uw VIRTUELE machine.

Volg deze instructies voor het installeren van de extensie op virtuele Windows-machines:

  1. Meld u aan bij het Azure-portaal.

  2. Selecteer de virtuele machine waarop u deze extensie wilt installeren.

    Schermopname van Azure Portal, met Virtuele machines gemarkeerd.

  3. Selecteer de blade Extensies en toepassingen en selecteer Toevoegen.

    Schermopname van de blade Extensies, met Toevoegen gemarkeerd.

  4. Zoek naar Azure Performance Diagnostics, klik op de extensie, controleer de voorwaarden en selecteer Volgende.

    Schermopname van het scherm Nieuwe resource, met Azure Performance Diagnostics gemarkeerd.

  5. Geef de parameterwaarden voor de installatie op en installeer vervolgens de extensie. Zie PerfInsights gebruiken voor meer informatie over ondersteunde scenario's.

    Schermopname van het dialoogvenster Extensie installeren.

  6. Wanneer de installatie is voltooid, wordt in de status van de extensie de inrichting weergegeven.

    Schermopname van het bericht Geslaagde inrichting.

    Notitie

    De extensie wordt uitgevoerd wanneer het inrichten is geslaagd. Het duurt twee minuten of minder om het basisscenario te voltooien. Voor andere scenario's wordt de duur doorlopen die tijdens de installatie is opgegeven.

De extensie verwijderen

Notitie

U wordt aangeraden de extensie te verwijderen via de blade prestatiediagnose, zoals beschreven in Prestatiediagnose verwijderen.

Voer de volgende stappen uit om de extensie van een virtuele machine te verwijderen:

  1. Meld u aan bij Azure Portal, selecteer de virtuele machine waaruit u deze extensie wilt verwijderen en selecteer vervolgens de blade Extensies en toepassingen .

  2. Selecteer de extensie voor diagnostische gegevens over prestaties en selecteer vervolgens Verwijderen.

    Schermopname van de blade Extensies, met Verwijderen gemarkeerd.

Sjabloonimplementatie

Extensies voor virtuele Azure-machines kunnen worden geïmplementeerd met Azure Resource Manager-sjablonen. Het JSON-schema dat in de vorige sectie wordt beschreven, kan worden gebruikt in een Azure Resource Manager-sjabloon. Hiermee wordt de AZURE Performance Diagnostics VM-extensie uitgevoerd tijdens de implementatie van een Azure Resource Manager-sjabloon. Hier volgt een voorbeeldsjabloon:

{
 "$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-implementatie

Gebruik de opdracht om azure Set-AzVMExtension Performance Diagnostics VM-extensie te implementeren op een bestaande virtuele machine:

$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

Informatie over de vastgelegde gegevens

Het hulpprogramma PerfInsights verzamelt verschillende logboeken, configuratie en diagnostische gegevens, afhankelijk van het geselecteerde scenario. Zie de PerfInsights-documentatie voor meer informatie.

De resultaten weergeven en delen

Uitvoer van de extensie vindt u in een zip-bestand dat is geüpload naar het opslagaccount dat tijdens de installatie is opgegeven en gedurende 30 dagen wordt gedeeld met behulp van Shared Access Signatures (SAS). Dit zip-bestand bevat diagnostische logboeken en een rapport met bevindingen en aanbevelingen. Een SAS-koppeling naar het zip-uitvoerbestand vindt u in een tekstbestand met de naam zipfilename_saslink.txt onder de map C:\Packages\Plugins\Microsoft.Azure.Performance.Diagnostics.AzurePerformanceDiagnostics\<version>. Iedereen die deze koppeling heeft, kan het zip-bestand downloaden.

Om de ondersteuningstechnicus te helpen bij het werken aan uw ondersteuningsticket, kan Microsoft deze SAS-koppeling gebruiken om de diagnostische gegevens te downloaden.

Als u het rapport wilt bekijken, extraheert u het zip-bestand en opent u het PerfInsights-Report.html-bestand .

U moet het zip-bestand ook rechtstreeks vanuit de portal kunnen downloaden door de extensie te selecteren.

Schermopname van de gedetailleerde status van Performance Diagnostics en de downloadkoppeling voor de extensie.

Notitie

De SAS-koppeling die in de portal wordt weergegeven, werkt mogelijk niet soms. Dit kan worden veroorzaakt door een onjuiste URL tijdens de coderings- en decoderingsbewerkingen. U kunt in plaats daarvan de koppeling rechtstreeks ophalen uit het *_saslink.txt-bestand van de virtuele machine.

Problemen met en ondersteuning oplossen

  • De implementatiestatus van de extensie (in het systeemvak) kan 'Implementatie wordt uitgevoerd' weergeven, zelfs als de extensie is ingericht.

    Dit probleem kan veilig worden genegeerd, zolang de extensiestatus aangeeft dat de extensie is ingericht.

  • U kunt enkele problemen tijdens de installatie oplossen met behulp van de extensielogboeken. Uitvoer van extensie-uitvoering wordt vastgelegd in bestanden in de volgende map:

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

  • Als u de volgende fouten ziet in de logboeken van de Azure-portal of extensielogboeken voor diagnostische gegevens over prestaties (AzPerfDiagExtension.log of PerfInsights.log), betekent dit meestal dat de HTTPS-certificaatketen is verbroken:

    • Inrichten is mislukt - bericht: Kan het resultaat perfInsights niet uploaden naar een Azure-opslagaccount.

    • PerfInsights-proces afgesloten met code 1700.

    • Kan geen vertrouwensrelatie tot stand brengen voor het beveiligde SSL/TLS-kanaal. Het externe certificaat is ongeldig volgens de validatieprocedure.

    Als u de fouten wilt oplossen, moet u ervoor zorgen dat u geen netwerkbeveiligingsgroep (NSG) hebt die de toegang blokkeert tot de URL's van de certificeringsinstantie die in deze lijst worden beschreven. Of zorg ervoor dat u geen SSL-inspectieprogramma in uw virtuele netwerkapparaat of firewall hebt.

Contact met ons opnemen voor ondersteuning

Als u vragen hebt of hulp nodig hebt, maakt u een ondersteuningsaanvraag of stelt u ondersteuning voor de Azure-community. U kunt ook productfeedback verzenden naar de Azure-feedbackcommunity.