[AIX Solaris HP-UX Linux Windows][z/OS]

Configuration de la trace sur le plug-in WebSphere

En configurant la fonction de trace, vous pouvez définir les informations de trace à collecter dans votre environnement.

Pourquoi et quand exécuter cette tâche

Configurez la fonction de trace sur votre serveur Web pour collecter des niveaux de journalisation spécifiques dans votre environnement. Les journaux sont enregistrés dans le fichier journal du plug-in standard plugins_root/logs/nom_serveur_web/http_plugin.log. Pour plus d'informations sur la journalisation des plug-ins, consultez les rubriques relatives aux propriétés du plug-in WebSphere.

Il existe deux types de traitement du plug-in : traitement des requêtes et traitement de contrôle. Le traitement des requêtes représente toute logique requise pour traiter une requête HTTP ou la réponse HTTP à partir du serveur d'origine. Le traitement de contrôle représente tout traitement qui n'entre pas dans la catégorie de traitement des requêtes. Par exemple, toute communication avec le service REST pour découvrir des informations de routage est considérée comme un traitement de contrôle.

Pour le paramétrage de la fonction de trace, la hiérarchie de priorité suivante s'applique :
  • Hiérarchie de trace par défaut
    1. Si la spécification de trace par défaut est définie, la spécification de trace de contrôle est utilisée.
    2. Si aucune spécification de trace par défaut n'est définie, le niveau de trace NOTICE est utilisé.
  • Hiérarchie de trace de requête
    1. Si une règle correspond à une requête, la spécification de trace de cette règle est utilisée.
    2. Si la règle ne correspond pas à la requête et que la propriété DefaultRequestTraceSpec est définie, la spécification de trace dans la propriété DefaultRequestTraceSpec est utilisée.
    3. Si la règle ne correspond pas à la requête, que la propriété DefaultRequestTraceSpec n'est pas définie, mais que la spécification de trace de contrôle est définie, la spécification de trace de contrôle est utilisée.
    4. Si aucune de ces spécifications n'est définie, le niveau de trace utilisé est NOTICE.

Le générateur de sous-expression permet de générer des conditions de règles complexes issues de sous-expressions en utilisant AND, OR, NOT et le regroupement mis entre parenthèses. Le générateur de règles valide la règle lorsque vous appliquez les modifications et vous prévient si des parenthèses ne concordent pas ou si des opérateurs logiques ne sont pas pris en charge.

L'opérande fait partie de la règle de classification que l'environnement d'exécution utilise pour faire correspondre une règle avec un travail. Par exemple, si vous spécifiez un type de protocole égal à HTTP, l'environnement d'exécution recherche un travail dont le type de protocole correspond à HTTP. La liste suivante contient les choix d'opérandes :

Tableau 1. Opérandes d'une demande HTTP
Opérande Syntaxe Description

Hôte virtuel

virtualhost

Hôte virtuel cible de la requête, utilisé pour configurer des applications Web avec un nom d'hôte spécifique.

Port virtuel

numeric

Port virtuel cible de la requête, utilisé pour configurer des applications Web avec un port spécifique.

URI

uri

Uniform Resource Identifier (URI)

Facilite l'identification du chemin de la requête : si l'URL est http://host:port/path?p1=v1, le chemin est path.

ID utilisateur

userid Renvoie l'ID de l'utilisateur authentifié ayant envoyé la requête.

ID groupe

groupingid Renvoie la liste des noms de groupes de l'utilisateur authentifié ayant envoyé la requête.

Nom du paramètre de requête de la demande

queryparm$<nom> Nom et valeur de l'en-tête.
Par exemple, l'expression queryparm$Hote='EST' permet de vérifier que la demande contient un paramètre de demande HTTP de fuseau horaire dont la valeur est EST. Pour vérifier la présence ou l'absence d'un paramètre de demande particulier, utilisez l'une des expressions suivantes :
queryparm$zone IS NOT NULL 
queryparm$zone IS NULL

Nom d'en-tête de la demande

header $<nom> Nom et valeur de l'en-tête.
Par exemple, l'expression header$Hote='localhost' permet de vérifier qu'une demande contient un en-tête hôte HTTP avec la valeur localhost. Pour vérifier la présence ou l'absence de l'en-tête d'hôte, utilisez l'une des expressions suivantes :
header$Host IS NOT NULL 
header$Host IS NULL

