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

Remarque

Cet article s’applique à Azure Azure Cloud Services (support étendu). Cloud Services (classique) est mis hors service depuis le 31 août 2024. Pour plus d'informations, consultez le modèle de déploiement des services cloud (classique) qui sera mis hors service 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 Functionsou Azure Container Apps. Pour obtenir la liste la plus récente des services disponibles, consultez Directory des produits Azure.

Lorsque vous devez résoudre les problèmes d’un service azure Cloud Services (support étendu) ou d’une machine virtuelle, vous pouvez utiliser Visual Studio pour configurer plus facilement les diagnostics Azure. Diagnostics capture les données système et les données de journalisation sur les machines virtuelles et les instances de machines virtuelles qui exécutent votre service cloud. Les données de diagnostic sont transférées vers 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 Web Apps dans Azure App Service.

Dans cet article, nous vous montrons comment utiliser Visual Studio pour activer et configurer Diagnostics Azure. Découvrez comment configurer diagnostics sur des machines virtuelles Azure, comment sélectionner les types d’informations de diagnostic à collecter et comment afficher les informations après sa collecte.

Pour configurer Diagnostics Azure, modifiez les paramètres de diagnostic dans la boîte de dialogue configuration de diagnostics dans Visual Studio. Les paramètres sont enregistrés dans un fichier appelé diagnostics.wadcfgx. Vous pouvez également modifier directement le fichier de configuration. Si vous mettez à jour manuellement le fichier, les modifications de configuration prennent effet la prochaine fois que vous déployez le service cloud sur Azure ou exécutez le service dans l’émulateur.

Avertissement

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

Comment Visual Studio détermine le compte de stockage de diagnostics

• Si une chaîne de connexion de diagnostics est spécifiée dans le fichier .cscfg, Visual Studio l’utilise pour configurer l’extension de diagnostic lors de la publication et quand elle génère les fichiers XML de configuration publique pendant l’empaquetage.
• Si une chaîne de connexion de diagnostic n’est pas spécifiée dans le fichier .cscfg, Visual Studio revient à utiliser le compte de stockage spécifié dans le fichier .wadcfgx pour configurer l’extension de diagnostics pour la publication et pour générer les fichiers XML de configuration publique pendant 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 de diagnostic est spécifiée dans le fichier .cscfg, Visual Studio utilise cette chaîne de connexion et ignore le compte de stockage dans .wadcfgx.

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

La case à cocher , qui permet de mettre à jour les chaînes de connexion de stockage de développement pour les diagnostics et la mise en cache avec les informations d’identification de compte de stockage Microsoft Azure lorsque vous publiez sur Microsoft Azure, est un moyen pratique de les actualiser avec le compte de stockage Azure que vous spécifiez. Lorsque vous publiez le projet sur Azure, Visual Studio met automatiquement à jour la chaîne de connexion de diagnostics avec le compte de stockage que vous avez spécifié dans l’Assistant de publication. Toutefois, si un compte de stockage réel a été spécifié comme chaîne de connexion de diagnostics, ce compte est utilisé à la place.

Configurer des sources de données de diagnostic

Après avoir activé la collecte de données de diagnostic, vous pouvez choisir exactement les sources de données que vous souhaitez collecter et quelles informations sont collectées. Les sections suivantes décrivent les onglets de la boîte de dialogue configuration diagnostics et ce que signifie chaque option de configuration.

Logs d'application

Les journaux d’application ont des informations de diagnostic générées par une application web. Si vous souhaitez capturer les journaux d’application, cochez la case Activer le transfert des journaux d’application. Pour augmenter ou diminuer l’intervalle entre les transferts des journaux d’application vers votre compte de stockage, vous devez changer la valeur de Période de transfert (min). Vous pouvez également modifier la quantité d’informations capturées dans le journal en définissant la valeur de niveau de log . Par exemple, sélectionnez Détaillé pour collecter plus d’informations ou Critique pour capturer seulement les erreurs critiques. Si vous avez un fournisseur de diagnostics spécifique qui génère des journaux d’application, vous pouvez capturer ceux-ci en ajoutant l’identificateur global unique (GUID) du fournisseur dans la zone GUID du fournisseur.

Pour plus d’informations sur les journaux des applications, consultez Activer la journalisation des diagnostics pour Web Apps 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 d’événements Windows. Pour augmenter ou diminuer l’intervalle entre le transfert des journaux d’événements vers votre compte de stockage, modifiez la valeur de période de transfert (min). Cochez les cases pour les types d’événements que vous souhaitez suivre.

Journaux d'événements

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> zone de texte, puis sélectionnez Ajouter. La source de données est ajoutée au fichier diagnostics.cfcfg.

Compteurs de performances

Les informations du compteur de performances peuvent vous aider à localiser les goulots d’étranglement du système et à ajuster les performances du système et des applications. Pour plus d’informations, consultez Créer et utiliser des compteurs de performances dans une application Azure. Pour capturer les compteurs de performances, cochez la case Activer le transfert des compteurs de performances. Pour augmenter ou diminuer l’intervalle entre le transfert des journaux d’événements vers votre compte de stockage, modifiez la valeur de période de transfert (min). Cochez les cases des compteurs de performances que vous souhaitez suivre.

compteurs de performances

Pour suivre un compteur de performances qui n’est pas répertorié, entrez le compteur de performances à l’aide de la syntaxe suggérée. puis sélectionnez 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’infrastructure

