DocumentationAPI de diffusion et de rendu d’images Dynamic Media

Journalisation des accès access-logging

Last update: Mon Jul 22 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Développeur
  • Administration
  • Utilisateur ou utilisatrice

Utilisez ces paramètres de serveur pour l’accès à la journalisation.

Syntaxe

TC::directory - Log File Folder section-5d9e2168d4504bbe9868b7d6051c9d67

Le dossier dans lequel Platform Server écrit les fichiers journaux. Il peut s’agir d’un chemin absolu ou d’un chemin relatif à install_folder. La valeur par défaut est ​ install_folder/logs.

NOTE
Le nouveau dossier doit être créé avant de modifier ce paramètre. Assurez-vous que le dossier dispose des droits d’accès en lecture/écriture corrects si le serveur d’images est installé pour s’exécuter sous un compte utilisateur autre que root.

TC::maxDays - Nombre de jours pour conserver les fichiers journaux section-45cbecffc5694c87b7d5c176a44a4885

Le nombre de jours pendant lesquels les fichiers journaux doivent être conservés. De nouveaux fichiers journaux sont créés tous les jours à minuit. Actuellement, le serveur supprime tous les fichiers du dossier de fichiers journaux qui sont antérieurs au nombre de jours spécifié, y compris ceux écrits par le serveur d’images ou le serveur de rendu. Par défaut : 10.

TC::prefix - Nom du fichier journal d’accès section-1003856323b844049632710a5a056aa7

Préfixe du nom du fichier auquel les données du journal d’accès sont écrites. La date et le suffixe de fichier ( ​ yyyy-mm-dd.log) sont ajoutés à la chaîne spécifiée. Le nom du fichier journal d’accès doit être différent de celui du fichier journal de trace. La valeur par défaut est " access-".

TC::pattern - Modèle de journal d’accès section-22775ea85cee444d8a7d7336a3b1feef

Spécifie le modèle de données pour les enregistrements de journaux d’accès Platform Server. La chaîne de modèle spécifie les variables qui sont remplacées par leurs valeurs correspondantes. Tous les autres caractères de la chaîne de modèle sont transférés littéralement vers l’enregistrement de journal.

Pour utiliser l’utilitaire de nettoyage du cache, les espaces doivent être utilisés comme séparateurs de champ. Platform Server remplace tous les espaces et les caractères '%' dans les valeurs de champ par %20 et %25, respectivement.

Les variables de modèle suivantes sont prises en charge :

Modèle
Description
%a
Adresse IP distante.
%A
Adresse IP locale.
%b
Nombre d’octets de réponse à l’exclusion des en-têtes HTTP ou ' si zéro.
%B
Nombre d’octets de réponse à l’exception des en-têtes HTTP.
%D
Temps de traitement des demandes en millisecondes.
%I
id de thread (pour les entrées de journal de débogage/erreur de référencement croisé).
%G

date et heure, au format aaaa - MM - dd HH : mm : ss . SSS offset

( SSS est en ms, offset est le décalage horaire GMT) ; la valeur de temps est capturée lorsque la réponse est envoyée au client.

%m
Méthode de requête ( GET , POST , etc.).
%O
Superposition des requêtes (nombre de requêtes traitées simultanément).
%p
Port local sur lequel cette demande a été reçue.
%q
Chaîne de requête (précédée d’un caractère '?' s’il existe).
%r
Première ligne de requête (méthode de requête, URI, version HTTP).
%R
Identique à %r , mais applique un codage HTTP limité à l’URI pour éviter les problèmes d’analyse des journaux.
%s
Code d’état de réponse HTTP.
%S
ID de session utilisateur.
%t
Date et heure, au format de journal commun.
%u
Utilisateur distant authentifié (le cas échéant), sinon "".
%U
chemin d’accès URI.
%v
Nom du serveur local.
%T
Temps de traitement des demandes en secondes.
%{CacheKey}r
Platform Server clé de cache (nom/dossier de fichier de cache).
%{CacheUse}r
Platform Server mot-clé de gestion du cache : { REUSED | CREATED | MISE À JOUR | REMOTE | REMOTE_CREATED | REMOTE_UPDATED | REMOTE_CACHE | VALIDÉ | IGNORÉ | UNDEFINED } .
%{ContentType}r
Type MIME de réponse.
%{Context}r
Contexte de destination si un contexte se produit vers l’avant.
%{Digest}r
La valeur de l’en-tête de réponse etag (signature MD5 des données de réponse).
%{Exception}r
Message d’erreur.
%{FetchTime}r
Temps nécessaire pour récupérer l’entrée ou les données du cache à partir du serveur d’images.
%{ParseTime}r
Temps nécessaire pour l’analyse des demandes et la recherche de catalogue d’images.
%{PathBasedAccess}r
Indique si cette requête a tenté ou non un accès basé sur un chemin en dehors du système de catalogue.
%{PeerServer}r
Adresse IP du serveur homologue dans la grappe de cache qui a fourni l’entrée de cache ou "-" si CacheUse n’est pas REMOTE_CREATED ni REMOTE_UPDATED .
%{ProcessingStatus}r

Catégorie d'erreur :

  • 0 = aucune erreur.

  • 1 = image(s) introuvable sur le serveur.

  • 2 = Erreur d’utilisation du protocole IS ou erreur de contenu autre que 1.

  • 3 = autre erreur du serveur.

  • 4 = demande refusée en raison d’une surcharge temporaire du serveur.

%{ReqType}r
La valeur supérieure de req= .
%{RootId}r
ID racine du catalogue principal de la requête.
%{SendTime}r
Le temps nécessaire à Platform Server pour envoyer une réponse après avoir écrit des données dans le flux de sortie.
%{Size}r
Comme %B , mais inclut des valeurs pour les réponses 304 (non modifiées).
%{TransformedUrl}r
L’URL finale après toutes les transformations d’ensemble de règles.
%{ httpRequestHeader }i
La valeur de l’en-tête de requête HTTP spécifié.
%{ httpResponseHeader
La valeur de l’en-tête de réponse HTTP spécifié.

La valeur par défaut est "%G %a %s %{ProcessingStatus}r %{Size}r %D %{ParseTime}r %{FetchTime}r %O %{ReqType}r '%{RootId}r' %{CacheUse}r %R [%I] '%{Referer}i' %{Host}i %{X-Forwarded-For}i %{If-None-Match}i %{If-Match}i %{If-Modified-Since}i %{Digest}r %{ContentType}r %p %{Exception}r %{CacheKey}r %{PeerServer}" %{SendTime}r %{Context}r %{TransformedUrl}r %{PathBasedAccess}r.

recommendation-more-help
a26166cd-f2f4-45ce-996d-96a0f0d6cf49