Configurer la journalisation dans IIS

  • Article

Auteurs : Keith Newman et Robert McMurray

Vous pouvez configurer la journalisation sur votre serveur web ou votre site web qui enregistre les informations relatives aux requêtes HTTP et aux erreurs. Les informations contenues dans votre journal peuvent vous aider à dépanner ou à optimiser votre site web.

Prérequis

Pour tirer le meilleur parti de ce tutoriel, vous devez avoir accès à un ordinateur qui exécute l'un des systèmes d'exploitation suivants :

  • Windows Server® 2012
  • Windows® 8

Configurer la journalisation au niveau du site

Vous pouvez effectuer cette procédure en utilisant l'interface utilisateur (IU) ou en modifiant directement les fichiers de configuration.

Pour configurer la journalisation au niveau du site à l'aide de l'interface utilisateur

  1. Ouvrez le Gestionnaire IIS.

    • Pour Windows Server 2012, à la page Démarrer, cliquez sur la mosaïque du Gestionnaire de serveur, puis cliquez sur OK. Dans le Gestionnaire de serveur, cliquez sur le menu Outils, puis sur Gestionnaire des Internet Information Services (IIS).
    • Pour Windows 8, à la page Démarrer, tapez Panneau de configuration, puis cliquez sur l'icône Panneau de configuration dans les résultats de la recherche. Dans l'écran Panneau de configuration , cliquez sur Système et sécurité, sur Outils d'administration, puis sur Gestionnaire des services Internet (IIS).

  2. Dans l'arborescence Connexions, sélectionnez votre site web.

  3. Dans Affichage des fonctionnalités, double-cliquez sur Journalisation.

  4. À la page Journalisation, dans la section Fichier journal sous Format, sélectionnez l'un des formats de fichier journal suivants :

    • IIS : pour utiliser le format de fichier journal Microsoft IIS pour enregistrer des informations relatives à un site. Ce format est géré par HTTP.sys. Il s’agit d’un format textuel ASCII fixe , ce qui signifie que vous ne pouvez pas personnaliser les champs qui sont enregistrés. Les champs sont séparés par des virgules et l’heure est enregistrée en heure locale. Pour plus d'informations sur le format de fichier journal IIS, consultez IIS Log File Format (IIS 6.0).
    • NCSA : pour utiliser le format de fichier journal NCSA (National Center for Supercomputing Applications) pour enregistrer des informations relatives à un site. Ce format est géré par HTTP.sys. Il s’agit d’un format textuel ASCII fixe , ce qui signifie que vous ne pouvez pas personnaliser les champs qui sont enregistrés. Les champs sont séparés par des espaces et l’heure est enregistrée en heure locale avec le décalage par rapport au temps universel coordonné (UTC). Pour plus d'informations sur le format de fichier journal NCSA, consultez le format de fichier journal commun NCSA (IIS 6.0).
    • W3C : pour utiliser le format de fichier journal W3C centralisé afin d'enregistrer des informations relatives à tous les sites sur le serveur. Ce format est géré par HTTP.sys et il s’agit d’un format textuel ASCII personnalisable , ce qui signifie que vous spécifiez les champs à enregistrer. Spécifiez les champs à enregistrer dans la boîte de dialogue Champs de journalisation W3C en cliquant sur Sélectionner les champs sur la page Journalisation . Les champs sont séparés par des espaces et l’heure est enregistrée en temps universel coordonné (UTC). Pour plus d'informations sur le format de fichier journal W3C, consultez W3C Extended Log File Format (IIS 6.0).
    • Personnalisé : pour utiliser un format personnalisé pour un module de journalisation personnalisé. Lorsque vous sélectionnez cette option, la page Journalisation est désactivée, car la configuration de la journalisation personnalisée est impossible dans le IIS Manager. Pour plus d'informations sur l'utilisation des formats de fichier journal personnalisés, consultez Modules de journalisation personnalisés (IIS 6.0).

  5. Sous Répertoire, spécifiez le chemin d'accès où le fichier journal doit être enregistré. Par défaut, il s’agit de %SystemDrive%\inetpub\logs\LogFiles.

    Remarque

    La meilleure pratique consiste à enregistrer les fichiers journaux, comme les journaux de suivi des requêtes ayant échoué, dans un répertoire autre que %systemroot%.

  6. Dans la section Substitution de fichier journal, sélectionnez l'une des options suivantes :

    • Planification : pour créer un fichier journal basé sur l'une des valeurs suivantes :

      • Toutes les heures: un nouveau fichier journal est créé chaque heure.
      • Tous les jours: un nouveau fichier journal est créé chaque jour.
      • Toutes les semaines: un nouveau fichier journal est créé chaque semaine.
      • Tous les mois: un nouveau fichier journal est créé chaque mois.

    • Taille maximale du fichier (en octets) : pour créer un fichier journal lorsque le fichier atteint une certaine taille (en octets). La taille minimale du fichier est de 1 048 576 octets. Si cet attribut a pour valeur un nombre inférieur à 1 048 576 octets, la valeur par défaut est implicitement 1 048 576 octets.

    • Ne pas créer de fichier journal : il existe un seul fichier journal dont la capacité augmente au fur et à mesure de l'enregistrement des informations.

  7. Sélectionnez Utiliser l'heure locale pour le nommage et la substitution de fichier pour spécifier que le nommage de fichier journal et l'heure de substitution de fichier journal utilisent l'heure qu'affiche le serveur local. Si cette option n'est pas sélectionnée, utilisez le temps universel coordonné (UTC).

    Remarque

    Indépendamment de ce paramètre, les timestamps dans le fichier journal actuel utiliseront le format de l'heure pour le format de journal que vous sélectionnez dans la liste Format. Par exemple, les formats de fichier journal NCSA et W3C utilisent le format d’heure UTC pour les horodatages.

  8. Cliquez sur Appliquer dans le volet Actions.

