Configurer les diagnostics pour Azure Cloud Services (support étendu) et les machines virtuelles

Remarque

Cet article s’applique à Azure Cloud Services (support étendu). Les services cloud (classiques) sont retirés à compter du 31 août 2024. Pour plus d’informations, consultez Le modèle de déploiement de services cloud (classique) prend fin le 31 août 2024. Pour le nouveau développement, nous vous recommandons d’utiliser un type de service plus récent conçu à des fins spécifiques, comme Azure App Service, Azure Functions ou Azure Container Apps. Pour obtenir la liste la plus récente des services disponibles, consultez le Répertoire des produits Azure.

Lorsque vous devez résoudre des problèmes d’un service Azure Cloud Services (support étendu) ou d’une machine virtuelle, vous pouvez utiliser Visual Studio pour configurer plus facilement Azure Diagnostics. Les diagnostics capturent les données système et les données de journalisation sur les machines virtuelles et sur les instances de machine virtuelle qui exécutent votre service cloud. Les données de diagnostic sont transférées à un compte de stockage que vous choisissez. Pour plus d’informations sur la journalisation des diagnostics dans Azure, consultez Activer la journalisation des diagnostics pour les applications web dans Azure App Service.

Dans cet article, nous vous montrons comment utiliser Visual Studio pour activer et configurer Azure Diagnostics. Découvrez comment configurer les diagnostics sur des machines virtuelles Azure, comment sélectionner les types d'informations de diagnostic à collecter et comment les afficher une fois collectées.

Pour configurer Azure Diagnostics, changez les paramètres des diagnostics via la boîte de dialogue Configuration des diagnostics dans Visual Studio. Les paramètres sont enregistrés dans un fichier appelé diagnostics.wadcfgx. Vous pouvez aussi modifier directement le fichier de configuration. Si vous mettez le fichier à jour manuellement, les changements de configuration prennent effet lors du déploiement suivant du service cloud sur Azure, ou lors de son exécution dans l’émulateur.

Avertissement

Dans Visual Studio 2022, l’émulateur déconseillé du Stockage Azure a été remplacé par l’émulateur Azurite lors du débogage de vos projets Cloud Service. Cet émulateur Azurite ne fonctionne pas avec le plug-in Diagnostics Azure qui fournit une prise en charge de Diagnostics Azure lors d'une exécution et d'un test local. Si vous avez besoin du plug-in pour les scénarios locaux d'exécution et de test, vous pouvez mettre à jour la chaîne de connexion dans la configuration locale du service (.cscfg) vers un compte de stockage Azure (voir Gérer des chaînes de connexion pour des comptes de stockage), ou télécharger le précédent émulateur de stockage Azure. Dans la version 17.10 de Visual Studio, le plug-in Azure Diagnostics local est en cours de dépréciation et est désactivé par défaut avec l’option de l’activer dans cette version. Le plug-in a été supprimé dans la version 17.11 de Visual Studio. Ce plug-in n’était utilisé qu’avec l’émulateur de calcul Azure local, et sa désactivation n’affecte pas les services Cloud déployés qui utilisent l’extension Azure Diagnostics sur Azure. Pour activer le plug-in diagnostics dans Visual Studio 17.10, ajoutez le paramètre de propriété suivant à n'importe quel PropertyGroup dans votre fichier projet : <EnableEmulatorDiagnosticsPlugin>True</EnableEmulatorDiagnosticsPlugin>.

Détermination du compte de stockage des diagnostics par Visual Studio

• Si une chaîne de connexion des diagnostics est spécifiée dans le fichier .cscfg, Visual Studio l’utilise pour configurer l’extension des diagnostics lors de la publication et lors de la génération des fichiers XML de configuration publique durant l’empaquetage.
• Si une chaîne de connexion des diagnostics n’est pas spécifiée dans le fichier .cscfg, Visual Studio utilise alors le compte de stockage spécifié dans le fichier .wadcfgx pour configurer l’extension des diagnostics lors de la publication et de la génération des fichiers XML de configuration publique durant l’empaquetage.
• La chaîne de connexion des diagnostics dans le fichier .cscfg est prioritaire sur le compte de stockage dans le fichier .wadcfgx. Si une chaîne de connexion des diagnostics est spécifiée dans le fichier .cscfg, Visual Studio l’utilise et ignore le compte de stockage spécifié dans .wadcfgx.

