Partager via

Activation du traçage au niveau de l'application

  • Article

Vous pouvez activer le traçage pour une application entière dans le fichier Web.config situé dans le répertoire racine de l'application. Par défaut, le traçage au niveau de l'application peut être affiché seulement sur l'ordinateur du serveur Web local. Vous devez définir l'attribut localOnly à false dans le fichier Web.config pour rendre les informations de traçage au niveau de l'application visibles à partir d'ordinateurs distants.

ATTENTION   Pour préserver la sécurité de votre application Web, utilisez la fonctionnalité de traçage distant seulement lorsque vous développez ou déployez votre application. Veillez à la désactiver avant de transférer votre application sur des serveurs Web de production. Pour désactiver le traçage distant, définissez l'attribut localOnly à true dans le fichier Web.config.

L'exemple suivant illustre la configuration de trace d'une application qui collecte des informations de traçage pour 40 demandes au maximum et permet aux navigateurs sur des ordinateurs autres que le serveur d'origine d'afficher la visionneuse de trace.

<configuration>
 <system.web>
  <trace enabled="true" requestLimit="40" localOnly="false"/>
 </system.web>
</configuration>

Lorsque vous activez le traçage pour une application, ASP.NET collecte les informations de traçage pour chaque demande faite à l'application, jusqu'au nombre maximal de demandes que vous spécifiez. Le nombre de demandes par défaut est de 10. Lorsque la visionneuse de trace atteint sa limite de demandes, l'application arrête de stocker les demandes de trace.

Remarque   Lorsque vous activez le traçage pour une application entière dans le fichier Web.config, les informations de traçage sont collectées et traitées pour chaque page de cette application. Pour désactiver le traçage pour une page particulière de l'application, affectez la valeur false à l'attribut Trace dans la directive @ Page de cette page. Les instructions TraceContext.Write ou TraceContext.Warn que vous incluez dans le code d'une page sont stockées et retournées à la visionneuse de trace uniquement.

Si vous souhaitez que les informations de traçage apparaissent à la fin de la page à laquelle elles sont associées, affectez la valeur true à l'attribut pageOutput dans la section de configuration du traçage du fichier Web.config. Si vous souhaitez que les informations de traçage soient affichées uniquement dans la visionneuse de trace, affectez la valeur false à cet attribut. Si vous activez le traçage au niveau de l'application, mais ne souhaitez pas que les informations de traçage soient affichées pour certaines pages de l'application, utilisez la directive @ Page pour affecter la valeur false à l'attribut Trace de ces pages-là.

Pour plus d'informations sur la configuration de votre application ASP.NET, consultez Configuration ASP.NET.

Vous trouverez ci-dessous tous les attributs que vous pouvez utiliser pour modifier le comportement du traçage au niveau de l'application.

Attribut Description
enabled true si le traçage est activé pour l'application ; sinon, false. La valeur par défaut est false.
pageOutput true si les informations de traçage sont affichées à la fois sur les pages d'une application et dans l'utilitaire de traçage .axd ; sinon, false. La valeur par défaut est false.
Remarque   Les pages pour lesquelles le traçage est activé ne sont pas affectées par ce paramètre.
requestLimit Nombre de demandes de trace à stocker sur le serveur. La valeur par défaut est 10.
traceMode Indique si les informations de traçage sont affichées dans l'ordre où elles ont été traitées (SortByTime) ou par ordre alphabétique selon la catégorie définie par l'utilisateur (SortByCategory). La valeur par défaut est SortByTime.
localOnly true si Trace Viewer (visionneuse de trace) (Trace.axd) est disponible uniquement sur le serveur Web hôte ; sinon, false. La valeur par défaut est true.

Pour activer le traçage pour une application

  1. 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.

  2. Entre les balises d'ouverture et de fermeture de l'élément <configuration>, ajoutez les balises d'ouverture et de fermeture d'un élément <system.web>.

  3. Entre les balises de l'élément <system.web>, ajoutez un élément <trace> qui se ferme automatiquement.

  4. Dans l'élément <trace>, déclarez l'attribut enabled et affectez-lui la valeur true.

  5. Déclarez d'autres attributs facultatifs pour modifier le comportement de trace de votre application, comme vous le souhaitez.

    Par exemple, la configuration de trace de l'application suivante collecte des informations de traçage pour 40 demandes au maximum et permet aux navigateurs, sur des ordinateurs autres que le serveur d'origine, d'afficher la visionneuse de trace.

    <configuration>
 <system.web>
  <trace enabled="true" requestLimit="40" localOnly="false"/>
 </system.web>
</configuration>

    Remarque   Le système de configuration ASP.NET respecte la casse. Toutes les sections de configuration à un seul mot sont en minuscules tandis que les sections ou les attributs qui sont des concaténations de deux mots doivent être de casse mixte. Par exemple, requestLimit est un nom d'attribut valide, mais requestlimit provoque une erreur d'analyse.

Affichage des informations de traçage avec la visionneuse de trace

Une fois que le traçage est activé pour votre application, chaque page de l'application exécute les instructions trace qu'elle contient lorsqu'elle est demandée. Vous pouvez afficher ces instructions et les informations de traçage supplémentaires dans la visionneuse de trace en demandant Trace.axd à partir de la racine du répertoire de votre application.

Remarque   Lorsque vous activez le traçage pour une application, vous pouvez visualiser les instructions trace, ainsi que des informations supplémentaires, dans n'importe quelle page de l'application en affectant la valeur true à l'attribut pageOutput dans le fichier Web.config.

La visionneuse de trace vous permet de choisir une demande spécifique provenant des pages qui ont été demandées à partir de votre application. La capture d'écran suivante illustre une visionneuse de trace dont l'application a reçu sept demandes depuis l'activation du traçage.

Visionneuse de trace

Si plusieurs demandes sont arrivées pour une application dont le traçage est activé, la visionneuse de trace répertorie les demandes dans l'ordre où elles ont été traitées. Les informations sur la page d'ouverture 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 View Details qui vous permet de voir des informations plus détaillées concernant la demande. Le nombre de demandes affiché n'excédera pas le paramètre requestLimit que vous avez spécifié dans le fichier Web.config.

Pour afficher des détails de trace pour une demande spécifique

  1. Accédez à la visionneuse de trace associée à votre application.

    Par exemple, si l'URL de votre application est https://localhost/myapplication, accédez à https://localhost/myapplication/trace.axd pour afficher les statistiques de trace de cette application.

  2. Sélectionnez le lien View Details pour la demande que vous souhaitez examiner.

    Une fois que vous avez sélectionné View Details, vous visualisez les mêmes informations que celles ajoutées à la page dont le traçage était activé.

Dans certaines circonstances, il est possible de supprimer toutes les demandes stockées dans la visionneuse de trace. Peut-être souhaitez-vous effectuer le suivi des modifications que vous avez apportées aux fichiers de votre application ou simplement voir des informations concernant des fichiers autres que ceux associés aux demandes actuellement affichées.

Pour effacer les demandes de la visionneuse de trace

  1. Accédez à la visionneuse de trace associée à l'application.

  2. Sélectionnez le lien effacer la trace actuelle pour supprimer tous les demandes stockées dans l'application de visionneuse de trace.

    Remarque   La visionneuse de trace effectue uniquement le suivi des demandes faites après l'effacement du journal. Les demandes faites après que la limite des demandes a été atteinte et avant l'effacement du journal ne peuvent pas être affichées.

Voir aussi

TraceModeEnum, énumération | Fonctionnalité de traçage ASP.NET | Schéma des paramètres ASP.NET | Activation du traçage pour une page