Enregistrement du traçage au niveau de l'application
Outre la fonctionnalité de traçage au niveau de la page, ASP.NET propose une manière d'activer la sortie du traçage pour la totalité d'une application. L'activation du traçage au niveau de l'application a pour effet d'activer le traçage au niveau de la page au sein de cette application (à moins qu'une directive au niveau de la page désactive explicitement le traçage). Si le traçage au niveau de la page est activé, le runtime ASP.NET rassemble aussi plusieurs statistiques supplémentaires, telles que l'état de la hiérarchie des contrôles, le contenu de l'état de session et de l'application, les valeurs d'entrée du formulaire et de la chaîne de requête, ainsi que d'autres caractéristiques de l'exécution de la demande. Ces statistiques sont rassemblées pour une série de demandes spécifiée dans le fichier de configuration de l'application. Pour activer le traçage d'une application, insérez les lignes suivantes dans le fichier web.config situé dans le répertoire racine de l'application :
<configuration>
<system.web>
<trace enabled="true"/>
</system.web>
</configuration>
À l'aide de la configuration ci-dessus, chaque page de l'application exécute ses instructions de traçage au niveau de la page à afficher dans le navigateur client. Pour accéder aux statistiques supplémentaires de la page, demandez une URL « trace.axd » spécialement mappée à partir de la racine de l'application. Par exemple, si l'URL de votre application est http://localhost/myapplication, demandez l'URL http://localhost/myapplication/trace.axd pour accéder aux statistiques de traçage de cette application.
Par défaut, les informations de traçage sont rassemblées pour 10 demandes au maximum (vous pouvez utiliser le lien « effacer le traçage actuel » pour réinitialiser le compteur de demandes). La section relative au traçage du fichier de configuration prend également en charge un attribut permettant de contrôler si les instructions de traçage sont affichées dans le navigateur client ou si elles sont uniquement disponibles dans le fichier trace.axd. Les attributs pris en charge dans la section de configuration du traçage sont énumérés dans le tableau ci-dessous :
| Valeur | Description |
| enabled | Égale à true | false, indique si le traçage est activé pour l'application (la valeur par défaut est false) |
| pageOutput | Égale à true | false, indique si les informations de traçage doivent être affichées à la fin de chaque page ou bien être uniquement accessibles par le biais de l'utilitaire trace.axd (la valeur par défaut est false) |
| requestLimit | Nombre de demandes de traçage à enregistrer sur le serveur (la valeur par défaut est égale à 10) |
| traceMode | Égale à SortByTime | SortByCategory, indique l'ordre d'affichage des messages de trace (la valeur par défaut est SortByTime) |
| localOnly | Égale à true | false, indique si le traçage est activé pour les utilisateurs de type « localhost » ou pour tous les utilisateurs (la valeur par défaut est true) |
Par exemple, la configuration suivante rassemble les informations de traçage de 40 demandes au maximum et empêche l'affichage des instructions de traçage dans le navigateur qui effectue la demande (à moins qu'une directive au niveau de la page active explicitement le traçage). Les messages s'affichent dans l'ordre des catégories :
<configuration>
<system.web>
<trace
enabled="true"
traceMode="SortByCategory"
requestLimit="40"
pageOutput="false"
localOnly="true"
/>
</system.web>
</configuration>
Informations détaillées sur la demande de traçage au niveau de l'application
Après le lancement d'une série de demandes à l'application, l'accès au fichier trace.axd entraîne l'affichage de la liste de ces demandes par ordre chronologique. Vous pouvez obtenir les détails de chaque demande en sélectionnant le lien « Afficher les détails ».
L'application de traçage contient les informations détaillées suivantes pour chaque demande :
|
Informations détaillées sur la demande
|
| Valeur | Description |
| Session Id | ID de session de la demande |
| Time of Request | Heure à laquelle la demande a été effectuée |
| Status Code | Code d'état retourné par la demande |
| Request Type | GET | POST |
| Request Encoding | Codage de la demande |
| Response Encoding | Codage de la réponse |
|
Informations sur le traçage
|
| Valeur | Description |
| Category | Catégorie du relevé de trace écrit dans le TraceContext |
| Message | Chaîne de message du relevé de trace |
| From First (s) | Temps (en secondes) à partir du premier relevé de trace |
| From Last (s) | Temps (en secondes) à partir du relevé de trace précédent |
|
Hiérarchie des contrôles
|
| Valeur | Description |
| Control ID | ID du contrôle |
| Type | Type qualifié complet du contrôle |
| Render Size | Taille de restitution du contrôle (en octets) y compris les contrôles enfants |
| ViewState Size | État d'affichage du contrôle (en octets) à l'exception des contrôles enfants |
|
État de session
|
| Valeur | Description |
| Key | Clé d'un objet dans l'état de session |
| Type | Type qualifié complet de l'objet |
| Value | Valeur de l'objet |
|
É tat de l'application
|
| Valeur | Description |
| Key | Clé d'un objet dans l'état de l'application |
| Type | Type qualifié complet de l'objet |
| Value | Valeur de l'objet |
|
Collection Cookies
|
| Valeur | Description |
| Name | Nom du cookie |
| Value | Valeur du cookie, ou sous-clés/valeurs en cas de valeurs multiples |
| Size | Taille du cookie restitué (en octets) |
|
Collection Headers
|
| Valeur | Description |
| Name | Nom de l'en-tête |
| Value | Valeur de l'en-tête |
|
Collection Form
|
| Valeur | Description |
| Name | Nom de la variable de formulaire |
| Value | Valeur de la variable de formulaire |
|
Collection QueryString
|
| Valeur | Description |
| Name | Nom de la variable querystring |
| Value | Valeur de la variable querystring |
|
Variables serveur
|
| Valeur | Description |
| Name | Nom de la variable serveur |
| Value | Valeur de la variable serveur |
Résumé de la section
- Vous pouvez activer le traçage au niveau de l'application à l'aide d'une section « trace » du fichier de configuration situé dans le répertoire racine de l'application.
- Le traçage au niveau de l'application active la sortie du journal de traçage pour chaque page d'une application (à moins qu'une directive au niveau de la page désactive explicitement le traçage).
- Après le lancement d'une série de demandes, vous pouvez accéder aux détails qui les concernent en demandant « trace.axd » à partir de la racine de l'application.
|