Journalisation du suivi des requêtes ayant échoué par défaut pour un site <traceFailedRequestsLogging>

Article
03/25/2024

Vue d’ensemble

L’élément <traceFailedRequestsLogging> de l’élément <siteDefaults> définit les options de suivi des demandes ayant échoué pour tous les sites, telles que le répertoire des fichiers journaux de suivi des demandes ayant échoué, le nombre maximal de fichiers journaux de suivi des demandes ayant échoué et si le suivi des demandes ayant échoué est activé.

Remarque

Si l’élément <traceFailedRequestsLogging> est configuré à la fois dans la section <siteDefaults> et dans la section <site> pour un site spécifique, la configuration de la section <site> est utilisée pour ce site.

Remarque

L’élément <traceFailedRequestsLogging> spécifie les options au niveau global pour le suivi des demandes ayant échoué, mais l’élément <system.webServer/tracing/traceFailedRequests> spécifie les règles de suivi des demandes ayant échoué.

Compatibilité

Version	Notes
IIS 10.0	L’élément `<traceFailedRequestsLogging>` n’a pas été modifié dans IIS 10.0.
IIS 8.5	L’élément `<traceFailedRequestsLogging>` n’a pas été modifié dans IIS 8.5.
IIS 8.0	La valeur par défaut de l’attribut `maxLogFileSizeKB` a été augmentée.
IIS 7.5	L’élément `<traceFailedRequestsLogging>` n’a pas été modifié dans IIS 7.5.
IIS 7.0	L’élément `<traceFailedRequestsLogging>` de l’élément `<siteDefaults>` a été introduit dans IIS 7.0.
IIS 6.0	S/O

Programme d’installation

Une fois l’installation par défaut d’IIS 7 et ultérieure terminée, vous devez installer le service de rôle de suivi pour utiliser le suivi des demandes ayant échoué. Après avoir installé le service de rôle, vous devez toujours activer le suivi des demandes ayant échoué au niveau du site, du niveau de l’application ou du répertoire.

Windows Server 2012 ou Windows Server 2012 R2

Dans la barre des tâches, cliquez sur Gestionnaire de serveur.
Dans Gestionnaire de serveur, cliquez sur le menu Gérer, puis sur Ajouter des rôles et des fonctionnalités.
Dans l’Assistant Ajout de rôles et de fonctionnalités, cliquez sur Suivant. Sélectionnez le type d’installation, puis cliquez sur Suivant. Sélectionnez le serveur de destination, puis cliquez sur Suivant.
Dans la page Rôles de serveur, développez Serveur web (IIS), Serveur web, Intégrité et diagnostic, puis sélectionnez Suivi. Sélectionnez Suivant.
.
Dans la page Sélectionner les composants, cliquez sur Suivant.
Dans la page Confirmer les sélections d’installation, cliquez sur Installer.
Dans la page Résultats , cliquez sur Fermer.

Windows 8 ou Windows 8.1

Dans l’écran d’accueil, déplacez le pointeur jusqu’au coin inférieur gauche, cliquez avec le bouton droit sur le bouton Démarrer, puis cliquez sur Panneau de configuration.
Dans le Panneau de configuration, cliquez sur Programmes et fonctionnalités, puis sur Activer ou désactiver des fonctionnalités Windows.
Développez Internet Information Services, développez World Wide Web Services, développez Intégrité et Diagnostics, puis sélectionnez Suivi.
- Cliquez sur OK.
Cliquez sur Fermer.

Windows Server 2008 ou Windows Server 2008 R2

Dans la barre des tâches, cliquez sur Démarrer, pointez sur Outils d’administration, puis cliquez sur Gestionnaire de serveur.
Dans le volet hiérarchie du Gestionnaire de serveur, développez Rôles, puis cliquez sur Serveur web (IIS).
Dans le volet Serveur web (IIS), faites défiler jusqu’à la section Services de rôle, puis cliquez sur Ajouter des services de rôle.
Dans la page Sélectionner des services de rôle de l’Assistant Ajout de services de rôle, sélectionner Suivi puis cliquer sur Suivant.
Dans la page Confirmer les sélections pour l'installation, cliquez sur Installer.
Dans la page Résultats , cliquez sur Fermer.

