![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[z/OS]](../images/ngzos.gif)
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
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.
- Hiérarchie de trace par défaut
- Si la spécification de trace par défaut est définie, la spécification de trace de contrôle est utilisée.
- 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
- Si une règle correspond à une requête, la spécification de trace de cette règle est utilisée.
- 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.
- 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.
- 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 :
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 :
|
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 :
|
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 :
|
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. où 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.
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) |
|
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
permet de rechercher les occurrences du terme blanca et tout autre terme se terminant par blanca, alors que l'expression
permet de rechercher les occurrences du terme blanca et tout autre terme commençant par blanca. L'expression
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. |