Suivi HTTP <httpTracing>
Vue d’ensemble
L’élément <httpTracing> vous permet de configurer le suivi d’événements sélectif basé sur les requêtes pour les requêtes IIS entrantes.
<httpTracing> contient un élément <traceUrls>, qui contient une collection d’éléments <add>.
Chaque élément <add> définit une URL unique pour activer le suivi.
Remarque
Le suivi d’événements pour Windows (ETW) est une installation de suivi à haut débit à usage général fournie par le système d’exploitation. Grâce à un mécanisme de mise en mémoire tampon et de journalisation implémenté dans le noyau, ETW fournit un mécanisme de traçage pour les événements générés par les applications en mode utilisateur et les pilotes de périphériques en mode noyau. En outre, ETW vous permet d’activer et de désactiver la journalisation de manière dynamique, ce qui facilite la réalisation de traçages détaillés dans les environnements de production sans nécessiter de redémarrage ou d’arrêt de l’application. Le mécanisme de journalisation utilise des tampons par processeur qui sont écrits sur le disque par un thread d’écriture asynchrone. Cette option permet aux applications serveur à grande échelle d’écrire des événements avec un minimum de perturbations.
Remarque
Pour activer IIS ETW basé sur les requêtes, installez le TracingModule.
Par défaut, IIS émet des événements ETW basés sur des requêtes pour toutes les URL via le fournisseur IIS : WWW Server avec GUID {3A2A4E84-4C21-4981-AE10-3FDA0D9B0F83} (les informations détaillées sont disponibles dans l’élément <traceProviderDefinitions>).
Pour activer le filtre d’URL pour ETW spécifié par la collection <traceUrls> sous l’élément <httpTracing>, le premier bit (le moins significatif) des indicateurs de trace doit être défini sur 1 lors de l’exécution d’une session ETW.
Par exemple, pour activer les événements ETW basés sur des requêtes IIS UNIQUEMENT pour les URL configurées dans la collection <traceUrls>, définissez les indicateurs de trace sur 0xFFFFFFFF pour une session ETW avec le fournisseur IIS : WWW Server.
Ces indicateurs de trace activent le filtre d’URL ainsi que toutes les zones de trace.
Pour activer les mêmes événements pour toutes les URL, définissez plutôt les indicateurs de trace sur 0xFFFFFFE.
Remarque
Le filtre d’URL défini dans la collection <traceUrls> sous l’élément <httpTracing> affecte uniquement l’ETW basé sur les requêtes IIS et n’a aucun impact sur le suivi des demandes ayant échoué.
Compatibilité
| Version | Notes |
|---|---|
| IIS 10.0 | L’élément <httpTracing> n’a pas été modifié dans IIS 10.0. |
| IIS 8.5 | L’élément <httpTracing> n’a pas été modifié dans IIS 8.5. |
| IIS 8.0 | L’élément <httpTracing> n’a pas été modifié dans IIS 8.0. |
| IIS 7.5 | L’élément <httpTracing> n’a pas été modifié dans IIS 7.5. |
| IIS 7.0 | L’élément <httpTracing> a été introduit dans IIS 7.0. |
| IIS 6.0 | S/O |
Programme d’installation
L’élément <httpTracing> est inclus dans l’installation par défaut IIS 7.
Procédure
Il n’existe aucune interface utilisateur pour l’élément <httpTracing> pour IIS 7. Pour obtenir des exemples sur la façon d’accéder à l’élément <httpTracing> programmatiquement, consultez la section Exemples de code de ce document.
Configuration
Vous pouvez configurer l’élément <httpTracing> au niveau du serveur dans le fichier ApplicationHost.config ou au niveau du site, de l’application ou du répertoire dans un fichier Web.config.
Attributs
Aucune.
Éléments enfants
| Élément | Description |
|---|---|
traceUrls |
Élément facultatif. Spécifie l’URL pour laquelle vous souhaitez activer le suivi ETW basé sur les requêtes. |
Exemple Configuration
L’exemple suivant permet d’activer le traçage pour l’exemple de page d’accueil fourni avec IIS 7 lorsqu’il est placé dans un fichier Web.config à la racine du site web par défaut.
<configuration>
<system.webServer>
<httpTracing>
<traceUrls>
<add value="/iisstart.htm" />
</traceUrls>
</httpTracing>
</system.webServer>
</configuration>
Exemple de code
Les exemples suivants permettent d’activer le suivi pour l’exemple de page d’accueil fourni avec IIS 7 sur le site web nommé Contoso en ajoutant une entrée à la collection <traceUrls> pour ce site.
AppCmd.exe
appcmd.exe set config "Contoso" -section:system.webServer/httpTracing /+"traceUrls.[value='/iisstart.htm']" /commit:apphost
Remarque
Vous devez veiller à définir le paramètre commit sur apphost quand vous utilisez AppCmd.exe pour configurer ces paramètres. Cela valide les paramètres de configuration dans la section d’emplacement appropriée dans le fichier ApplicationHost.config.
C#
using System;
using System.Text;
using Microsoft.Web.Administration;
internal static class Sample
{
private static void Main()
{
using (ServerManager serverManager = new ServerManager())
{
Configuration config = serverManager.GetApplicationHostConfiguration();
ConfigurationSection httpTracingSection = config.GetSection("system.webServer/httpTracing", "Contoso");
ConfigurationElementCollection traceUrlsCollection = httpTracingSection.GetCollection("traceUrls");
ConfigurationElement addElement = traceUrlsCollection.CreateElement("add");
addElement["value"] = @"/iisstart.htm";
traceUrlsCollection.Add(addElement);
serverManager.CommitChanges();
}
}
}
VB.NET
Imports System
Imports System.Text
Imports Microsoft.Web.Administration
Module Sample
Sub Main()
Dim serverManager As ServerManager = New ServerManager
Dim config As Configuration = serverManager.GetApplicationHostConfiguration
Dim httpTracingSection As ConfigurationSection = config.GetSection("system.webServer/httpTracing", "Contoso")
Dim traceUrlsCollection As ConfigurationElementCollection = httpTracingSection.GetCollection("traceUrls")
Dim addElement As ConfigurationElement = traceUrlsCollection.CreateElement("add")
addElement("value") = "/iisstart.htm"
traceUrlsCollection.Add(addElement)
serverManager.CommitChanges()
End Sub
End Module
JavaScript
var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";
var httpTracingSection = adminManager.GetAdminSection("system.webServer/httpTracing", "MACHINE/WEBROOT/APPHOST/Contoso");
var traceUrlsCollection = httpTracingSection.ChildElements.Item("traceUrls").Collection;
var addElement = traceUrlsCollection.CreateNewElement("add");
addElement.Properties.Item("value").Value = "/iisstart.htm";
traceUrlsCollection.AddElement(addElement);
adminManager.CommitChanges();
VBScript
Set adminManager = createObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set httpTracingSection = adminManager.GetAdminSection("system.webServer/httpTracing", "MACHINE/WEBROOT/APPHOST/Contoso")
Set traceUrlsCollection = httpTracingSection.ChildElements.Item("traceUrls").Collection
Set addElement = traceUrlsCollection.CreateNewElement("add")
addElement.Properties.Item("value").Value = "/iisstart.htm"
traceUrlsCollection.AddElement addElement
adminManager.CommitChanges()