Que fait la case à cocher « Mettre à jour les chaînes de connexion du stockage de développement… » ?

La case à cocher Mettre à jour les chaînes de connexion du stockage de développement pour les diagnostics et le Caching avec les informations d'identification du compte de stockage Microsoft Azure lors de la publication vers Microsoft Azure offre un moyen pratique pour mettre à jour les chaînes de connexion de compte de stockage de développement avec le compte de stockage Azure spécifié lors de la publication. Lorsque vous publiez le projet sur Azure, Visual Studio met automatiquement à jour la chaîne de connexion des diagnostics avec le compte de stockage que vous avez spécifié dans l’assistant de publication. Cependant, si un compte de stockage réel a été spécifié comme chaîne de connexion des diagnostics, ce compte est utilisé à la place.

Configurer des sources de données de diagnostic

Après avoir activé la collecte des données de diagnostic, vous pouvez sélectionner les sources de données et les informations à collecter. Les sections suivantes décrivent les onglets de la boîte de dialogue Configuration des diagnostics et la signification de chaque option de configuration.

Journaux d’activité d’application

Les journaux d’activité d’application contiennent des informations de diagnostic produites par une application web. Si vous voulez capturer les journaux d'application, sélectionnez la case à cocher Activer le transfert des journaux d'application. Pour augmenter ou diminuer l’intervalle entre les transferts des journaux d’activité d’application vers votre compte de stockage, vous devez changer la valeur de Période de transfert (min). Vous pouvez également changer la quantité d’informations consignées dans le journal en définissant la valeur de Niveau de journalisation. Par exemple, sélectionnez Détaillé pour collecter plus d’informations ou Critique pour capturer seulement les erreurs critiques. Si vous disposez d'un fournisseur de diagnostics spécifique qui émet des journaux d'application, vous pouvez capturer les journaux en ajoutant l'identifiant unique global (GUID) du fournisseur dans la case GUID du fournisseur.

Pour plus d’informations sur les journaux d’activité d’application, consultez Activer la journalisation des diagnostics pour les applications web dans Azure App Service.

Journaux des événements Windows

Pour capturer les journaux des événements Windows, cochez la case Activer le transfert des journaux des événements Windows. Pour augmenter ou diminuer l’intervalle entre les transferts des journaux des événements vers votre compte de stockage, changez la valeur de Période de transfert (min). Activez les cases à cocher correspondant aux types d'événements que vous voulez suivre.

Si vous souhaitez spécifier une source de données personnalisée, entrez-la dans la zone de texte <Nom de la source de données>, puis sélectionnez Ajouter. La source de données est ajoutée au fichier diagnostics.cfcfg.

Compteurs de performance

Les informations d’un compteur de performances peuvent vous aider à localiser des goulets d’étranglement système et à affiner les performances des applications et du système. Pour plus d’informations, consultez Créer et utiliser des compteurs de performances dans une application Azure . Pour capturer des compteurs de performances, cochez la case Activer le transfert des compteurs de performances. Pour augmenter ou diminuer l’intervalle entre les transferts des journaux des événements vers votre compte de stockage, changez la valeur de Période de transfert (min). Activez les cases à cocher correspondant aux compteurs de performances que vous voulez suivre.

Pour suivre un compteur de performances qui n'est pas répertorié, entrez-le en utilisant la syntaxe suggérée. Sélectionnez ensuite Ajouter. Le système d’exploitation de la machine virtuelle détermine les compteurs de performances que vous pouvez suivre. Pour plus d’informations sur la syntaxe, consultez Spécifier un chemin de compteur.

Journaux d’activité d’infrastructure

Les journaux d’activité d’infrastructure contiennent des informations sur l’infrastructure de diagnostic Azure, le module RemoteAccess et le module RemoteForwarder. Pour collecter des informations sur les journaux d'activité d'infrastructure, cochez la case Activer le transfert des journaux d'activité d'infrastructure. Pour augmenter ou diminuer l’intervalle entre les transferts des journaux d’activité d’infrastructure vers votre compte de stockage, changez la valeur de Période de transfert (min).

