Modification des paramètres du journal

Les fichiers journaux du serveur d'administration enregistrent les données relatives au serveur, y compris le type des erreurs et les informations sur l'accès au serveur. La consultation de ces journaux permet de surveiller l'activité du serveur et de résoudre les problèmes en fournissant des données comme le type d'erreur rencontré et l'heure à laquelle certains fichiers ont été ouverts.

Types de journal

Il existe deux grandes catégories de journaux :

  1. Journal d'accès – Le journal d'accès enregistre des informations sur les requêtes envoyées au serveur et sur les réponses obtenues.

  2. Journal du serveur — Le journal du serveur garde la liste de toutes les erreurs rencontrées par le serveur depuis la création du fichier de journal. Il contient également des messages d'information concernant le serveur, par exemple quand le serveur a été lancé et qui n'a pas réussi à se connecter au serveur.

Configuration des paramètres du journal

Pour activer et modifier les paramètres du journal pour une configuration, effectuez les tâches suivantes :

  1. Cliquez sur l'onglet Configuration

  2. Sélectionnez la configuration à partir de laquelle vous devez activer/modifier les paramètres du journal.

  3. Cliquez sur Paramètres généraux > onglet Préférences du journal d'accès

Modification des préférences du journal d’accès

Le tableau suivant décrit les champs de la section Préférences du journal d'accès :

Tableau 20 Description des champs > Préférences du journal d'accès

Champ

Description

Activer

Activé/Désactivé. Par défaut, le journal d'accès est désactivé. Sélectionnez cette option pour activer le journal d'accès. Notez que l'activation du journal d'accès dégrade les performances du serveur à une magnitude faible.

Emplacement du journal d'accès

Chemin d'accès au serveur, dans lequel les fichiers du journal d'accès sont stockés. La valeur par défaut est ../logs/access

Format du journal d'accès

  1. Utilisez Format de Journal Courant — Cette option est le type de format par défaut du fichier de journal. Le serveur consigne les informations les plus pertinentes extraites des en-têtes de la requête. Le format de Journal Courant est IP Address - user [date] "request" status content-length

  2. Saisissez uniquement ces détails — Vous ne pouvez saisir que des valeurs spécifiques à partir de l'en-tête de demande en utilisant cette option. Par exemple, vous ne pouvez saisir que le nom d'utilisateur client et les statuts HTTP.

    Sélectionnez les options disponibles sur cette page pour inclure le rapport de journal.

    Vous pouvez également configurer manuellement le format du journal en utilisant l'option Personnaliser le format du journal.

Modification des préférences du journal du serveur

Les champs de la section Préférences du journal du serveur sont décrits dans le tableau suivant :

Tableau 21 Description de champ > Préférences du journal du serveur

Champ

Description

Emplacement du journal du serveur

Le chemin d'accès du serveur, où les fichiers de journal du serveur seront stockés. La valeur par défaut est ../logs/errors

Niveau de verbosité du journal

Cette option constitue une manière élégante de définir la granularité du journal. Lors du test et du débogage d'applications Web, le niveau recommandé est Le plus fin .

Pour l'environnement de production, le niveau de journal recommandé est échec ou sécurité. Le niveau catastrophe consigne très peu de détails.

Nom du journal du serveur virtuel

Si cette option est sélectionnée, outre les erreurs, le nom du serveur virtuel qui traite la requête est également consigné.

Données du journal d'application écrites sur stderr

Si cette option est sélectionnée, les exceptions générées par les applications Web déployées sont consignées, si elles sont écrites sur stderr.

Cette option est activée par défaut.

Données du journal d'application écrites sur la console

Si cette option est sélectionnée, les exceptions générées par les applications Web déployées sont consignées, si elles sont écrites sur la console.

Cette option est activée par défaut.

Format de la date

Format d'heure utilisé pour ajouter des horodatages aux messages d'erreur. La valeur par défaut est [%d/%b/%Y:%H:%M:%S]

Archivage des fichiers journaux

Vous pouvez paramétrer l'archivage de vosfichiers journaux pour les archiver automatiquement. A un moment donné, ou après un intervalle spécifié, le serveur exécute la rotation de vos journaux d'accès. Le serveur enregistre les anciens fichiers journaux et marque le fichier sauvegardé par un nom qui inclut la date et l'heure de l'enregistrement.

Par exemple, vous pouvez configurer vos fichiers sur une rotation horaire ; le serveur enregistre et nomme le fichier "access.199907.0152400," où les éléments "name|year|month|day|24-hour time" sont concaténés en une chaîne de caractères unique. Le format exact du fichier archive du journal d'accès varie en fonction du type de rotation de journal configuré.

La rotation du journal d'accès est initialisée au démarrage du serveur. Si la rotation est activée, le serveur crée un fichier de journal d'accès horodaté et la rotation débute au démarrage du serveur.

Une fois la rotation commencée, le serveur crée un nouveau fichier journal d'accès avec horodatage lorsqu'une requête doit être consignée dans le fichier journal d'accès et que cela se produit après « l'heure de rotation suivante » précédemment planifiée.

Définition de la rotation du journal

Cliquez sur le bouton Effectuer la rotation des journaux pour archiver immédiatement les fichiers journaux. La rotation est exécutée et le journal est enregistré sous le format suivant : <nom du fichier original> .<AAAA.MM.JJ.HHMM>.

Vous pouvez également créer une planification de la rotation du journal d'accès/de serveur pour les instances configurées à l'aide de l'option de rotation de journal. Pour configurer la rotation du journal, effectuez les étapes suivantes :

  1. Cliquez sur l'onglet Configuration

  2. Sélectionnez la configuration à partir de laquelle vous devez activer/modifier les paramètres du journal.

  3. Cliquez sur Paramètres généraux > onglet Préférences du journal d'accès

  4. Cliquez sur le bouton Nouveau sous la section Consigner l'archivage

Commande d'archivage : Vous pouvez spécifier le chemin absolu de la commande après la rotation du fichier journal par le serveur. Le nom post-rotation du fichier journal est transféré en tant qu'argument à la commande d'archivage. Cette dernière compresse également le fichier journal concerné par la rotation.

La section suivante décrit les champs de la page de rotation du journal :

Tableau 22 Description des champs > Définition de la rotation du journal

Champ

Description

Événement

Rotation du journal d'accès / Rotation du journal de serveur. Sélectionnez l'une de ces options ou les deux pour configurer la rotation de ce type de journal.

Heure

Heure configurée à laquelle l'événement va démarrer. Sélectionnez l'heure et les minutes dans la zone de liste déroulante.

Chaque jour — Démarre l'événement spécifié chaque jour à l'heure définie.

Jours spécifiques — Démarre l'événement spécifié aux jours définis.

1. Jours — Spécifiez un jour compris entre dimanche et samedi.

2. Dates — Spécifiez les jours du mois compris entre 1 et 31 sous forme d'entrées séparées par une virgule. Par exemple, 4,23,9

Mois spécifiques — Démarre l'événement spécifié à l'heure et au mois définis. Spécifiez un mois compris entre janvier et décembre.

Intervalle

Démarre l'événement spécifié après cette période.

1. Toutes les heures — Sélectionnez le nombre d'heures dans la zone de liste déroulante.

2. Toutes les secondes — Sélectionnez le nombre de secondes dans la zone de liste déroulante.

Si vous souhaitez supprimer la rotation planifiée du journal, cliquez sur le bouton Supprimer dans la section Consigner l'archivage.