Informations sur le site Web

Vous pouvez obtenir diverses informations sur le fonctionnement de votre site Web 4D :

• Vous pouvez contrôler le site par l’intermédiaire d’URL particuliers (/4DSTATS, /4DHTMLSTATS, /4DCACHECLEAR et /4DWEBTEST).
• Vous pouvez générer un historique des requêtes.
• Vous pouvez visualiser la charge du serveur Web dans la page "Evaluation" de l'Explorateur d'exécution de 4D.

Note : Pour des raisons de sécurité, à compter de 4D v15 R2, la méthode HTTP TRACE est désactivée par défaut dans le serveur Web de 4D. Cela signifie que lorsqu'il reçoit une requête HTTP TRACE, le serveur Web de 4D retourne désormais une erreur 405 ("méthode non autorisée"). Si vous souhaitez autoriser explicitement la méhode HTTP TRACE, vous devez utiliser l'option Web HTTP TRACE avec la commande WEB SET OPTION. 

Le serveur Web 4D accepte quatre URLs particuliers : /4DSTATS, /4DHTMLSTATS, /4DCACHECLEAR et /4DWEBTEST.

• /4DSTATS, /4DHTMLSTATS et /4DCACHECLEAR sont accessibles uniquement au Super_Utilisateur et à l’Administrateur de la base. Si la base ne comporte pas de système de mots de passe 4D, ces URLs sont accessibles à tout utilisateur.
• /4DWEBTEST est toujours accessible.

L’URL /4DSTATS renvoie plusieurs informations sous la forme d'un tableau HTML (affichable dans un navigateur) :

• Cache Current Size : taille courante du cache du serveur Web (en octets)
• Cache Max Size : taille maximale du cache (en octets)
• Cached Object Max Size : taille maximum de chaque objet dans le cache (en octets)
• Cache Use : pourcentage du cache utilisé
• Cached Objects : nombre d’objets (pages, fichiers image...) présents dans le cache.

Pour plus d’informations sur le cache des pages statiques et des images, reportez-vous à la section Paramétrages du serveur Web.

Ces informations peuvent vous permettre de contrôler le fonctionnement de votre serveur et éventuellement d’adapter les paramètres correspondants.

Note : La commande WEB GET STATISTICS vous permet également d’obtenir des informations sur l’utilisation du cache pour les pages statiques.

L’URL /4DHTMLSTATS renvoie, également sous forme de tableau HTML, les mêmes informations que l’URL /4DSTATS, à la différence près que le champ Cached Objects ne dénombre que les pages HTML (sans les fichiers image). En outre, cet URL retourne le champ Filtered Objects.

• Filtered Objects : nombre d’objets du cache non comptabilisés par l’URL, notamment les images.

L’URL /4DCACHECLEAR provoque l’effacement immédiat du cache des pages statiques et des images. Il permet donc de “forcer” la mise à jour de pages ayant été modifiées.

L'URL /4DWEBTEST permet de contrôler le statut du serveur Web. Lorsque cet URL est appelé, 4D retourne un fichier texte contenant les champs HTTP suivants :

• Date : date du jour au format RFC 822
  Exemple : “Mon, 16 Jan 2012 13:12:50 GMT”
• Server : 4D_version/numéro de version interne
  Exemple : “4D_v12/12.3.0”
• User-Agent : nom et version @ adresse IP du client
  Exemple : “Mozilla/5.0 (Windows NT 6.1; WOW64; rv:9.0.1) Gecko/20100101 Firefox/9.0.1 @ 127.0.0.1

4D vous permet de générer un historique des requêtes.

Ce fichier est nommé “logweb.txt” et est automatiquement placé :

• avec 4D en mode local et 4D Server, dans le dossier Logs situé à côté du fichier de structure de la base.
• avec 4D en mode distant, dans le sous-dossier Logs du dossier base 4D client (dossier de cache).

L’activation et la configuration du contenu du fichier d’historique s’effectue dans les Propriétés de la base, page Web/Journal (Format) :

