4D v16.3

Page Web/Journal (format)

Accueil

 
4D v16.3
Page Web/Journal (format)

Page Web/Journal (format)  


 

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 :

ChampELFWLFValeur
BYTES_RECEIVEDXNombre d’octets reçus par le serveur
BYTES_SENTXXNombre d’octets envoyés par le serveur au client
C_DNSXXAdresse IP du DNS (ELF : champ identique au champ C_IP)
C_IPXXAdresse IP du client (par exemple 192.100.100.10)
CONNECTION_IDXNuméro unique de la connexion
CS(COOKIE)XXInformations sur les cookies contenus dans la requête HTTP
CS(HOST)XXChamp Host de la requête HTTP
CS(REFERER)XXURL de la page pointant vers le document demandé
CS(USER_AGENT)XXInformations sur le logiciel et le système d’exploitation du client
CS_SIPXXAdresse IP du serveur
CS_URIXXURI sur lequel la requête est effectuée
CS_URI_QUERYXXParamètres d’interrogation de la requête
CS_URI_STEMXXPartie de la requête sans les paramètres d’interrogation
DATEXXDD: jour, MMM: abréviation de 3 lettres pour le mois (Jan, Feb,...), YYYY: année
METHODXXMéthode HTTP utilisée pour la requête adressée au serveur
PATH_ARGSXParamètres de la CGI : chaîne située après le caractère “$”
STATUSXXRéponse fournie par le serveur
TIMEXXHH: heure, MM: minutes, SS: secondes
TRANSFER_TIMEXXDélai ayant été nécessaire au serveur pour générer la réponse
USERXXNom d’utilisateur s’il s’est authentifié, sinon - (signe moins). Si le nom d’utilisateur contient des espaces, ils sont remplacés par des _ (traits de soulignement)
URLXURL demandé par le client

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



Voir aussi  

Page Web/Journal (périodicité)

 
PROPRIÉTÉS 

Produit : 4D
Thème : Propriétés de la base

 
HISTORIQUE 

 
UTILISATION DE L'ARTICLE

4D - Mode Développement ( 4D v16)
4D - Mode Développement ( 4D v16.1)
4D - Mode Développement ( 4D v16.3)