Configurer la journalisation par site au niveau du serveur

Vous pouvez effectuer cette procédure en utilisant l'interface utilisateur (IU) ou en modifiant directement les fichiers de configuration.

Configurer la journalisation par site au niveau du serveur à l'aide de l'interface utilisateur

  1. Dans l'arborescence Connexions du IIS Manager, sélectionnez votre serveur web.

  2. Dans Affichage des fonctionnalités, double-cliquez sur Journalisation.

  3. À la page Journalisation sous Un fichier journal par site, sélectionnez Site à partir de la liste déroulante. Par défaut, sélectionnez Site.

  4. À la page Journalisation, dans la section Fichier journal sous Format, sélectionnez l'un des formats de fichier journal suivants :

    • IIS : pour utiliser le format de fichier journal Microsoft IIS pour enregistrer des informations relatives à un site. Ce format est géré par HTTP.sys. Il s’agit d’un format textuel ASCII fixe , ce qui signifie que vous ne pouvez pas personnaliser les champs qui sont enregistrés. Les champs sont séparés par des virgules et l’heure est enregistrée en heure locale. Pour plus d'informations sur le format de fichier journal IIS, consultez IIS Log File Format (IIS 6.0).
    • NCSA : pour utiliser le format de fichier journal NCSA (National Center for Supercomputing Applications) pour enregistrer des informations relatives à un site. Ce format est géré par HTTP.sys. Il s’agit d’un format textuel ASCII fixe , ce qui signifie que vous ne pouvez pas personnaliser les champs qui sont enregistrés. Les champs sont séparés par des espaces et l’heure est enregistrée en heure locale avec le décalage par rapport au temps universel coordonné (UTC). Pour plus d'informations sur le format de fichier journal NCSA, consultez le format de fichier journal commun NCSA (IIS 6.0).
    • W3C : pour utiliser le format de fichier journal W3C centralisé afin d'enregistrer des informations relatives à tous les sites sur le serveur. Ce format est géré par HTTP.sys et il s’agit d’un format textuel ASCII personnalisable , ce qui signifie que vous spécifiez les champs à enregistrer. Spécifiez les champs à enregistrer dans la boîte de dialogue Champs de journalisation W3C en cliquant sur Sélectionner les champs sur la page Journalisation . Les champs sont séparés par des espaces et l’heure est enregistrée en temps universel coordonné (UTC). Pour plus d'informations sur le format de fichier journal W3C, consultez W3C Extended Log File Format (IIS 6.0).
    • Personnalisé : pour utiliser un format personnalisé pour un module de journalisation personnalisé. Lorsque vous sélectionnez cette option, la page Journalisation est désactivée, car la configuration de la journalisation personnalisée est impossible dans le IIS Manager. Pour plus d'informations sur l'utilisation des formats de fichier journal personnalisés, consultez Modules de journalisation personnalisés (IIS 6.0).

  5. Sous Répertoire, spécifiez le chemin d'accès où le fichier journal doit être enregistré. Par défaut, il s’agit de %SystemDrive%\inetpub\logs\LogFiles.

    Remarque

    La meilleure pratique consiste à enregistrer les fichiers journaux, comme les journaux de suivi des requêtes ayant échoué, dans un répertoire autre que %systemroot%.

  6. Dans la section Substitution de fichier journal, sélectionnez l'une des options suivantes :

    • Planification : pour créer un fichier journal basé sur l'une des valeurs suivantes :

      • Toutes les heures: un nouveau fichier journal est créé chaque heure.
      • Tous les jours: un nouveau fichier journal est créé chaque jour.
      • Toutes les semaines: un nouveau fichier journal est créé chaque semaine.
      • Tous les mois: un nouveau fichier journal est créé chaque mois.

    • Taille maximale du fichier (en octets) : pour créer un fichier journal lorsque le fichier atteint une certaine taille (en octets). La taille minimale du fichier est de 1 048 576 octets. Si cet attribut a pour valeur un nombre inférieur à 1 048 576 octets, la valeur par défaut est implicitement 1 048 576 octets.

    • Ne pas créer de fichier journal : il existe un seul fichier journal dont la capacité augmente au fur et à mesure de l'enregistrement des informations.

  7. Sélectionnez Utiliser l'heure locale pour le nommage et la substitution de fichier pour spécifier que le nommage de fichier journal et l'heure de substitution de fichier journal utilisent l'heure qu'affiche le serveur local. Si cette option n'est pas sélectionnée, utilisez le temps universel coordonné (UTC).

    Remarque

    Indépendamment de ce paramètre, les timestamps dans le fichier journal actuel utiliseront le format de l'heure pour le format de journal que vous sélectionnez dans la liste Format. Par exemple, les formats de fichier journal NCSA et W3C utilisent le format d’heure UTC pour les horodatages.

  8. Cliquez sur Appliquer dans le volet Actions.