Nom d'en-tête du cookie

cookie$<nom> Nom d'un cookie.
Par exemple, l'expression cookie$My_Cookie_Name='My_Cookie_Value' teste une requête pour déterminer si elle contient un cookie nommé My_Cookie_Name associé à la valeur My_Cookie_Value. Pour vérifier la présence ou l'absence d'un cookie particulier, utilisez l'une des expressions suivantes :
cookie$MonNomCookie IS NOT NULL 
cookie$MonNomCookie IS NULL

Méthode HTTP

HTTPMethod Méthode HTTP de la demande. Les valeurs possibles sont POST, GET, PUT et DELETE.

Hôte client

clienthost Nom d'hôte qualifié complet du client. Il s'agit de la valeur du nom d'hôte de la commande IP (Internet Protocol). Cet opérande ne prend pas en charge les opérateurs numériques tels que >, >=, <, <=.

IPV4 client

clientipv4 clientipv4 – Adresse IP du client dans le format Internet Protocol version 4 (IPv4) à quatre éléments séparés par des points n.n.n.n.

IPV6 client

clientipv6 Adresse Internet Protocol version 6 (IPv6) 128 bits du type x:x:x:x:x:x:x:x conforme au protocole RFC 1924 de l'ordinateur client.

Hôte serveur

serverhost Nom hôte qualifié complet du serveur. Cet opérande ne prend pas en charge les opérateurs numériques tels que >, >=, <, <=.

IPV4 serveur

serveripv4 Adresse IP de l'ordinateur serveur au format IPv4 à quatre éléments séparés par des points n.n.n.n.

IPV6 serveur

serveripv6 Adresse IPv6 128 bits du type x:x:x:x:x:x:x:x conforme au document RFC 1924 de l'ordinateur serveur.

port

port Port d'écoute sur lequel la demande a été reçue.

Protocole

protocol Protocoles de communication qui transmettent la demande. Les protocoles actuellement pris en charge sont HTTP, HTTPS, SOAP et SOAPS.

Age

time

Permet de définir la date et l'heure de la journée à laquelle une requête spécifique doit être traitée. Comporte deux zones facultatives : Heure de début et Heure de fin. Si une demande est reçue en dehors de la plage horaire définie, elle n'est pas traitée.

Le format des zones d'heure de début et d'heure de fin est le suivant : jour/date/mois/année::heure:minutes:secondes.

Par exemple, "mardi 11 avril 2007 à 13:03:45" est indiqué sous la forme suivante :

Mar/11/Avr/2007::13:03:45

Le caractère générique * peut être utilisé dans toutes les zones.

Par exemple, le 1er de chaque mois est indiqué sous la forme */1.

Les valeurs du jour_de_la_semaine sont Dim, Lun, Mar, Mer, Jeu, Ven, Sam et les valeurs du jour_du_mois vont de 1 à 31.

La valeur mois est une valeur non numérique représentant les douze mois : Jan, Fév, Mar, Avr, Mai, Juin, Juil, Août, Sep, Oct, Nov, Déc.

La valeur année est constituée des quatre chiffres de l'année. par exemple : 2007.

L'heure est indiquée au format 24 heures. Par exemple, 8 h est représenté par ::8. Les minutes et les secondes sont exprimées par des entiers compris entre 0 et 59.

La barre oblique inverse (/) sépare les paramètres de date, les deux-points doubles (::) séparent les paramètres de date, et les deux points simples (:) séparent les paramètres d'heure. Le résultat booléen de la règle entière dans laquelle l'opérande time est utilisé détermine l'action de routage engagée.

Pourcentage

percentage$<val> L'opérande de pourcentage a pour valeur true pour un pourcentage fixe du temps.

Par exemple, percentage$50 a pour valeur true 50 % du temps.

Augmentation progressive

rampup$<heure_début>$<heure_fin>

  

L'opérande rampup renvoie la valeur true pendant un pourcentage de temps variable. Il est toujours associé à la valeur false avant <heure_début> et à la valeur true avant <heure_fin>. Au fur et à mesure que l'heure se rapproche de la valeur <heure_fin>, il prend la valeur true pour un pourcentage du temps qui augmente de façon linéaire.