Windows Vista ou Windows 7

Dans la barre des tâches, cliquez sur Démarrer, puis sur Panneau de configuration.
Dans le Panneau de configuration, cliquez sur Programmes et fonctionnalités, puis sur Activer ou désactiver des fonctionnalités Windows.
Développez Internet Information Services, puis World Wide Web Services et Diagnostics et santé.
Sélectionner Suivi, puis cliquer sur OK.

Procédure

Comment configurer les valeurs par défaut du site pour un serveur

Ouvrez le Gestionnaire des services Internet (IIS) :
- Si vous utilisez Windows Server 2012 ou Windows Server 2012 R2 :
  - Dans la barre des tâches, cliquez sur Gestionnaire de serveur, cliquez sur Outils, puis sur Gestionnaire Internet Information Services (IIS).
- Si vous utilisez Windows 8 ou Windows 8.1 :
  - Maintenez la touche Windows enfoncée, appuyez sur la lettre X, puis cliquez sur Panneau de configuration.
  - Cliquez sur Outils d’administration, puis double-cliquez sur Gestionnaire Internet Information Services (IIS).
- Si vous utilisez Windows Server 2008 ou Windows Server 2008 R2 :
  - Cliquez sur Démarrer, placez le curseur sur Outils d’administration, puis cliquez sur Gestionnaire Internet Information Services (IIS).
- Si vous utilisez Windows Vista ou Windows 7 :
  - Dans la barre des tâches, cliquez sur Démarrer, puis sur Panneau de configuration.
  - Double-cliquez sur Outils d’administration, puis double-cliquez sur Gestionnaire Internet Information Services (IIS).
Dans le volet Connexions, développez le nom du serveur, puis cliquez sur le nœud Sites.
Dans le volet Sites du serveur, cliquez surDéfinir les valeurs par défaut du site web…dans le volet Actions.
Dans la boîte de dialogue Paramètres par défaut du site web, spécifiez vos options par défaut pour tous les sites web, puis cliquez sur OK.

Configuration

Attributs

Attribut	Description
`customActionsEnabled`	Attribut booléen facultatif. Spécifie si les actions personnalisées sont activées pour le suivi des demandes ayant échoué. La valeur par défaut est `false`.
`directory`	Attribut de chaîne facultatif. Spécifie le répertoire de journalisation des traces des demandes ayant échoué pour un site. La valeur par défaut est `%SystemDrive%\inetpub\logs\FailedReqLogFiles`.
`enabled`	Attribut booléen facultatif. Spécifie si la journalisation des traces des demandes ayant échoué est activée pour un site (true) ou désactivée (false). La valeur par défaut est `false`.
`maxLogFiles`	Attribut uint facultatif. Spécifie le nombre maximal de fichiers journaux de suivi des demandes ayant échoué à conserver pour le site. La valeur par défaut est `50`.
`maxLogFileSizeKB`	Attribut uint facultatif. Spécifie la taille de fichier maximale en kilo-octets pour les journaux de suivi des demandes ayant échoué. Remarque : si les journaux de suivi des demandes ayant échoué dépassent cette valeur, IIS tronque les journaux à la taille maximale du fichier et spécifie LOG_FILE_MAX_SIZE_TRUNCATE pour l’événement de trace. La valeur par défaut est `1024`.

Éléments enfants

Aucune.

Exemple Configuration

L’exemple de configuration suivant spécifie les options traceFailedRequestsLogging par défaut pour IIS 7.

<system.applicationHost>
   <sites>
      <siteDefaults>
         <traceFailedRequestsLogging enabled="true"
            directory="%SystemDrive%\inetpub\logs\FailedReqLogFiles"
            maxLogFiles="20" />
      </siteDefaults>
   </sites>
</system.applicationHost>

Exemple de code