Note : L’activation et la désactivation du fichier d’historique des requêtes peut également être effectuée par programmation, à l’aide de la commande SET DATABASE PARAMETER (4D v12) ou WEB SET OPTION (4D v13 et suivantes).

Le menu de format du journal propose les options suivantes :

• Pas de journal : lorsque cette option est sélectionnée, 4D ne génère pas d’historique des requêtes.
• CLF (Common Log Format) : lorsque cette option est sélectionnée, l’historique des requêtes est généré au format CLF. Avec le format CLF, chaque ligne du fichier représente une requête sous la forme :
  hôte rfc931 utilisateur [JJ/MMM/AAAA:HH:MM:SS] "requête" statut longueur
  Chaque champ est séparé par un espace, chaque ligne se termine par la séquence CR/LF (caractère 13, caractère 10).
  
  • hôte : adresse IP du client (ex. 192.100.100.10)
  • rfc931 : information non gérée par 4D, c’est toujours - (signe moins)
  • utilisateur : nom de l’utilisateur tel qu’il s’est authentifié, sinon - (signe moins). Si le nom de l’utilisateur contient des espaces, ils sont remplacés par des _ (tiret bas).
  • JJ : jour, MMM : mois abrégé en 3 lettres et toujours en anglais (Jan, Feb, ...), AAAA : année, HH : heure, MM : minutes, SS : secondes
  La date et l’heure sont locales au serveur
  • requête : requête envoyée par le client (ex. GET /index.htm HTTP/1.0)
  • statut : réponse donnée par le serveur.
  • longueur : taille des données renvoyées (hors en-tête HTTP) ou 0.
  Les valeurs possibles de statut sont :
  200 : OK
  204 : Pas de contenu
  302 : Redirection
  400 : Mauvaise requête
  401 : Authentification requise
  404 : Non trouvé
  500 : Erreur interne
  Le format CLF ne peut pas être personnalisé.

• DLF (Combined Log Format) : lorsque cette option est sélectionnée, l’historique des requêtes est généré au format DLF. Le format DLF est semblable au format CLF dont il reprend exactement la structure. Il contient simplement deux champs HTTP supplémentaires à la fin de chaque requête : Referer et User-agent.
  
  • Referer : contient l’URL de la page pointant vers le document demandé.
  • User-agent : contient le nom et la version du navigateur ou du logiciel client à l’origine de la requête.
  Le format DLF ne peut pas être personnalisé.

• ELF (Extended Log Format) : lorsque cette option est sélectionnée, l’historique des requêtes est généré au format ELF. Le format ELF est largement répandu dans le monde des serveurs HTTP. Il permet de construire des historiques sophistiqués, répondant à des besoins spécifiques. Pour cette raison, le format ELF est personnalisable : il est possible de choisir les champs à enregistrer ainsi que leur ordre d’insertion dans le fichier.

• WLF (WebStar Log Format) : lorsque cette option est sélectionnée, l’historique des requêtes est généré au format WLF. Le format WLF a été développé spécifiquement pour le serveur 4D WebSTAR. Il est semblable au format ELF, il dispose simplement de champs supplémentaires. Comme le format ELF, il est personnalisable.

Configurer les champs
Lorsque vous choisissez le format ELF (Extended Log Format) ou WLF (WebStar Log Format), la zone “Formatage du journal” affiche les champs disponibles pour le format. Vous devez sélectionner chaque champ à inclure dans l’historique. Pour cela, utilisez les flèches de commande ou procédez par glisser-déposer.

Note : Il n’est pas possible de sélectionner deux fois le même champ.

Le tableau suivant liste les champs disponibles pour chaque format (par ordre alphabétique) et décrit son contenu :

Note : La date et l’heure sont indiquées en GMT.