Les journaux d’infrastructure ont des informations sur l’infrastructure de diagnostic Azure, le module RemoteAccess et le module RemoteForwarder. Pour collecter des informations sur les journaux 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’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 à l’aide d’Azure Diagnostics.

Répertoires de journaux

Les répertoires de journaux contiennent des données collectées à partir de répertoires de journaux pour les requêtes adressées à Internet Information Services (IIS), les requêtes ayant échoué ou les dossiers que vous sélectionnez. Pour capturer les répertoires de journal, cochez la case Activer le transfert des répertoires de journal. Pour augmenter ou diminuer l’intervalle entre les transferts des journaux vers votre compte de stockage, changez la valeur de Période de transfert (min).

Cochez les cases correspondant aux journaux à collecter, comme Journaux IIS et Journaux de requêtes ayant échoué. Les noms de conteneur de stockage par défaut sont fournis, mais vous pouvez modifier les noms.

Vous pouvez capturer des journaux 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 de bord sont enregistrés dans les conteneurs spécifiés.

Journaux de suivi des événements ETW

Si vous utilisez suivi d’événements pour Windows (ETW) (ETW) et souhaitez capturer les journaux ETW, cochez la case Activer le transfert des journaux ETW. Pour augmenter ou diminuer l’intervalle entre les transferts des journaux 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 manifestes d’événements que vous spécifiez. Pour spécifier une source d’événement, dans la section sources d’événements, entrez un nom, puis sélectionnez Ajouter une source d’événement. De même, vous pouvez spécifier un manifeste d’événement dans la section manifestes d’événements, puis sélectionner Ajouter un manifeste d’événement.

L’infrastructure ETW est prise en charge dans ASP.NET via des classes dans l’espace de noms System.Diagnostics.aspx. L’espace de noms Microsoft.WindowsAzure.Diagnostics, qui hérite et étend les classes de System.Diagnostics.aspx standard, permet l’utilisation de 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 suivi 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 en cours de suivi sont répertoriés dans la capture d’écran suivante. Cochez les cases des processus que vous souhaitez capturer. Pour ajouter un autre processus à la liste, entrez le nom du processus, puis sélectionnez Ajouter un processus.

Pour plus d’informations, consultez Prendre le contrôle de la journalisation et du suivi dans Microsoft Azure.

Résoudre les problèmes liés aux services cloud Azure (support étendu)

Si vous rencontrez des problèmes avec vos projets de service cloud, comme un rôle bloqué dans un état « occupé », se recycle à plusieurs reprises ou soulève une erreur de serveur interne, il existe des outils et des techniques que vous pouvez utiliser pour diagnostiquer et résoudre 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 plateforme en tant que service Azure (PaaS) compute diagnostics data.

Questions et réponses

Quelle est la taille de la mémoire tampon, et de quelle taille devrait-elle être ?

Sur chaque instance de machine virtuelle, les quotas limitent la quantité de données de diagnostic pouvant être stockées sur le système de fichiers local. En outre, vous spécifiez une taille de mémoire tampon pour chaque type de données de diagnostic disponibles. Cette taille de mémoire tampon agit comme un quota individuel pour ce type de données. Pour déterminer le quota global et la quantité de mémoire qui reste, consultez le bas de la boîte de dialogue pour le type de données de diagnostic. Si vous spécifiez des mémoires tampons plus volumineuses ou plus de types de données, vous approchez du quota global. Vous pouvez modifier 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, vous ne devez pas augmenter le quota global de diagnostics.

Quelle est la période de transfert et combien de temps faut-il ?

La période de transfert correspond au 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 sur une machine virtuelle vers des 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 ignorées. Si vous perdez des données, car vos données 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 sont les horodatages ?

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

• PreciseTimeStamp : l'horodatage ETW de l'événement. Autrement dit, l’heure à laquelle l’événement est enregistré à partir du client.
• TIMESTAMP : La valeur de PreciseTimeStamp arrondie à la limite de fréquence de chargement. Par exemple, si votre fréquence de chargement est de 5 minutes et que l’heure d’événement 00:17:12, TIMESTAMP est 00:15:00.
• Timestamp : Horodatage auquel l’entité a été créée dans la table Azure.

Comment gérer les coûts lors de la collecte des informations de diagnostic ?

Les paramètres par défaut (niveau de journalisation défini sur Erreur, et période de transfert définie sur une minute) sont conçus pour réduire les coûts. Vos coûts de calcul augmentent lorsque vous collectez plus de données de diagnostic ou si 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 lorsque vous n’en avez plus besoin. Vous pouvez toujours l’activer à nouveau, même au moment de l’exécution, comme décrit précédemment dans cet article.

Comment recueillir des journaux de requêtes IIS ayant échoué ?

Par défaut, IIS ne collecte pas les journaux de requêtes ayant échoué. Vous pouvez configurer IIS pour collecter les journaux de demandes échouées en modifiant le fichier web.config pour votre rôle web.

Je ne reçois pas d’informations de trace à partir de méthodes RoleEntryPoint comme OnStart. Qu’est-ce qui ne va pas?

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 activent normalement le suivi ne s’appliquent pas. Pour résoudre ce problème, ajoutez un fichier .config à votre projet de rôle web et nommez le fichier pour qu’il 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 Web Apps dans Azure App Service.