Journalisation améliorée pour IIS 8.5

par Gary Ericson

Dans IIS 8.5, l’administrateur a la possibilité de journaliser des champs personnalisés supplémentaires à partir d’en-têtes de requête ou de réponse, ou à partir de variables de serveur.

Compatibilité

Version Notes
IIS 8.5 et versions ultérieures La journalisation améliorée a été introduite dans IIS 8.5.
IIS 8.0 et versions antérieures La journalisation améliorée n’a pas été prise en charge avant IIS 8.5.

Problème

Internet Information Services (IIS) sur Windows Server 2012 fournit des fonctionnalités de journalisation limitées pour un ensemble fixe de champs standard, sans options d’extensibilité ou de personnalisation pour la journalisation. Les administrateurs qui doivent journaliser les champs au-delà de cet ensemble standard doivent créer un module de journalisation personnalisé.

Solution

Dans IIS 8.5 et versions ultérieures, l’administrateur a la possibilité de journaliser des champs personnalisés supplémentaires à partir d’en-têtes de requête ou de réponse, ou à partir de variables de serveur.

Instructions pas à pas

Configurer la journalisation améliorée pour IIS 8.5 et versions ultérieures

  1. Ouvrez le Gestionnaire IIS.
  2. Sélectionnez le site ou le serveur dans le volet Connexions , puis double-cliquez sur journalisation. Notez que la journalisation améliorée est disponible uniquement pour la journalisation au niveau du site. Si vous sélectionnez le serveur dans le volet Connexions , la section Champs personnalisés de la boîte de dialogue boîte de dialogue De journalisation W3C est désactivée.
  3. Dans le champ Format de sous fichier journal, sélectionnez W3C, puis cliquez sur Sélectionner des champs....
    Select fields
  4. Dans la boîte de dialogue champs de journalisation W3C , cliquez sur Ajouter un champ.... Notez que la journalisation améliorée est disponible uniquement pour la journalisation au niveau du site. Si vous avez sélectionné le serveur dans le volet Connexions , Ajouter un champ... est désactivé.
    Add custom fields
  5. Dans la boîte de dialogue Ajouter un champ personnalisé , entrez un nom de champ pour identifier le champ personnalisé dans le fichier journal. Notez que le nom du champ ne peut pas contenir d’espaces.
  6. Sélectionnez le type de source . Vous pouvez sélectionner 'en-tête de requête, 'en-tête de réponseou variable serveur (notez que la journalisation améliorée ne peut pas journaliser une variable serveur avec un nom contenant des caractères minuscules, pour inclure une variable serveur dans le journal des événements, assurez-vous simplement que son nom se compose de tous les caractères majuscules).
  7. Sélectionnez Source, qui est le nom de l’en-tête HTTP ou de la variable de serveur (selon le type de source que vous avez sélectionné) qui contient une valeur que vous souhaitez journaliser. Vous pouvez également entrer votre propre chaîne source personnalisée. Par exemple, pour enregistrer l’en-tête HTTP personnalisé « X-FORWARDED-FOR », entrez cette chaîne dans source .
    Enter custom source
  8. Cliquez sur OK.
  9. Cliquez sur Ajouter un champ... pour chaque champ personnalisé supplémentaire que vous souhaitez ajouter. Vous pouvez également cliquer sur Supprimer le champ pour supprimer un champ personnalisé que vous avez ajouté ou cliquer sur Modifier le champ... pour le modifier.
  10. Cliquez sur OK.
  11. Cliquez sur Appliquer dans le volet Actions pour appliquer la nouvelle configuration.

Une fois les champs personnalisés configurés, IIS crée des fichiers journaux texte avec « _x » ajouté au nom de fichier pour indiquer que le fichier contient des champs personnalisés.

Notez que la taille totale des données collectées à partir de tous les champs personnalisés ne peut pas dépasser 65 536 octets. Si le total dépasse 65 536 octets, IIS tronque les données.

Résumé

Dans ce guide, vous avez configuré IIS pour ajouter des champs personnalisés aux journaux IIS.