Le fichier d’historique des requêtes Web pouvant atteindre une taille importante, il est possible de mettre en place un mécanisme d’archivage automatique. Le déclenchement de l’archivage peut être basé sur un délai (exprimé en heures, jours, semaines ou mois) ou une taille de fichier ; à chaque échéance, 4D referme et archive automatiquement le fichier d’historique courant et en crée un nouveau.
Lorsque l’archivage du ficher d’historique se déclenche, le fichier d’historique est archivé dans un dossier nommé “Logweb Archives”, créé au même niveau que le fichier logweb.txt (c’est-à-dire à côté du fichier de structure de la base).
Le fichier archivé est renommé sur le modèle “DAAAA_MM_JJ_Thh_mm_ss.txt”. Par exemple, pour un fichier archivé le 4 septembre 2006 à 15 heures 50 minutes et 7 secondes : “D2006_09_04_T15_50_07.txt”

Les paramètres d’archivage automatique de l’historique des requêtes sont définis dans la page Web/Journal (Périodicité) des Propriétés de la base :

Vous devez dans un premier temps choisir une échelle de fréquence (jours, semaines...) ou le critère de taille limite en cliquant sur le bouton radio correspondant. Vous devez ensuite éventuellement préciser le moment de la sauvegarde.

• Pas de sauvegarde du journal : la fonction de sauvegarde périodique est inactivée.
• Toutes les N heure(s) : cette option permet de programmer la sauvegarde sur une base horaire. Vous pouvez saisir une valeur comprise entre 1 et 24.
  
  • à partir de : permet de définir l’heure à laquelle débutera la première sauvegarde horaire.
• Tous les N jour(s) à N : cette option permet de programmer la sauvegarde sur une base journalière. Saisissez 1 si vous souhaitez une sauvegarde quotidienne. Lorsque vous cochez cette option, vous devez indiquer l’heure à laquelle la sauvegarde doit être déclenchée.
• Toutes les N semaine(s), jour à N : cette option permet de programmer la sauvegarde sur une base hebdomadaire. Saisissez 1 si vous souhaitez une sauvegarde hebdomadaire. Lorsque vous cochez cette option, vous devez indiquer le ou les jour(s) de la semaine et l’heure à laquelle chaque sauvegarde doit être déclenchée. Vous pouvez cocher un ou plusieurs jour(s) de la semaine. Par exemple, vous pouvez utiliser cette option pour définir deux sauvegardes hebdomadaires : une le mercredi et une le vendredi.
• Tous les N mois, Ne jour à N : cette option permet de programmer la sauvegarde sur une base mensuelle. Saisissez 1 si vous souhaitez une sauvegarde mensuelle. Lorsque vous cochez cette option, vous devez indiquer le jour de chaque mois auquel la sauvegarde doit être déclenchée,
  ainsi que l’heure de déclenchement. 
• Tous les N Mo : cette option permet de programmer la sauvegarde sur la base de la taille du fichier d’historique des requêtes courant. La sauvegarde est automatiquement déclenchée lorsque le fichier atteint la taille définie. Vous pouvez fixer une taille limite de 1, 10, 100 ou 1000 Mo.

Note : En cas de sauvegarde périodique, si le serveur Web n’était pas lancé au moment théorique de la sauvegarde, 4D considère au lancement suivant que la sauvegarde a échoué et applique les paramétrages adéquats, définis dans les Propriétés.

La page Evaluation (rubrique “Web”) de l’Explorateur d’exécution affiche différentes informations concernant le fonctionnement du serveur Web 4D, notamment :

• Occupation du cache Web : indique le nombre de pages présentes dans le cache Web ainsi que son pourcentage d’utilisation. Cette information n’est disponible que si le serveur Web est actif et si la taille du cache est différente de 0.
• Temps d’activité du serveur Web : indique la durée de fonctionnement (au format heures:minutes:secondes) du serveur Web. Cette information n’est disponible que si le serveur Web est actif.
• Nombre de requêtes http : indique le nombre total de requêtes HTTP reçues depuis le démarrage du serveur Web, ainsi que le nombre instantané de requêtes par secondes (mesure prise entre deux mises à jour de l’Explorateur d’exécution). Cette information n’est disponible que si le serveur Web est actif.