Partager via

Configuration de la journalisation des erreurs de l’API de serveur HTTP

  • Article

La journalisation des erreurs de l’API serveur HTTP est contrôlée par trois valeurs de registre sous une clé HTTP\Parameters située à l'emplacement suivant :

HKEY_LOCAL_MACHINE
   System
      CurrentControlSet
         Services
            HTTP
               Parameters

Remarque

L’emplacement et la forme des valeurs de configuration peuvent changer dans les futures versions du système d’exploitation Windows.

L'utilisateur doit disposer de privilèges Administrateur/Système local pour modifier les valeurs du registre ainsi que pour afficher ou modifier les fichiers journaux et le dossier qui les contient.

Les informations de configuration dans les valeurs de registre sont lues lorsque le pilote d’API HTTP Server est démarré. Par conséquent, si les paramètres sont modifiés, le pilote doit être arrêté et redémarré pour lire les nouvelles valeurs. Pour ce faire, utilisez les commandes de console suivantes :

net stop http

net start http

Les fichiers journaux suivent la convention de nommage suivante :

httperr + SequenceNumber + .log

Par exemple : « httperr4.log ».

Les fichiers journaux sont cyclées lorsqu’ils atteignent la taille maximale spécifiée par la valeur de registre ErrorLogFileTruncateSize. Cette valeur ne doit être d'au moins un mégaoctet (Mo).

Si la configuration de la journalisation des erreurs n’est pas valide ou si un type d’échec se produit lors de l’écriture dans les fichiers journaux, l’API HTTP Server utilise la journalisation des événements pour informer les administrateurs que la journalisation des erreurs n’a pas eu lieu.

Les valeurs de configuration du registre sont décrites dans le tableau suivant.

Valeur de Registre Description
EnableErrorLogging Un DWORD qui peut être mis à 1 (signifie Vrai) pour activer le journal des erreurs, ou à 0 (signifie Faux) pour le désactiver. La valeur par défaut est 1.
ErrorLogFileTruncateSize Un DWORD qui spécifie la taille maximale d'un fichier journal des erreurs, en octets. La valeur par défaut est un octet (0x100000).
Remarque : La valeur indiquée ne peut pas être inférieure à la valeur par défaut.
ErrorLoggingDir Une chaîne qui indique le dossier dans lequel l'API HTTP Server place ses fichiers de journalisation.
L’API HTTP Server crée un sous-dossier nommé « HTTPERR » sous le dossier dans lequel les fichiers journaux sont placés. Ce sous-dossier et les fichiers journaux reçoivent les mêmes paramètres d’autorisation. Par conséquent, les comptes d’administrateur et de système local disposent d’un accès complet, tandis que d’autres utilisateurs n’y ont pas accès.
Si un dossier n’est pas spécifié dans le registre, le dossier par défaut est le suivant :
"%SystemRoot%\System32\LogFiles"
Remarque : La valeur de chaîne ErrorLoggingDir doit être un chemin complet, mais elle peut contenir « %SystemRoot% ».