Pour plus d’informations, consultez Collecter des données de journalisation avec les diagnostics Azure.

Répertoires de journaux

Les répertoires de journaux contiennent des données collectées à partir de répertoires de journaux pour les demandes, les demandes ayant échoué ou les dossiers IIS que vous choisissez. Pour capturer les répertoires de journaux, cochez la case Activer le transfert des répertoires de journaux. Pour augmenter ou diminuer l’intervalle entre les transferts des journaux d’activité vers votre compte de stockage, changez la valeur de Période de transfert (min).

Cochez les cases correspondant aux journaux d'activité à collecter, comme Journaux d'activité IIS et Journaux d'activité de demandes ayant échoué. Des noms de conteneurs de stockage par défaut sont fournis, mais vous pouvez les changer.

Vous pouvez capturer des journaux d’activité de n’importe quel dossier. Spécifiez le chemin dans la section Journal du répertoire absolu, puis sélectionnez Ajouter le répertoire. Les journaux d’activité sont capturés dans les conteneurs spécifiés.

Journaux d’activité de suivi des événements ETW

Si vous utilisez la fonction Suivi d'événements pour Windows (ETW) et souhaitez capturer les journaux d'activité ETW, sélectionnez la case à cocher Activer le transfert des journaux d'activité ETW. Pour augmenter ou diminuer l’intervalle entre les transferts des journaux d’activité vers votre compte de stockage, changez la valeur de Période de transfert (min).

Les événements sont capturés à partir de sources d’événements et de fichiers manifestes d’événements que vous spécifiez. Pour spécifier une source d’événements, dans la section Sources d’événements, entrez un nom, puis sélectionnez Ajouter une source d’événements. De même, vous pouvez spécifier un manifeste d’événements dans la section Manifestes d’événements, puis sélectionner Ajouter un manifeste d’événements.

L’infrastructure ETW est prise en charge dans ASP.NET via des classes de l’espace de noms System.Diagnostics.aspx. L’espace de noms Microsoft.WindowsAzure.Diagnostics, qui hérite des classes System.Diagnostics.aspx, permet d’utiliser System.Diagnostics.aspx comme infrastructure de journalisation dans l’environnement Azure. Pour plus d’informations, consultez Prendre le contrôle de la journalisation et du traçage dans Microsoft Azure et Activer les diagnostics dans Azure Cloud Services (support étendu) et les machines virtuelles.

Vidages sur incident

Pour capturer des informations sur le moment où une instance de rôle se bloque, cochez la case Activer le transfert de vidages sur incident. (Étant donné qu’ASP.NET gère la plupart des exceptions, cette option s’avère généralement utile uniquement pour les rôles de travail.) Pour augmenter ou diminuer le pourcentage d’espace de stockage dédié aux images mémoire, modifiez la valeur Quota de répertoire (%). Vous pouvez changer le conteneur de stockage où les vidages sur incident sont stockés et choisir de capturer un vidage Complet ou Mini.

Les processus actuellement suivis sont répertoriés dans la capture d’écran suivante. Activez les cases à cocher correspondant aux processus que vous voulez capturer. Pour ajouter un processus à la liste, entrez le nom du processus, puis sélectionnez Ajouter un processus.

Pour plus d’informations, consultez Contrôler la journalisation et le suivi dans Microsoft Azure.

Dépannage des problèmes liés à Azure Cloud Services (support étendu)

Si vous rencontrez des problèmes avec vos projets de service cloud, par exemple si un rôle reste bloqué à l’état « occupé », s’il exécute un cycle en boucle ou s’il lève une erreur interne du serveur, il existe des outils et des techniques permettant de diagnostiquer et de corriger le problème. Pour des exemples spécifiques de problèmes courants et de solutions, et pour une vue d'ensemble des concepts et des outils que vous pouvez utiliser pour diagnostiquer et corriger ces erreurs, consultez Données de diagnostic de calcul PaaS (Platform as a Service) Azure.

Questions et réponses

Qu’est-ce que la taille de la mémoire tampon et quelle doit-elle être ?