Le format de <heure_début> et <heure_fin> est jour/mois/année::hour:min:sec.

jour est le jour du mois, mois est l'un des douze mois : Jan, Fév, Mar, Avr, Mai, Jui, Juil, Aoû, Sep, Oct, Nov, Déc, année est une année composée de quatre chiffres, heure est l'heure à deux chiffres de l'horloge à 24 heures, min est la valeur à deux chiffres pour les minutes et sec est la valeur à deux chiffres pour les secondes.

Par exemple,

rampup$01/Jan/2007::08:00:00$01/Jan/2007::17:00:00 est parfois associé à la valeur true à 8 heures le 1er janvier 2007 et est toujours associé à la valeur true à 17 heures le même jour, une fois l'heure de fin atteinte progressivement.

Selon l'opérateur que vous choisissez, entrez une valeur pour la sous-expression à créer. Tous les opérateurs débouchent sur des valeurs booléennes. Les opérateurs ne sont pas sensibles à la casse : AND est équivalent à AnD.

Tableau 2. Opérateurs de spécification de trace
Opérateur Description
Egal à et ignorant la casse (EQUALSIGNORECASE) Opérateur Egal à et ignorant la casse. La casse des chaînes est ignorée. 'ABC' EQUALSIGNORECASE 'abc' renvoie true. ('ABC' = 'abc') renvoie false.
Non égal (< >) L'opérateur Non égal à stipule que la valeur de l'opérande n'est pas égal à la valeur saisie.
Dans (IN)
  • chaîne IN liste de chaînes renvoie true si la première chaîne correspond exactement (casse comprise) à la deuxième chaîne. Par exemple :
    • 'adrian' in ('keith','eric','kalyan','david', 'adrian and etc') renvoie false.
    • 'adrian' in ('tom','adrian') renvoie true.
    • 'adrian' in ('Tom','Adrian')renvoie false.
  • entier IN liste d'entiers :
    • 1 in (1,2,3,4,5) renvoie true.
    • 6 in (1,2,3,4,5) renvoie false.
Similaire à (LIKE)

Exprime une correspondance de masque pour les valeurs d'opérande chaîne. La valeur doit contenir le caractère générique (%) à la position où la correspondance de masque est censée commencer.

Par exemple, l'expression
host LIKE %blanca
permet de rechercher les occurrences du terme blanca et tout autre terme se terminant par blanca, alors que l'expression
host LIKE %blanca
permet de rechercher les occurrences du terme blanca et tout autre terme commençant par blanca. L'expression
host LIKE %blanca
permet de rechercher les occurrences du terme blanca et de tout autre terme contenant la chaîne blanca.
Similaire à et ignorant la casse (LIKEIGNORECASE) Cet opérateur indique une correspondance de modèle pour les valeurs d'opérande de type chaîne. La casse des chaînes est ignorée.
N'est pas Null (IS NOT NULL) Une validation de la requête indique que le paramètre demandé existe.
Concaténer (+) Cet opérateur interprète 'abc'+'def' comme 'abcdef'.
Similaire et dans (LIKEIN) Cet opérateur exprime chaîne likein (chaîne1, chaîne2, chaîne3,...), renvoie true si la chaîne précédant likein correspond à une ou plusieurs des chaînes (stringN).
Est Null (IS NULL) Une validation de la requête indique que le paramètre demandé n'existe pas. Teste la présence d'un opérande avec une valeur NULL.
Egal à ( = ) Opérateur d'égalité utilisé pour exprimer une correspondance différenciant les minuscules et les majuscules.
Supérieur à (>) Prend la valeur du résultat logique standard.
Supérieur ou égal à (>=) Prend la valeur du résultat logique standard.
Inférieur à (<) Prend la valeur du résultat logique standard.
Inférieur ou égal à (<=) Prend la valeur du résultat logique standard.
Compris entre (BETWEEN) Cet opérateur est utilisé conjointement avec l'opérateur AND pour sélectionner un intervalle de valeurs comprenant la première valeur (la plus basse) et la dernière valeur (la plus haute). Ensemble, ils agissent sur des nombres et des dates.

Procédure

Résultats

Vous avez configuré la fonction de trace sur votre plug-in WebSphere.

Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twve_plugintrace
Nom du fichier : twve_plugintrace.html