Le suivi de l'ensemble de l'application peut être activé dans le fichier Web.config dans le répertoire racine de l'application. Par défaut, les traces au niveau de l'application ne peuvent être affichées que sur l'ordinateur du serveur Web local. Vous devez
définir localOnly sur false dans le fichier Web.config afin que les informations de suivi au niveau de l'application soient visibles depuis l'ordinateur distant.
Pour désactiver le suivi à distance, définissez la propriété localOnly sur true dans le fichier Web.config. L'exemple suivant montre une configuration de suivi d'application qui collecte
des informations de trace pour un maximum de 40 requêtes et permet aux navigateurs sur des machines autres que le serveur d'origine d'afficher la visionneuse de trace.
<configuration>
<système.web>
<trace activé="true" requestLimit="40" localOnly="false"/>
</system.web>
</configuration>
Lorsque vous activez le suivi pour une application, ASP.NET collecte les informations de suivi pour chaque demande adressée à l'application jusqu'à ce que le nombre maximal de demandes que vous spécifiez soit atteint. Le nombre de requêtes par défaut est 10. Lorsque la visionneuse de trace
atteint sa limite de requêtes, l'application arrête de stocker les requêtes de trace.
Remarque Lorsque vous activez le suivi pour une application entière dans le fichier Web.config, les informations de suivi sont collectées et traitées pour chaque page de l'application. Pour désactiver le traçage pour une page spécifique de votre application,
définissez la propriété Trace sur false dans la directive @Page de la page. Toutes les instructions TraceContext.Write ou TraceContext.Warn que vous incluez dans le code de la page sont stockées
et
sont uniquement renvoyées à Trace Viewer.
Si vous souhaitez que les informations de suivi soient ajoutées à la fin de la page à laquelle elles sont associées, définissez la propriété pageOutput sur true dans la section de configuration de suivi du fichier Web.config. Si vous souhaitez que les informations de trace soient affichées uniquement dans
la visionneuse de trace, définissez cette propriété sur false. Si vous activez le traçage au niveau de l'application mais ne souhaitez pas que les informations de trace soient affichées pour certaines pages de votre application, utilisez la directive @Page pour
définir la propriété Trace sur false pour les pages pour lesquelles vous ne souhaitez pas que les informations de trace soient affichées.
Vous trouverez ci-dessous toutes les propriétés qui peuvent être utilisées pour modifier le comportement de traçage au niveau de l'application.
Description du bien
activé vrai si le suivi au niveau de l'application est activé ; sinon faux. La valeur par défaut est fausse.
pageOutput true si les informations de suivi sont affichées à la fois sur la page de l'application et dans l'utilitaire de traçage .axd ; sinon, false ; La valeur par défaut est fausse.
Remarque Les pages sur lesquelles le suivi est activé ne sont pas affectées par ce paramètre.
requestLimit Nombre de demandes de suivi stockées sur le serveur. La valeur par défaut est 10.
traceMode indique si les informations de trace sont affichées dans l'ordre dans lequel elles ont été traitées (SortByTime) ou par ordre alphabétique par catégories définies par l'utilisateur (SortByCategory). La valeur par défaut est
SortByTime.
localOnly true si la visionneuse de trace (Trace.axd) est disponible uniquement sur le serveur Web hôte ; sinon, false ; La valeur par défaut est vraie.
Activer le traçage au niveau de l'application
Si vous ne l'avez pas déjà fait, créez un fichier texte, nommez-le Web.config et enregistrez-le dans le répertoire racine de votre application.
Entre les balises d'ouverture et de fermeture de l'élément <configuration>, ajoutez les balises d'ouverture et de fermeture de l'élément <system.web>.
Entre les balises de l'élément <system.web>, ajoutez un élément <trace> (il se ferme automatiquement).
Dans l'élément <trace>, déclarez l'attribut activé et définissez-le sur true.
Déclarez d'autres propriétés facultatives pour modifier le comportement de suivi de votre application en fonction de vos besoins.
Par exemple, la configuration de suivi d'application suivante collecte des informations de trace pour un maximum de 40 requêtes et permet aux navigateurs sur des machines autres que le serveur d'origine d'afficher la visionneuse de trace.
<configuration>
<système.web>
<trace activé="true" requestLimit="40" localOnly="false"/>
</system.web>
</configuration>
Notez que le système de configuration ASP.NET est sensible à la casse. Toutes les sections de configuration d'un seul mot sont en minuscules, tandis que les sections ou attributs concaténés de deux mots doivent être en casse Camel. Par exemple,
requestLimit est un nom de propriété valide, mais requestlimit entraîne une erreur d'analyseur.
Afficher les informations de trace avec Trace Viewer Une fois le traçage au niveau de l'application activé, lorsque chaque page de l'application est demandée, elle exécutera toutes les instructions de trace qu'elle contient.
peuvent être visualisées dans la visionneuse
de trace
en demandant Trace.axd dans le répertoire racine de l'application .Remarque Lorsque le suivi au niveau de l'application est activé, vous pouvez afficher les instructions de trace et
d'autres
informations dans n'importe quelle page de l'application en définissant la propriété pageOutput sur true dans le fichier Web.config .
Le visualiseur de trace vous permet de sélectionner des requêtes spécifiques parmi les pages qui ont été demandées à l'application. La capture d'écran ci-dessous montre une visionneuse de trace qui a 7 requêtes adressées à son
application
une fois le traçage activé .Trace Viewer
Si plusieurs demandes arrivent pour une application compatible avec le traçage, Trace Viewer les répertorie dans l'ordre dans lequel elles ont été traitées. Les informations sur la page de démarrage de la visionneuse de trace incluent : l'heure de la demande,
le fichier demandé, le code d'état de la demande, le verbe HTTP associé à la demande et un lien Afficher les détails qui vous permet d'afficher des informations plus détaillées sur la demande. Le nombre de requêtes affichées ne
dépassera pas le paramètre requestLimit que vous spécifiez dans le fichier Web.config.
Pour afficher les détails de trace pour une demande spécifique,
accédez à la visionneuse de trace associée à votre application.
Par exemple, si l'URL de votre application est http://localhost/myapplication , accédez à http://localhost/myapplication/trace.axd pour afficher les statistiques
de trace
de l'application .Sélectionnez le lien Afficher les détails de la demande que vous souhaitez rechercher.
Lorsque vous sélectionnez Afficher les détails, vous verrez les mêmes informations ajoutées à une page compatible avec le suivi.
Dans certains cas, vous souhaiterez peut-être supprimer toutes les demandes stockées dans la visionneuse de trace. Peut-être souhaitez-vous suivre les modifications apportées aux fichiers dans votre application, ou peut-être souhaitez-vous simplement voir
des informations sur un fichier autre que celui associé à la demande actuellement affichée.
Larequête Clear from Trace Viewer
cible la visionneuse de trace associée à l’application.
Sélectionnez le lien Effacer la trace actuelle pour supprimer toutes les demandes stockées dans l'application Trace Viewer.
Remarque La visionneuse de trace trace uniquement les demandes effectuées après que l'enregistrement a été effacé. Les demandes effectuées après que la limite de demandes a été atteinte et avant que l'enregistrement ne soit effacé ne peuvent pas être consultées.