Configurer la journalisation par serveur au niveau du serveur

Vous pouvez effectuer cette procédure en utilisant l'interface utilisateur (IU) ou en modifiant directement les fichiers de configuration.

Configurer la journalisation par serveur au niveau du serveur à l'aide de l'interface utilisateur

  1. Dans l'arborescence Connexions du IIS Manager, sélectionnez votre serveur web.

  2. Dans Affichage des fonctionnalités, double-cliquez sur Journalisation.

  3. À la page Journalisation, sous Un fichier journal par site, sélectionnez Serveur depuis la liste déroulante. Par défaut, sélectionnez Site.

  4. À la page Journalisation, dans la section Fichier journal sous Format, sélectionnez l'un des formats de fichier journal suivants :

    • IIS : pour utiliser le format de fichier journal Microsoft IIS pour enregistrer des informations relatives à un site. Ce format est géré par HTTP.sys. Il s’agit d’un format textuel ASCII fixe , ce qui signifie que vous ne pouvez pas personnaliser les champs qui sont enregistrés. Les champs sont séparés par des virgules et l’heure est enregistrée en heure locale. Pour plus d'informations sur le format de fichier journal IIS, consultez IIS Log File Format (IIS 6.0).
    • NCSA : pour utiliser le format de fichier journal NCSA (National Center for Supercomputing Applications) pour enregistrer des informations relatives à un site. Ce format est géré par HTTP.sys. Il s’agit d’un format textuel ASCII fixe , ce qui signifie que vous ne pouvez pas personnaliser les champs qui sont enregistrés. Les champs sont séparés par des espaces et l’heure est enregistrée en heure locale avec le décalage par rapport au temps universel coordonné (UTC). Pour plus d'informations sur le format de fichier journal NCSA, consultez le format de fichier journal commun NCSA (IIS 6.0).
    • W3C : pour utiliser le format de fichier journal W3C centralisé afin d'enregistrer des informations relatives à tous les sites sur le serveur. Ce format est géré par HTTP.sys et il s’agit d’un format textuel ASCII personnalisable , ce qui signifie que vous spécifiez les champs à enregistrer. Spécifiez les champs à enregistrer dans la boîte de dialogue Champs de journalisation W3C en cliquant sur Sélectionner les champs sur la page Journalisation . Les champs sont séparés par des espaces et l’heure est enregistrée en temps universel coordonné (UTC). Pour plus d'informations sur le format de fichier journal W3C, consultez W3C Extended Log File Format (IIS 6.0).
    • Personnalisé : pour utiliser un format personnalisé pour un module de journalisation personnalisé. Lorsque vous sélectionnez cette option, la page Journalisation est désactivée, car la configuration de la journalisation personnalisée est impossible dans le IIS Manager. Pour plus d'informations sur l'utilisation des formats de fichier journal personnalisés, consultez Modules de journalisation personnalisés (IIS 6.0).

  5. Sous Répertoire, spécifiez le chemin d'accès où le fichier journal doit être enregistré. Par défaut, il s’agit de %SystemDrive%\inetpub\logs\LogFiles.

    Remarque

    La meilleure pratique consiste à enregistrer les fichiers journaux, comme les journaux de suivi des requêtes ayant échoué, dans un répertoire autre que %systemroot%.

  6. Dans la section Substitution de fichier journal, sélectionnez l'une des options suivantes :

    • Planification : pour créer un fichier journal basé sur l'une des valeurs suivantes :

      • Toutes les heures: un nouveau fichier journal est créé chaque heure.
      • Tous les jours: un nouveau fichier journal est créé chaque jour.
      • Toutes les semaines: un nouveau fichier journal est créé chaque semaine.
      • Tous les mois: un nouveau fichier journal est créé chaque mois.

    • Taille maximale du fichier (en octets) : pour créer un fichier journal lorsque le fichier atteint une certaine taille (en octets). La taille minimale du fichier est de 1 048 576 octets. Si cet attribut a pour valeur un nombre inférieur à 1 048 576 octets, la valeur par défaut est implicitement 1 048 576 octets.

    • Ne pas créer de fichier journal : il existe un seul fichier journal dont la capacité augmente au fur et à mesure de l'enregistrement des informations.

  7. Sélectionnez Utiliser l'heure locale pour le nommage et la substitution de fichier pour spécifier que le nommage de fichier journal et l'heure de substitution de fichier journal utilisent l'heure qu'affiche le serveur local. Si cette option n'est pas sélectionnée, utilisez le temps universel coordonné (UTC).

    Remarque

    Indépendamment de ce paramètre, les timestamps dans le fichier journal actuel utiliseront le format de l'heure pour le format de journal que vous sélectionnez dans la liste Format. Par exemple, les formats de fichier journal NCSA et W3C utilisent le format d’heure UTC pour les horodatages.

  8. Cliquez sur Appliquer dans le volet Actions.

