Extension de machine virtuelle Diagnostics des performances Azure (PerfInsights) pour Windows

S’applique à : ✔️ Machine virtuelles Windows

L’extension de machine virtuelle Diagnostics des performances Azure permet de collecter des données de diagnostic des performances sur des machines virtuelles Windows. Elle effectue une analyse et fournit un rapport de résultats et de recommandations permettant d’identifier et de résoudre les problèmes de performances sur la machine virtuelle. Cette extension installe un outil de résolution des problèmes appelé PerfInsights.

Prerequisites

Cette extension peut être installée sur :

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

Schéma d’extensions

Le code JSON suivant montre le schéma de l’extension de machine virtuelle Diagnostics des performances Azure. Elle a besoin du nom et de la clé d’un compte de stockage pour stocker la sortie et le rapport de diagnostic. Ces valeurs sont sensibles. La clé de compte de stockage doit être stockée dans une configuration de paramètres protégés. Les données des paramètres protégés de l’extension de machine virtuelle Azure sont chiffrées, et ne sont déchiffrées que sur la machine virtuelle cible. Notez que storageAccountName et storageAccountKey respectent la casse. Les autres paramètres obligatoires sont indiqués dans la section ci-dessous.

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

Valeurs de propriétés

Installer l’extension

Suivez ces instructions pour installer l’extension sur des machines virtuelles Windows :

1. Connectez-vous au Portail Azure.

2. Sélectionnez la machine virtuelle sur laquelle vous voulez installer cette extension.

   

3. Sélectionnez le panneau Extensions + applications, puis sélectionnez Ajouter.

   

4. Recherchez Diagnostics des performances Azure, cliquez sur l’extension, passez en revue les conditions générales, puis sélectionnez Suivant.

   

5. Indiquez les valeurs des paramètres d’installation, puis installez l’extension. Pour plus d’informations sur les scénarios pris en charge, consultez la page Guide pratique de PerfInsights.

   

6. Lorsque l’installation est réussie, l’état de l’extension indique Provisionnement réussi.

   

   Note

   L’extension s’exécute dès la fin de l’approvisionnement. Cela prend deux minutes maximum pour le scénario de base. Pour les autres scénarios, la durée d’exécution est spécifiée pendant l’installation.

Supprimer l’extension

Pour supprimer l’extension d’une machine virtuelle, effectuez ces étapes :

1. Connectez-vous au Portail Azure, sélectionnez la machine virtuelle sur laquelle vous voulez supprimer cette extension, puis sélectionnez le panneau Extensions + applications.

2. Sélectionnez l’extension Diagnostics des performances, puis sélectionnez Désinstaller.

   

Déploiement de modèle

Les extensions de machines virtuelles Azure peuvent être déployées avec des modèles Azure Resource Manager. Le schéma JSON détaillé dans la section précédente est utilisable dans un modèle Azure Resource Manager. Il exécute l’extension de machine virtuelle Diagnostics des performances Azure pendant un déploiement de modèle Azure Resource Manager. Voici un exemple de modèle :

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

Déploiement PowerShell

Utilisez la commande pour déployer l’extension Set-AzVMExtension de machine virtuelle Diagnostics des performances Azure sur une machine virtuelle existante :

$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

Informations sur les données capturées

L’outil PerfInsights collecte différents types de journaux d’activité, de configurations et de données de diagnostic, selon le scénario sélectionné. Pour plus d’informations, consultez la documentation PerfInsights.

Afficher et partager les résultats

La sortie de l’extension peut être obtenue dans le fichier zip qui a été chargé dans le compte de stockage indiqué pendant l’installation et est partagée pendant 30 jours à l’aide de signatures d’accès partagé (SAP). Ce fichier zip contient des journaux de diagnostic et un rapport avec les résultats et les recommandations. Un lien SAS vers le fichier zip de sortie est fourni dans le fichier texte nommé zipfilename_saslink.txt, qui se trouve dans le dossier C:\Packages\Plugins\Microsoft.Azure.Performance.Diagnostics.AzurePerformanceDiagnostics\<version>. Toute personne qui dispose de ce lien est en mesure de télécharger le fichier zip.

Pour aider l’ingénieur qui travaille sur le ticket de support, Microsoft a la possibilité d’utiliser ce lien SAP pour télécharger les données de diagnostic.

Pour afficher le rapport, extrayez le fichier zip et ouvrez le fichier PerfInsights Report.htm.

Vous devriez également pouvoir télécharger le fichier zip directement sur le portail, en sélectionnant l’extension.

Dépannage et support technique

• Il peut arriver que l’état du déploiement de l’extension (dans la zone de notification) indique « Déploiement en cours » même si l’extension est correctement approvisionnée.

  Vous pouvez ignorer ce problème sans risque tant que l’état de l’extension indique que l’extension est correctement approvisionnée.

• Vous pouvez résoudre certains problèmes survenant lors de l’installation en utilisant les journaux d’activité de l’extension. La sortie de l’exécution de l’extension est enregistrée dans les fichiers qui que se trouvent dans le répertoire suivant :

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

• Si vous voyez les erreurs suivantes dans les journaux d’extension Portail Azure ou Diagnostics de performances (AzPerfDiagExtension.log ou PerfInsights.log), cela signifie généralement que la chaîne de certificats HTTPS est interrompue :

  • Échec de l’approvisionnement : message : échec du chargement du résultat PerfInsights sur le compte de stockage Azure.

  • Le processus PerfInsights s’est arrêté avec le code 1700.

  • Impossible d’établir une relation de confiance pour le canal sécurisé SSL/TLS. Le certificat distant n’est pas valide selon la procédure de validation.

  Pour résoudre les erreurs, vérifiez que vous n’avez pas de groupe de sécurité réseau (NSG) bloquant l’accès aux URL d’autorité de certification décrites dans cette liste. Ou vérifiez que vous n’avez pas d’outil d’inspection SSL dans votre appliance virtuelle réseau ou pare-feu.

Contactez-nous pour obtenir de l’aide

Pour toute demande ou assistance, créez une demande de support ou posez une question au support de la communauté Azure. Vous pouvez également soumettre des commentaires sur les produits à la communauté de commentaires Azure.