Les exemples de code suivants configurent les options traceFailedRequestsLogging par défaut pour IIS 7.

AppCmd.exe

appcmd.exe set config -section:system.applicationHost/sites /siteDefaults.traceFailedRequestsLogging.enabled:"True" /commit:apphost
appcmd.exe set config -section:system.applicationHost/sites /siteDefaults.traceFailedRequestsLogging.directory:"%SystemDrive%\inetpub\logs\FailedReqLogFiles" /commit:apphost
appcmd.exe set config -section:system.applicationHost/sites /siteDefaults.traceFailedRequestsLogging.maxLogFiles:"20" /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 sitesSection = config.GetSection("system.applicationHost/sites");
         ConfigurationElement siteDefaultsElement = sitesSection.GetChildElement("siteDefaults");

         ConfigurationElement traceFailedRequestsLoggingElement = siteDefaultsElement.GetChildElement("traceFailedRequestsLogging");
         traceFailedRequestsLoggingElement["enabled"] = true;
         traceFailedRequestsLoggingElement["directory"] = @"%SystemDrive%\inetpub\logs\FailedReqLogFiles";
         traceFailedRequestsLoggingElement["maxLogFiles"] = 20;

         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 sitesSection As ConfigurationSection = config.GetSection("system.applicationHost/sites")
      Dim siteDefaultsElement As ConfigurationElement = sitesSection.GetChildElement("siteDefaults")

      Dim traceFailedRequestsLoggingElement As ConfigurationElement = siteDefaultsElement.GetChildElement("traceFailedRequestsLogging")
      traceFailedRequestsLoggingElement("enabled") = True
      traceFailedRequestsLoggingElement("directory") = "%SystemDrive%\inetpub\logs\FailedReqLogFiles"
      traceFailedRequestsLoggingElement("maxLogFiles") = 20

      serverManager.CommitChanges()
   End Sub

End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";
var sitesSection = adminManager.GetAdminSection("system.applicationHost/sites", "MACHINE/WEBROOT/APPHOST");
var siteDefaultsElement = sitesSection.ChildElements.Item("siteDefaults");

var traceFailedRequestsLoggingElement = siteDefaultsElement.ChildElements.Item("traceFailedRequestsLogging");
traceFailedRequestsLoggingElement.Properties.Item("enabled").Value = true;
traceFailedRequestsLoggingElement.Properties.Item("directory").Value = "%SystemDrive%\\inetpub\\logs\\FailedReqLogFiles";
traceFailedRequestsLoggingElement.Properties.Item("maxLogFiles").Value = 20;

adminManager.CommitChanges();

VBScript

Set adminManager = WScript.CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set sitesSection = adminManager.GetAdminSection("system.applicationHost/sites", "MACHINE/WEBROOT/APPHOST")
Set siteDefaultsElement = sitesSection.ChildElements.Item("siteDefaults")

Set traceFailedRequestsLoggingElement = siteDefaultsElement.ChildElements.Item("traceFailedRequestsLogging")
traceFailedRequestsLoggingElement.Properties.Item("enabled").Value = True
traceFailedRequestsLoggingElement.Properties.Item("directory").Value = "%SystemDrive%\inetpub\logs\FailedReqLogFiles"
traceFailedRequestsLoggingElement.Properties.Item("maxLogFiles").Value = 20

adminManager.CommitChanges()

Partager via

Journalisation du suivi des requêtes ayant échoué par défaut pour un site <traceFailedRequestsLogging>

Vue d’ensemble

Compatibilité

Programme d’installation

Windows Server 2012 ou Windows Server 2012 R2

Windows 8 ou Windows 8.1

Windows Server 2008 ou Windows Server 2008 R2

Windows Vista ou Windows 7

Procédure

Comment configurer les valeurs par défaut du site pour un serveur

Configuration

Attributs

Éléments enfants

Exemple Configuration

Exemple de code

AppCmd.exe

C#

VB.NET

JavaScript

VBScript

Commentaires

Ressources supplémentaires