Sélectionner les champs W3C à enregistrer

Vous pouvez effectuer cette procédure en utilisant l'interface utilisateur (IU) ou en modifiant directement les fichiers de configuration.

Pour sélectionner les champs W3C à enregistrer à l'aide de l'interface utilisateur

  1. Dans Affichage des fonctionnalités de IIS Manager, double-cliquez sur Journalisation.

  2. À la page Journalisation, à la section Fichier journal sous Format, cliquez sur Sélectionnez les champs.

  3. Dans la boîte de dialogue Journalisation des champs W3C, sélectionnez une ou plusieurs des options suivantes :

    • Date (date) : la date à laquelle la requête a été formulée.
    • Heure (heure) : l'heure, en temps universel coordonné (UTC), à laquelle la requête a été formulée.
    • Adresse IP du client (c-ip) : l'adresse IP du client qui a formulé la requête.
    • Nom d'utilisateur (nom d'utilisateur cs) : le nom de l'utilisateur authentifié qui a accédé à votre serveur. Les utilisateurs anonymes sont indiqués par un trait d'union.
    • Nom du service (nom du site s) : le numéro d'instance du site qui a répondu à la requête.
    • Nom du serveur (nom de l'ordinateur s) : le nom du serveur sur lequel l'entrée du fichier journal a été générée.
    • Adresse IP du serveur (s-ip) : l'adresse IP du serveur sur lequel l'entrée du fichier journal a été générée.
    • Port du serveur (port en s) : le numéro de port du serveur configuré pour le service.
    • Méthode (méthode cs) : l'action demandée, par exemple une méthode GET.
    • Ressource URI (ressource cs-uri) : l'identificateur universel de ressources (Universal Resource Identifier), ou la cible, de l'action.
    • Requête URI (requête cs-uri) : la requête que le client essayait d'effectuer,le cas échéant. Une requête URI est nécessaire uniquement pour les pages dynamiques.
    • État du protocole (état sc) : le code d'état de HTTP ou de FTP.
    • Sous-état du protocole (sous-état sc) : le code du sous-état de HTTP ou de FTP.
    • État Win32 (état sc-win32) : code d'état Windows.
    • Octets envoyés (sc-bytes) : nombre d'octets envoyés par le serveur.
    • Octets reçus (cs-bytes) : nombre d'octets reçus par le serveur.
    • Durée (time-taken) : durée nécessaire à l'exécution de l'action (en millisecondes).
    • Version du protocole (cs-version) : version du protocole utilisée par le client.
    • Hôte (cs-host) : nom d'hôte, le cas échéant.
    • Agent utilisateur (cs(UserAgent)) : type de navigateur utilisé par le client.
    • Cookie (cs(Cookie)) : contenu du cookie envoyé ou reçu, le cas échéant.
    • Référent (cs(Referer)) : dernier site visité par l'utilisateur. Ce site a fourni un lien vers le site actuel.

  4. Cliquez sur Appliquer dans le volet Actions.

Configurer les options de substitution de fichier journal

Vous pouvez effectuer cette procédure en utilisant l'interface utilisateur (IU) ou en modifiant directement les fichiers de configuration.

Pour configurer les options de substitution de fichier journal à l'aide de l'interface utilisateur

  1. Dans Affichage des fonctionnalités de IIS Manager, double-cliquez sur Journalisation.

  2. À la page Journalisation, dans la section Substitution de fichier journal, sélectionnez l'une des options suivantes :

    • Planification : pour créer un fichier journal basé sur l'une des valeurs suivantes :

      • Toutes les heures: un nouveau fichier journal est créé chaque heure.
      • Tous les jours: un nouveau fichier journal est créé chaque jour.
      • Toutes les semaines: un nouveau fichier journal est créé chaque semaine.
      • Tous les mois: un nouveau fichier journal est créé chaque mois.

    • Taille maximale du fichier (en octets) : pour créer un fichier journal lorsque le fichier atteint une certaine taille (en octets). La taille minimale du fichier est de 1 048 576 octets. Si cet attribut a pour valeur un nombre inférieur à 1 048 576 octets, la valeur par défaut est implicitement 1 048 576 octets.

    • Ne pas créer un nouveau fichier journal : il existe un seul fichier journal dont la capacité continue d'augmenter à mesure que des informations sont enregistrées. Si vous utilisez un seul fichier journal pour votre site, ce dernier est utile lorsque vous utilisez des utilitaires d'analyse de journal, mais il crée également des fichiers journaux volumineux qui peuvent affecter les performances globales du serveur.

  3. Sélectionnez Utiliser l'heure locale pour le nommage et la substitution de fichier pour spécifier que le nommage de fichier journal et l'heure de substitution de fichier journal utilisent l'heure qu'affiche le serveur local. Si cette option n'est pas sélectionnée, utilisez le temps universel coordonné (UTC).

    Remarque

    Indépendamment de ce paramètre, les timestamps dans le fichier journal actuel utiliseront le format de l'heure pour le format de journal que vous sélectionnez dans la liste Format. Par exemple, les formats de fichier journal NCSA et W3C utilisent le format d’heure UTC pour les horodatages.

  4. Cliquez sur Appliquer dans le volet Actions.

Voir aussi