![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[z/OS]](../images/ngzos.gif)
Format du fichier journal personnalisé
Lorsqu'une demande est traitée, vous pouvez créer des ensembles de règles pour indiquer les données à inclure dans les journaux, l'ordre d'affichage, la logique conditionnelle utilisée pour filtrer les demandes à inclure, ainsi que le nombre et les noms des fichiers journaux.
Objets de propriété personnalisée
Les objets de propriété personnalisée peuvent être utilisés au niveau de l'ensemble de règles, de la règle et de l'action. Les règles déterminent les conditions dans lesquelles les actions de consignation sont effectuées. Une zone d'expression est utilisée pour déterminer les demandes et les réponses à consigner. Cette expression utilise les opérandes de langage HTTP standard et l'opérande response.code pour filtrer les données par codes de réponse HTTP, tels que 404 ou 503. Par exemple, response.code = 200 filtre toutes les réponses associées au code réponse 200. L'opérande HTTP targetserver est utilisé pour indiquer au serveur où la demande a été envoyée dans un format WebSphere Application Server. L'opérande des journaux personnalisés HTTP service.time représente l'intervalle séparant l'envoi de la demande au serveur d'applications et la réception d'une réponse du serveur d'applications. L'opérande des journaux personnalisés HTTP response.time représente l'intervalle séparant la réception de la demande sur le routeur ODR et l'envoi de la réponse par le routeur ODR. Pour plus d'informations, consultez la rubrique relative aux opérandes des journaux personnalisés HTTP.
La priorité des règles détermine l'ordre d'évaluation des règles. Des actions de journalisation spécifiques sont exécutées lorsqu'une correspondance est trouvée avec les règles. Les actions de consignation comportent une zone continue. Lorsque continue est défini sur true, les actions de consignation peuvent continuer à s'exécuter. Toutefois, si continue est défini sur false, aucune action de consignation n'est effectuée une fois que l'action de consignation est terminée. Utilisez le script manageODR.py pour créer un cluster de routeurs ODR et gérer la consignation personnalisée. Pour plus d'informations, consultez les rubriques relatives au script manageODR.py.
Ensemble de règles
- name
- Indique le nom de l'ensemble de règles. (Chaîne, obligatoire)
- type
- Indique le type de l'ensemble de règles. (Chaîne, identificateur de protocole, tels que HTTP)
- continueDefault
- Détermine la valeur par défaut pour continue. (Booléen, requis)
- properties
- Optional
- rule
- Obligatoire.
règle
- name
- Indique le nom de la règle. (Chaîne, unique au sein de l'ensemble de règles)
- priority
- Obligatoire, entier (unique au sein de l'ensemble de règles)
- expression
- Chaîne, obligatoire.
- action
- Obligatoire.
- properties
- Optional
Action
- name
- Indique le nom de l'action. (Chaîne, unique au sein de la règle)
- priority
- Facultatif, entier (unique au sein de la règle).
- type
- Chaîne, obligatoire, journal
- value
- Obligatoire. (Chaîne, inclut une série de formats de journaux délimités par le caractère @. Par exemple :
value="custom01.log %a%z@custom02.log @(#) 10 1.7@(#)Z"
- continue
- Facultatif, valeur booléenne. Si la valeur de ce paramètre n'est pas définie, la valeur continueDefault est appliquée ; true, false.
- properties
- Optional
customProperties
- name
- Indique la propriété personnalisée name. (Chaîne)
- value
- Obligatoire. (Chaîne)
- continue
- Facultatif, valeur booléenne. Si la valeur de ce paramètre n'est pas définie, la valeur continueDefault est appliquée ; true, false.
Format d'une action de consignation
L'attribut de la valeur de l'action contient un ensemble d'arguments pour indiquer le nom de fichier et le format du journal. Pour créer plusieurs journaux dans l'attribut de valeur, délimitez les arguments en utilisant le caractère @. Le premier argument de l'action de consignation est le nom du fichier journal par rapport au répertoire logs du routeur ODR. Les arguments suivants sont des paramètres qui permettent d'indiquer le type d'informations à consigner dans le journal. Les données sont affichées dans l'ordre dans lequel les paramètres ont été spécifiés.
Paramètre | Description |
---|---|
%a | Adresse IP distante. |
%A | Adresse IP locale. |
%B | Octets envoyés, à l'exclusion des en-têtes HTTP. |
%b | Octets envoyés, à l'exclusion des en-têtes HTTP. Dans le format CLF,'-' est utilisé au lieu de 0 lorsqu'aucun octet n'est envoyé. |
%{FOOBAR}C | Contenu du cookie de la demande envoyée au serveur. |
%{FOOBAR}i | Contenu de Foobar: lignes d'en-tête dans la demande envoyée au serveur. |
% I | Les octets reçus, incluant la demande et les en-têtes, ne peuvent pas correspondre à 0. |
%{FOOBAR}e | Contenu de l'argument de débogage ("-D") FOOBAR indiqué pour la machine virtuelle Java du processus ODR. |
%h | Hôte distant. |
%H | Protocole de la demande, HTTP ou HTTPS. |
%m | Méthode de la demande. |
%{FOOBAR}o | Contenu de Foobar, lignes d'en-tête dans la réponse. |
%O | Octets envoyés, y compris les en-têtes ; Le nombre ne doit pas être 0. |
%p | Port canonique du serveur qui traite la demande. |
%q | Chaîne de la requête, associée au préfixe ? s'il existe une chaîne de requête. Sinon, il s'agit d'une chaîne vide. |
%r | Première ligne de la demande. |
%R | Temps de réponse, en millisecondes. Temps combiné passé dans le routeur ODR et le serveur d'applications. |
%s | Etat, code de réponse HTTP, par exemple 503, 404, 200. |
%t | Heure, dans le format de consignation anglais standard. |
%{format}t | Heure, exprimée dans le format indiqué, qui doit se trouver au format strftime(3). Peut être localisé. |
%T | Temps nécessaire pour traiter la demande, en millisecondes. |
%U | Chemin de l'adresse URL demandé sans chaîne de requête. |
%v | Nom du serveur canonique qui traite la demande. |
%z | Adresse IP de destination. |
%Z | Nom du serveur de destination (cellule/noeud/serveur). |