Sur chaque instance de machine virtuelle, des quotas limitent la quantité de données de diagnostic qui peuvent être stockées sur le système de fichiers local. De plus, vous pouvez spécifier une taille de mémoire tampon pour chaque type de données de diagnostic disponible. Cette taille de mémoire tampon joue le rôle de quota individuel pour ce type de données. Pour déterminer le quota global et la quantité de mémoire restante, regardez dans la partie inférieure de la boîte de dialogue pour les types de données de diagnostic. En spécifiant des mémoires tampons plus grandes ou des types de données plus nombreux, vous vous approchez du quota général. Vous pouvez changer le quota global en modifiant le fichier de configuration diagnostics.wadcfgx. Les données de diagnostic sont stockées sur le même système de fichiers que les données de votre application. Si votre application utilise une grande quantité d'espace disque, n'augmentez pas le quota de diagnostic global.

Qu’est-ce que la période de transfert et quelle doit être sa durée ?

La période de transfert est le temps écoulé entre les captures de données. Après chaque période de transfert, les données sont déplacées du système de fichiers local d’une machine virtuelle aux tables de votre compte de stockage. Si la quantité de données collectées dépasse le quota avant la fin d’une période de transfert, les données plus anciennes sont écartées. Si vous perdez des données en raison du fait qu’elles dépassent la taille de la mémoire tampon ou le quota global, vous pouvez diminuer la période de transfert.

Dans quel fuseau horaire se trouvent les horodatages ?

Les horodatages correspondent au fuseau horaire local du centre de données qui héberge votre service cloud. Les trois colonnes d’horodatage suivantes sont utilisées dans les tables de journaux :

• PreciseTimeStamp : horodatage ETW de l’événement. Autrement dit, l’heure de l’événement est enregistrée à partir du client.
• TIMESTAMP : valeur de PreciseTimeStamp arrondie vers le bas à la limite de la fréquence de chargement. Par exemple, si votre fréquence de chargement est de 5 minutes et si l’heure de l’événement est 00:17:12, TIMESTAMP vaut 00:15:00.
• Timestamp : horodatage de la création de l’entité dans la table Azure.

Comment gérer les coûts pendant la collecte d’informations de diagnostics ?

Les paramètres par défaut (Niveau du journal défini sur Erreur et Période de transfert sur 1 minute) sont conçus pour minimiser les coûts. Vos coûts de calcul augmentent dès lors que vous collectez plus de données de diagnostic ou que vous diminuez la période de transfert. Ne collectez pas plus de données que nécessaire et n'oubliez pas de désactiver la collecte de données quand vous n'en avez plus besoin. Vous pouvez toujours la réactiver, même au moment de l’exécution, comme décrit précédemment dans cet article.

Comment recueillir des journaux d’activité de demandes IIS ayant échoué ?

Par défaut, IIS ne collecte pas les journaux d'activité de demandes ayant échoué. Vous pouvez configurer IIS de façon à collecter des journaux d’activité pour les demandes ayant échoué en modifiant le fichier web.config pour votre rôle web.

Je n'obtiens pas les informations des méthodes RoleEntryPoint comme OnStart. Quel est le problème ?

Les méthodes de RoleEntryPoint sont appelées dans le contexte de WAIISHost.exe, et non dans IIS. Les informations de configuration dans web.config qui autorisent normalement le traçage ne s'appliquent pas. Pour résoudre ce problème, ajoutez un fichier .config à votre projet de rôle web et nommez le fichier de façon à ce que son nom corresponde à l’assembly de sortie qui contient le code RoleEntryPoint. Dans le projet de rôle web par défaut, le nom du fichier .config doit être WAIISHost.exe.config. Ajoutez les lignes suivantes à ce fichier :

<system.diagnostics>
  <trace>
      <listeners>
          <add name "AzureDiagnostics" type="Microsoft.WindowsAzure.Diagnostics.DiagnosticMonitorTraceListener">
              <filter type="" />
          </add>
      </listeners>
  </trace>
</system.diagnostics>

Dans la fenêtre Propriétés, définissez la propriété Copier dans le répertoire de sortie sur Toujours copier.

Contenu connexe

Pour en savoir plus sur la journalisation des diagnostics dans Azure, consultez Activer les diagnostics dans Azure Cloud Services (support étendu) et les machines virtuelles et Activer la journalisation des diagnostics pour les applications Web dans Azure App Service.