IBM Tealeaf CX Version juin Guide de configuration

Transcription

1 IBM Tealeaf CX Version juin 2014 Guide de configuration

2 Important Aant d'utiliser le présent document et le produit associé, prenez connaissance des informations figurant à la section «Remarques», à la page 433. LE PRESENT DOCUMENT EST LIVRE EN L'ETAT SANS AUCUNE GARANTIE EXPLICITE OU IMPLICITE. IBM DECLINE NOTAMMENT TOUTE RESPONSABILITE RELATIVE A CES INFORMATIONS EN CAS DE CONTREFACON AINSI QU'EN CAS DE DEFAUT D'APTITUDE A L'EXECUTION D'UN TRAVAIL DONNE. Ce document est mis à jour périodiquement. Chaque nouelle édition inclut les mises à jour. Les informations qui y sont fournies sont susceptibles d'être modifiées aant que les produits décrits ne deiennent eux-mêmes disponibles. En outre, il peut contenir des informations ou des références concernant certains produits, logiciels ou serices non annoncés dans ce pays. Cela ne signifie cependant pas qu'ils y seront annoncés. Pour plus de détails, pour toute demande d'ordre technique, ou pour obtenir des exemplaires de documents IBM, référez-ous aux documents d'annonce disponibles dans otre pays, ou adressez-ous à otre partenaire commercial. Vous pouez également consulter les sereurs Internet suiants : (sereur IBM en France) (sereur IBM au Canada) (sereur IBM aux Etats-Unis) Compagnie IBM France Direction Qualité 17, aenue de l'europe Bois-Colombes Cedex Cette édition s'applique à la ersion d'ibm Tealeaf CX et à toutes les éditions et modifications ultérieures, sauf mention contraire dans les nouelles éditions. Copyright IBM Corporation 1999, 2014.

3 Table des matières Ais aux lecteurs canadiens..... ii Tealeaf CX - Guide de configuration.. ix Chapitre 1. Présentation de la configuration de CX Configuration initiale Configuration des sereurs et serices Configuration du pipeline CX Chapitre 2. Configuration des composants Tealeaf Sauegarde du modèle d'éénement Légende Serices Serice d'alerte Gestionnaire du Canister Collecteur de données Serice de données serice d'extraction Interface graphique du portail Sereur de requêtes Serice RSE Indexeur de session Serice de planification Statut Tealeaf serice de transport Sereurs Sereur du Canister Sereur cxconnect Sereur cxreeal Sereur de serice de données Sereur PCA sereur de relecture Sereur de rapports Sereur de recherche Sereur SQL Sereur de gestion Tealeaf Sereur TLI Sereur de transport Sereur de rapport des isiteurs Configuration Configuration de la messagerie Tealeaf Configuration partagée Configuration globale de Tealeaf éditeur de pipeline Filtre de confidentialité Application RTV RTV Pro TLBackup et TLRestore TLTMaint Configuration du fuseau horaire du système Indicateur de fuseau horaire Fuseau horaire actuel Effets du fuseau horaire du système Configuration du fuseau horaire du système.. 14 Traitement des incidents Configuration du serice de transport Accès à la configuration du serice de transport 16 Présentation du transport Configuration du serice de transport Sureillance du pipeline Configuration du serice de transport sur la ligne de commande Traitement des incidents Configuration du Canister CX Présentation du Canister Onglet Serices du canister Onglet Contrôles de serices Onglet Réalisation de serices Onglet Consignation des Canisters Configuration du sereur de Canister Traitement des incidents Configuration de l'indexation CX Présentation de l'indexation Traitement des index Configuration Paramètres d'ajout Traitement des incidents des index de session.. 47 Format et stockage des index Sureillance de l'indexation Ajout d'autres zones pour indexation et recherche 55 Traitement des incidents Chapitre sur la configuration du sereur de rapports 61 Fuseau horaire du sereur de rapports Accès à la configuration du sereur de rapports 61 Onglet Portail Onglet Base de données Onglet BD cxresults Configuration supplémentaire du sereur de rapports Traitement des incidents Configuration du serice de données Tealeaf Connexions Installation Configuration de la base de données Configuration du serice de données Tealeaf.. 71 Démarrage et arrêt du serice Journalisation Configuration du sereur de relecture Exigences Installation Configuration du sereur de relecture Création de sereurs de relecture supplémentaires Configuration des règles de relecture Confidentialité à la demande Plug-ins du sereur de relecture Copyright IBM Corp. 1999, 2014 iii

4 Personnalisation de la relecture des sessions d'application mobile Traitement des incidents Gestion des modules d'extension de correspondance des données Présentation Ajout et suppression de plug-ins Configuration Génération de plug-ins personnalisés Chapitre sur la configuration du sereur de recherche Présentation Configuration de la recherche Authentification Traitement des incidents Confidentialité à la demande Comment la confidentialité à la demande est appliquée Configuration de la confidentialité à la demande 138 Règles de relecture pour la confidentialité Mode de débogage Consignation et génération de rapports Référence Configuration du serice d'alerte Fonctionnement des alertes Installation Terminologie du serice d'alerte Création d'alertes Configuration Statistiques de Canister Démarrage/Arrêt/Redémarrage du serice Configuration du serice de planification Actiation du serice de planification Tealeaf 151 Configuration du serice de planification Tealeaf 151 Chapitre sur la configuration du serice d'extraction Configuration Référence Chapitre 3. Configuration initiale de CX Sauegarde du modèle d'éénement Configuration de Tealeaf CX Etapes de configuration initiales Configuration facultatie Vérification de otre solution Tealeaf Configuration initiale du portail Annonces du portail Configuration du fuseau horaire du système Tealeaf Paramètres diers Configuration du sereur Administration des utilisateurs CX Configuration de rapport Test de otre configuration Configuration initiale de TMS Exemple d'architecture Prérequis Initialisation de TMS Gestion de la configuration Tâches de mise à jour i IBM Tealeaf CX - Guide de configuration Test de otre configuration Configuration initiale de cxconnect Prérequis Installation de cxconnect Ajout d'un sereur cxconnect Ajout d'une tâche configurée Autres options de configuration Test de otre configuration Références Configuration initiale d'ibm Tealeaf cxverify Prérequis Installation d'ibm Tealeaf cxverify Types d'archiage Sereurs Tâches d'archiage Tâches Fichier de session Sauegarder la tâche Vérification du statut de la tâche Test de otre configuration Références Configuration initiale de cxresults Prérequis Vérification de la base de données des isiteurs 193 Actiation du traail de l'extracteur de base de données de isiteurs Configuration de la mise en isites Administration des utilisateurs cxresults Configuration des modèles de recherche et des listes de sessions Configuration des éénements de filtrage des sessions cxresults Autres paramètres cxresults Tableaux de bord des isiteurs Références Test de otre configuration Configuration initiale de RTV Installation de RTV Connexion à Tealeaf Configuration Test de otre configuration Références Configuration initiale de CX Mobile Prérequis Configuration de Tealeaf CX Mobile Configuration des éénements pour CX Mobile 211 Test de otre configuration Configuration initiale de CX Mobile for Mobile App Références Test de otre solution Tealeaf Méthodologie Installation Considérations à prendre en compte lors de la génération de otre session de test Génération d'une session Tests de la session actie Tests de session terminés Capture de sessions de test supplémentaires Etapes suiantes

5 Chapitre 4. Agents de session de pipeline CX Configuration du pipeline CX Modes de capture Pipelines par défaut Comment configurer le pipeline Configuration aec filtre de capture Configuration manuelle des pipelines Configuration initiale du pipeline Ports d'écoute autres que les ports par défaut 231 Configuration de la confidentialité Health-Based Routing (HBR) Dépose de données Test de otre configuration Présentation du pipeline de capture et des agents de session A propos des agents de session Agents de session disponibles Ajout d'un agent de session Agent de session Archiage Agent de session Indexation des attributs Agent de session Canister Agent de session Analyseur de cookie Agent de session Dépose de données Paramètres de configuration Règles de suppression personnalisées Exemple de configuration Agent de session Analyseur de données Configuration des règles de modèle Paramètres de configuration Génération des règles de l'analyseur de données 261 Options de configuration des règles Exemples de règle Agent de session Decouple Agent de session DecoupleEx Vidage du Canister à court terme Génération de rapports Consignation Configuration du découpleur étendu Paramètres généraux Seuils du Canister à court terme Génération de rapports DecouplerEx Paramètres de disque de DecouplerEx Désactiation de la mise en file d'attente sur disque Agent de session Confidentialité étendue Agent de session Health-Based Routing (HBR) 278 Paramètres de configuration Détermination de l'état de HBR Comment configurer HBR Configuration des paramètres globaux de HBR 281 Configuration des paramètres HBR pour des Canisters indiiduels Configuration des paramètres d'un pipeline HBR enfant Exemple de configuration Personnalisation des configurations DecoupleEx principales et enfant Agent de session Déploiement Agent de session Analyseur mobile JSON Utilisations Présentation Prérequis Installation d'une page cible Tealeaf Identificateurs de demande Configuration de la PCA Pipeline de traitement de l'analyseur mobile Ajout de l'agent de session Paramètres de configuration Journalisation Exceptions non traitées Références aux paires nom/aleur mobiles Exemples de données de demande Section AppEn Section MobileEents Agent de session Code géré Agent de session Null Agent de session Confidentialité Versions de l'agent de session Confidentialité Prise en charge des applications mobiles Ajout et configuration de l'agent de session Test de la confidentialité Aant de commencer Ajout de l'agent de session Actiation de l'agent de session Confidentialité 309 Etapes de base Accès à l'éditeur de confidentialité Règles Tests Actions Keys Filtres préconfigurés Filtre de blocage des données Filtre de chiffrement des données Filtres préconfigurés supplémentaires Exemples de filtre Exemple - Filtrage des données de session des employés Exemple - Blocage de texte Exemple - Actiation de la recherche de zones chiffrées ou bloquées Exemple : l'existence d'une zone de demande signifie d'une section de demande doit être supprimée Exemple - Ajout de données de demande pour indexation Actiation de la confidentialité ia TMS Actiation de la confidentialité ia TealeafCaptureSocket.cfg Consignation de l'agent de session Confidentialité Application de la confidentialité Test de la confidentialité Agent de session RTA (Real-Time Monitoring and Alert) Actiation de RTA Paramètres de configuration Configuration de tests RTA dans TMS Edition du fichier RTA.ini Limites des règles Exemples de règle RTA Exemple de sortie Table des matières

6 Agent de session Balises de réponse pour la demande Agent de session Fractionnement RTA Agent de session Routeur de session Agent de session de mise en sessions Paramètres de configuration Autres zones de mise en sessions Agents de session liés aux périphériques mobiles 355 Agent de session Socket Agent de session Consignateur de statistiques 358 Agent de session de référence Tealeaf Agent de session de référence Tealeaf - Mode existant Présentation Actiation du mode existant Désactiation de l'utilisation des génériques Optimisation du cache à élagage automatique 382 Messages du journal des éénements au démarrage Détection du type de système d'exploitation et de naigateur à partir des informations d'agent utilisateur (ersion la plus ancienne) Agent de session Mise en sessions Tealeaf Exemple de configuration de section TLSessioning 385 Paramètres de configuration Exemples Remarques Jointure de sessions Exemples réels de configuration de TLSessioning 388 Agent de session TimeGrades Paramètres de configuration Agent de session TLI Prérequis Configuration de la gestion de TLI Configuration de pipelines pour les archies statiques Hypothèses de déploiement Flux de traaux de configuration Pipeline de traitement TLI Principal pipeline de traitement Désactiation de DelImages Ajout de l'agent de session Configuration de l'agent de session TLI Heure d'enregistrement Noms de fichier TLI Spécification des répertoires TLI Journalisation Gestion de l'espace disque Agent de session de décodage d'url Utilitaires du pipeline CX Lecteur d'archie TeaLeaf - Exécuter les sessions archiées Démarrage et sureillance du pipeline de capture sur plusieurs sereurs Démarrage du pipeline de capture Sureillance du pipeline de capture sur plusieurs sereurs Statut de capture TeaLeaf - Utilitaire de sureillance des pipelines Filtres Connexions Graphique de transfert Console Serice de transport Minimisation Utilitaire Testeur de confidentialité Versions Démarrage du testeur de confidentialité Pour les agents de session Confidentialité Pour l'agent de session RTA (Real-Time Monitoring Alert) Flux de traaux Acquisition d'exemples de données Edition de règles Exécution du testeur de confidentialité Examen des résultats Vue côte à côte Vue unifiée Journaux de confidentialité Sauegarde Chapitre 5. Documentation et aide d'ibm Tealeaf Remarques Marques Remarques sur les règles de confidentialité i IBM Tealeaf CX - Guide de configuration

7 Ais aux lecteurs canadiens Le présent document a été traduit en France. Voici les principales différences et particularités dont ous deez tenir compte. Illustrations Les illustrations sont fournies à titre d'exemple. Certaines peuent contenir des données propres à la France. Terminologie La terminologie des titres IBM peut différer d'un pays à l'autre. Reportez-ous au tableau ci-dessous, au besoin. IBM France ingénieur commercial agence commerciale ingénieur technico-commercial inspecteur IBM Canada représentant succursale informaticien technicien du matériel Claiers Les lettres sont disposées différemment : le claier français est de type AZERTY, et le claier français-canadien de type QWERTY. OS/2 et Windows - Paramètres canadiens Au Canada, on utilise : les pages de codes 850 (multilingue) et 863 (français-canadien), le code pays 002, le code claier CF. Nomenclature Les touches présentées dans le tableau d'équialence suiant sont libellées différemment selon qu'il s'agit du claier de la France, du claier du Canada ou du claier des États-Unis. Reportez-ous à ce tableau pour faire correspondre les touches françaises figurant dans le présent document aux touches de otre claier. Copyright IBM Corp. 1999, 2014 ii

8 Breets Il est possible qu'ibm détienne des breets ou qu'elle ait déposé des demandes de breets portant sur certains sujets abordés dans ce document. Le fait qu'ibm ous fournisse le présent document ne signifie pas qu'elle ous accorde un permis d'utilisation de ces breets. Vous pouez enoyer, par écrit, os demandes de renseignements relaties aux permis d'utilisation au directeur général des relations commerciales d'ibm, 3600 Steeles Aenue East, Markham, Ontario, L3R 9Z7. Assistance téléphonique Si ous aez besoin d'assistance ou si ous oulez commander du matériel, des logiciels et des publications IBM, contactez IBM direct au iii IBM Tealeaf CX - Guide de configuration

9 Tealeaf CX - Guide de configuration Le document IBM Tealeaf CX - Guide de configuration explique en détails comment configurer le système IBM Tealeaf CX une fois que ous aez effectué l'installation et de manière régulière. Utilisez les liens ci-après pour accéder à des rubriques spécifiques du document. Ce document doit être utilisé une fois que ous aez effectué une installation ou une mise à nieau. Pour plus d'informations sur l'installation, oir "Tealeaf CX - Guide d'installation" dans le document IBM Tealeaf CX - Guide d'installation. Remarque : Si ous mettez à nieau une solution Tealeaf existante, utilisez le Guide de mise à nieau. Voir "Tealeaf CX ersion 8 - Guide de mise à nieau" dans le document IBM Tealeaf CX - Guide de mise à nieau. Copyright IBM Corp. 1999, 2014 ix

10 x IBM Tealeaf CX - Guide de configuration

11 Chapitre 1. Présentation de la configuration de CX Configuration initiale Ce document contient des rubriques sur la manière de configurer otre solution IBM Tealeaf CX dans les trois catégories ci-après. Une fois que ous aez terminé l'installation des produits IBM Tealeaf CX, ous pouez examiner des rubriques indiiduelles pour décourir comment configurer des produits Tealeaf indiiduels. Voir Chapitre 3, «Configuration initiale de CX», à la page 165. Configuration des sereurs et serices Configuration du pipeline CX Dans le cadre de la configuration initiale, les sereurs et serices ci-après sont configurés. Il se peut que ous deiez parfois modifier ces configurations. Voir Chapitre 2, «Configuration des composants Tealeaf», à la page 3. Ces configurations peuent être gérées ia Tealeaf Management System. Voir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Le pipeline IBM Tealeaf CX permet d'effectuer des actions de traitement sur les demandes et réponses indiiduelles de chaque hit capturé par Tealeaf. Des agents de session indiiduels peuent être ajoutés et configurés dans un ou plusieurs pipelines, pour permettre une manipulation précise des données capturées. Voir «Présentation du pipeline de capture et des agents de session», à la page 235. Copyright IBM Corp. 1999,

12 2 IBM Tealeaf CX - Guide de configuration

13 Chapitre 2. Configuration des composants Tealeaf Cette section fournit des informations sur les configurations, les serices et les sereurs Tealeaf indiiduels, ainsi que sur les applications autonomes qui font partie du système IBM Tealeaf CX. Vous pouez utiliser les liens ci-après pour accéder à la documentation de configuration des composants Tealeaf répertoriés. Pour plus d'informations sur les lignes de chaque tableau, oir «Légende». Pour plus d'informations sur la configuration générale d'ibm Tealeaf CX et notamment sur les étapes de configuration initiales de chaque produit Tealeaf, oir Chapitre 1, «Présentation de la configuration de CX», à la page 1. Sauegarde du modèle d'éénement Aant de commencer à modifier os définitions d'éénement, ous deez effectuer une sauegarde de otre modèle d'éénement Tealeaf, qui pourra être utilisée pour restaurer les définitions d'éénement à un état précédemment connu. Voir "Sauegarde et restauration du modèle d'éénement" dans le document IBM Tealeaf cximpact - Guide d'administration. Légende Serices Description : description du composant Panneau Serices : entrée du panneau de configuration des serices Windows, si applicable Gestion du portail : entrée dans "Gestion des sereurs Tealeaf" dans le document IBM Tealeaf cximpact - Guide d'administration, si applicable TMS : entrée dans "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration, si applicable Documentations : liens ers la documentation de la configuration Remarque : Eitez d'utiliser le panneau de configuration des serices Windows pour arrêter et redémarrer les serices Tealeaf. Au lieu de cela, utilisez les raccourcis insérés dans le menu Démarrer. Serice d'alerte Description Gère l'exécution et la distribution des alertes de type éénement Panneau Serices Serice d'alerte Tealeaf Chapitre sur la gestion du portail TMS Serice d'alerte Documentations «Configuration du serice d'alerte», à la page 145 Copyright IBM Corp. 1999,

14 Gestionnaire du Canister Description Ce serice contrôle et sureille le canister et les processus du sereur de canister Tealeaf. Les serices de Canister sont redémarrés par le gestionnaire du Canister lorsqu'un cas d'erreur est détecté. Panneau Serices Gestionnaire du Canister Tealeaf Chapitre sur la gestion du portail TMS Canister Documentations Collecteur de données Description Ce serice interroge les Canisters Tealeaf et agrège les données pour les stocker dans les bases de données Tealeaf Panneau Serices Collecteur de données Tealeaf Gestion du portail TMS Collecteur de données Documentations "Paramètres CX" dans le document IBM Tealeaf cximpact - Guide d'administration. Serice de données Description Gestion des connexions entre les serices Tealeaf et les bases de données qu'ils interrogent Panneau Serices Serice de données Tealeaf Chapitre sur la gestion du portail TMS Documentations "Configuration du serice de données Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration serice d'extraction 4 IBM Tealeaf CX - Guide de configuration Description Serice utilisé par IBM Tealeaf cxconnect for Data Analysis pour extraire les données de session des bases de données Tealeaf Panneau Serices Serice de l'extracteur Tealeaf Chapitre sur la gestion du portail TMS Serice d'extraction Documentations «Chapitre sur la configuration du serice d'extraction», à la page 162

15 "cxconnect for Data Analysis Administration Manual" dans le document IBM Tealeaf cxconnect for Data Analysis Administration Manual Interface graphique du portail Description Serice qui arrête, démarre et redémarre Microsoft IIS, qui héberge l'application de portail Panneau Serices Chapitre sur la gestion du portail TMS Interface graphique du portail Documentations Sereur de requêtes Serice RSE Description Gère les communications entre le portail et la base de données des isiteurs. Imbriqué dans le serice RSE. Panneau Serices Chapitre sur la gestion du portail TMS Documentations "Chapitre sur la présentation de l'administration cxresults dans le document IBM Tealeaf cxresults Administration Manual Description Le serice analyse les données de session pour créer des segments Panneau Serices Chapitre sur la gestion du portail TMS Serice de l'extracteur RSE Documentations "Paramètres de l'extracteur RS" dans le document IBM Tealeaf cximpact - Guide d'administration. Indexeur de session "Présentation de l'administration cxresults" dans le document IBM Tealeaf cxresults - Guide d'administration Description Indexe les sessions terminées stockées dans le Canister sur le même sereur de traitement Panneau Serices Indexeur de session Tealeaf Chapitre sur la gestion du portail TMS Indexeur de session Chapitre 2. Configuration des composants Tealeaf 5

16 Documentations «Configuration de l'indexation CX», à la page 34 Serice de planification Description Gère la planification et l'exécution des traaux Tealeaf et notamment les sauegardes, les extractions et la génération de rapports de statut du portail. Panneau Serices Serice de planification Tealeaf Gestion du portail TMS Serice de planification Documentations "Configuration du serice de planification" dans le document IBM Tealeaf CX - Guide de configuration Statut Tealeaf Description Informations de statut sur les serices et les composants Tealeaf configurés Panneau Serices Chapitre sur la gestion du portail TMS Documentations serice de transport "Rapport de statut Tealeaf" dans le document IBM Tealeaf cximpact Administration Manual "Configuration du serice de planification" dans le document IBM Tealeaf CX - Guide de configuration Description Reçoit les données de session du sereur PCA et lance et gère les opérations de pipeline Windows Panneau Serices Serice de transport Tealeaf Chapitre sur la gestion du portail Sereur de transport TMS serice de transport Documentations Configuration : «Configuration du serice de transport», à la page 15 Gestion du portail : "Gestion des sereurs Tealeaf" dans le document IBM Tealeaf cximpact - Guide d'administration Configuration des pipelines : "Editeur de pipeline TMS" dans le document IBM Tealeaf cximpact - Guide d'administration 6 IBM Tealeaf CX - Guide de configuration

17 Sereurs Sereur du Canister Description Capture et stockage de sessions acties et terminées ; indexation des sessions terminées pour les recherches. Egalement connu sous le nom de sereur de traitement, l'équialent fonctionnel de la base de données ctree. Panneau Serices Sereur de Canisters Tealeaf Gestion du portail Sereur du Canister Lorsqu'une référence à un sereur de Canister est créée dans la page Gestion du portail, une référence au sereur de recherche sur le Canister est également créée automatiquement. TMS Sereur du Canister Documentations Configuration : «Configuration du Canister CX», à la page 17 Gestion du portail : "Gestion des sereurs Tealeaf" dans le document IBM Tealeaf cximpact - Guide d'administration Sereur cxconnect Description Gère l'extraction des données de session pour les distribuer aux systèmes tiers Panneau Serices Chapitre sur la gestion du portail IBM Tealeaf cxconnect for Data AnalysisSereur TMS IBM Tealeaf cxconnect for Data AnalysisSereur Documentations Configuration : Chapitre sur l'installation de cxconnect dans le document IBM Tealeaf cxconnect for Data Analysis Administration Manual Gestion du portail : "Gestion des sereurs Tealeaf" dans le document IBM Tealeaf cximpact - Guide d'administration Sereur cxreeal Description Reçoit les informations d'attribut de session du Canister ia le bus d'éénements pour les insérer dans la base de données de recherche d'ibm Tealeaf cxreeal. Panneau Serices Gestion du portail Sereur de recherche de base de données IBM Tealeaf cxreeal TMS Sereur distinct Documentations Installation : "Installation cxreeal" dans le document IBM Tealeaf cxreeal - Guide d'administration Chapitre 2. Configuration des composants Tealeaf 7

18 Configuration : "Configuration de la recherche d'attributs de session" dans le document IBM Tealeaf cxreeal - Guide d'administration Gestion du portail : "Gestion des sereurs Tealeaf" dans le document IBM Tealeaf cximpact - Guide d'administration Sereur de serice de données Description Gère les communications entre les composants Tealeaf et les bases de données Panneau Serices Serice de données Tealeaf Chapitre sur la gestion du portail Sereur de serice de données TMS serice de données Documentations Configuration : "Configuration du serice de données Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration Sereur PCA Description Définition du portail pour la machine qui héberge IBM Tealeaf CX Passie Capture Application Panneau Serices Gestion du portail Sereur applicatif de capture TMS Sereur PCA Documentations Configuration de PCA : "Console Web PCA - Onglet distribution" dans le document IBM Tealeaf Passie Capture Application - Guide Gestion du portail : "Gestion des sereurs Tealeaf" dans le document IBM Tealeaf cximpact - Guide d'administration sereur de relecture Description Gère la relecture des sessions ia le portail (BBR) Panneau Serices Sereur de relecture Tealeaf Chapitre sur la gestion du portail sereur de relecture TMS sereur de relecture Documentations Configuration : «Configuration du sereur de relecture», à la page 74 Gestion du portail : "Gestion des sereurs Tealeaf" dans le document IBM Tealeaf cximpact - Guide d'administration 8 IBM Tealeaf CX - Guide de configuration

19 Sereur de rapports Description Gère les requêtes à destination d'autres sereurs dans l'enironnement Tealeaf Panneau Serices Chapitre sur la gestion du portail Sereur de rapports Lorsqu'une référence à un sereur de rapports est créée dans la page Gestion du portail, une référence à l'instance de sereur de recherche sur le sereur est également créée. TMS Documentations Configuration : «Chapitre sur la configuration du sereur de rapports», à la page 61 Gestion du portail : "Gestion des sereurs Tealeaf" dans le document IBM Tealeaf cximpact - Guide d'administration Sereur de recherche Sereur SQL Description Gère entre autres les recherches de données de session acties et terminées Panneau Serices Sereur de recherche Tealeaf Chapitre sur la gestion du portail TMS Sereur de recherche Documentations «Chapitre sur la configuration du sereur de recherche», à la page 107 Gestion du portail : "Gestion des sereurs Tealeaf" dans le document IBM Tealeaf cximpact - Guide d'administration Description Le produit Microsoft SQL Serer est un hôte requis par les bases de données Tealeaf Panneau Serices MSSQLSERVER Chapitre sur la gestion du portail TMS Documentations Chapitre relatif à la liste de contrôle préinstallation CX dans le document IBM Tealeaf CX Installation Manual Sereur de gestion Tealeaf Description Gère TMS Panneau Serices Sereur de gestion Tealeaf Chapitre 2. Configuration des composants Tealeaf 9

20 Sereur TLI Chapitre sur la gestion du portail TMS Sereur de gestion Tealeaf Documentations "Onglet TMS WorldView" dans le document IBM Tealeaf cximpact - Guide d'administration Description Gère le stockage du contenu statique Panneau Serices Chapitre sur la gestion du portail Sereur TLI TMS Documentations Sereur de transport Configuration : "Gestion des archies statiques" dans le manuel d'administrationibm Tealeaf cximpact Administration Manual Gestion du portail : "Gestion des sereurs Tealeaf" dans le document IBM Tealeaf cximpact - Guide d'administration Utilisateur : "Utilisation d'archies statiques dans RTV" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation Description Les instances supplémentaires du serice de transport peuent être déployées comme périphériques HBR (Health-Based Routing). Panneau Serices Serice de transport Tealeaf Chapitre sur la gestion du portail TMS serice de transport Documentations «Configuration du serice de transport», à la page 15 «Agent de session Health-Based Routing (HBR)», à la page 278 Sereur de rapport des isiteurs Description Sereur hébergeant le sereur de requêtes qui communique aec la base de données des isiteurs Panneau Serices Chapitre sur la gestion du portail Sereur de rapport des isiteurs TMS Documentations Gestion du portail : "Gestion des sereurs Tealeaf" dans le document IBM Tealeaf cximpact - Guide d'administration 10 IBM Tealeaf CX - Guide de configuration

21 Configuration Configuration de la messagerie Tealeaf Description Configure le sereur de messagerie utilisé par Tealeaf Panneau Serices Gestion du portail TMS Tealeaf > Informations de configuration de la messagerie Tealeaf Documentations "Onglet TMS WorldView" dans le document IBM Tealeaf cximpact - Guide d'administration Configuration partagée Description Paramètres de configuration partagés par plusieurs sereurs et serices Panneau Serices Gestion du portail TMS Tealeaf > Informations de configuration partagées Documentations "Onglet TMS WorldView" dans le document IBM Tealeaf cximpact - Guide d'administration Configuration globale de Tealeaf Description Paramètres de configuration généraux Panneau Serices Gestion du portail TMS Tealeaf > Paramètres de configuration généraux de Tealeaf Documentations Globale : "Onglet TMS WorldView" dans le document IBM Tealeaf cximpact - Guide d'administration Fuseau horaire du système : «Configuration du fuseau horaire du système», à la page 13 éditeur de pipeline Description Configure les pipelines Windows ia l'éditeur de pipeline TMS Panneau Serices Chapitre sur la gestion du portail TMS Serice de transport > Configuration du serice de transport Documentations "Editeur de pipeline TMS" dans le document IBM Tealeaf cximpact - Guide d'administration Chapitre 2. Configuration des composants Tealeaf 11

22 Application Filtre de confidentialité Description Configure le filtrage des données dans le pipeline Windows. Panneau Serices Chapitre sur la gestion du portail TMS Serice de transport > Configuration du filtre de confidentialité Documentations «Agent de session Confidentialité», à la page 307 RTV Description Application de bureau IBM Tealeaf CX RealiTea Viewer permettant de rechercher et de relire des sessions Tealeaf. Panneau Serices Chapitre sur la gestion du portail TMS IBM Tealeaf CX RealiTea Viewer Documentations "Présentation de RealiTea Viewer" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. RTV Pro Description Application de bureau IBM Tealeaf CX RealiTea Viewer Professional permettant d'effectuer des recherches dans les sessions Tealeaf et de relire ces sessions. Panneau Serices Gestion du portail TMS IBM Tealeaf CX RealiTea Viewer Pro Documentations "Présentation de RealiTea Viewer" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. TLBackup et TLRestore Description Configurent et exécutent des opérations planifiées de sauegarde et de restauration de Canister Panneau Serices Gestion du portail TMS Documentations "TLBackup et TLRestore" dans le document IBM Tealeaf cximpact - Guide d'administration 12 IBM Tealeaf CX - Guide de configuration

23 TLTMaint Description Examine et répare le Canister pour la cohérence de données Panneau Serices Chapitre sur la gestion du portail TMS Canister > TLTMaint Documentations Configuration du fuseau horaire du système Tealeaf requiert la définition d'un seul fuseau horaire pour tous les sereurs Tealeaf du système. Pour certaines opérations Tealeaf, telles que les recherches, le fuseau horaire peut modifier la signification de certains paramètres, tels que aujourd hui ou hier. Ce fuseau horaire à l'échelle du système sert entre autres à déterminer quand les rapports planifiés sont exécutés et distribués. Toutes les aleurs de fuseau horaire des composants et des applications Tealeaf sont calculées à partir du fuseau horaire du système, excepté pour le sereur de recherche. Toutes les sessions et données de Canister étant stockées à l'aide d'horodatages GMT, aucune référence de fuseau horaire n'est requise pour le sereur de recherche. Voir «Chapitre sur la configuration du sereur de recherche», à la page 107. Chaque utilisateur peut définir son fuseau horaire local. Le fuseau horaire d'un utilisateur affecte principalement la recherche de données. Voir "Mes options" dans le document IBM Tealeaf cximpact - Guide d'utilisation. Remarque : Pour les fuseaux horaires qui incluent l'heure d'été au cours de l'année, les aleurs communiquées lorsque l'heure est aancée présentent un écart d'une heure, tandis que celles communiquées lorsque l'heure est retardées génèrent des comptes en double. Les administrateurs Tealeaf peuent utiliser les annonces de portail pour aertir les utilisateurs du changement d'heure et de ses effets. Voir "Gestion du portail" dans le document IBM Tealeaf cximpact - Guide d'administration. Remarque : Lors de la procédure d'installation, le fuseau horaire du système doit être attentiement étudié et sélectionné. Une fois que le fuseau horaire du système a été modifié sur un système Tealeaf en plein traitement, certaines données risquent d'être perdues au prochain élagage des Canisters. Le olume de données potentiellement perdues correspond au nombre d'heures du décalage horaire. Indicateur de fuseau horaire En fonction de otre ersion de Windows, le portail peut afficher l'indicateur de fuseau horaire à l'aide de l'un des acronymes ci-après. Ces indicateurs sont présents dans le fuseau horaire affiché dans le coin supérieur droit du portail et dans les données de fuseau horaire sauegardées. Remarque : Sur le plan fonctionnel, ces indicateurs de fuseau horaire identifient les mêmes fuseaux dans le monde entier. Acronyme Description UTC Le temps uniersel coordonné est un mécanisme de découpage en fuseaux horaires plus précis que GMT. Cette méthode est utilisée dans les ersions plus récentes du système d'exploitation Windows. Chapitre 2. Configuration des composants Tealeaf 13

24 GMT Le temps moyen de Greenwich indique otre fuseau horaire par rapport au méridien de Greenwich. Cette méthode est plus courante dans les anciennes ersions du système d'exploitation Windows. Fuseau horaire actuel Utilisateur Le fuseau horaire de l'utilisateur actuellement connecté au portail est affiché dans la barre d'outils, par rapport au fuseau horaire du système Tealeaf. Par exemple, GMT-7 correspond au fuseau horaire qui se troue sept heures derrière le temps moyen de Greenwich, à saoir, au fuseau horaire du Pacifique. Global Le fuseau horaire du système global est spécifié et disponible ia TMS. Voir «Configuration du fuseau horaire du système». Effets du fuseau horaire du système La configuration du fuseau horaire du système a les comportements suiants : 1. Toutes les données de rapport reçoient un horodatage basé sur le fuseau horaire du système global. A des fins de génération de rapports, une journée et ses périodes d'une heure sont définies par l'interalle entre minuit et minuit dans le fuseau horaire du système global. 2. Les horodatages d'éénement sont enregistrés lorsque l'éénement se produit. Les éénements peuent se produire au début d'une session, dans des pages indiiduelles et à la fin d'une session. Cet horodatage précis améliore les calculs de nombre d'éénements, qui sont effectués toutes les heures. Si la session coure deux périodes d'une heure, ses éénements peuent être répartis sur deux interalles différents. Remarque : Les éénements étant enregistrés au moment où ils se produisent, ous pouez détecter des nombres d'éénements non concordants si ous recherchez une session qui se termine à une heure différente. Par exemple, si l'éénement est déclenché à 11h55 et que la session se termine à 12h05, la recherche porte sur les sessions du créneau 11h00-12h00 et ne détectera pas cette session spécifique, qui s'est terminée à une heure différente. Les données de rapport sont plus précises, mais les explorations peuent présenter des écarts. Voir "Gestionnaire d'éénements Tealeaf" dans le document IBM Tealeaf Eent Manager - Guide. 3. Toutes les sessions terminées sont toujours indexées à l'heure GMT. Les données de session et d'index Tealeaf sont agrégées quotidiennement, en fonction du jour GMT. Lors des opérations de recherche, le sereur de recherche Tealeaf applique un décalage horaire de sorte que les données de session renoyées s'appliquent à otre fuseau horaire local. Configuration du fuseau horaire du système Lors de l'installation, le fuseau horaire est défini comme étant le fuseau horaire de la machine d'installation. 14 IBM Tealeaf CX - Guide de configuration

25 Pour les solutions Tealeaf dans lesquelles tous les sereurs Tealeaf se trouent dans le même fuseau horaire, il se peut qu'aucune modification de la configuration ne soit requise. L'heure d'été étant décalée à 2h00, aucune donnée quotidienne n'est perdue en aançant ou en retardant l'heure d'une heure. Pour une implémentation sur plusieurs machines qui coure plusieurs fuseaux horaires, toutes les machines doient enregistrer les données en même temps. Par exemple, si le sereur de traitement se troue à New York et qu'un autre sereur de traitement se troue à Los Angeles, ous deez choisir et configurer un seul fuseau horaire que les deux machines reconnaissent. Sinon, les opérations telles que les recherches au cours d'une période spécifique risquent de générer des résultats incorrects. Remarque : Tous les sereurs Tealeaf doient être configurés pour utiliser le même fuseau horaire d'enregistrement. L'impossibilité de synchroniser sur le même fuseau horaire peut entraîner des comportements impréisibles. Le fuseau horaire du système peut être modifié à l'aide de TMS (Tealeaf Management System). Pour configurer le fuseau horaire du système : 1. Connectez-ous au portail en tant qu'administrateur. 2. Dans le menu Portail, sélectionnez Tealeaf > TMS. 3. Dans la ue Sereurs, sélectionnez le sereur de otre choix pour accéder à ses composants. 4. Sélectionnez le composant Tealeaf pour afficher les configurations. 5. Cliquez deux fois sur Paramètres de configuration globale de Tealeaf pour ourir la boîte de dialogue des informations de configuration. 6. Cliquez sur Editer. L'éditeur de configuration s'affiche. 7. Cliquez sur Roll Time Zone. Sélectionnez le fuseau horaire de otre choix dans la liste, puis cliquez sur Appliquer. 8. Entrez une description pour la modification dans la zone Description de ersion, puis cliquez sur Sauegarder pour sauegarder les modifications. 9. Si ous êtes inité à ajouter des tâches permettant d'enoyer la nouelle configuration, sélectionnez tous les sereurs et cliquez sur OK. 10. Pour enoyer la modification de configuration au sereur sélectionné, cliquez sur Soumettre. Traitement des incidents Pour plus d'informations concernant le traitement des incidents, oir "Traitement des incidents - Infrastructure" dans le document de dépannage d'ibm Tealeaf. Configuration du serice de transport Le composant Transport est chargé d'accepter les hits du sereur de capture, d'effectuer une série d'opérations de pipeline, puis de distribuer le hit au composant Processeur. Les opérations de pipeline sont gérées par une séquence configurable d'agents de session. Voir Chapitre 4, «Agents de session de pipeline CX», à la page 223. Le composant Processeur peut être installé sur la même que le composant Transport ou sur une machine distincte. Chapitre 2. Configuration des composants Tealeaf 15

26 Remarque : La configuration de ce composant Tealeaf peut être effectuée sur la ligne de commande en éditant un fichier stocké sur chaque sereur Tealeaf, mais il est recommandé de modifier la configuration ia Tealeaf Management System, qui ous permet d'effectuer des modifications dans un même endroit et de les appliquer à plusieurs sereurs. Voir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Accès à la configuration du serice de transport Pour configurer le serice de transport : 1. Connectez-ous au portail Tealeaf en tant qu'administrateur. 2. Dans le menu, sélectionnez Tealeaf > TMS. 3. Tealeaf Management System s'affiche. Pour plus d'informations sur la manière d'utiliser TMS, oir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. 4. Dans le menu déroulant Afficher, sélectionnez Sereurs. 5. Cliquez sur Serice de transport. Les noeuds suiants sont affichés : «Configuration du serice de transport», à la page 17 : configure le pipeline Windows par l'intermédiaire de l'éditeur de pipeline. Voir «Configuration du serice de transport», à la page 17. Configuration du filtre de confidentialité : configurez l'agent de session Confidentialité de Windows, qui permet de supprimer, masquer, chiffrer ou manipuler les données sensibles incluses dans le hit. Voir «Agent de session Confidentialité», à la page 307. Il existe également une ersion étendue de cet agent de session. Voir «Agent de session Confidentialité étendue», à la page 275. Modèles de recherche de l'analyseur de données : configurez les masques de recherche et les règles de l'analyseur de données. Voir «Agent de session Analyseur de données», à la page 260. Configuration de RTA : traitement en temps réel sur chaque hit capturé. Voir «Agent de session RTA (Real-Time Monitoring and Alert)», à la page 341. Actiation du transport SSL aec l'application de capture passie Si nécessaire, ous pouez générer des clés SSL et les utiliser pour autoriser le transport chiffré entre IBM Tealeaf CX Passie Capture Application et le serice de transport. Remarque : Le transport SSL requiert un traitement supplémentaire et peut aoir un impact sur le débit global. Voir "Opérations sur les clés SSL" dans le document IBM Tealeaf Passie Capture Application - Guide. Présentation du transport Le programme d'installation crée les opérations de pipeline par défaut. Ces dernières sont répertoriées suiant leur ordre d'exécution : DataDrop > DecoupleEx > Inflate > PriacyEx > TLTRef > SessionRouter > Canister (or Socket) Si un composant Processeur a été installé sur cette machine, le pipeline se termine par l'agent de pipeline Canister. Si le composant Processeur est installé sur une autre machine, ce pipeline se termine par l'agent Socket. 16 IBM Tealeaf CX - Guide de configuration

27 Ce pipeline peut être modifié pour inclure ou exclure d'autres opérateurs. Chaque opérateur de pipeline disponible et ses options sont décrits de manière plus détaillée dans le chapitre Agents de session de pipeline. Voir Chapitre 4, «Agents de session de pipeline CX», à la page 223. Configuration du serice de transport A l'aide de l'éditeur de pipeline de TMS, ous pouez configurer la structure et le séquencement des pipelines principaux et enfant dans le serice de transport. 1. Dans TMS, cliquez sur le noeud Serice de transport. 2. Cliquez sur Configuration du serice de transport. 3. Dans le panneau Actions de configuration, cliquez sur Afficher/Modifier. 4. La configuration actuelle du serice de transport est affichée dans l'éditeur de pipeline. Voir "Editeur de pipeline TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. Sureillance du pipeline Vous pouez sureiller les actiités dans les pipelines que ous créez ia l'onglet Statut du pipeline dans TMS. Voir "Onglet Statut du pipeline TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. Configuration du serice de transport sur la ligne de commande Sur la ligne de commande, la configuration du transport est effectuée dans le fichier TeaLeafCaptureSocket.cfg : Vous pouez ourir ce fichier ia le menu Démarrer de Windows : Démarrer > Programmes > TeaLeaf Technology > TeaLeaf CX Capture > Fichiers de configuration > Socket Capture Configuration Ce fichier est un fichier Windows au format ini, dans lequel chaque section représente une opération de pipeline. Pour plus d'informations sur la manière de le configurer, ous pouez examiner le fichier lui-même. Remarque : Lorsque ous modifiez le fichier TeaLeafCaptureSocket.cfg, ous deez redémarrer le serice de transport Tealeaf pour que les modifications soient appliquées. Il est recommandé d'effectuer les modifications ia TMS, qui gère le contrôle des ersions. Traitement des incidents Pour plus d'informations concernant le traitement des incidents, oir "Traitement des incidents - Pipeline" dans le document de dépannage d'ibm Tealeaf. Configuration du Canister CX Après l'installation, il se peut que ous deiez effectuer des opérations de configuration supplémentaires sur le Canister IBM Tealeaf CX pour des installations à un ou plusieurs sereurs. La modification de ces paramètres peut permettre de déployer le Canister IBM Tealeaf CX et les fonctions d'indexation sur plusieurs sereurs ou ous pouez installer plusieurs Canisters sur la même machine ou sur plusieurs machines. La configuration du Canister IBM Tealeaf CX est gérée ia Tealeaf Management System, qui gère également les configurations des autres composants Tealeaf. Il peut être utilisé pour afficher et éditer la configuration du sereur IBM Tealeaf CX Chapitre 2. Configuration des composants Tealeaf 17

28 sur l'ordinateur local ou sur un ordinateur éloigné. Cette section décrit comment utiliser TMS pour gérer les configurations de Canister IBM Tealeaf CX. Pour plus d'informations générales sur TMS, oir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Remarque : Le fichier ctsrr.cfg dans le répertoire d'installation de Tealeaf contient un paramètre LOCAL_DIRECTORY qui définit le répertoire racine des Canisters. Les noms du répertoire de Canister sont spécifiés comme chemins d'accès par rapport au répertoire LOCAL_DIRECTORY, dans la section Emplacement du Canister de la configuration du Canister. Ne spécifiez pas comme répertoire LOCAL_DIRECTORY le répertoire racine d'un olume, tel que C:. Pour afficher ou éditer les paramètres de configuration du Canister : 1. Connectez-ous au portail en tant qu'administrateur. 2. Dans le menu Portail, sélectionnez Tealeaf > TMS. 3. Dans la ue Sereurs, sélectionnez le sereur de otre choix pour accéder à ses composants. 4. Cliquez sur le composant Canister pour afficher les configurations. 5. Cliquez sur Configuration du Canister pour afficher les informations de configuration. 6. Cliquez sur Afficher/Modifier. L'éditeur de configuration s'affiche. Les onglets d'options de configuration suiants sont disponibles pour la configuration du Canister à l'aide de TMS. Présentation du Canister Le Canister Tealeaf se compose de deux bases de données conçues pour la capture, l'éaluation et le stockage de données de session Tealeaf. Canister à court terme : cette base de données en mémoire permet de stocker les hits transmis au Canister à partir du serice de transport ou de l'agent de session HBR (Health-Based Routing). Pour chaque session, chaque occurrence est ajoutée au STC, associée aux autres occurrences de la session et éaluée pour les éénements. Une fois que la session a été fermée, elle est déplacée ers le Canister à long terme. Canister à long terme : une fois qu'une session a été fermée, elle est enregistrée sur une base de données sur disque appelée Canister à long terme. Ces sessions stockées sur disque sont ensuite indexées pour la recherche. Processus du Canister Le processeur de Canister comprend un processus de gestionnaire : TlCanMgr.exe. Ce processus gère quatre types de processeurs auxiliaires: Les processus TLEentProc.exe éaluent les occurrences des éénements. Le processus TLSesnCloser.exe éalue les sessions arriées à expiration pour les éénements de nieau session. Les processus TLSesnArchier.exe préparent et stockent les sessions. Le processus TLEentBus.exe traite les éénements placés dans la file d'attente du bus d'éénements. Remarque : Pour arrêter et redémarrer le gestionnaire de Canister, utilisez les raccourcis du menu Démarrer sous l'en-tête du portail IBM Tealeaf CX. Le raccourci du menu Démarrer exécute CanScs.exe, qui gère le flux de hits dans les 18 IBM Tealeaf CX - Guide de configuration

29 opérations de Canister et de spoulage. L'utilisation du panneau de configuration des serices Windows pour arrêter et démarrer le gestionnaire de Canister peut entraîner une perte de données. Sécurité du Canister Ports du Canister Les Canisters Tealeaf requièrent deux ports ouerts. Par défaut, ces ports sont les suiants : Port Description 5597 Permet les communications SQL entre l'application du portail et les Canisters à l'aide des bibliothèques naties de Canisters. Ce port prend en charge les processus Tealeaf tels que le collecteur de données, le gestionnaire de Canisters et les autres agents de session. Remarque : Ce port est sécurisé à l'aide du compte TLUSER ou ADMIN et de son mot de passe, que ous spécifiez dans la page Gestion du portail. Voir "Gestion des sereurs Tealeaf" dans le document IBM Tealeaf cximpact - Guide d'administration Permet les communications entre le sereur de recherche et le Canister pour rechercher les informations de session. Il existe deux types de communications : Lecture seule : recherche dans le Canister les informations de statut des processus Tealeaf (par exemple, le statut du Canister, le statut du régulateur, etc.). Aucune authentification n'est requise. Manipulation des données : recherche les données de session ou exécute une commande sur le Canister. Remarque : Pour permettre l'authentification des opérations de manipulation des données sur le Canister, l'authentification NT doit être actiée. Voir "Authentification" dans le document IBM Tealeaf cximpact - Guide d'administration. Voir "Liste de contrôle préinstallation CX" dans le document IBM Tealeaf CX - Guide d'installation. Données de session Sur le disque du Canister, les données de session sont chiffrées à l'aide du chiffrement 3DES. Voir "Normes de chiffrement Tealeaf" dans le document IBM Tealeaf cximpact - Guide d'administration. Chemins UNC L'utilisation des chemins UNC est prise en charge dans la configuration des Canisters Tealeaf. Remarque : Pour le sereur de traitement (Canister), ous deez effectuer une installation en local, puis insérez les chemins UNC dans la configuration du Canister une fois l'installation terminée. Application des modifications de configuration de Canister Le Canister étant un composant à hautes performances intégré dans la capture et le flux de traitement, les modifications doient être appliquées aec précautions. Chapitre 2. Configuration des composants Tealeaf 19

30 Lorsque ous appliquez les modifications au Canister, ne sélectionnez Ajouter des tâches de redémarrage que si ous modifiez le nombre de processeurs de hits et de sessions : Onglet Contrôles de serices : Processeurs de hits Onglet Contrôles de serices : Processeurs de sessions Si ces paramètres sont modifiés, un redémarrage du serice de transport est également requis car le gestionnaire du Canister demande au serice de transport de commencer le spoulage du flux de données. Remarque : Une fois que ous aez modifié les paramètres du Canister et redémarré le serice de transport, les hits peuent être différés jusqu'à ce que le Canister soit actif. Dans certains cas, l'agent de session Découpleur étendu ne reçoit pas de notification comme quoi le Canister a été redémarré et les hits continuent d'être différés bien que le Canister soit prêt à les receoir. Dans ce cas, un redémarrage de tous les serices Tealeaf est requis. Le redémarrage du serice de transport redémarre le flux du flux de données. Voir «Configuration du serice de transport», à la page IBM Tealeaf CX - Guide de configuration

31 Onglet Serices du canister Figure 1. Onglet Serices du canister Chapitre 2. Configuration des composants Tealeaf 21

32 Indexation en texte libre A des fins d'indexation, les sessions sont extraites directement du Canister. Paramètre Description Location of Files to be Indexed Lorsqu'il extrait des données du Canister, le serice d'indexation de Tealeaf utilise le répertoire spécifié pour stocker ses fichiers de traaux. Compression du Canister (CanTrim) CanTrim consere les sessions dans le Canister à long terme pendant le nombre de jours spécifié et supprime les données de session antérieures au nombre de jours spécifié. Par exemple, si ous aez spécifié sept jours pour CanTrim, ce dernier consere sept jours de sessions et supprime les données de session antérieures à sept jours. CanTrim supprime à la fois les fichiers LSSN*.dat et LSSN*.idx. Il enoie également un message à l'indexeur de session pour supprimer les index dtsearch correspondants. Remarque : Si ous utilisez CanTrim pour supprimer des sessions de l'archie à long terme, les statistiques sur les sessions supprimées sont toujours affichées dans les graphiques et les récapitulatifs de rapport du portail. Paramètre Description CanTrim Enabled Actie l'élagage des données de session. Time of Day to Run CanTrim Remarque : Choisissez une heure creuse pour élaguer les données de session de tous les Canisters actifs. Delete session data only after backup Demande à CanTrim de ne supprimer que les Canisters du jour dont le bit d'archiage est effacé, ce qui correspond à toutes les sessions antérieures au nombre de jours spécifié. Si ous exécutez Backup aant CanTrim, désélectionnez cette aleur pour que CanTrim puisse supprimer des sessions. Si ous laissez cette aleur sélectionnée sans exécuter Backup, CanTrim ne supprime jamais de sessions et la taille du Canister à long terme continue d'augmenter. Si cette option est sélectionnée, lorsque CanTrim est exécuté, ous pouez oir les erreurs suiantes dans le journal : 03/25/12 00:40:58 DeleteLSSNDataFile: Skip trimming data file CANISTER.dbs\LSSN_<date>_<serername>.dat, archie bit is set Ces erreurs indiquent que les sessions n'ont pas pu être élaguées car elles n'ont pas encore été archiées. Il se peut que ous deiez configurer otre traail de sauegarde de sorte qu'il soit exécuté aant le moment où l'opération CanTrim doit être exécutée. Voir "TLBackup et TLRestore" dans le document IBM Tealeaf cximpact - Guide d'administration. Number of Days to Retain Data Le nombre de jours de données dans l'archie à long terme ne doit pas saturer l'espace sur otre disque dur. Remarque : Ce paramètre doit être configuré conjointement aec Backup, qui sauegarde les fichiers de Canister, de rapport et d'index. Par exemple, 22 IBM Tealeaf CX - Guide de configuration

33 si ous souhaitez effectuer une sauegarde tous les jours, définissez CanTrim de sorte que les fichiers de session soient supprimés un jour sur deux. Configuration du nombre de jours de conseration des données de session Pour chaque Canister, les données de session sont stockées sur l'unité locale du Canister, dans l'emplacement spécifié par LOCAL_DIRECTORY dans la configuration du sereur de Canister. Par défaut, Tealeaf est configuré pour conserer les données des sessions terminées dans chaque Canister de otre enironnement pendant sept (7) jours. Remarque : Les données de Canister sont stockées sur le disque désigné du Canister (sereur de traitement). Elles ne sont pas stockées dans une base de données SQL Serer. Remarque : Lorsque les données atteignent une ancienneté supérieure au nombre de jours de conseration maximal autorisé, la prochaine opération de compression du Canister supprime les données de l'unité locale. A moins que les données ne soient archiées ou sauegardées dans un autre emplacement, elles ne sont plus accessibles. Si nécessaire, ous pouez modifier le nombre de jours pendant lesquels les données sont conserées dans chaque Canister de otre enironnement. Utilisez les étapes ci-après pour érifier l'espace disponible et modifier en conséquence le nombre de jours pendant lesquels les données sont conserées dans le Canister. Remarque : N'utilisez pas ces étapes pour modifier l'emplacement de stockage des données de session sur chaque Canister. Ce processus implique plusieurs étapes supplémentaires et doit être effectué aec l'aide de Tealeaf. Pour plus d'informations, contactez Tealeaf Remarque : Aant de commencer, ous deez effectuer une sauegarde de chaque Canister dont ous souhaitez modifier le nombre de jours de conseration. Voir "TLBackup et TLRestore" dans le document IBM Tealeaf cximpact - Guide d'administration. Accès au système de gestion : Accès à Tealeaf Management System : 1. Tealeaf > TMS. Tealeaf Management System s'affiche. Voir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. 2. Cliquez sur l'onglet WorldView. Voir "Onglet TMS WorldView" dans le document IBM Tealeaf cximpact - Guide d'administration. 3. Sélectionnez Sereurs dans le menu déroulant Afficher. 4. Effectuez les étapes ci-après pour chaque Canister de otre enironnement Tealeaf. Traitement des Canisters : 1. Cliquez sur le sereur qui héberge l'un de os Canisters. 2. Cliquez sur le noeud Sereur de Canister. 3. Cliquez sur Configuration du sereur de Canister. Chapitre 2. Configuration des composants Tealeaf 23

34 4. Cliquez sur Afficher/Modifier. La boîte de dialogue de configuration du Canister s'oure. 5. Déeloppez le noeud Par défaut. 6. Examinez la aleur de LOCAL_DIRECTORY. 7. Vérifiez l'espace disponible sur ce olume. Aant de modifier le nombre de jours de conseration, ous deez érifier que l'espace disponible est suffisant pour stocker les données si ous en augmentez la quantité. Remarque : Généralement, ce olume correspond à celui du Canister, mais ous deez le érifier. 8. Si l'espace disponible est suffisant, ous pouez modifier la aleur du paramètre Nombre de jours de conseration des données. Cette aleur définit le nombre de jours pendant lesquels les données de session seront conserées dans le Canister. Si les données sont antérieures à cette aleur, les opérations d'élagage des données dans le Canister les supprime de manière permanente. a. Cliquez sur le noeud du Canister, qui est un noeud différent dans la ue Sereur. b. Cliquez sur Configuration du Canister. c. Cliquez sur Afficher/Modifier. La boîte de dialogue de configuration du Canister s'oure. d. Cliquez sur l'onglet Serices de Canister. e. Le paramètre à modifier est Nombre de jours de conseration des données. f. Si ous augmentez le nombre de jours de conseration : commencez par une légère augmentation pour en obserer l'impact sur l'espace disponible dans otre olume. g. Si ous diminuez le nombre de jours de conseration : Remarque : Si ous réduisez le nombre de jours de données conserées, la prochaine opération d'élagage du Canister supprime les données maintenant identifiées comme plus anciennes que le tout noueau nombre de jours de conseration. Ne spécifiez jamais une aleur inférieure à Cliquez sur Sauegarder. 10. Soumettez la tâche et exécutez le traail immédiatement. 11. Répétez les étapes ci-dessus pour chaque Canister de otre enironnement Tealeaf. Onglet Contrôles de serices Dans l'onglet Contrôles de serices, ous pouez configurer la manière dont les aleurs numériques sont traitées, le nombre d'unités de traitement à utiliser et la quantité de mémoire dur le sereur de traitement réserée pour le Canister à court terme. 24 IBM Tealeaf CX - Guide de configuration

35 Figure 2. Onglet Contrôles de serices Paramètre Description Max Ctree Bytes Indique la quantité de mémoire à allouer au sereur de Canister Tealeaf. La quantité de mémoire est calculée lors de l'installation en fonction de la mémoire physique disponible. Decimal Character for Numbers (obsolète) Pour les aleurs numériques, ous pouez spécifier le caractère à utiliser comme séparateur décimal. Vous pouez choisir entre. et,. Par défaut, cette aleur est définir sur. Ce paramètre est ignoré si Local number formats est spécifié. Local number formats Liste séparée par des irgules de noms de formats numériques locaux au format IETF BCP 47, tels qu'en-us ou fr-ch, à utiliser lors de l'analyse des attributs de hit numériques. Si ce paramètre n'est pas spécifié, Tealeaf utilise une liste par défaut de deux formats. Le premier format utilise le paramètre du caractère décimal des nombres comme séparateur décimal et l'alternatie comme séparateur des milliers. Le second format utilise l'inerse. Chapitre 2. Configuration des composants Tealeaf 25

36 Remarque : IBM Tealeaf commence par analyser les nombres dans chaque format local en demandant que le nombre soit formaté exactement comme préu. Il essaie ensuite de réanalyser les nombres pour chaque enironnement local dans un mode qui ignore les séparateurs de milliers manquants ou mal placés. Cela peut générer des résultats inattendus. Par exemple, est conerti correctement en 12,345,678 dans l'enironnement local fr-fr. Les éénements qui extraient des nombres lisibles par la machine (pas de séparateur de milliers et un point (.) comme séparateur décimal), tels que des données JSON ou XML, doient être enregistrés comme des éénements personnalisés, analyser l'attribut de hit dans le code JaaScript et appeler setfact() aec la aleur numérique au lieu d'une chaîne. De cette manière, ils fonctionnent indépendamment des formats numériques locaux. Parse Numerics as Currency Si la aleur True est spécifiée, les aleurs numériques détectées dans les données de session sont traitées comme des aleurs de deise. Ces aleurs sont arrondies à deux chiffres après la irgule et le paramètre Decimal Character for Numbers est appliqué. Processeurs Ces contrôles permettent de configurer les unités de traitement utilisées pour éaluer les hits et les sessions dans le Canister. Remarque : Pour chaque Canister, il est rarement nécessaire d'augmenter le nombre total de processeurs de hits et de sessions au dessus de 8. Le choix d'une limite logicielle supérieure peut aoir des impacts importants sur les performances du système et être à l'origine d'un spoulage et d'une perte de données potentielle. Paramètre Description Hit Processors Indique le nombre de processus à allouer pour l'éaluation des éénements de hit sur le sereur de Canister Tealeaf. Si le statut du découpleur signale un spoulage en raison d'un nombre éleé de hits non éalués, l'augmentation du nombre de processeurs de hits permet d'atténuer cette condition. La aleur par défaut est 2. Remarque : Pour appliquer les modifications apportées à cette aleur, le serice de transport est requis. Voir «Configuration du serice de transport», à la page 15. Session Processors Indique le nombre de processus à allouer pour l'archiage des sessions sur le sereur de Canister Tealeaf. Si le statut du découpleur signale un spoulage en raison d'un nombre éleé de sessions en attente d'archiage, l'augmentation du nombre de processeurs de sessions permet d'atténuer cette condition si un débit d'e-s excédentaire est disponible. L'une des principales fonctions du processeur de sessions consiste à compresser les sessions pour les stocker, ce qui augmente la itesse à laquelle les sessions sont prêtes à être enregistrées sur disque. La aleur par défaut est 2. Remarque : Pour appliquer les modifications apportées à cette aleur, le serice de transport est requis. Voir «Configuration du serice de transport», à la page IBM Tealeaf CX - Guide de configuration

37 Limites de sécurité du Canister Tealeaf fournit un ensemble de contrôles permettant de définir la taille maximale d'une session en termes de hits, d'octets ou de durée. Ces contrôles peuent être configurés ia le mode Aancé dans le gestionnaire d'éénements. Voir "Tutoriel EES Tealeaf" dans le document IBM Tealeaf Eent Manager - Guide. Onglet Réalisation de serices Cet onglet contient des contrôles pour diers paramètres d'expiration dans le Canister. Vous pouez également actier le bus d'éénements à l'aide de cet onglet. Voir "Bus d'éénements Tealeaf" dans le document IBM Tealeaf cxconnect for Data Analysis - Guide d'administration. Chapitre 2. Configuration des composants Tealeaf 27

38 Figure 3. Onglet Réalisation de serices 28 IBM Tealeaf CX - Guide de configuration Paramètre Description Session Idle Seconds Indique que si aucun hit ne parient à une session au cours du nombre de secondes spécifié, la session est marquée comme fermée et aucun autre hit n'y est ajouté. Si des hits supplémentaires arrient aec le même ID session TLT une fois que la session a été fermée, ils sont sauegardés dans une nouelle session.

39 Les délais d'expiration de chaque session peuent également être modifiés par les éénements déclenchés. Consultez la section "Onglet Eénements TEM" du manuel IBM Tealeaf Eent Manager Manual. Régulateurs de Canister Les régulateurs de Canister permettent de modifier le délai pendant lequel les statistiques et les enregistrement de données sont conserés dans le Canister à des fins de collecte des données ou autres. Paramètre Description Current Image Statistics Size Indique le nombre maximal d'enregistrements à conserer dans la table NIMG (statistiques d'affichage de l'interface graphique du Canister à court terme). La spécification de la aleur 0 désactie cette fonction et autorise une croissance illimitée. La aleur par défaut est 10. Alert records time to lie Nombre de secondes pendant lesquelles les statistiques d'image actuelles sont conserées dans le Canister. La aleur par défaut est de secondes, soit 72 heures. Si le serice d'alerte est désactié pour une période supérieure à ce paramètre, les données d'alerte risquent d'être perdues. Voir «Configuration du serice d'alerte», à la page 145. Fact aggregation records time to lie Nombre de secondes pendant lesquelles les enregistrements d'agrégation des faits sont conserés dans le Canister. La aleur par défaut est de secondes, soit 72 heures. Si le collecteur de données est désactié pour une période supérieure à ce paramètre, les données d'alerte risquent d'être perdues. Le collecteur de données doit être actié et connecté à chaque Canister actif. Voir "Paramètres CX" dans le document IBM Tealeaf cximpact - Guide d'administration. Dimension alues records time to lie Nombre de secondes pendant lesquelles les aleurs de dimension sont conserées dans le Canister. La aleur par défaut est de secondes, soit 72 heures. Si le collecteur de données est désactié pour une période supérieure à ce paramètre, les aleurs des données de dimension sont perdues. Le collecteur de données doit être actié et connecté à chaque Canister actif. Voir "Paramètres CX" dans le document IBM Tealeaf cximpact - Guide d'administration. Path statistics records time to lie Nombre de secondes pendant lesquelles les statistiques d'image actuelles sont conserées dans le Canister. La aleur par défaut est de secondes, soit 72 heures. Si le collecteur de données est désactié pour une période supérieure à ce paramètre, les données d'alerte risquent d'être perdues. Le collecteur de données doit être actié et connecté à chaque Canister actif. Voir "Paramètres CX" dans le document IBM Tealeaf cximpact - Guide d'administration. Chapitre 2. Configuration des composants Tealeaf 29

40 Bus d'éénement Le bus d'éénements Tealeaf achemine les données de la base de données en mémoire ers le composant approprié pour les traiter. Pour plus d'informations sur la configuration du bus d'éénements, oir "Bus d'éénements Tealeaf" dans le document IBM Tealeaf cxconnect for Data Analysis - Guide d'administration. Paramètre Description Enable Eent Bus Actie le pipeline du bus d'éénements pour l'exportation des éénements. Remarque : Une fois que ous aez actié ou désactié le bus d'éénements, éditez la aleur du fichier de configuration du pipeline, même si ous n'aez pas l'intention d'effectuer des modifications. Lorsque ous cliquez sur Appliquer, TMS alide l'existence du fichier et actie ou supprime la configuration du bus d'éénements dans l'onglet TMS WorldView. Cette anomalie sera corrigé dans une prochaine build. Include Response Lorsque ous exportez des éénements, incluez le fichier de réponses de la page dans le paquet d'éénements. Remarque : L'inclusion de la réponse peut augmenter considérablement le olume de données enoyées au bus d'éénements. N'actiez cette option que si ous êtes certain que le système de destination peut traiter ce olume de données supérieur. Pipeline Configuration File Chemin d'accès au pipeline d'agent de session utilisé pour exporter les éénements. Remarque : Le bus d'éénements doit être configuré à l'aide de l'éditeur de pipeline dans Tealeaf Management System. Voir "Bus d'éénements Tealeaf" dans le document IBM Tealeaf cxconnect for Data Analysis - Guide d'administration. Voir "Editeur de pipeline TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. 30 IBM Tealeaf CX - Guide de configuration

41 Onglet Consignation des Canisters Figure 4. Onglet Consignation des Canisters Paramètre Description Canister Log Leel Définissez le nieau de consignation du Canister : Erreur : le nieau Erreur inclut les messages d'erreur. Chapitre 2. Configuration des composants Tealeaf 31

42 Aertissement : le nieau Aertissement inclut les messages de nieau Aertissement et Erreur. Info : le nieau Info inclut les messages de nieau Informations, Aertissement et Erreur. Il s'agit du paramètre par défaut. Débogage : le nieau Débogage inclut tous les messages de débogage et tous les messages des trois autres nieaux. Remarque : Le nieau de débogage ne doit être utilisé que pour déboguer des problèmes spécifiques car les fichiers journaux peuent deenir assez olumineux. Dès que le problème est résolu, ous deez affecter au nieau de consignation l'un des paramètres moins prolixes. Consignation des performances des éénements Les performances de l'éaluation des éénements dans le Canister peuent être sureillées à l'aide des fonctions de consignation que ous actiez dans cette section. Remarque : Les éénements pouant être déclenchés aec un débit éleé dans le Canister, ous deez tester la fréquence et les exemples de débit pour sureiller la taille des journaux générés. Paramètre Description Enable Eent Performance Logging Actie ou désactie la consignation des performances de l'éaluation des éénements, qui inclut des informations statistiques sur les éénements déclenchés. Logging Frequency (sec) Définit l'interalle auquel les entrées des performances des éénements sont insérées dans le journal. La aleur par défaut est de 3600 secondes (une fois par heure). Sample Rate Pourcentage d'éénements testés pour la consignation des performances des éénements. La aleur par défaut est d'un éénement sur dix. Si ous spécifiez la aleur 1, les données de performances sont collectées sur chaque éaluation d'éénement. Statistiques de Canister Par défaut, le sereur du Canister Tealeaf sureille les informations statistiques et soumet périodiquement les hits des statistiques pour les capturer et les stocker dans la base de données Tealeaf. Ces statistiques peuent être examinées par l'intermédiaire du tableau de bord Statistiques système de Tealeaf. Voir section "Statistiques système" du Manuel d'administration d'ibm Tealeaf cximpact. Configuration du sereur de Canister Lors de l'installation, le sereur de Canister Tealeaf est configuré et actié automatiquement. Vous pouez configurer le sereur de Canister ia TMS, mais ous ne deriez pas aoir à effectuer des ajustements une fois que le logiciel a été installé et configuré correctement. Remarque : A moins que ous ne rencontriez des problèmes lors de la connexion ou de l'interaction aec os Canisters à court terme ou à long terme, ous ne deriez pas aoir besoin d'apporter des modifications à la configuration du sereur de Canister. Pour plus d'informations, accédez au site 32 IBM Tealeaf CX - Guide de configuration

43 Pour configurer le sereur de Canister : 1. Connectez-ous au portail Tealeaf en tant qu'administrateur. 2. Pour ourir TMS, sélectionnez Tealeaf > TMS. Voir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. 3. Déeloppez le noeud Sereur de Canister. 4. Cliquez sur Configuration du sereur de Canister. 5. Dans la sous-fenêtre Actions de configuration, cliquez sur Afficher/Modifier. 6. La configuration du sereur de Canister s'affiche. Les paramètres suiants sont disponibles : Paramètres aancés Paramètre Description DAT_MEMORY Mémoire réserée pour les tables de données système (octets). La aleur par défaut est de 50 Mo. DISK_FULL_LIMIT Si l'espace disque disponible descend sous cette aleur, il est considéré comme saturé. Les aleurs sont spécifiées sous forme d'un nombre de mégaoctets suii de Mo. La aleur par défaut est de 100 Mo. SIGNAL_READY Chemin d'accès complet à l'utilitaire TLTMaint. Paramètres par défaut Paramètre Description CHECKPOINT_FLUSH La aleur par défaut est 17. CHECKPOINT_INTERVAL Fréquence en termes de mégaoctets traités à laquelle une mise à jour de point de contrôle est effectuée. La aleur par défaut est 10 Mo. COMMIT_DELAY Délai en millisecondes entre le lancement et l'exécution d'une commande de alidation. La aleur par défaut est 2. IDX_MEMORY Mémoire réserée pour les index de Canister en octets. La aleur par défaut est de (eniron 200 Mo). LOCAL_DIRECTORY Chemin d'accès complet au répertoire du Canister. Remarque : La modification de la aleur de LOCAL_DIRECTORY requiert une régénération du Canister. Voir "Traitement des incidents - Canister" dans le document de dépannage d'ibm Tealeaf. LOG_SPACE Espace indiqué sur le périphérique de stockage pour les données de journal. La aleur par défaut est 120 Mo. LOG_TEMPLATE Identificateur du modèle de journal ctree. La aleur par défaut est 2. Chapitre 2. Configuration des composants Tealeaf 33

44 TRANSACTION_FLUSH La aleur par défaut est Une fois que les modifications ont été sauegardées, le sereur de Canister doit être redémarré pour que les modifications soient appliquées. Voir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Traitement des incidents Pour plus d'informations concernant le traitement des incidents, oir "Traitement des incidents - Canister" dans le document de dépannage d'ibm Tealeaf. Configuration de l'indexation CX Un index de session est une base de données qui stocke les emplacements de termes et de zones significatifs dans chaque session. Un index ne contenant pas tout le texte de chaque session, il peut conserer une quantité importante d'informations de session dans un même fichier. Les mots ides, tels que "mais" et "si" ne sont pas indexés. Une fois qu'une session a été fermée par le Canister à court terme, le sereur IBM Tealeaf CX indexe automatiquement les sessions sélectionnées pour archiage. Les fichiers d'index recherchent les occurrences de données ou codes d'erreur pour lesquels ous pouez configurer des éénements dériés et mener des recherches de données capturées plus efficaces. Le moteur de recherche sous-jacent prend en charge de nombreux types de fichier et notamment les types binaires tels que les fichiers.pdf, pour l'indexation et la recherche. Si Tealeaf est configuré pour capturer et traiter ces types de fichier, le moteur de recherche indexe le fichier pour la recherche, après quoi des recherches peuent y être effectuées par l'intermédiaire du portail ou de RTV. Les documents utilisant certains formats sont conertis par le moteur de recherche en HTML afin de pouoir être affichés. Le document d'origine est conseré comme partie intégrante de l'enregistrement de session. Remarque : Le moteur de recherche ne compte généralement pas sur l'extension de fichier pour identifier les types de fichier. Toutefois, ous deez configurer IBM Tealeaf CX Passie Capture Application pour qu'il capture les types de données non standard à l'aide de l'extension du nom de fichier. Voir "Console Web de la PCA - Onglet Pipeline" dans le document IBM Tealeaf Passie Capture Application - Guide. Voir Voir Présentation de l'indexation Le serice Indexeur de session conertit la session d'archiage à long terme au format XML. 34 IBM Tealeaf CX - Guide de configuration 1. Il supprime les balises HTML et les caractères XML non alides. 2. Les index sont nommés par jour, en fonction de l'heure du dernier hit. 3. Les fichiers XML sont ensuite conertis en fichiers d'index de session et sauegardés dans le répertoire Canister\Indexes. Le XML peut ensuite être conseré ou supprimé. Pour économiser de l'espace disque, Tealeaf recommande de supprimer ce XML (paramètre par défaut).

45 La fréquence à laquelle le serice Indexeur recherche les sessions à indexer dépend du paramètre Délai d inactiité. Voir «Onglet Heures de fonctionnement», à la page 46. Une fois que les fichiers d'index de session ont été créés, ils peuent être utilisés à la fois par le portail et IBM Tealeaf CX RealiTea Viewer pour rechercher les sessions stockées dans le Canister à long terme. Pour plus d'informations sur la recherche de sessions dans le portail, oir "Recherche de données de session" dans le document IBM Tealeaf cximpact - Guide d'utilisation. Pour plus d'informations sur la recherche de sessions dans RTV, oir "RealiTea Viewer - Recherche de sessions" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Traitement des index Une fois qu'une session a été sauegardée dans le Canister à long terme, elle est indexée. Lors de l'indexation, les hits de la session, les éénements du Canister et les informations récapitulaties du Canister sont enregistrés au format XML et enoyés au moteur d'indexation. Les paramètres qui contrôlent le traitement en temps réel des index sont disponibles ia TMS. Voir «Configuration», à la page 36. Processus d'indexation multiples L'opération d'indexation d'ibm Tealeaf CX comprend une série de sous-programmes à une seule unité d'exécution exécutés de manière temporelle. Vous pouez modifier le nombre de processus exécutés simultanément. Le programme d'indexation est exécuté en arrière-plan et sureille les données de session capturées pour l'indexation. Il exécute les sous-programmes appropriés pour effectuer le traail aux heures adéquates. Ces sous-programmes sont les suiants : 1. IndexCheck : s'assure que les index sont synchronisés aec le fichier de bibliothèque et effectue une opération de érification permettant de s'assurer que les index sont corrects. 2. IndexMerge : fusionne plusieurs index. 3. IndexMultiProcess : conertit les documents aux formats multiples en index et sauegarde ces index dans le répertoire <répertoire_installation_tealeaf>\ Canister\Indexes. 4. IndexDelete : supprime des sessions de l'index si d'autres composants Tealeaf le demandent. Remarque : Si le programme d'indexation est en cours d'exécution, les sous-processus tels qu'indexmerge ou IndexCheck ne peuent pas être lancés à partir de la ligne de commande. Il est préférable de planifier l'exécution de ces sous-processus ia TMS. Programme d'indexation (IndexProgram.exe) Le programme d'indexation boucle de manière continue, en recherchant les opérations d'indexation à effectuer, jusqu'à ce qu'un arrêt soit demandé. S'il en troue, il érifie l'espace disque, puis lance le processus. Le programme d'indexation extrait une liste des sessions non indexées. Les fichiers de traail sont générés, chacun contenant une liste de sessions non indexées à indexer dans un même lot. Chapitre 2. Configuration des composants Tealeaf 35

46 Le nombre de fichiers de traail générés dépend du paramètre des fichiers de traail par lots et du nombre de processus disponibles. Les types de fichier suiants sont alides pour l'indexation : TLA : fichiers d'archie Tealeaf capturés TLC : fichiers d'archie Tealeaf du Canister Les fichiers TLA et TLC ne sont généralement pas générés lors du processus de capture, mais le système peut être configuré pour cela à des fins d'identification et de résolution des problèmes. Filename.ano.yyy : fichiers d'annotations Si le fichier est filename.ano.xxx, il est indexé à l'aide de la fonction d'indexation natie de dtsearch pour les fichiers de type xxx. Le nom du fichier de traail est TeaLeafWork_nnn_mmm ou WORKTeaLeafWork_ _ où : nnn représente l'heure UNIX au moment de la création. mmm est un compteur permettant de garantir l'unicité du fichier. DOC : fichiers Microsoft Word PDF : fichiers PDF (Portable Document Format) (Adobe Reader) Les fichiers d'annotations, PDF et DOC peuent être ajoutés comme pièces jointes aux sessions ia IBM Tealeaf CX RealiTea Viewer. Pour plus d'informations sur l'ajout de commentaires et de fichiers joints à des index, oir "RealiTea Viewer (RTV) - Guide d'utilisation" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. XML : fichiers XML Le nombre de fichiers générés dépend de la formule suiante : (nombre de processus d index) x (fichiers de traail par lots) Le nombre maximal d'entrées dans chaque fichier est spécifié par le paramètre du lot de fichiers de traail. Voir «Onglet Options d'indexation», à la page 40. Vous pouez spécifier des types de contenu de réponse HTTP supplémentaires à indexer. Voir «Ajout de types de contenu de réponse HTTP pour l'indexation», à la page 49. Configuration Chemins UNC pris en charge Vous pouez entrer des chemins UNC dans toute zone de configuration qui requiert un chemin de répertoire. IP6 pris en charge Les adresses IP sont indexées pour les recherches au format IP4 ou IP6. En fonction de otre déploiement, les ersions IP6 de l'adresse sont insérées dans la demande, à partir de laquelle elles sont indexées pour être disponibles dans les recherches. Voir "Prise en charge d'ip6" dans le document IBM Tealeaf CX - Guide d'installation. Guide d'initiation Dans Tealeaf Management System, ous pouez configurer les options d'indexation. 36 IBM Tealeaf CX - Guide de configuration

47 Remarque : Les modifications apportées aux options de configuration de l'indexation ne sont pas actiées tant que le serice Indexeur de session n'a pas été redémarré ia TMS. Pour afficher ou éditer les paramètres de configuration de l'indexation : 1. Connectez-ous au portail en tant qu'administrateur. 2. Dans le menu Portail, sélectionnez Tealeaf > TMS. 3. Dans la ue Sereurs, sélectionnez le sereur de otre choix pour accéder à ses composants. 4. Sélectionnez le composant Indexeur de session pour afficher les configurations. 5. Sélectionnez Configuration du serice d'indexation. 6. Dans le panneau Actions de configuration, cliquez sur Afficher/Modifier. 7. Les onglets de configuration de l'indexation sont affichés. Pour plus d informations, oir : «Onglet Planification/Diagnostic», à la page 38 «Onglet Options d'indexation», à la page 40 «Onglet Options de fusion», à la page 44 «Onglet Heures de fonctionnement», à la page 46 Pour plus d'informations sur TMS en général, oir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Chapitre 2. Configuration des composants Tealeaf 37

48 Onglet Planification/Diagnostic Figure 5. Onglet Planification/Diagnostic Paramètre Description Index Directory Indique l'emplacement du fichier de la bibliothèque (ou commande) 38 IBM Tealeaf CX - Guide de configuration

49 d'index (ixlib.tll). Ce fichier contient l'heure à laquelle les index ont été enregistrés et une liste de tous les dossiers qui composent l'index. Maximum Number of Work Processes Ce paramètre détermine le nombre maximal de sous-processus utilisés pour effectuer le traail. La aleur par défaut est 1. Remarque : Un seul processus d'index doit être configuré à tout moment. Des processus d'index supplémentaires ne doient être configurés que si l'indexeur de session prend systématiquement du retard. L'ajout d'indexeurs de session inutiles peut augmenter l'utilisation du disque. Minimum Disk Aailable Indique la quantité d'espace minimale requise pour que le traitement de l'indexation commence. La aleur par défaut est de 100 Mo. Si des messages du journal des éénements NT de l'indexeur de session signalent un manque d'espace sur le disque en raison d'un échec lors d'opérations d'écriture, augmentez cette aleur de 25 pourcent et libérez de l'espace sur le disque contenant le répertoire <répertoire_installation_tealeaf>\canister\indexes. Planification Indique la priorité de planification des sous-programmes de l'indexation des sessions. Cette aleur détermine la classe de priorité du processus. Remarque : Ne modifiez pas ce paramètre sauf si Tealeaf ous le demande. Pour plus d'informations, consultez la documentation de otre système d'exploitation Microsoft. Nieau Indique la quantité d'informations à inclure dans le fichier journal : 5 spécifie le nieau d'informations le plus éleé. 1 spécifie le nieau d'informations le plus faible. 0 désactie intégralement la consignation. Output to Console Window Si cette option est actiée, elle génère les informations de journal dans la fenêtre de console lorsque le programme d'indexation est exécuté à partir de la ligne de commande. Enable dtsearch Logging Si cette option est actiée, la consignation des erreurs dtsearch est actiée. Chapitre 2. Configuration des composants Tealeaf 39

50 Onglet Options d'indexation Figure 6. Onglet Options d'indexation Paramètre Description Taille maximale des mots Nombre maximal de caractères par mot à indexer. Par exemple, la aleur par défaut est de 32, ce qui signifie que les caractères d'un mot après les 32 premiers caractères sont ignorés à des fins d'indexation. Remarque : La modification de cette aleur peut considérablement modifier la taille de os index. Tealeaf recommande d'utiliser le paramètre par défaut. Voir «Configuration des tailles d'index», à la page 42. Taille d index maximum Spécifie la taille maximale qu'un index peut atteindre aant qu'un nouel index ne soit créé. La aleur recommandée est de 250 Mo. 40 IBM Tealeaf CX - Guide de configuration

51 La aleur maximale de ce paramètre est de 2048 Mo. Voir «Configuration des tailles d'index», à la page 42. Delete Source Files when Done Supprime automatiquement les fichiers TLA et TLC du répertoire FilesToIndex une fois qu'ils ont été traités. Ce paramètre n'est significatif que si le mode d'extraction directe n'est pas utilisé. Build Temporary XML in Memory Si cette option est sélectionnée, le XML temporaire est généré en mémoire et non sur disque. Ce mode par défaut accélère les performances système. Delete Temporary XML When Done Supprime automatiquement les fichiers XML temporaires une fois l'indexation terminée. La aleur par défaut est true. Ce paramètre doit être sélectionné si Build Temporary XML in Memory est actié. Il ne doit être désactié que si le XML est requis par un autre système, tel que l'extracteur BW. Modify Temporary XML to Comply with W3C Cette option corrige le XML pour qu'il respecte les spécifications W3C. Lorsqu'ils sont conertis en XML, certains fichiers HTML ne respectent pas la spécification W3C. Ce paramètre demande à l'indexeur de corriger le XML afin qu'il soit conforme. Cet option augmente la quantité de traail de l'indexeur et n'est nécessaire que si le XML temporaire est utilisé par une autre application. Session Batch Nombre maximal de sessions à indexer par exécution. Workfile Batch Spécifie le nombre de fichiers de traail à traiter simultanément. La aleur par défaut est 5. Direct Pull Timeout Ferme l'index si le lot d'indexation par extraction directe actuel a indexé en permanence pendant la durée spécifiée. La aleur par défaut est de 300 secondes (5 minutes). Ce paramètre permet aux processus de recherche d'utiliser l'index de manière périodique, plutôt que d'immobiliser l'index actuel exclusiement jusqu'à ce qu'un autre seuil entraîne sa fermeture. Minimum Sessions to Start Indexing Spécifie le nombre minimal de sessions requises pour lancer le traitement. Use as session batch for direct pull Si ce paramètre est sélectionné, la aleur Session Batch est utilisée pour les communications par extraction directe aec le Canister. Path for Temp XML File Spécifie l'emplacement dans lequel les fichiers XML sont générés et stockés comme étape intermédiaire dans les processus d'indexation, si l'indexation en mémoire n'est pas utilisée. Ce paramètre est utilisé conjointement aec le paramètre Delete Temp XML. Les fichiers XML ne sont pas supprimés lorsque le XML est utilisé comme entrée dans un autre système. Chapitre 2. Configuration des composants Tealeaf 41

52 Style de césure Spécifie la manière de traiter les tirets à des fins d'indexation. Voir «Indexation des tirets», à la page 43. Additional Content Types to Index Spécifie un ensemble d'un ou plusieurs types de contenu de réponse HTTP dont les données doient être indexées. Voir «Ajout de types de contenu de réponse HTTP pour l'indexation», à la page 49. Configuration des tailles d'index : Par l'intermédiaire de la configuration du Canister, ous pouez modifier les limites qui affectent la taille maximale autorisée des mots et des fichiers indexés. Limites relaties aux mots indexés : Par défaut, Tealeaf impose une limite de 32 caractères sur les longueurs des mots à indexer. Tout mot plus long que 32 caractères est tronqué à 32 caractères à des fins d'indexation. Par exemple, si la longueur de mot maximale est de 32 caractères, les mots ThisWordIsMyFaoriteWordOfAllTime et ThisWordIsMyFaoriteWordOfAllTimeNoItsNot sont tous deux indexés sous ThisWordIsMyFaoriteWordOfAllTim. Vous pouez modifier la aleur du paramètre Taille maximale des mots pour accommoder des mots plus longs si ces derniers sont couramment utilisés sur otre application Web. La longueur de mot maximale acceptée est de 128. Remarque : La modification de cette aleur peut considérablement modifier la taille de os index. Tealeaf recommande d'utiliser le paramètre par défaut. Remarque : Les modifications apportées à ce paramètre ne s'appliquent qu'aux index créés après la modification. Généralement, ces index sont créés le jour suiant. Remarque : Le moteur de recherche sous-jacent impose une limite maximale de 80 caractères sur les noms de zone. Si la longueur de mot maximale est supérieure à 80 caractères, le moteur de recherche sous-jacent limite les noms de zone à 80 caractères. Les noms de zone d'une longueur supérieure à 80 caractères ne sont pas du tout inclus dans l'index. L'utilisation de ces mots comme termes de recherche ou noms de zone ne génère aucun résultat. Si ous recherchez des mots plus longs que la taille de mot maximale admise : Vous pouez utiliser le caractère générique (*) pour effectuer une recherche. Voir "Recherche dans les données de session" dans le documentibm Tealeaf cximpact - Guide d'utilisation. Vous pouez créer une zone de recherche qui applique un hachage MD5 à la aleur. Les utilisateurs soumettent la ersion en texte intégral du terme à rechercher, qui est conertie en aleur de hachage MD5 de 32 caractères et soumise au moteur de recherche pour traitement. Voir la rubrique "Configuration des modèles de recherche" dans le document IBM Tealeaf cximpact - Guide d'administration. Tailles des fichiers d'index : Lorsque l'indexeur enregistre les fichiers d'index sur l'espace de stockage, ces fichiers sont sauegardés dans des répertoires distincts pour chaque jour. Si la taille des fichiers d'indexation d'un répertoire dépasse la Taille d index maximum, un répertoire est créé et les noueaux index ides y sont enregistrés. Les opérations d'indexation suiantes enregistrent leurs données dans le noueau répertoire. 42 IBM Tealeaf CX - Guide de configuration

53 Par défaut, la taille des répertoires d'index est limitée à 250 Mo, ce qui doit permettre l'indexation du trafic des sessions d'une journée pour un client de taille moyenne. Ce paramètre peut être modifié si nécessaire. La aleur maximale de ce paramètre est de 2048 Mo. Remarque : La taille finale du répertoire d'index généré peut être supérieure à la aleur définie pour la Taille d index maximum. Si ous deez conserer la taille du répertoire sous cette taille maximale, affectez une Taille d index maximum de 30 % inférieure à la taille maximale souhaitée. Indexation des tirets : Le moteur de recherche de Tealeaf indexe les blocs de texte, mais fournit des mécanismes pour le traitement des caractères spéciaux. Les tirets des données de session peuent être traités de plusieurs manières. Par exemple, le terme cross-reference peut apparaître dans les données indexées comme suit : crossreference cross-reference cross reference Les mots indiiduels dans une phrase contenant des tirets sont toujours indexés. Dans l'exemple ci-dessus, cross et reference sont indexés dans toutes les méthodes. Vous pouez configurer l'indexeur de session de sorte qu'il indexe le texte aec tirets à l'aide de toutes les méthodes ci-dessus ou de certaines d'entre elles. Pour spécifier le style d'indexation des tirets, affectez à Indexing Hyphen Style l'une des aleurs suiantes : Valeur Description Ignored Ignore les tirets (crossreference). Searchable Text Traite les tirets comme du texte acceptant les recherches (cross-reference). Spaces Traite les tirets comme des espaces (cross reference). Il s'agit de la aleur par défaut. Tout Effectue l'indexation dans tous les styles ci-dessus. Remarque : Le choix de la aleur Tout pour indexer tous les styles peut gonfler la taille des index et générer des résultats inattendus dans les recherches impliquant des phrases ou des mots plus longs aec plusieurs tirets. Vous deez sureiller les changements des itesses d'indexation une fois que ous aez effectué cette modification. Remarque : Pour appliquer cette modification à des sessions déjà indexés, ous deez réindexer ces sessions. Chapitre 2. Configuration des composants Tealeaf 43

54 Onglet Options de fusion Figure 7. Onglet Options de fusion Paramètre Description Sae Merged Indexes Sauegarde les index fusionnés dans le répertoire des index. Ne supprime 44 IBM Tealeaf CX - Guide de configuration

55 pas les index d'origine une fois qu'ils ont été fusionnés dans un nouel index fusionné. Ce paramètre n'est utile qu'à des fins d'identification et de résolution des problèmes. Merge Current Day Fusionne les index du jour s'ils satisfont les critères de fusion. Si ce paramètre est désactié, la fusion n'est tentée que sur les index des jours antérieurs au jour actuel. Ce paramètre est désactié par défaut pour que la fusion n'entre pas en concurrence aec le processus de création d'index pour les données entrantes du jour. Maximum Merge Size Spécifie la taille maximale (en Mo) d'un index fusionné. Maximum Merge Count Spécifie le nombre maximal d'index à fusionner dans un nouel index fusionné. Merge Until all Possible Merging is Complete Répète le processus de fusion jusqu'à ce que chacun des index sous Maximum Merge Size et Maximum Merge Count ait été fusionné. Chapitre 2. Configuration des composants Tealeaf 45

56 Onglet Heures de fonctionnement Figure 8. Onglet Heures de fonctionnement Paramètre Description Enable Indexing Paramètre maître permettant d'actier ou de désactier l'indexation des données Tealeaf. Enable Index Check Détermine si la chèque d'index doit être exécutée. Enable Index Check at Startup Détermine si IndexCheck doit être exécuté au démarrage. 46 IBM Tealeaf CX - Guide de configuration

57 Enable Index Merge Détermine si la fusion d'index doit être exécutée. Enable Command File Processing Détermine si les fichiers de commandes doient être exécutés. Sleep Time when No Work Indique le délai en secondes pendant lequel l'indexation doit rester inactie en l'absence de sessions non indexées ou de fichier XEQ à traiter. La aleur par défaut est de millisecondes (10 secondes). Interal Between Index Check Indique le délai d'attente en minutes entre les exécutions du processus de érification d'index. Durées de fusion Indique l'heure, au format 24 heures, d'exécution d'indexmerge pour fusionner les fichiers d'index qui satisfont les critères spécifiés sur l'onglet Options de fusion. Vous pouez ajouter plusieurs durées de fusion au cours d'une journée de 24 heures. Paramètres d'ajout Les durées de fusion sont basées sur le fuseau horaire local et non sur celui du système Tealeaf. Groupe Système Dans TMS, les options du groupe système pour l'indexation en général sont disponibles sous le noeud du composant Tealeaf. Voir "Onglet TMS WorldView" dans le document IBM Tealeaf cximpact - Guide d'administration. Traitement des incidents des index de session Voir "Traitement des incidents - Indexeur" dans le document de dépannage d'ibm Tealeaf. Format et stockage des index Les index consistent en un fichier de bibliothèque d'index (IXILB.ILB) et un groupe de fichiers d'index correspondant (*.IX). Le fichier ILB n'est utilisé que si dtsearch Desktop est actié. Les bibliothèques d'index sont essentiellement des listes qui gardent une trace des noms et emplacements de chaque index. Le fichier IXLIB.TLL contient les même informations que le fichier de bibliothèque, en plus des informations utilisées exclusiement par IBM Tealeaf CX. Format du fichier de contrôle d'indexation (IXLIB.TLL) Le tableau ci-après fournit une description de chaque balise qui constitue le fichier IXLIB.TLL, un fichier spécifique à Tealeaf utilisé par IBM Tealeaf CX RealiTea Viewer pour les recherches. Il peut être nécessaire de consulter ce fichier à des fins d'identification et de résolution des problèmes. Balise Description <Day> Version texte de la date <Julian> Date pseudo-julienne : (year ) * 1000) + DayOfTheYear Chapitre 2. Configuration des composants Tealeaf 47

58 <FirstUse> Heure UNIX de la dernière heure de la première session dans l'index <LastUse> Heure UNIX de la dernière heure de la dernière session dans l'index <IndexName> Nom de l'index <IndexPath> Chemin relatif de l'index <Valid> Cet index est-il alide? False dans certains cas, principalement lors d'une fusion pendant la création des index. <InUse> L'index est-il utilisé? <FirstSession> Identificateur de session de Canister de la première session dans l'index <LastSession> Identificateur de session de Canister de la dernière session dans l'index <CheckRequired> Une érification doit-elle être exécutée sur cet index? Cette option n'est définie que si l'indicateur -F est fourni à IndexCheck ou en cas de problème lors d'un fonctionnement normal. <IndexSize> Détermination dtsearch de la taille de l'index <DocCount> Valeur interne à dtsearch du nombre de documents pour cet index <CheckCount> Le fichier TLPIS.ix est-il à jour pour cet index? Répertoires d'index Un répertoire d'index est un sous-répertoire du répertoire TeaLeaf\Canister\ Indexes. Les répertoires d'index sont nommés aec la date et l'heure de création de l'index, au format suiant : AAAAMMJJxxx où : xxx représente trois majuscules séquentielles. Par exemple, un index créé le 12 décembre 2004 peut être stocké dans un répertoire intitulé AAA. Un fichier d'index peut représenter plusieurs sessions, une seule session ou une session partielle suiant les limites spécifiées pour os options d'indexation. Le nombre d'index créés dépend de la taille limite de chaque index spécifiée dans la boîte de dialogue Options d'indexation. Par exemple, si la taille d'un index est limitée à 50 Mo, un noueau répertoire d'index est créé une fois que les fichiers du répertoire d'index actuel ont atteint cette limite. Une fois qu'un index a été créé, il est ajouté au fichier de bibliothèque et répertorié par nom de répertoire. Types de contenu indexé Les types de contenu suiants, également appelés types de support Internet et types MIME, sont indexés par défaut : 48 IBM Tealeaf CX - Guide de configuration

59 Remarque : Ces types de contenu configurés ne s'appliquent qu'aux réponses HTTP. Les demandes HTTP sont indexées en fonction des sections indiiduelles. Voir «Fichier de demande», à la page 50. text/html text/plain text/xml application/xhtml+xml application/rdf+xml application/nd.mozilla.xul+xml application/xml Ajout de types de contenu de réponse HTTP pour l'indexation : Si nécessaire, des types de contenu supplémentaires peuent être ajoutés à la liste des types de contenu qui sont automatiquement indexés par Tealeaf. Remarque : En fonction du type de contenu, IBM Tealeaf CX Passie Capture Application dera peut-être être configuré pour le capturer. Voir "Console Web de la PCA - Onglet Pipeline" dans le document IBM Tealeaf Passie Capture Application - Guide. Voici quelques-uns des types notables qui peuent être ajoutés : text/json text/x-json application/json application/x-json Remarque : L'ajout de types de contenu peut accroître la taille des index, suiant le olume de données du type de contenu ajouté. Remarque : N'ajoutez pas de types de contenu binaires pour l'indexation. Ces types ne peuent pas être indexés et, si ous passiez outre, ous n'en retireriez aucun aantage et les performances de l'indexation en pâtiraient. Pour ajouter de noueaux types de contenu, respectez les instructions ci-après. 1. Connectez-ous au portail en tant qu'administrateur Tealeaf. 2. Sélectionnez Tealeaf > TMS. 3. Cliquez sur le noeud Indexeur de session. 4. Sélectionnez Configuration du serice d'indexation. 5. Cliquez sur Afficher/Modifier. 6. Cliquez sur l'onglet Options d'indexation. 7. Sélectionnez Additional Content Types to Index. 8. Spécifiez les noueaux types de contenu sous forme de liste séparée par des irgules. Remarque : N'insérez pas d'espaces. Remarque : Aucune alidation des données n'est effectuée sur les entrées. 9. Cliquez sur Sauegarder. 10. Configurez un traail pour enoyer les modifications à tous les sereurs Tealeaf. Voir "Console Web de la PCA - Onglet Pipeline" dans le document IBM Tealeaf Passie Capture Application - Guide. Chapitre 2. Configuration des composants Tealeaf 49

60 Indexation des caractères : Certaines règles en fonction desquelles l'index effectue l'indexation de caractères spécifiques peuent être appliquées par l'intermédiaire du fichier alphabet.dat. Des règles spéciales supplémentaires peuent être appliquées à des structures de données spécifiques. Voir "Indexation des caractères" dans le document IBM Tealeaf cximpact - Guide d'administration. Eléments indexés Fichier STS : Le fichier STS contient les données qui s'appliquent à l'intégralité de la session et notamment les attributs de session. Section [CanisterSummary] Les ariables ci-après de la section CanisterSummary sont indexées. TltStsBrowser TltStsCanisterID TltStsCloseSessionEent TltStsDomain TltStsEnumValueId TltStsEentText TltStsEentUniqueId TltStsEentUniqueIdHour TltStsFirstPage TltStsFirstUse TltStsIPaddr TltStsLastUse TltStsLastPage TltStsLoginID TltStsNumHits TltStsRandomSel TltStsSesnDuration TltStsSesnID TltStsSesnIdx TltStsTLTVID TltStsTrafficType TltStsTxtPages TltStsUniqueIdAndEnumValueId TltStsUserDef TltStsUserID TltStsCustomVar0 - TltStsCustomVar63 Les zones TltStsEentUniqueId sont enregistrées dans le fichier STS suiant leur ordre d'occurrence. Un éénement n'est répertorié qu'une seule fois dans le fichier STS, mais il peut l'être plusieurs fois dans les mémoires tampon de demande d'occurrences indiiduelles. Pour plus d'informations sur ces termes, oir "RealiTea Viewer - Attributs de session" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Fichier de demande : Section [AppData] Tout est indexé dans cette section. 50 IBM Tealeaf CX - Guide de configuration

61 Si ous souhaitez indexer autre chose dans la demande, insérez-le comme paire nom/aleur dans cette section. Section [En] Seules les zones suiantes sont indexées : http_referer http_remote_addr local_addr referer remote_addr remote_host StatusCode URL Cette section peut être alimentée à partir des en-têtes de demande/réponse HTTP, de l'insertion de données PCA et d'actions de pipeline Windows. Voir "RealiTea Viewer - ue Demande" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. [Timestamp]Les zones suiantes sont indexées : NT_Grade RT_Grade WS_Grade Section [URLField] Tout est indexé dans cette section. Attributs de session En plus d'effectuer des recherches dans les données de réponse ci-dessus, les recherches en texte libre recherchent et trouent les zones ci-après dans une demande. cookies Les cookies ne sont pas automatiquement ajoutés aux index. Les sites qui utilisent des cookies peuent en aoir plusieurs qui contiennent de longues chaînes illisibles de données codées sur les informations de personnalisation, souent propre à chaque hit. L'indexation de ces chaînes génère généralement des index extrêmement olumineux. Si ous souhaitez indexer un cookie spécifique ou y effectuer des recherches, ous pouez l'ajouter à la règle RTA [IndexFields] qui copie le cookie et sa aleur dans la section [appdata] d'une demande, afin qu'il puisse être indexé et que des recherches puissent y être effectuées. Autres sections : Rien d'autre n'est indexé dans les fichiers de demande. Fichier de réponses : L'en-tête HTTP n'est pas indexé dans l'indexation standard. Section REQ : Pour l'indexation standard, les sections suiantes sont indexées : [urlfield] [appdata] [TimeBlock] : heure du hit. Voir «Section TimeBlock», à la page 52. Chapitre 2. Configuration des composants Tealeaf 51

62 [TLFID_]. Voir «Section des faits». Si elle existe dans la section [appdata], placez l'entrée <TLMergeId> à la fin du XML. Voir "RealiTea Viewer - ue Requête" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Section TimeBlock : Dans chaque demande, la section [TimeBlock], qui contient les informations temporelles liées au hit, est automatiquement insérée. Ces données sont automatiquement indexées. Voici un exemple de section [TimeBlock] : [TimeBlock] WEEK=24 MONTH=6 QUARTER=2 YEAR=2010 HOUR_OF_DAY=13 DAY_OF_WEEK=4 DAY_OF_MONTH=10 DAY_OF_YEAR= IBM Tealeaf CX - Guide de configuration Pour plus d'informations sur les définitions de chaque ariable de demande, oir "RealiTea Viewer - Vue Demande" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Section des faits : Dans l'indexation standard, chaque fait enregistré est indexé, s'il a été configuré pour accepter les recherches ia Tealeaf Eent Manager. Remarque : Les faits sont marqués pour indexation ia Tealeaf Eent Manager. Si l'indicateur Searchable est défini, la paire nom/aleur suiante est insérée dans la demande : Searchable=True Si la aleur ci-dessus est False, le fait n'est pas indexé. Si cet indicateur a la aleur true, les éléments suiants du fait sont indexés : TLFID TLFactValue TLDimHash* Exemple de définition de fait : [TLFID_78] Searchable=True TLFID=78 TLFactValue=1 TLDimHash1=926515C2EE3C2BAB9D2C675E0FD8B487 TLDimHash2=C815C31FCFF0FD2640B310579BD35BCC TLDimHash3=8CD892B7B97EF9489AE4479D3F4EF0FC TLDimHash4=04C3451BC46213B3EAD4DCBFBF9E3389 TLDim1=/store/defaultpage TLDim2= TLDim3=store TLDim4= Dans l'exemple ci-dessus, sous l'indexation standard, les deux premiers éléments et les derniers éléments de formulaire ne sont pas indexés.

63 Pour plus d'informations sur l'actiation de l'indexation de faits spécifiques, oir "Onglet Eénements TEM" dans le document IBM Tealeaf Eent Manager - Guide. Section RSP : Les en-têtes HTTP sont supprimés de l'indexation standard. Voir "RealiTea Viewer - Vue Réponse" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. TimeGrades : Les zones TimeGrades suiantes se trouent dans le XML de chaque hit : <WS_Grade> ExcellentWS </WS_Grade> <NT_Grade> ExcellentNT </NT_Grade> <RT_Grade> ExcellentRT </RT_Grade> Remarque : A part ExcellentWS, etc., les autres options sont Normal<nn>, HighNormal<nn> et High<nn>, <nn> représentant WS, NT ou RT, en fonction de la mesure. Dans les données capturées, ous pouez rechercher des nieaux de durée. Voir "Recherche dans les données de session" dans le documentibm Tealeaf cximpact - Guide d'utilisation. Pour plus d'informations sur la configuration des nieaux de durée, oir "Console Web de la PCA - Onglet Pipeline" dans le document IBM Tealeaf Passie Capture Application - Guide. Messages JSON : Les messages soumis au format JSON à partir des structures client Tealeaf sont automatiquement indexés comme paires Request/RequestBody. Remarque : Les structures client Tealeaf permettent de capturer les éénements d'interface graphique côté client des applications Web, Web mobile, ios et Android. Pour plus d'informations : Voir le document relatif à UI Capture j2 Guide dans le document IBM Tealeaf UI Capture for j2 Guide. Voir la section "Guide de référence Tealeaf d'enironnement de capture de consignation sous Android" dans le document IBM Tealeaf Android Logging Framework - Guide de référence. Voir la section "Guide de référence Tealeaf d'enironnement de capture de consignation sous ios" dans le document IBM Tealeaf ios Logging Framework - Guide de référence. Pour plus d'informations sur l'indexation des messages JSON, oir "Integrating Client Framework Data into Tealeaf" (Intégration des données de l'enironnement de capture côté client dans Tealeaf) dans le document IBM Tealeaf Client Framework - Guide d'intégration des données. Sureillance de l'indexation Vous pouez utiliser les mécanismes ci-après pour sureiller l'indexation. Statut système - Rapport Canister A partir du portail, ous pouez sureiller le statut des Canisters. Dans le menu Portail, sélectionnez Tealeaf > Statut système > Canister. Dans la liste déroulante Chapitre 2. Configuration des composants Tealeaf 53

64 IBM Tealeaf CX, sélectionnez le Canister spécifique à sureiller. Cliquez sur Rafraîchir si nécessaire. Voir "Etat du système" dans le document IBM Tealeaf cximpact - Guide d'administration. Statut système - Rapport Stockage A partir du portail, ous pouez sureiller l'indexation des sessions pendant le nombre de jours durant les quels les sessions sont conserées sur chaque sereur. Dans le menu Portail, sélectionnez Tealeaf > Statut système > Stockage. Le rapport de base fournit les exigences globales en matière de stockage de chaque Canister ou archie. Dans la liste déroulante Sereur de stockage, sélectionnez le sereur de traitement spécifique à sureiller. Cliquez sur Rafraîchir si nécessaire. Dans le rapport affiché, ous pouez comparer les aleurs de la colonne Sessions LSSN aec celles de la colonne Sessions d index de chaque jour pour déterminer si l'indexation prend du retard. Voir "Etat du système" dans le document IBM Tealeaf cximpact - Guide d'administration. Rapport de statut Tealeaf Le rapport de statut Tealeaf contient une mine d'informations sur l'état et le statut du système IBM Tealeaf CX. Pour l'indexation, ous pouez rechercher dans un rapport de statut Tealeaf généré la section "Présentation du Canister" et la section "Statut du Canister" pour des sereurs indiiduels. Si l'indexeur de session tombe en dessous d'un seuil défini pour le nombre de sessions non indexées, le rapport de statut Tealeaf inclut le message suiant : Sessions Waiting to be Indexed has broken its threshold. Pour générer un rapport de statut Tealeaf immédiat ia le portail : 1. Connectez-ous au portail en tant qu'administrateur. 2. Dans le menu Portail, sélectionnez Tealeaf > Gestion du portail. 3. Dans la page Gestion du portail, cliquez sur la sous-fenêtre Journaux dans le panneau de naigation de gauche. 4. Cliquez sur le lien Voir le statut de Tealeaf. 5. Un rapport de statut Tealeaf est généré et affiché. Voir "Rapport de statut Tealeaf" dans le document IBM Tealeaf cximpact - Guide d'administration. Journaux d'indexation Dans le répertoire Logs du répertoire d'installation de Tealeaf, les fichiers journaux contiennent des informations utiles sur l'indexation des serices : Fichier Description history.ix Journal de l'indexeur de sessions principal. TLTIndexMultiProcess*.log Messages de journal générés par le processus de génération de l'indexation. TLTIndexCheck*.log Messages de journal générés par le sous-programme IndexCheck. TLTIndexMerge*.log Messages de journal générés par le sous-programme IndexMerge. 54 IBM Tealeaf CX - Guide de configuration

65 TLTIndexSerice*.log Messages de journal du serice d'indexation de Tealeaf. Dans les noms de fichier ci-dessus, la aleur * correspond à un horodatage et à l'identificateur de processus. Ajout d'autres zones pour indexation et recherche Par défaut, Tealeaf indexe dierses données de demande de sorte que les composants et les utilisateurs Tealeaf puissent rechercher des sessions à l'aide d'une fourchette de critères. L'ensemble des zones disponibles est défini pour le cas le plus courant. Les zones spécifiques à l'application ou les données ajoutées à l'aide de composants Tealeaf facultatifs ne sont pas automatiquement disponibles pour les recherches. La section ci-après fournit un ensemble de méthodes potentielles permettant de rendre toute ariable de demande disponible pour l'indexation et la recherche. Par défaut, la plupart des solutions Tealeaf n'indexent pas les données de réponse. Méthodes et compromis Approche générale : Pour que les données soient disponibles pour l'indexation, elles doient se trouer dans une section de la demande où les données sont indexées ou y être transférées. Remarque : IndexMultiProcess ne prend pas en charge la spécification de zones ou de sections indiiduelles de la demande pour l'indexation. Toutes les données supplémentaires à indexer doient être insérées dans la section [appdata] de la demande. Toutefois, l'indexation a pour objet de rendre les données disponibles pour les recherches. Il est également possible de rendre les données de demande ou de réponse disponibles pour les recherches en créant des éénements qui capturent et stockent les aleurs comme données d'éénement. Dans les sections ci-après, les différentes approches sont décrites et des exemples sont fournis pour rendre les données disponibles pour chaque approche. Méthodes permettant de rendre l'indexation disponible pour les recherches : Utilisez les méthodes ci-après pour que les données de demande ou de réponse soient disponibles pour l'indexation. Vous pouez également utiliser ces méthodes pour transférer les données de réponse. Chapitre 2. Configuration des composants Tealeaf 55

66 Tableau 1. Méthodes permettant de rendre l'indexation disponible pour les recherches Méthode Description Aantages Inconénients Transfert des données de demande dans [appdata] A l'aide de l'agent de session Confidentialité, ous pouez transférer toutes ariable de demande dans la section [appdata] de la demande. Toutes les zones de cette section sont automatiquement indexées. Voir «Utilisation de la confidentialité pour insérer des données de demande ou de réponse pour l'indexation», à la page 57. L'agent de session Confidentialité doit déjà être déployé. Les données indexées sont disponibles dans un espace cohérent. Les données ne sont pas disponibles pour la génération de rapports. Les index sont stockés dans des Canisters indiiduels et élagués de manière périodique lorsque la session n'est plus disponible. Les données de rapport sont généralement conserées plus longtemps dans une base de données SQL. L'agent de session Confidentialité peut consommer une quantité importante de ressources, en particulier si des expressions régulières sont utilisées ou que la zone apparaît fréquemment dans les données de session. Le nombre de règles pouant être créées pour l'agent de session Confidentialité est limité. Aec deux copies des données dans la demande, des écarts peuent exister entre les noms des ariables de demande et leurs aleurs. Chaque zone supplémentaire ajoutée à l'indexation augmente la taille des index. 56 IBM Tealeaf CX - Guide de configuration

67 Tableau 1. Méthodes permettant de rendre l'indexation disponible pour les recherches (suite) Méthode Description Aantages Inconénients Création d'un éénement pour capturer les données de demande A l'aide du gestionnaire d'éénements, ous pouez créer un éénement permettant de capturer et de stocker les données de demande. A partir du portail, ous pouez ensuite rechercher des sessions à l'aide de cet éénement ou de ses aleurs. Voir «Création d'éénements pour permettre la recherche de données de session», à la page 59. Les données d'éénement sont disponibles pour la recherche et la génération de rapports. Les données d'éénement sont stockées dans la session elle-même ; les données d'indexation sont stockées à part. Par défaut, les données d'éénement sont stockées dans la base de données SQL pendant 365 jours. Les données d'éénement sont plus largement accessibles dans le portail. Par exemple, ous pouez rechercher des sessions qui contiennent des éénements en fonction de l'icône associée à l'éénement. Les éénements peuent être configurés pour être érifiés sur chaque hit, alors qu'ils ne doient l'être que sur le premier et le dernier hit, par exemple, ce qui affecte les performances du Canister. Si une expression régulière est utilisée pour définir un éénement, l'éaluation de l'éénement peut être affectée par une expression régulière dont la syntaxe est médiocre. L'ajout d'un nouel éénement augmente l'espace de stockage requis pour chaque session dans laquelle cet éénement se produit. En fonction de la fréquence à laquelle l'éénement est déclenché et du nombre de dimensions associées à l'éénement, l'augmentation de l'espace de stockage peut être considérable. Les éénements sont également stockés dans la base de données de génération de rapports et, si IBM Tealeaf cxresults fait l'objet d'une licence, dans la base de données des isiteurs. Utilisation de la confidentialité pour insérer des données de demande ou de réponse pour l'indexation L'agent de session Confidentialité peut être utilisé pour transférer les ariables de demande ou de réponse et les aleurs dans la section [appdata] de la demande, où elles deiennent automatiquement disponibles pour l'indexation. Remarque : L'ajout de nouelles zones pour l'indexation augmente la taille des index, en particulier si ces zones apparaissent fréquemment dans les données de session. En outre, en fonction des règles de confidentialité que ous créez, le noueau traitement peut entraer le débit dans le pipeline Windows. Tealeaf recommande de créer une règle de confidentialité unique pour transférer une zone de données et érifier le changement de taille dans les index aant d'ajouter daantage de règles. Chapitre 2. Configuration des composants Tealeaf 57

68 Remarque : L'ajout de nouelles zones pour l'indexation n'est pas requis pour permettre aux utilisateurs de rechercher les données. Pour rechercher des combinaisons de ariable et de aleur de demande, les utilisateurs peuent entrer le code suiant dans la zone Tout le texte : RequestVariable contains RequestVariableValue où RequestVariable = nom de la ariable de demande RequestVariableValue = aleur de la ariable de demande La méthode ci-dessus fonctionne, mais elle sollicite fortement le sereur de recherche. Tealeaf recommande de transférer les données à indexer pour rechercher les ariables de demande courantes. Exemple : La solution IBM Tealeaf CX UI Capture for AJAX de Tealeaf capture, à partir du naigateur du isiteur, les éléments qui risquent de ne pas générer de transactions aec le sereur Web, tels que les éénements d'interface utilisateur et autres propriétés, et les soumet à Tealeaf pour capture. A l'aide de Tealeaf IBM Tealeaf CX UI Capture for AJAX, ous pouez capturer un référentiel de données enrichi sur les isiteurs de otre application Web. Pour plus d'informations sur IBM Tealeaf CX UI Capture for AJAX, oir "UI Capture - Foire aux questions" dans la foire aux questions d'ibm Tealeaf UI Capture for AJAX. Si IBM Tealeaf CX UI Capture for AJAX est déployé, certains rapports de performances de Tealeaf sont alimentés aec les données capturées à partir du naigateur du isiteur. Ces rapports sont disponibles ia le portail Tealeaf. Pour plus d'informations sur la génération de rapports de performances, oir "Analyse des performances" dans le document IBM Tealeaf - Guide de génération de rapports. Toutefois, ces rapports sont générés à partir des éénements internes du Canister. A des fins de performances, le Canister ne consere pas les éénements pour refléter toutes les données possibles capturées du client. Par exemple, les exceptions détectées dans l'interface utilisateur le sont par IBM Tealeaf CX UI Capture for AJAX et sont soumis à Tealeaf, mais elles ne sont pas disponibles dans les rapports fournis. Ces informations peuent s'aérer très utiles pour aider les clients à résoudre leurs problèmes liés à otre application Web, puis communiquer ces informations aux déeloppeurs chargés de les résoudre. Si ous pouiez capturer ces informations et les stocker de sorte qu'elles soient indexées pour la recherche, les Canisters à court terme de otre entreprise pourraient rechercher ces sessions, les parcourir pour rechercher les problèmes des clients, puis fournir les sessions aux déeloppeurs afin qu'ils puissent les résoudre. Tealeaf fournit automatiquement ces informations dans le section [en] de la demande. Dans cette section, IBM Tealeaf CX UI Capture for AJAX insère la ariable de demande suiante contenant un identificateur pour le nombre d'exceptions de l'interface utilisateur client : HTTP_X_TEALEAF_PAGE_CUI_EXCEPTIONS=2 Voir "Exemple de message d'éénement client UI Capture for AJAX" dans le document IBM Tealeaf UI Capture for AJAX - Guide. 58 IBM Tealeaf CX - Guide de configuration

69 Configuration de la confidentialité : Par défaut, Tealeaf n'indexant pas cette zone, ous pouez utiliser l'agent de session Confidentialité pour transférer cette zone dans la section [appdata] de la demande. Remarque : L'exemple ci-après est créé à l'aide de la configuration brute du filtre de confidentialité. Si ous créez plusieurs règles pour transférer le contenu dans la section [appdata] de la demande, ous pouez copier et coller les ersions terminées de la règle pour créer des règles similaires. Si ous préférez utiliser l'interface TMS pour créer des règles de confidentialité, ous pouez examiner un exemple similaire permettant de configurer la mise en isites d'ibm Tealeaf cxresults. Voir "Installation de cxresults" dans le document IBM Tealeaf cxresults - Guide d'administration. Voir «Agent de session Confidentialité», à la page 307. Voir «Agent de session Confidentialité étendue», à la page 275. Pour configurer l'indexation de la confidentialité : 1. Vérifiez que la confidentialité est actiée. 2. Ourez la configuration de la confidentialité. 3. Créez une action et une règle de confidentialité. 4. Testez l'action et la règle de confidentialité. 5. Créez des règles et des actions supplémentaires. Création d'éénements pour permettre la recherche de données de session L'autre méthode permettant de rendre disponible des données de demande supplémentaires consiste à capturer les aleurs de la ariable de demande dans des objets d'éénement. Lorsque des données de demande sont capturées dans les éénements, ous pouez rechercher ces données ia le portail. Voir "Eénements" dans le document IBM Tealeaf cximpact - Guide d'utilisation. En outre, les données sont disponibles pour les rapports créés ia le générateur de rapports. Voir "Générateur de rapports Tealeaf" dans le document IBM Tealeaf - Guide de génération de rapports. Les étapes ci-après présentent une approche générale de capture des données de demande dans des objets d'éénement à des fins de recherche et de génération de rapports. 1. Identifiez les données de demande à capturer : Dans notre exemple ci-dessus, nous recherchons des données qui correspondent au masque suiant : HTTP_X_TEALEAF_PAGE_CUI_EXCEPTIONS=2 La aleur à droite du signe égal est celle à capturer et peut changer aec chaque hit. 2. Créez l'attribut de hit : ia le gestionnaire d'éénements, ous deez créer l'attribut de hit permettant de rechercher et capturer, si elles existent, ces données sur chaque hit. Propriétés clés : Définissez l'attribut de hit permettant de érifier la demande. Balise de début : \r\nhttp_x_tealeaf_page_cui_exceptions= Balise de fin : Chapitre 2. Configuration des composants Tealeaf 59

70 \r\n Vérifiez qu'il ne s'agit pas d'une recherche sensible à la casse. Voir la section sur la balise des attributs de hit TEM dans le document IBM Tealeaf - Guide du gestionnaire d'éénements. 3. Créez la dimension : ous pouez également créer une dimension proenant de l'attribut de hit pour capturer les informations contextuelles. Propriétés clés : a. Alimenté par : sélectionnez l'attribut de hit que ous aez créé. b. Alimenté aec : sélectionnez Première aleur sur la page/le hit. c. Valeurs à enregistrer : sélectionnez Liste blanche + Valeurs obserées. Remarque : Si les aleurs obserées peuent être enregistrées, les données sont immédiatement collectées et disponibles. Toutefois, chacune des instances de la dimension est enregistrée sans que le nombre d'instances ne soit limité. Chaque fois que possible, les dimensions qui enregistrent des aleurs obserées doient être conerties pour ne mettre en liste blanche que des dimensions. Voir "Gestion des données pour les dimensions" dans le document IBM Tealeaf Eent Manager - Guide. Voir "Listes blanches et les listes noires" dans le document IBM Tealeaf Eent Manager - Guide. 4. Sauegardez la dimension. 5. Validez les modifications sur le sereur. 6. Créez l'éénement : A l'aide du gestionnaire d'éénements, ous pouez créer l'éénement à déclencher à partir de l'attribut de hit. L'éénement enregistre la aleur de l'attribut de hit. Propriétés clés : Ealuer : Chaque hit Suii : Chaque occurrence Type de aleur : Numérique Etape Condition : Sélectionnez l'attribut de hit que ous aez créé. Si ous n'aez pas spécifié de libellé pour cet attribut, il se troue sous le libellé Par défaut. Définissez la condition selon laquelle le paramètre Attribut de hit détecté possède la aleur Est rai, car cette aleur n'est pas insérée en l'absence d'exceptions. Etape Valeur : Pour l'élément à enregistrer, sélectionnez l'attribut de hit que ous aez créé, ce qui signifie que la aleur numérique de l'attribut de hit est enregistrée comme aleur numérique pour l'éénement. Etape Groupes de rapports : Si ous souhaitez que l'éénement soit associé à des informations contextuelles, ous pouez associer les groupes de rapports contenant les dimensions contextuelles dans cette étape. Cette étape n'est pas obligatoire. Etape Plus d'options : Tant que ous n'êtes pas satisfait des résultats de l'éénement, il est déconseillé de les inclure dans IBM Tealeaf cxresults (si ous en possédez une licence) ou de les enoyer à d'autres composants ou objets d'éénement. a. Sauegardez l'éénement et l'attribut de hit. 60 IBM Tealeaf CX - Guide de configuration

71 b. Validez les modifications sur le sereur. Voir "Onglet Eénements TEM" dans le document IBM Tealeaf Eent Manager - Guide. 7. Testez l'éénement : pour tester l'éénement, ous pouez enoyer des échantillons de session, qui incluent les données, au testeur d'éénements. Voir la section sur le testeur d'éénement dans le document IBM Tealeaf Eent - Guide du gestionnaire. 8. Autorisez les nombres d'éénements à s'accumuler : si l'éénement et l'attribut de hit sont correctement déclenchés dans le testeur d'éénement, ous deez laisser un laps de temps suffisant pour que des occurrences de l'éénement soient détectées dans le Canister et stockées dans les données de rapport. a. En attendant, ous pouez rechercher l'éénement ia le portail. Vous deez pouoir rechercher les sessions acties qui incluent l'éénement dès qu'elles sont détectées dans le Canister. Voir "Eénements" dans le document IBM Tealeaf cximpact - Guide d'utilisation. b. Après un certain laps de temps, ous pouez créer un rapport à l'aide de l'éénement. Si ous aez créé la dimension, ous pouez également l'utiliser dans des rapports. Voir "Générateur de rapports Tealeaf" dans le document IBM Tealeaf - Guide de génération de rapports. Pour plus d'informations sur l'utilisation du gestionnaire d'éénements, consultez la section "Tealeaf Eent Manager" dans le document IBM Tealeaf Eent Manager - Guide. Traitement des incidents Pour plus d'informations concernant le traitement des incidents, oir "Traitement des incidents - Indexeur" dans le document de dépannage d'ibm Tealeaf. Chapitre sur la configuration du sereur de rapports Le sereur de rapports comprend l'application Web du portail, les bases de données et le serice de données. Pour configurer le sereur de rapports, ous pouez utiliser Tealeaf Management System (TMS). Pour plus d'informations sur TMS en général, oir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Fuseau horaire du sereur de rapports Le fuseau horaire de la machine Windows qui héberge le sereur de rapports Tealeaf doit être configuré pour correspondre au fuseau horaire du système Tealeaf. Cette exigence sera peut-être assouplie dans une ersion ultérieure. Voir «Configuration du fuseau horaire du système», à la page 13. Accès à la configuration du sereur de rapports Remarque : Les modifications apportées à la configuration du sereur de rapports requièrent un redémarrage, ce qui force tous les utilisateurs du portail Tealeaf. Effectuez ces modifications de configuration en conséquence. Chapitre 2. Configuration des composants Tealeaf 61

72 Pour afficher ou éditer les paramètres de configuration du sereur de rapports : 1. Connectez-ous au portail en tant qu'administrateur. 2. Dans le menu Portail, sélectionnez Tealeaf > TMS. 3. Dans la ue Sereurs, sélectionnez le sereur de otre choix pour accéder à ses composants. 4. Sélectionnez le composant Tealeaf pour afficher les configurations. 5. Sélectionnez Informations de configuration partagées pour afficher la boîte de dialogue Informations de configuration. 6. Cliquez sur Afficher/Modifier. L'éditeur de configuration s'affiche. Remarque : Une fois que ous aez modifié la configuration du sereur de rapports, les étapes suiantes sont requises : a. Enoyez la configuration à tous les sereurs ia TMS. b. Redémarrez le serice de données Tealeaf. Voir "Configuration du serice de données Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration. c. Réinitialisez le portail Tealeaf. Onglet Portail Les informations ci-après sont accessibles ia l'onglet Portail. 62 IBM Tealeaf CX - Guide de configuration

73 Figure 9. Onglet Portail Paramètre Description Délai d attente de session de portail Indique la durée en minutes pendant laquelle un utilisateur du portail peut rester inactif aant d'être automatiquement déconnecté. Format de date Contrôle le format d'entrée/de sortie des dates dans le portail. Chapitre 2. Configuration des composants Tealeaf 63

74 Méthode d authentification Sélectionnez l'une des aleurs suiantes : 3DES (par défaut), RC2, MD5 ou NT. L'authentification 3DES représente la méthode par défaut de toutes les nouelles installations d'ibm Tealeaf cximpact. L'authentification NT permet au portail d'utiliser un modèle d'authentification de style Windows simplifié pour les connexions des utilisateurs. Voir «Authentification NT du portail», à la page 69. Délai d expiration du sereur de recherche Indique le paramètre de délai d'expiration du sereur de recherche. La aleur par défaut est de 300 secondes (5 minutes). Autoriser la connexion en mode mixte La connexion en mode mixte permet aux utilisateurs du portail de choisir si l'authentification doit être effectuée ia la base de données Tealeaf ou la méthode du domaine Windows NT. Si la méthode d'authentification est NT, ce paramètre actie ou désactie l'affichage du lien de connexion à l'aide de l'authentification de base de données, dans la page de connexion du portail. Pour supprimer le lien, actiez cette option. Onglet Base de données Les informations ci-après sont requises lors de la connexion à la base de données, qui est automatiquement configurée lors de l'installation de Tealeaf. Remarque : Ces aleurs ne doient pas être modifiées à moins que ous apportiez des modifications spécifiques aux paramètres de connexion à la base de données (nom d'hôte aec une instance et un numéro de port). 64 IBM Tealeaf CX - Guide de configuration

75 Figure 10. Onglet Base de données Paramètre Description Sereur de base de données de rapport Définit le nom de l'hôte de la base de données. Si les bases de données se trouent sur une instance désignée, le format suiant doit être utilisé : <nom du sereur>\<nom de l instance>. Chapitre 2. Configuration des composants Tealeaf 65

76 Base de données du système Définit le nom de la base de données des rapports. La aleur par défaut est TL_SYSTEM. Base de données de rapports cximpact Définit le nom de la base de données des rapports. La aleur par défaut est TL_REPORTS. Base de données de segments de session Définit le nom de la base de données de l'extracteur d'ensemble de résultats. La aleur par défaut est TL_RSEXTRACTOR. Base de données de statistiques système Définit le nom de la base de données des statistiques du système. La aleur par défaut est TL_STATISTICS. Nom de l administrateur Définit le nom de l'utilisateur des bases de données qui dispose de droits de modification. La aleur par défaut est TLADMIN. Voir «Modification des mots de passe de base de données». Nom d utilisateur du portail Définit le nom de l'utilisateur de la base de données qui dispose de droits de lecture/d'écriture. La aleur par défaut est TLUSER. Voir «Modification des mots de passe de base de données». Report Database Serer Port Spécifie le port utilisé pour communiquer aec la base de données SQL Serer. La aleur par défaut est Remarque : Si ous utilisez un port autre que le port par défaut (1433), ce numéro de port doit être inséré lorsque ous ous connectez aux bases de données Tealeaf à l'aide de Tealeaf Database Manager. Voir "Référence de Tealeaf Database Manager" dans le document IBM Tealeaf Databases Guide. Nieau de journal Détermine le nieau de consignation, qui peut être compris entre 1 (le plus faible) et 9 (le plus éleé). Remarque : Le nieau de consignation est également utilisé par le portail pour déterminer le nieau de consignation à afficher dans une erreur. Le nieau 9 affiche tous les détails dans le portail et ne doit être utilisé qu'à des fins de débogage. Interalle de traitement Détermine la période d'inactiité entre les exécutions de collecte des données. Si ce nombre est défini sur 0, le serice de données est exécuté une fois et s'arrête. La aleur par défaut est de 300 secondes (5 minutes), ce qui correspond au paramètre le plus faible recommandé. Délai de connexion Détermine le délai de réponse maximal en secondes du sereur MSSQL. La aleur par défaut est de 300 secondes (5 minutes). Modification des mots de passe de base de données Remarque : La modification des mots de passe de base de données dans le portail ne modifie que les mots de passe utilisés par le portail pour se connecter à la base de données ; elle ne modifie pas les mots de passe dans SQL Serer. Modifiez les mots de passe à l'aide des étapes ci-après. 66 IBM Tealeaf CX - Guide de configuration

77 1. Connectez-ous au sereur de rapports. 2. Arrêtez tous les serices excepté Tealeaf Management System, qui est requis pour effectuer cet ensemble d'étapes. 3. Dans SQL Serer, modifiez les mots de passe des comptes de l'administrateur et de l'utilisateur Tealeaf. Par défaut, les ID de ces comptes sont TLADMIN et TLUSER. Conserez ces mots de passe pour pouoir les utiliser ultérieurement. Pour plus d'informations sur cette modification dans SQL Serer, reportez-ous à la documentation fournie aec le produit. 4. Exécutez le gestionnaire de base de données Tealeaf. Connectez-ous à l'aide d'un compte disposant de droits d'administration de base de données. 5. Dans le menu du gestionnaire de base de données Tealeaf, sélectionnez Info/Config > Report Serer Configuration. 6. Modifiez les mots de passe si ous le souhaitez. 7. Cliquez sur OK. Les mots de passe sont modifiés. 8. Pour quitter le gestionnaire de base de données Tealeaf, cliquez sur Quitter. 9. Relancez le gestionnaire de base de données Tealeaf. Connectez-ous à l'aide de l'authentification Tealeaf. 10. Si les mots de passe que ous aez entrés sont corrects, ous deez pouoir ous connecter au gestionnaire de base de données Tealeaf. 11. Cliquez sur Quitter. 12. Redémarrez tous les serices Tealeaf sur le sereur de rapports. Onglet BD cxresults Dans l'onglet IBM Tealeaf cxresults, ous pouez configurer les noms du sereur et des bases de donnés utilisés pour IBM Tealeaf cxresults. Remarque : Cet onglet n'apparaît pas si ous ne possédez pas de licence d'ibm Tealeaf cxresults et que ous n'aez pas installé ce produit. IBM Tealeaf cxresults est un produit faisant l'objet d'une licence à part de la plateforme IBM Tealeaf CX. IBM Tealeaf cxresults n'est plus disponible comme noueau produit sous licence à partir de la ersion 8.7. Les clients disposant d'une licence de IBM Tealeaf cxresults dans la ersion 8.6 ou une ersion antérieure peuent continuer à utiliser le produit et à bénéficier de l'assistance technique associée, dans la ersion 8.7 et les ersions ultérieures. Pour plus d'informations, contactez Tealeaf Customer Support. Chapitre 2. Configuration des composants Tealeaf 67

78 Figure 11. Onglet BD IBM Tealeaf cxresults Paramètre Description Visitor Database Serer Définit le nom d'hôte des bases de données de transfert et de génération de rapports des isiteurs. Si les bases de données se trouent sur une instance désignée, le format suiant doit être utilisé : <nom du sereur>\<nom de l instance>. 68 IBM Tealeaf CX - Guide de configuration

79 Port de base de données des isiteurs Port utilisé pour communiquer aec les bases de données des isiteurs. Chemin d accès aux fichiers de base de données des isiteurs Sur le sereur hébergeur, chemin d'accès complet à l'emplacement de stockage des fichiers de base de données des isiteurs. Base de données de rapport des isiteurs Nom de la base de données de génération de rapports des isiteurs. Base de données de transfert des isiteurs Nom de la base de données de transfert des isiteurs. Configuration supplémentaire du sereur de rapports Vous pouez effectuer les tâches de configuration supplémentaires du sereur de rapports en dehors de TMS. Configuration des alertes SNMP Voir «Configuration du serice d'alerte», à la page 145. Authentification NT du portail L'authentification NT du portail permet au portail d'authentifier les utilisateurs en fonction de leur identité de domaine Windows NT. Pour pouoir utiliser cette fonction, les comptes utilisateur du portail doient être configurés de sorte à être associés aux noms d'utilisateur et domaines NT. Si un utilisateur est connecté à un domaine NT associé à une identité d'utilisateur de portail et qu'il demande la page de connexion du portail, cet utilisateur est reconnu comme utilisateur de domaine NT et peut se connecter au portail à l'aide des données d'identification du domaine NT. Le compte utilisateur de portail associé à ses données d'identification NT détermine ensuite les fonctions et données du portail (par exemple, les graphiques) accessibles par l'utilisateur. Pour plus d'informations sur les méthodes d'authentification Tealeaf, oir "Authentification" dans le document IBM Tealeaf cximpact - Guide d'administration. Traitement des incidents Pour plus d'informations concernant le traitement des incidents, oir "Traitement des incidents - Génération de rapports" dans le document de dépannage d'ibm Tealeaf. Configuration du serice de données Tealeaf Le serice de données Tealeaf gère les connexions entre les serices et les composants Tealeaf et les bases de données qu'ils interrogent. Ce serice permet de gérer la connectiité à la base de données comme un serice Windows pour la sécurité, la fiabilité et le contrôle. A partir de la ersion 8.0, le serice de génération de rapports est un composant intégré du serice de données Tealeaf. Pour acquérir les données, les sereurs et serices Tealeaf enoient des requêtes ia le serice de données Tealeaf, qui enoie à son tour des requêtes aux bases de données et/ou Canisters appropriés. Le sereur de recherche ne communique pas directement aec la base de données. Tout sereur autre qu'un sereur de portail qui exécute une commande nécessitant le serice de données Tealeaf est redirigé ers le sereur de recherche Chapitre 2. Configuration des composants Tealeaf 69

80 associé au sereur de portail. Cette instance de sereur de recherche interroge le serice de données Tealeaf et renoie les données. Connexions Le serice de données Tealeaf remplace certaines des fonctionnalités gérées par le sereur de recherche, qui utilise l'authentification SQL pour un accès direct aux bases de données Tealeaf. Dans certains enironnements, cette méthode d'authentification pose des problèmes. Actuellement, le serice de données Tealeaf gère les connexions suiantes : 1. Données utilisateur Tealeaf : les informations utilisateur Tealeaf sont accessibles par les composants Tealeaf ia le serice de données Tealeaf. Voir "Administration des utilisateurs CX" dans le document IBM Tealeaf cximpact - Guide d'administration. Voir "Administration des utilisateurs cxview" dans le document IBM Tealeaf cximpact - Guide d'administration. Voir "Administration des utilisateurs cxreeal" dans le document IBM Tealeaf cxreeal - Guide d'administration. 2. Statut Tealeaf : le rapport de statut Tealeaf utilise le serice de données Tealeaf pour extraire les statistiques sur les sereurs et bases de données Tealeaf. Voir "Rapport de statut Tealeaf" dans le document IBM Tealeaf cximpact - Guide d'administration. 3. Paramètres de contrôle du portail : les paramètres de configuration internes au portail sont stockés dans la base de données TL_SYSTEM et extraits au démarrage pour être utilisés. 4. Définitions des sereurs de Canister Tealeaf : le portail utilise le serice pour acquérir les définitions de tous les sereurs de Canister dans l'enironnement. Voir "Gestion des sereurs Tealeaf" dans le document IBM Tealeaf cximpact - Guide d'administration. 5. Journaux d'audit des recherches et relectures RTV : IBM Tealeaf CX RealiTea Viewer utilise le serice pour alider les journaux d'audit dans la base de données du portail isible dans les rapports d'actiité des utilisateurs. Voir "Sureillance de l'actiité utilisateur" dans le document IBM Tealeaf cximpact - Guide d'administration. 6. Listes d'utilisateurs NT/Actie Directory : si l'authentification NT/AD est actiée pour Tealeaf, le portail extrait la liste des groupes NT/AD configurés du serice de données. Le serice de données collecte ces groupes sur les sereurs de recherche du système Tealeaf, selon un interalle planifié. 7. Rapports de portail : si possible, le portail s'appuie sur le serice de données Tealeaf comme source de données lors de la génération des rapports. En particulier, le serice de données fournit les entrées aux rapports suiants : Rapports de statut système Tealeaf. Voir "Statut système" dans le document IBM Tealeaf cximpact - Guide d'administration. Rapports d'éénements et de statut actifs et moniteur d'alertes. Voir "Sureillance des actiités Tealeaf en cours" dans le document IBM Tealeaf cximpact - Guide d'utilisation. Le serice de génération de rapports est un composant du serice de données Tealeaf. 8. Définitions d'éénement et de dimension :les éénements, dimensions, attributs de session et autres définitions de données d'exécution sont gérés ia le sereur de recherche, qui interroge le serice de données pour interagir aec les tables de base de données. 70 IBM Tealeaf CX - Guide de configuration

81 Voir "Tealeaf Eent Manager" dans le document IBM Tealeaf Eent Manager - Guide. Installation Lors de la procédure d'installation, le serice de données Tealeaf est installé sur le même sereur que le collecteur de données Tealeaf. Le serice de données Tealeaf utilise les mêmes paramètres de registre pour s'auto-configurer et se connecter aux bases de données Tealeaf. Configuration de la base de données Pour plus d'informations sur la manière de configurer les bases de données Tealeaf et les réinstaller si nécessaire, oir "Administration des bases de données" dans le Guide des bases de données IBM Tealeaf. Configuration du serice de données Tealeaf Par l'intermédiaire du sereur de recherche, les sereurs et serices Tealeaf communiquent aec le serice de données et le sereur de rapports par extension. Sur chaque sereur Tealeaf spécifié dans TMS, la configuration du sereur de recherche doit être fournie aec une méthode permettant de se connecter au serice de données Tealeaf, en fonction du type de sereur : 1. Sereur de portail : la machine hébergeant le sereur de portail doit receoir une entrée alide pour le serice de données TeaLeaf. Dans la plupart des configurations, le serice est installé sur le sereur de qui est généralement installé sur la machine du sereur de portail. Dans ces configurations, cette aleur est localhost: Si le sereur de portail et le sereur de rapports se trouent sur des machines distinctes ou que le serice est installé sur un sereur non standard, la aleur doit être spécifiée de sorte à pointer ers le nom d'hôte et le numéro de port du sereur qui héberge la machine. <Serer_hosting_Tealeaf_Data_Serice>: Tous les autres sereurs : tous les autres sereurs Tealeaf requièrent une entrée alide pour le sereur de portail dans leurs configurations de sereur de recherche. Ces sereurs Tealeaf communiquent ia le sereur de portail, qui sait comment contacter le serice de données Tealeaf en fonction de la configuration de l'étape précédente. Dans la configuration du sereur de recherche des machines autres que celle du sereur de portail, la aleur du serice de données TeaLeaf doit rester ide. Pour plus d'informations sur la configuration du sereur de recherche, oir "Configuration du sereur de recherche" dans le document IBM Tealeaf CX - Guide de configuration. Pour plus d'informations sur l'utilisation de TMS, oir "Onglet TMS WorldView" dans le document IBM Tealeaf cximpact - Guide d'administration. Démarrage et arrêt du serice Vous pouez démarrer, arrêter et redémarrer le serice de données Tealeaf ia TMS. Chapitre 2. Configuration des composants Tealeaf 71

82 Remarque : Le serice de données Tealeaf fournissant des données critiques au sereur de recherche, il doit être démarré aant le sereur de recherche et arrêté après ce dernier. 1. Connectez-ous au portail Tealeaf en tant qu'administrateur. 2. Dans le menu Portail, sélectionnez Tealeaf > TMS. 3. Cliquez sur l'onglet WorldView. 4. Sélectionnez la ue Sereurs. 5. Cliquez sur le noeud Serice de données. 6. Les commandes disponibles sont affichées dans le panneau Actions de composant. Voir "Onglet TMS WorldView" dans le document IBM Tealeaf cximpact - Guide d'administration. Journalisation Cette section décrit la manière de gérer et d'utiliser les fichiers journaux du serice de données dans IBM Tealeaf Portal. Accès aux journaux Les administrateurs Tealeaf peuent accéder aux fichiers journaux du serice de données ia le portail Tealeaf. 1. Dans le menu du portail, sélectionnez Tealeaf > Gestion du portail. 2. Cliquez sur le lien Sereurs Tealeaf dans le panneau de naigation de gauche. 3. Cliquez sur le lien Gérer les sereurs. 4. Le côté droit de l'écran est alimenté aec les sereurs Tealeaf configurés. 5. Sélectionnez le sereur de rapports. 6. Dans la barre d'outils au dessus du panneau de configuration du sereur, cliquez sur l'icône Journaux Tealeaf. 7. Dans la liste déroulante Filtrer par, sélectionnez Serice de données. 8. Les journaux du serice de données actuellement stockés sur le sereur de rapports sont répertoriés. Voir "Gestion des sereurs Tealeaf" dans le document IBM Tealeaf cximpact - Guide d'administration. Vous pouez également accéder aux entrées de la base de données du serice de données ia la section Journaux de la page Gestion du portail. Voir "Journaux du portail" dans le document IBM Tealeaf cximpact - Guide d'administration. Emplacement des fichiers journaux Le serice de données Tealeaf génère les messages du journal dans le fichier journal suiant : <répertoire_installation_tealeaf>\logs\tldataserice.log Le fichier journal est enregistré tous les jours à minuit. Les fichiers journaux des jours précédents incluent un indicateur AAAAMMJJ dans le nom de fichier. Modification du nieau de consignation Par défaut, le nieau de consignation du serice de données Tealeaf est défini sur 1, ce qui signifie que le fichier journal ne contient que les types de message de statut suiants : Démarrage Arrêt Vérification de la connexion à toutes les bases de données 72 IBM Tealeaf CX - Guide de configuration

83 Si nécessaire, pour résoudre les problèmes liés au serice de données Tealeaf, ous pouez remplacer le nieau de consignation par une aleur comprise entre 1 et 9. Si le nieau de consignation 9 est actié ia TMS, le fichier journal du serice de données contient des informations sur des demandes indiiduelles et des instructions de traçage/débogage supplémentaires pour faciliter la résolution des problèmes. Le serice de données Tealeaf partage les mêmes contrôles de consignation que les autres serices gérés ia le sereur de rapports. Pour en modifier le nieau de consignation et modifier celui des autres fonctions du sereur de recherche, définissez la aleur Nieau de journal dans l'onglet Base de données de la configuration du sereur de rapports dans TMS. Voir "Configuration du sereur de rapports" dans le document IBM Tealeaf CX - Guide de configuration. Statistiques du serice de données par minute En plus des fonctions de consignation de base, le serice de données enregistre les informations statistiques sur son état actuel dans des fichiers.csv, dans le répertoire Logs. Ces fichiers fournissent des informations sur les performances relaties à l'utilisation de l'uc par le serice de données, aux unités d'exécution, aux descripteurs, aux demandes, etc. Les fichiers se trouent dans l'emplacement suiant : <répertoire_installation_tealeaf>\logs\tldataserice-stats_yyyymmdd.log Ce fichier est mis à jour toutes les minutes et enregistré tous les jours. Il contient les zones délimitées par tabulations ci-après. zone Description LogTime Horodatage de l'enregistrement de l'entrée dans le fichier DsUptime Temps d'actiité actuel du serice de données en minutes ReqsSinceStart Demandes depuis que le serice de données a été redémarré pour la dernière fois ReqsInLastMinute Demandes au serice de données au cours de la dernière minute AgReqsPerMinute Demandes moyennes au serice de données par minute depuis le dernier redémarrage UC Utilisation de l'uc par le serice de données au moment où l'entrée a été enregistrée Handles Nombre de descripteurs utilisés par le serice de données Threads Nombre d'unités d'exécution utilisées par le serice de données WorkingSet Quantité actuelle de mémoire physique allouée pour le serice de données Chapitre 2. Configuration des composants Tealeaf 73

84 PeakWorkingSet Quantité maximale de mémoire physique utilisée par le serice de données depuis le dernier redémarrage PriateMemory Quantité actuelle de mémoire paginée allouée par le serice de données PagedMemory Quantité actuelle de mémoire paginée allouée par le serice de données PeakPagedMemory Quantité maximale de mémoire dans le fichier de pagination de la mémoire irtuelle utilisé par le serice de données depuis le dernier redémarrage NonpagedSystemMemory Quantité actuelle de mémoire non paginée allouée pour le serice de données PagedSystemMemory Quantité actuelle de mémoire paginable allouée pour le serice de données VirtualMemory Quantité actuelle de mémoire irtuelle allouée pour le serice de données PeakVirtualMemory Quantité maximale de mémoire irtuelle utilisée par le serice de données depuis le dernier redémarrage AailWorkerThreads Nombre d'unités d'exécution de tâche actuellement disponibles pour le serice de données AailCpThread Nombre d'unités d'exécution d'e-s asynchrones disponibles pour le serice de données Configuration du sereur de relecture Exigences Le sereur de relecture gère la relecture des sessions sur des clients de relecture sur naigateur. Chaque fois qu'un utilisateur BBR recherche une session à relire, la requête est transmise ia le sereur de recherche pour extraire la session, qui est distribuée au naigateur de l'utilisateur ia le sereur de relecture. Remarque : Pour relire efficacement la session complète, le sereur de relecture doit aoir accès au contenu statique et notamment aux images, scripts Jaa et feuilles de style référencées dans la session. Le contenu statique peut être référencé à partir du sereur d'origine ou d'un sereur TLI. Tealeaf recommande de déployer un sereur TLI pour la gestion des archies statiques. Pour plus d'informations sur les sereurs TLI, oir section "Gestion des archies statiques" du Manuel d'administration d'ibm Tealeaf cximpact. Des limitations peuent s'appliquer à l'expérience de relecture en raison des différences de présentation du contenu des sessions à afficher dans des périphériques spécifiques. Voir "Recherche et relecture pour Web mobile" dans le document IBM Tealeaf CX Mobile - Guide d'utilisation. 74 IBM Tealeaf CX - Guide de configuration

85 Installation Lors de l'installation initiale, un sereur de relecture est installé dans le cadre de l'installation d'ibm Tealeaf cximpact. Ce sereur est conçu à l'origine comme sereur de relecture maître. Si nécessaire, des sereurs de relecture supplémentaires peuent être installés et configurés. Voir «Création de sereurs de relecture supplémentaires», à la page 84. Référence du portail Lors de l'installation, une référence au sereur de relecture maître initial est ajoutée à la page Gestion du portail, ce qui permet aux utilisateurs BBR de demander des sessions au sereur de relecture ia l'application du portail et d'en receoir. Voir "Gestion des sereurs Tealeaf" dans le document IBM Tealeaf cximpact - Guide d'administration. Configuration du sereur de relecture Vous pouez afficher ou éditer la configuration du sereur de relecture à partir du portail. Accès à la configuration du sereur de relecture Pour afficher ou éditer les paramètres de configuration du sereur de relecture : 1. Connectez-ous au portail en tant qu'administrateur. 2. Dans le menu Portail, sélectionnez Tealeaf > TMS. 3. Dans le menu déroulant Afficher, sélectionnez Sereurs. 4. Dans la ue Sereurs, sélectionnez le sereur de otre choix pour accéder à ses composants. 5. Cliquez sur le noeud Sereur de relecture. 6. Sélectionnez Configuration du sereur de relecture. 7. Dans le panneau Actions de configuration, cliquez sur Afficher/Modifier. L'éditeur de configuration s'affiche. Remarque : Une fois que ous aez modifié la configuration du sereur de relecture, les étapes suiantes sont requises : Enoyez la configuration à tous les sereurs ia TMS. Redémarrez le sereur de relecture. Chapitre 2. Configuration des composants Tealeaf 75

86 Paramètres du sereur de relecture Dans TMS, les éléments de configuration ci-après sont disponibles. Paramètre Description Sereur maître d authentification Identifie le sereur qui gère l'authentification. Dans les enironnements où le sereur de relecture se troue sur le même sereur que l'application de portail, cette aleur est localhost. CacheTimeout Durée (en minutes) pendant laquelle les ressources statiques sont conserées dans le cache. En l'absence d'accès aux éléments aant la fin du délai d'expiration, les éléments sont supprimés du cache. ChromeInstances Indique le nombre d'instances de présentateur de rendu qui utilisent le naigateur Chrome/WebKit à générer sur le sereur de relecture. Remarque : Ce présentateur de rendu n'est requis que si otre application Web prend en charge les sessions du naigateur Chrome ou de naigateurs Web mobiles. Cette définition n'est disponible que dans la configuration brute. Nombre de jours de conseration des journaux Nombre de jours de conseration des données de journal du sereur de relecture. La aleur par défaut est de 30 jours. DisablerendererImageLoading Si ce paramètre est défini sur 1, DisableRendererImageLoading arrête le chargement d'une image lors de l'affichage de la relecture pour améliorer les performances. Si ce paramètre est actié, le paramètre FakeImagesOnRender est désactié. Enable Natie Replay Spécifiez true pour actier la gestion des sessions mobiles naties dans BBR. 76 IBM Tealeaf CX - Guide de configuration

87 Enable TLI Serer Si ce paramètre a la aleur 1, le sereur de relecture est configuré pour rechercher le contenu statique sur le sereur TLI spécifier et stocker les données TLI du sereur de relecture dans un cache (Chemin d accès du cache TLI). Voir «Configuration de l'utilisation du sereur TLI», à la page 80. ExecUIEentsNow Spécifiez 1 pour actier cette option. Si ce paramètre est actié, les éénements d'interface graphique de la session sont présentés en même temps que le hit. Cette configuration peut s'aérer utile si les pages présentées dans BBR apparaissent pour afficher les éénements d'interface graphique sur la page après laquelle l'éénement s'est produit. Par défaut, ce paramètre est défini sur 0. Si c'est le cas, les pages sont présentées après le hit. FakeImagesOnRender Si ce paramètre est défini sur 1, le sereur de relecture génère des images de remplacement de 1x1 pixel à utiliser pour toutes les demandes d'image, au lieu d'extraire les images réelles du site d'origine. Par défaut, cette option est désactiée, mais elle peut être actiée si le temps de chargement des images est important. Cette définition n'est disponible que dans la configuration brute. Si ce paramètre est actié, des modules de remplacement sont générés pour toutes les images demandées, même si elles sont archiées sur un sereur TLI. Pour plus d'informations sur les archies TLI, oir "Gestion des archies statiques" dans le document IBM Tealeaf cximpact - Guide d'administration. Remarque : Si cette option est actiée, elle peut générer des problèmes aec les pages dans lesquelles les styles d'images sont dynamiquement modifiés par JaaScript. Ces situations ne sont pas courantes. IEInstances Indique le nombre d'instances de présentateur de rendu qui utilisent le naigateur Internet Explorer à générer sur le sereur de relecture. Cette définition n'est disponible que dans la configuration brute. InsertBackPages Spécifiez 1 pour actier cette option. Les naigateurs mettent en cache les pages précédemment isitées et n'enoient pas de demande au sereur d'origine lorsque l'utilisateur retourne sur ces pages. Cette option permet d'insérer synthétiquement des pages consultables dans la liste de naigation si UISDK est en fonction sur le site Web. Les éénements d'interface graphique seront joints aux pages synthétiques pour une relecture homogène. InsertMissingOrCachedPages Spécifiez 1 pour actier cette option. Lorsqu'elle est actiée, cette option tente d'insérer les pages qui sont manquantes dans la session ou qui ont été mises en cache par un réseau de distribution de contenu en les extrayant depuis le sereur d'origine. Ce paramètre est désactié par défaut. Remarque : Cette option doit être désactiée de façon isolée pour rectifier des problèmes simples à l'aide de la relecture des données manquantes. L'actiation de ce paramètre peut générer des faux positifs dans lesquels Chapitre 2. Configuration des composants Tealeaf 77

88 une correspondance ne peut pas être établie entre les paramètres de requête se trouant dans les URL d'éénements IU et les pages stockées dans la session. Dans ces cas, cette option a pour effet que le sereur de relecture tente d'accéder à la page à partir du sereur d'origine. Pour les pages d'éénement IU, la page n'existe pas et cela peut générer des problèmes de relecture. InsertUIEentBackPages Spécifiez 1 pour actier cette option. Cette option tente d'insérer les pages de bouton précédent manquantes dans les éénements d'interface graphique. InsertUIEentBackPages utilise l'éénement d'interface graphique Performance Init et de aleur WindowHref. Il parcourt la session à la recherche des pages manquantes en fonction de l'url WindowHref. Journalisation Si la aleur est Oui, la journalisation est actiée. MaxRenderPerSesn Cette option indique le nombre maximal de présentateurs de rendu Mozilla dédiés à l'affichage d'une session parmi le pools de présentateurs de rendu disponibles. Les autres présentateurs de rendu ne seront pas utilisés pour afficher la session donnée. MozillaInstances Indique le nombre d'instances de présentateur de rendu qui utilisent le naigateur Mozilla Gecko à générer sur le sereur de relecture. La aleur par défaut est de 4. Vous ne deriez pas aoir besoin de la modifier. Cette définition n'est disponible que dans la configuration brute. OnDemandRendering Spécifiez 1 pour actier cette option. Lorsque ce paramètre est actié, seule la page en cours et la page suiante s'affichent jusqu'à ce qu'une autre page soit demandée. Le délai de chargement des sessions est ainsi amélioré. Port Cette aleur définie le port sereur par l'intermédiaire duquel les interactions du sereur de relecture sont effectuées. La aleur par défaut est Proxy Auth Password Lorsqu'un sereur proxy se troue entre les utilisateurs BBR et l'internet public, ce paramètre spécifie le mot de passe à utiliser pour l'authentification aec le proxy. Proxy Auth Username Lorsqu'un sereur proxy se troue entre les utilisateurs BBR et l'internet public, ce paramètre spécifie le nom d'utilisateur à utiliser pour l'authentification aec le proxy. RenderDelay Le délai de restitution est la durée (en secondes) pendant laquelle le présentateur de rendu attend que la page soit chargée (et que les éénements d'interface graphique soient exécutés) aant de prendre l'instantané. Après l'instantané initial de la page, les éénements d'interface graphique sont exécutés les uns après les autres (instantané après chacun d'eux, après le délai de restitution). Session Idle Timeout Nombre de minutes d'inactiité autorisé pour une session BBR, après quoi la session arrie automatiquement à expiration. 78 IBM Tealeaf CX - Guide de configuration

89 ShowClientEents Si ce paramètre est actié, la liste de naigation inclut le message d'état du client (Type 1) du message JSON UI Capture. ShowPerformanceEents Entrez 7 ShowInfoEents Entrez 2 ShowReplayGUIEents Si ce paramètre est actié, la liste de naigation inclut le message de contrôle (Type 4) du message JSON UI Capture. TLI Cache Path Si le sereur TLI est actié (Enable TLI Serer), ce paramètre indique le chemin d'accès sur le sereur de relecture où les objets extraits du sereur TLI sont stockés dans un cache. Voir «Configuration de l'utilisation du sereur TLI», à la page 80. Sereur TLI Si le sereur TLI est actié (Enable TLI Serer), ce paramètre indique le nom de la machine qui héberge le sereur TLI. Voir «Configuration de l'utilisation du sereur TLI», à la page 80. Chemin d accès temporaire Chemin d'accès au répertoire de l'espace de stockage temporaire pour la relecture. UIEentCoalesce Si cette option est actiée, elle supprime les éénements d'interface graphique redondants tels que les clics de zone de texte de la session distribuée lors de la relecture. Ce type d'éénements n'offre aucun aantage supplémentaire. UIEentDeleteDuplicates Pour supprimer les éénements d'interface graphique adjacents en double à des fins de relecture, spécifiez la aleur 1. UIEentSubTypeSkip1 Cette liste affiche les sous-types d'éénement d'interface graphique potentiels que ous pouez demander à ignorer (alue=1) ou à relire (alue=0). En fonction de la manière dont otre site est présenté, certains de ces sous-types pouant générer un olume considérable d'éénements ou risquant de ne pas être relus correctement, ces options permettent d'optimiser l'expérience de relecture BBR propre à otre application Web. Pour plus d'informations sur ces options, oir «Sous-types d'éénement de l'interface graphique», à la page 81. UseBackingStore Si cette aleur est définie sur 1, le sereur de relecture stocke les données de demande de la session présentée dans un fichier local. Si elle est définie sur 0, les données de demande sont stockées en mémoire. White List Enable Spécifiez 1 pour actier cette option. Si ce paramètre est actié, ous pouez spécifier des listes blanches d'url autorisées à contacter le sereur d'origine du domaine défini Ces listes blanches sont spécifiées sous forme de masques d'expression régulière dans la page Gestion du portail. Voir "Gestion des sereurs Tealeaf" dans le document IBM Tealeaf cximpact - Guide d'administration. Chapitre 2. Configuration des composants Tealeaf 79

90 Configuration de l'accès au proxy pour le sereur de relecture Lorsqu'une session est ouerte dans la relecture sur naigateur, le contenu statique, tel que les images et les feuilles de style, est demandé au sereur de relecture. Si, sur le sereur de relecture, le contenu n'est pas stocké en local dans un cache, il demande le contenu au sereur d'origine. Si un sereur proxy se troue entre Tealeaf et le sereur d'origine, ous deez configurer l'accès entre le sereur de relecture et le sereur d'origine ia ce proxy. Voir "Dépannage - BBR" dans le document IBM Tealeaf Troubleshooting Guide. Configuration de l'utilisation du sereur TLI Remarque : Si ous aez déployé un sereur TLI dans otre enironnement, chaque sereur de relecture que ous déployez doit être configuré pour faire référence au sereur TLI des objets statiques. Cette configuration doit être appliquée à chaque sereur de relecture de otre enironnement. Voir "Gestion des archies statiques" dans le document IBM Tealeaf cximpact - Guide d'administration. Configuration de l'accès au sereur d'origine Le contenu statique n'est pas stocké aec les données de session. Si des références au contenu statique sont détectées dans les données de session, le sereur de relecture enoie des demandes au sereur d'origine à partir de l'un des modes ci-après. Remarque : Si un sereur TLI a été déployé dans otre enironnement, le sereur de relecture recherche toujours le contenu statique en priorité dans son cache d'objets statiques local, puis sur le sereur TLI aant de contacter le sereur d'origine. Voir «Configuration de l'utilisation du sereur TLI». Si ces érifications ne permettent pas de renoyer le contenu statique ou qu'aucun sereur TLI n'est déployé, les modes ci-après s'appliquent. Mode Liste noire Par défaut, le sereur de relecture fonctionne en mode liste noire, dans lequel il enoie des demandes de contenu statique au sereur d'origine. Si le sereur de relecture ne parient pas à satisfaire la demande ia les ressources locales (par exemple, un cache ou un sereur TLI), la demande est renoyée au sereur d'origine. En mode Liste noire, le mode Liste blanche est désactié et les règles de la liste blanche sont ignorées. Remarque : Si le sereur de relecture fonctionne en mode Liste noire et que ous souhaitez empêcher tout contact aec le sereur d'origine, ous pouez spécifier une règle BlockUrl dans otre profil de relecture, qui empêchera le sereur de relecture de contacter le sereur d'origine pour les URL spécifiées. Notez que les pages bloquées ne peuent pas être affichées lors de la relecture. Voir "RealiTea Viewer - Options de profil" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. 80 IBM Tealeaf CX - Guide de configuration

91 Mode Liste blanche En mode Liste blanche, le sereur de relecture n'est pas autorisé à contacter le sereur d'origine par défaut. Dans de nombreux enironnements, il est interdit ou non souhaitable de contacter le sereur d'origine à partir du sereur de relecture. Pour plus d'informations sur les raisons d'éiter de contacter le sereur d'origine, oir "Gestion des archies statiques" dans le document IBM Tealeaf cximpact - Guide d'administration. Vous deez spécifier les règles de la liste blanche qui identifient les masques d'url autorisés à contacter le sereur d'origine. Pour chaque règle que ous configurez, une ou plusieurs URL sont définies de sorte à pouoir contacter le sereur d'origine afin de lui demander le contenu statique du domaine spécifié. Par exemple, ous pouez créer des masques d'expression régulière pour identifier les extensions de fichier du contenu que le sereur de relecture est autorisé à extraire du sereur d'origine. Toutes les URL qui respectent le masque d'expression régulière peuent contacter le sereur d'origine. Le mode liste blanche doit être actié sur chaque sereur de relecture de otre enironnement. Voir «Actiation de règles de liste blanche pour plusieurs sereurs de relecture», à la page 86. Une fois que ous aez actié le mode Liste blanche, ous deez configurer les règles de la liste blanche. Voir "Gestion des sereurs Tealeaf" dans le document IBM Tealeaf cximpact - Guide d'administration. Sous-types d'éénement de l'interface graphique Les sous-types d'éénement ci-après de l'interface graphique peuent être actiés ou désactiés pour la relecture dans BBR. S'ils sont désactiés, ils sont masqués lors de la relecture ; les données restent dans la session pour la mise en éénements et autres opérations. Ces paramètres ne s'appliquent qu'à l'affichage des sessions dans BBR. Si otre implémentation d'ui Capture a été configurée de sorte à ne pas capturer de sous-type, les données ne sont pas présentes dans la session et le fait de modifier le paramètre correspondant n'a aucun impact. Voir le document relatif à UI Capture j2 Guide dans le document IBM Tealeaf UI Capture for j2 Guide. Voir "Guide d'ui Capture for AJAX" dans le document IBM Tealeaf UI Capture for AJAX Guide. Remarque : L'actiation de certains de ces éénements d'interface graphique peut considérablement augmenter le nombre d'éénements d'interface graphique présentés dans une session, ce qui peut aoir un impact sur les performances et le fonctionnement de BBR. Soyez prudent lorsque ous effectuez des modifications. Tableau 2. Sous-types d'éénement de l'interface graphique Sous-type Description Par défaut blur La mise en éidence a été supprimée 0 de l'élément. focusin L'élément a été mis en éidence. 1 Chapitre 2. Configuration des composants Tealeaf 81

92 Tableau 2. Sous-types d'éénement de l'interface graphique (suite) Sous-type Description Par défaut focusout La mise en éidence a été déplacée 1 de l'élément. mousedown Un clic du bouton de la souris a été 1 enregistré sur l'élément. mouseup Un bouton de la souris actié a été 1 relâché sur l'élément. mousewheel La roulette de la souris a défilé sur 0 l'élément. scroll L'élément a été parcouru. 1 unchanged L'élément a été mis en éidence, a perdu la mise en éidence et reste inchangé. 0 attention L'élément a été obseré. 0 resize L'élément a été redimensionné. 0 load L'élément a été chargé sur la page. 0 unload L'élément a été déchargé de la page. 0 mouseout La souris a été déplacée de l'élément. 0 Mise à jour du profil du sereur de relecture pour la correspondance de données DWR POST Si ous aez effectué une mise à nieau ers la ersion 8.4 ou une ersion ultérieure et que otre site utilise la bibliothèque DWR pour les interactions Jaascript/Jaa, ous deez mettre à jour le profil stocké sur le sereur de relecture pour utiliser le plug-in de correspondance de données POST approprié lorsque des demandes DWR sont détectées dans les données de session au cours de la relecture. Les plug-ins de correspondance de données POST sont utilisés pour associer les demandes du contenu spécifié aux réponses correspondantes dans les données de session. Les plug-ins de correspondance de données POST améliorent la probabilité d'associer correctement chaque demande à sa réponse correspondante. Voir «Gestion des modules d'extension de correspondance des données», à la page 100. Les données DWR POST doient être transmises ia le plug-in FormData pré-existant pour une correspondance correcte. Pour procéder à la configuration, ous deez inclure une référence au type de hit dans la configuration du plug-in FormData sur le sereur de relecture. Effectuez les étapes ci-après. 1. Connectez-ous au sereur qui héberge le sereur de relecture. 2. Accédez au répertoire suiant : <répertoire_installation_tealeaf>\system 3. Editez le fichier ReplaySererProfile.xml. 4. Recherchez la configuration ci-après. Il est possible qu'elle se troue au début du fichier : <Plugins> <ReplayHitMatchPlugin name="amf" ersion=" " interfaceversion="1" errorcode="0" errormessage=""> <HitType contenttype="application/x-amf" handlesquerystring="false" wantresponsedata="false" haecustomoptionsdialog="false" haecustomignoreparamdialog="false" haecustomresponsedisplay="false" 82 IBM Tealeaf CX - Guide de configuration

93 haecustompostdatadisplay="false" affinity="0.5"> <URLFilter pattern="" reqvar="" reqvarvalue=""/></hittype> </ReplayHitMatchPlugin> <ReplayHitMatchPlugin name="formdata" ersion=" " interfaceversion="1" errorcode="0" errormessage=""> <HitType contenttype="application/x-www-form-urlencoded" handlesquerystring="true" wantresponsedata="false" haecustomoptionsdialog="false" haecustomignoreparamdialog="false" haecustomresponsedisplay="false" haecustompostdatadisplay="false" affinity="0.5"> <URLFilter pattern="" reqvar="" reqvarvalue=""/></hittype> </ReplayHitMatchPlugin> <ReplayHitMatchPlugin name="json" ersion=" " interfaceversion="1" errorcode="0" errormessage=""> <HitType contenttype="application/json" handlesquerystring="false" wantresponsedata="false" haecustomoptionsdialog="false" haecustomignoreparamdialog="false" haecustomresponsedisplay="false" haecustompostdatadisplay="false" affinity="0.5"> <URLFilter pattern="" reqvar="" reqvarvalue=""/></hittype> </ReplayHitMatchPlugin> <ReplayHitMatchPlugin name="xml" ersion=" " interfaceversion="1" errorcode="0" errormessage=""> <HitType contenttype="text/xml" handlesquerystring="false" wantresponsedata="false" haecustomoptionsdialog="false" haecustomignoreparamdialog="false" haecustomresponsedisplay="false" haecustompostdatadisplay="false" affinity="0.5"> <URLFilter pattern="" reqvar="" reqvarvalue=""/></hittype> <HitType contenttype="application/msbin1" handlesquerystring="false" wantresponsedata="false" haecustomoptionsdialog="false" haecustomignoreparamdialog="false" haecustomresponsedisplay="false" haecustompostdatadisplay="false" affinity="0.5"> <URLFilter pattern="" reqvar="" reqvarvalue=""/></hittype> </ReplayHitMatchPlugin> </Plugins> 5. La configuration ci-dessus représente la configuration des plug-ins de correspondance de données POST sur le sereur de relecture. Recherchez la configuration du plug-in FormData. Elle soit se présenter comme suit : <ReplayHitMatchPlugin name="formdata" ersion=" " interfaceversion="1" errorcode="0" errormessage=""> <HitType contenttype="application/x-www-form-urlencoded" handlesquerystring="true" wantresponsedata="false" haecustomoptionsdialog="false" haecustomignoreparamdialog="false" haecustomresponsedisplay="false" haecustompostdatadisplay="false" affinity="0.5"> <URLFilter pattern="" reqvar="" reqvarvalue=""/></hittype> </ReplayHitMatchPlugin> 6. Juste aant la balise de fermeture </ReplayHitMatchPlugin>, insérez la configuration suiante : <HitType contenttype="text/plain" handlesquerystring="false" wantresponsedata="false" haecustomoptionsdialog="false" haecustomignoreparamdialog="false" haecustomresponsedisplay="false" haecustompostdatadisplay="false" affinity="0.5" enabled="1"> <URLFilter pattern="" reqvar="" reqvarvalue="" enabled="1"/> </HitType> 7. Enregistrez le fichier. 8. Redémarrez le sereur de relecture par l'intermédiaire de TMS. Voir "Onglet Vue globale de TMS" dans le manuel IBM Tealeaf cximpact - Guide d'administration. 9. S'il existe des sereurs de relecture supplémentaires dans otre enironnement, cette modification doit être appliquée à ces sereurs. Chapitre 2. Configuration des composants Tealeaf 83

94 Remarque : Les utilisateurs indiiduels d'ibm Tealeaf CX RealiTea Viewer doient appliquer une modification similaire à leurs profils de relecture locaux. Voir le chapitre sur la présentation de RealiTea Viewer dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Création de sereurs de relecture supplémentaires Lors de l'installation d'ibm Tealeaf cximpact, un sereur de relecture est créé automatiquement. Ce sereur de relecture est désigné comme sereur maître. En fonction de la charge du sereur de relecture, il se peut que ous deiez installer et déployer des sereurs de relecture supplémentaires. Remarque : Votre solution Tealeaf doit contenir un et un seul sereur de relecture désigné comme maître. Lorsqu'un sereur de relecture reçoit une commande pour ourir une session, l'une des opérations suiantes est effectuée, en fonction du statut du sereur de relecture maître : Le sereur de relecture érifie s'il est le sereur de relecture maître. Si c'est le cas, il utilise la copie locale du profil de relecture. Le sereur de relecture sait qu'une autre machine est le sereur de relecture maître et en extrait le profil maître. Si le sereur de relecture maître n'est pas disponible, le sereur de relecture demandeur utilise sa copie locale. Si le sereur de relecture maître est disponible, le profil extrait est stocké en local, au cas où il ne serait plus disponible ultérieurement. Le sereur de relecture ne parient pas à reconnaître le sereur de relecture maître. Dans ce cas, le sereur demandeur utilise sa copie locale du profil. Au démarrage, le sereur de relecture demandeur consigne un message d'erreur dans le journal des éénements Windows. Remarque : Un sereur de relecture doit être désigné comme sereur maître. Si ous aez plusieurs sereurs de relecture et que ous aez désactié le sereur maître, le portail désigne automatiquement un autre sereur de relecture comme noueau maître. Si ous ne possédez qu'un seul sereur de relecture, ous ne pouez pas le désactier car il s'agit du sereur maître par défaut. Flux de traail de base En supposant que ous ayez installé au moins un sereur IBM Tealeaf CX, les étapes de base ci-après expliquent comment ajouter un sereur de relecture. 1. Procurez-ous (si nécessaire) et installez du noueau matériel pour héberger le sereur de relecture. 2. Installez un portail uniquement sur le noueau sereur. a. Dans le programme d'installation d'ibm Tealeaf cximpact, sélectionnez l'option Portail uniquement. b. Effectuez l'installation. 3. Dans le fichier CanScs.cfg, spécifiez le redémarrage automatique pour tous les serices, exceptés ceux du sereur de relecture : a. Sereur de recherche b. Collecteur de données c. Serice de données 84 IBM Tealeaf CX - Guide de configuration

95 Remarque : Les seuls serices à conserer sont TMS, le sereur de recherche et le sereur de relecture. 4. Le démarrage manuel doit être configuré pour tous les serices exceptés ceux du sereur de relecture ia le panneau de configuration des serices Windows sur la machine hôte. 5. Ajoutez le sereur à l'aide de la page Gestion du portail. Voir "Gestion des sereurs Tealeaf" dans le document IBM Tealeaf cximpact - Guide d'administration. Pour plus de détails, lisez les sections ci-après. Ealuation de la charge du sereur de relecture Dans un enironnement comportant plusieurs sereurs de relecture, les sessions sont gérées et series aux utilisateurs BBR de façon circulaire entre les sereurs de relecture actifs. Lorsqu'un utilisateur BBR demande une session à relire, cette session est serie par le prochain sereur de relecture en fonction de la charge en cours et le sereur de relecture qui en est chargé est transféré en fin de liste. Toutes les ingt secondes, la liste de chargement est régénérée en fonction de la charge en cours de chaque sereur. Le dernier sereur à aoir seri une session est toujours placé en fin de liste. Remarque : En général, si la relecture ou le chargement d'une nouelle session est lent, ous pouez améliorer les performances en ajoutant un noueau sereur de relecture. Installation de sereurs de relecture supplémentaires Aant de créer une référence à des sereurs de relecture supplémentaires dans le portail, érifiez que les composants ci-après ont été installés sur le sereur désigné. Ces composants sont disponibles dans le programme d'installation d'ibm Tealeaf cximpact, à l'aide du sereur de rapports et du composant Application Web de portail. Voir "Installation et configuration de CX" dans le document IBM Tealeaf CX - Guide d'installation. Désactiation de la détection des serices interactifs Pour que le présentateur de rendu WebKit/Chrome fonctionne correctement, le serice de détection des serices interactifs sur le sereur qui héberge le sereur de relecture doit être désactié. Remarque : Lorsque ous ajoutez un noueau sereur de relecture, le serice de détection des serices interactifs doit être désactié pour empêcher les conflits aec le présentateur de rendu WebKit/Chrome. Si ous actiez le sereur de relecture sur un sereur qui héberge déjà des logiciels Tealeaf, il se peut que ous deiez désactier manuellement ce serice. Voir "Liste de contrôle préinstallation CX" dans le document IBM Tealeaf CX - Guide d'installation. Si ous installez le sereur de relecture à l'aide du programme d'installation, il désactie automatiquement le serice. Chapitre 2. Configuration des composants Tealeaf 85

96 Le sereur de relecture doit être exécuté en tant que Système local Le sereur de relecture doit être exécuté pour être exécuté comme utilisateur Système local sur le sereur. Voir "Nettoyage post-mise à nieau" dans le document IBM Tealeaf CX - Guide de mise à nieau. Configuration d'instances de sereur de relecture Une fois que le logiciel a été installé sur le sereur désigné, ous deez ajouter une référence au noueau sereur de relecture ia la page Gestion du portail. Vous deez créer une référence pour chaque sereur de relecture dans le portail. Remarque : Un sereur de relecture doit exister dans le portail. Un sereur de relecture doit être désigné comme sereur maître. Chaque sereur de relecture doit être configuré pour utiliser le sereur TLI, s'il est déployé. Voir «Configuration de l'utilisation du sereur TLI», à la page 80. Actiation de règles de liste blanche pour plusieurs sereurs de relecture : A l'aide de la page Gestion du portail, ous pouez configurer des règles de liste blanche. Lorsque ces règles sont définies, toutes les URL correspondantes peuent contacter le sereur d'origine pour obtenir du contenu, ce qui ous permet d'empêcher les autres URL de contacter le sereur et de déclencher des actions côté sereur en fonction du contact de relecture. Remarque : Les règles de liste blanche doient être actiées et configurées sur chaque sereur de relecture de otre enironnement. Pour configurer les règles de liste blanche pour plusieurs sereurs de relecture, effectuez les étapes ci-après. 1. Sur le sereur de relecture maître, configurez os règles de liste blanche de relecture. Voir "Gestion des sereurs Tealeaf" dans le document IBM Tealeaf cximpact - Guide d'administration. 2. Testez ces règles pour érifier qu'elles fonctionnent correctement. 3. Si ous ne l'aez pas déjà fait, dans la page Gestion du portail, définissez les sereurs de relecture esclae. 4. Via TMS, actiez les règles de liste blanche sur les sereurs esclae. a. Dans le menu Portail, sélectionnez Tealeaf > TMS. Tealeaf Management System s'affiche. Voir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. b. Dans TMS, cliquez sur l'onglet WorldView. c. Dans le menu déroulant Afficher, sélectionnez Sereurs. d. Pour chaque sereur qui héberge une instance de sereur de relecture : 1) Sélectionnez le sereur. 2) Cliquez sur le noeud Sereur de relecture. 3) Cliquez sur Configuration du sereur de relecture. 4) Cliquez sur Afficher/Modifier. 5) Cliquez sur l'option Whitelist Enable. 6) Définissez cette aleur sur 1. 7) Cliquez sur Appliquer. 86 IBM Tealeaf CX - Guide de configuration

97 8) Cliquez sur Sauegarder. 9) Cliquez sur Ajouter au traail actuel. e. Répétez les étapes ci-dessus pour chaque sereur de relecture de l'enironnement. f. Une fois que tous les sereurs de relecture ont été mis à jour, cliquez sur l'onglet Traaux dans TMS. g. Sélectionnez le traail et cliquez sur Soumettre. h. Tous les sereurs de relecture peuent désormais utiliser des listes blanches. 5. Testez la relecture sur les sereurs esclae pour érifier que les règles de liste blanche sont appliquées. Voir "Gestion des sereurs Tealeaf" dans le document IBM Tealeaf cximpact - Guide d'administration. Configuration des règles de relecture Le sereur de relecture prend en charge la création d'un ensemble personnalisé de règles de relecture à appliquer à des sessions BBR. Ces règles sont gérées par le sereur de relecture principal qui les publie sur des sereurs de relecture secondaires. Voir "Règles de relecture BBR" dans le IBM Tealeaf cximpact - Guide d'utilisation. Si ous déployez des listes blanches dans un enironnement aec plusieurs sereurs de relecture, une autre configuration est requise. Voir «Actiation de règles de liste blanche pour plusieurs sereurs de relecture», à la page 86. Confidentialité à la demande Vous pouez éentuellement configurer des règles de confidentialité à appliquer à la relecture par l'intermédiaire du sereur de relecture. Cette fonction permet le blocage ou le masquage des données sensibles lors de la relecture tout en conserant les données dans l'enregistrement de session. Voir «Confidentialité à la demande», à la page 136. Plug-ins du sereur de relecture Pour gérer la correspondance des demandes aux réponses dans une session, Tealeaf fournit un ensemble de plug-ins pour le sereur de relecture, qui peuent être utilisés pour associer les données POST à la réponse appropriée lors de la relecture. Ces plug-ins gère les correspondances des types de contenu spécifiques. Voir «Gestion des modules d'extension de correspondance des données», à la page 100. Personnalisation de la relecture des sessions d'application mobile IBM Tealeaf peut relire des sessions d'application mobile ia BBR, si otre structure de consignation mobile est configurée pour le prendre en charge. Remarque : La personnalisation de la relecture des sessions d'application mobile est dans sa phase préliminaire de déeloppement. Par conséquent, si ous personnalisez les modèles de relecture de session d'application mobile, ous derez certainement réimplémenter os personnalisations lorsque la prochaine ersion est publiée. Si ous souhaitez personnaliser os modèles, consultez IBM Tealeaf Chapitre 2. Configuration des composants Tealeaf 87

98 Professional Serices. Ils disposent de l'expertise et des outils permettant de garantir une personnalisation réussie des modèles de relecture de session d'application mobile. Cette fonction fonctionne en interprétant les données JSON d'une session qui ont été enoyées à TealeafTarget par la structure de consignation mobile. Les données JSON enoyées par l'infrastructure de consignation incluent des informations d'en-tête et une série de messages décriant les éénements qui se sont produits dans l'application mobile. Chaque message possède un type numérique qui indique le type d'informations que le message contient La relecture s'appuie sur plusieurs composants de l'article JSON. Les informations d'en-tête qui décrient l'application mobile et le périphérique. Les messages de type 10 qui décrient les contrôles natifs de la plateforme à l'écran à un moment donné. Les messages de type 4 qui décrient les changements d'état des contrôles à l'écran. Dans BBR, les sessions Web sont organisées en pages et éénements d'interface utilisateur, aec des éénements d'interface utilisateur imbriqués sous leurs pages. Lorsque ous relisez une session d'application mobile, BBR réutilise ce même paradigme aec des messages de Type 10 présentés comme pages et aec des messages de Type 4 représentés comme éénements d'interface utilisateur imbriqués sous ces pages. Pour faciliter la compréhension des données JSON dans les messages de Type 10 et Type 4, les messages de Type 10 sont conertis en HTML, et les messages de Type 4 sont représentés sur ce HTML. Pour cela, chaque contrôle reçoit un identificateur unique qui reste identique dans les messages de Type 10 et les messages de Type 4. Par exemple, un message de Type 10 peut indiquer la présence d'un contrôle Textbox sur l'écran de l'application mobile aec une certaine aleur et un message de Type 4 ultérieur peut indiquer une modification de cette aleur de Textbox. Dans BBR, le message de Type 10 est représenté sous forme de page dans la Liste de naigation et la relecture de cette page est le résultat de la conersion du message de Type 10 en HTML. Le message de Type 4 est représenté sous forme d'éénement d'interface utilisateur sous cette page et la relecture de cet éénement d'interface utilisateur montre la page Type 10, mais aec la aleur Textbox mise à jour et Textbox mis en éidence en ert, couleur caractéristique des éénements d'interface utilisateur. Modèles La conersion de messages de Type 10 en HTML est configurable. Comme pour ASP et JSP, cette conersion est obtenue en utilisant un ensemble de modèles qui consistent en un texte fixe aec des expressions en ligne. Les expressions de modèle peuent faire référence à JSON, qui est fourni comme entrée, peuent effectuer une logique et générer une sortie qui utilise JSON. Les expressions de modèle sont délimitées entre les caractères de début {{ et les caractères de fin }}. Exemple de modèle <label>{{["currstate"]["text"]}}</label> 88 IBM Tealeaf CX - Guide de configuration

99 Dans ce cas, le code HTML <label></label> correspond à du texte fixe. Les caractères {{ et }} délimitent l'expression. L'expression elle-même est ["currstate"]["text"]. Comme exemple, le résultat d'affichage de ce modèle peut être : <label>tealeaf</label> Un modèle peut contenir toute quantité de texte fixe et tout nombre d'expressions délimitées. Les données JSON de l'article de la structure de consignation sont affichées par les modèles pour générer du HTML. Les modèles disposent de deux sources de données JSON disponibles. Un contexte est un message de Type 10 ou un sous-élément de ce message. Un enironnement, à saoir des informations d'application et de périphérique de l'en-tête de l'article JSON. Les modèles sont installés dans le répertoire ReplaySerer\tlt spécifié par rapport à l'installation d'ibm Tealeaf. Pour afficher un message de Type 10, le modèle Type10.html, dans ce répertoire, est utilisé. Le nom et l'emplacement de ce fichier sont fixes et ne peuent pas être modifiés. Exemple Type10.html Il s'agit d'un exemple de configuration du fichier Type10.html. {{ if( eq([$"ostype"],"android"), template([], "android\\root.tlt"), template([], "ios\\root.tlt") ) }} Dans cet exemple, le modèle Type10.html se compose intégralement d'un expression unique délimitée par des caractères {{ }}. La aleur d'enironnement ostype est testée pour déterminer si elle est égale (eq) à la chaîne Android. Si ce test aboutit, la aleur de contexte complète, représentée par [], est transmise au modèle root.tlt, dans le répertoire android. La racine d'un message de Type 10 unique étant transmise comme contexte, c'est ce qui est enoyé à ce sous-modèle. Par contre, si le test échoue, le message de Type 10 est transmis à un modèle du répertoire ios. Outil de test de l'analyseur de modèle L'outil de test de l'analyseur de modèle permet de déelopper et de tester des modèles. La syntaxe de cet outil est la suiante : templateparsertest.exe templatefilename [paramjsonfilename [enjsonfilename] ] Utilisé aec un seul argument, le nom d'un fichier modèle est attendu. Le modèle est alors analysé et testé pour déterminer s'il est alide. Seules les expressions de modèle à l'intérieur de {{ }} sont érifiées. Le texte statique n'est pas érifié. Aec cette utilisation, seul le nom templatefilename transmis à la ligne de commande est alidé. Les autres fichiers modèle appelés éentuellement à partir de ce fichier modèle ne sont pas alidés. Utilisé aec deux arguments, le second paramètre est un fichier JSON qui représente l'entrée context. Dans ce scénario, l'entrée context de JSON est affichée Chapitre 2. Configuration des composants Tealeaf 89

100 ia le modèle pour générer un résultat et aucune entrée d'enironnement n'est disponible pour le modèle. Pour les modèles de relecture, le résultat est présumé être du HTML ou un sous-ensemble de HTML. Cette entrée peut être un objet JSON ou un tableau JSON. Utilisé aec trois arguments, le troisième paramètre est un fichier JSON qui représente l'entrée enironment. Dans ce scénario, l'entrée de contexte JSON est affichée de la même manière que pour deux arguments et les entrées d'enironnement sont disponibles. Cette entrée doit être un objet JSON où chaque ariable d'enironnement est représentée comme paire de nom-aleur JSON. Lorsque ous utilisez templateparsertest.exe, soyez prudent si ous utilisez des modèles qui font référence à des sous-modèles. Les chemins d'accès des sous-modèles sont indiqués par rapport au répertoire d'exécution du fichier templateparsertest.exe et non par rapport au nom templatefilename fourni comme entrée. Par exemple, il est d'usage de copier l'utilitaire templateparsertest.exe dans le répertoire qui contient le modèle racine des modèles testés. Langage des modèles Le langage des modèles de relecture de session d'application mobile d'ibm Tealeaf utilise un modèle de programmation par fonctions. Le langage des modèles de relecture de session d'application mobile possède les caractéristiques ci-après. Chaque macro du langage des modèles consiste en une expression unique qui comprend des appels de fonction imbriqués et génère une aleur Json affichée comme sortie. Aucune aleur existante ne peut être modifiée ; seule la création de copies modifiées est autorisée. Par conséquent, les paramètres des fonctions ne peuent pas être modifiés. Les fonctions ne peuent pas aoir d'effets secondaires. Chacune des fonctions ou naigations jpath renoie une aleur json ou génère une exception comme seul résultat ou effet. Les paramètres non utilisés sont garantis ne jamais être éalués. Par exemple, dans les fonctions default(), if() ou foreach() (ou n'importe où ailleurs). Le langage des modèles offre un traitement des erreurs par exception, selon lequel les erreurs qui se produisent lors du traitement d'une expression généreront une exception. Si l'exception est récupérable, (par exemple, un élément de naigation jpath inexistant), elle peut être traitée par une fonction default(). Les autres exceptions telles que les erreurs d'analyse ou les paramètres json de type incorrect transmis à une fonction généreront des exceptions "non-defaultable" (fatales) qui ne peuent pas être interceptées par default(), mais qui le sont par le sereur de relecture. Constructions du langage des modèles : Le langage des modèles de relecture de session d'application mobile est composé de trois constructions ; aleurs littérales JSON en ligne, naigation JSON de style Jpath entre crochets et composition d'appels de fonction prédéfinis. 90 IBM Tealeaf CX - Guide de configuration

101 Valeurs littérales JSON en ligne Les aleurs littérales JSON en ligne sont des chaînes entre guillemets, des entiers, des aleurs flottantes doubles et des réels, les constantes true, false et null, ainsi que des tableaux et des objets conertis en aleurs JSON. JSON utilise [ alue, alue, alue ] pour spécifier des tableaux, mais si cela est déjà utilisé pour la mise en ligne des tableaux JSON, il crée une ambiguïté de l'analyseur syntaxique aec la naigation jpath ; par conséquent, les constantes des aleurs de tableau en ligne doient être spécifiées entre parenthèses et non entre crochets, à saoir, comme suit : ( alue, alue, alue ). La sortie contient des crochets JSON [] si un tableau est généré. Les constantes de chaîne sont des chaînes JSON et ne doient pas inclure de caractères " (guillemets), \ (barre oblique inersée) ou de contrôle (par exemple, retour à la ligne, alimentation papier, tabulation) dans les chaînes. Les séquences d'échappement des chaînes JSON sont fournies, excepté pour \uxxxx (point de code Unicode hexadécimal). \" guillemet \\ barre oblique inersée \/ barre oblique (la barre oblique / facultatie peut être utilisée sans caractère d échappement) \b retour arrière \f alimentation papier \n retour à la ligne \r retour chariot \t tabulation horizontale Exemple {{ "JSON text string \n" }} {{5}} {{ 5.6 }} {{ 5.6e10 }} {{ true }} {{ false }} {{ null }} {{ ( 6, 8.2, "alue", true, false, null ) }} outputs as [6,8.2,"alue",true, false,null] {{ {"a" : 3, "b" : true, "c" : (5, 2, 3), "d" :{"e":2,"f":3}}}} outputs as: {"a":3,"b":true,"c":[5,2,3),"d":{"e":2,"f":3}} Naigation JSON de style Jpath entre crochets Cette construction possède les ariantes ci-après. Des crochets ide, [], indiquent l'arborescence JSON transmise au démarrage du modèle. Dans la plupart des cas, le contexte racine est la aleur par défaut et les crochets [] sont facultatifs. ["alue-name"] indique une aleur du nom spécifié dans un objet JSON. [3] indique la quatrième aleur d'un tableau JSON (index basé sur 0). [@"iter-name"] indique le nom d'une ariable ou d'un itérateur de portée limitée. Ces ariantes sont utilisées aec les appels de fonction foreach(), let() et filter(). [$"en-ar-name"] indique une aleur de ariable d'enironnement. Ces aleurs sont rendues accessibles ia le moteur de modèle, mais les aleurs sont Chapitre 2. Configuration des composants Tealeaf 91

102 déterminées et fournies par le programme qui démarre le moteur de modèle. Ces aleurs sont généralement utilisées pour les informations de ersion des diers aspects du système ou d'autres données non contenues dans la aleur JSON racine. La détermination de la présence ou non de telles ou telles ariables d'enironnement doit reposer sur la aleur de la ariable [$"j2hversion"] car J2H est chargé de définir ces aleurs. Les aleurs d'enironnement actuelles fournies par le sereur de relecture et J2H sont les suiantes : [$"ostype"] correspond à Android ou ios. [$"osversion"] correspond à la ersion du système d'exploitation Android ou ios. [$"msgversion"] correspond à la ersion du message JSON utilisé pour le message de type 10 et [$"clientenironment]. [$"j2hversion"] correspond à la ersion de j2h.dll ayant démarré le moteur de modèle. Cette aleur est principalement utilisée pour déterminer les autres ariables d'enironnement qui doient être présentes. [$"clientenironment"] correspond à l'objet "clientenironment" de l'en-tête du message JSON qui incluait également le message de type 10 transmis comme aleur principale. Utilisez la aleur [$"msgversion"] pour déterminer les aleurs qui doient être présentes dans cette aleur. Exemple {{ ["layout"]["controls"][0]["tltype"] }} is equialent to: {{ []["layout"]["controls"][0]["tltype"] }} Remarque : La naigation JSON est souent la seule chose à l'intérieur de {{...}}. Dans ce cas, le contenu de cette aleur JSON est remplacé par l'expression. Composition des appels de fonction prédéfinis Remarque : Les fonctions définies par l'utilisateur ne sont pas prises en charge. Remarque : Les aleurs/sous-expressions jamais utilisées ne sont jamais exécutées. Par exemple, la portion else d'une expression if() dans laquelle la condition de prédicat a pour aleur true. Toutes les fonctions renoient une aleur JSON ou génèrent une exception et n'acceptent comme arguments que les expressions résolues en aleurs JSON. Certaines exceptions peuent être interceptées et gérées par la fonction default(). Les aleurs d'objet manquantes ou les plages de tableau de naigation json constituent de telles exceptions. Les autres exceptions ne peuent pas être interceptées par default() et sont fatales. Il s'agit notamment des erreurs d'analyse ou d'une naigation json par l'intermédiaire de types de aleur JSON non alides. Ces exceptions entraînent toujours un incident pour ce modèle et ses parents/ancêtres qui l'ont instancié. Ces exceptions sont interceptées par le sereur de relecture, qui consigne les informations appropriées et génère un html indiquant l'erreur. Les aleurs de prédicat sont égales à true si une aleur booléenne est true, une aleur int ou uint n'est pas égale à zéro ou une chaîne, un objet ou une aleur de tableau n'est pas ide. 92 IBM Tealeaf CX - Guide de configuration

103 Fonctions de la bibliothèque de modèles : Les modèles de relecture de session d'application mobile possèdent dierses fonctions que ous pouez utiliser pour personnaliser otre relecture de session. Fonctions de ersion gettemplatelanguageversion() Renoie une chaîne de ersion qui indique la ersion du langage des modèles. La ersion actuelle est Voir aussi les fonctions de prédicat de comparaison ersionxx(). gettemplatelibraryversion() Renoie une chaîne de ersion qui indique la ersion de la bibliothèque de modèles. La ersion actuelle est Voir aussi les fonctions de prédicat de comparaison ersionxx(). Fonctions de prédicat Ces fonctions renoient une aleur booléenne true/false. Fonctions d'identificateur de type JSON : isnull(jsonvalue) isbool(jsonvalue) isint(jsonvalue) isuint(jsonvalue) isintegral(jsonvalue) isdouble(jsonvalue) isnumeric(jsonvalue) isstring(jsonvalue) isarray(jsonvalue) isobject(jsonvalue) Ces fonctions d'identificateur de type JSON ne renoient true que si le type de la aleur correspond au type du nom à l'extrémité de la fonction. isintegral() et isnumeric() sont des tests composés qui indiquent si le type est composé de plusieurs types. isempty(jsonarrayvalue) Renoie true si le tableau est ide ou false dans le cas contraire. eq(jsonvalue1, jsonvalue2) Compare les deux aleurs JSON pour déterminer si elles sont égales. jsonvalue1 et jsonvalue2 peuent correspondre à tout type JSON. lt(jsonvalue1, jsonvalue2) le(jsonvalue1, jsonvalue2) gt(jsonvalue1, jsonvalue2) ge(jsonvalue1, jsonvalue2) Compare la relation ordinale de deux aleurs. jsonvalue1 et jsonvalue2 doient correspondre toutes deux à des types numériques ou à des chaînes. Renoie true si la relation ordinale entre jsonvalue1 et jsonvalue2 correspond à la condition désignée et false, dans le cas contraire. Chapitre 2. Configuration des composants Tealeaf 93

104 La comparaison de chaînes est strictement lexicale et triée par aleurs numériques ascii / UTF-8. exists(jsonobject, "aluename1" [, "aluename2" [, "aluename3" ]]) Cette fonction de prédicat indique si les aleurs désignées existent dans un objet JSON. Renoie false si jsonobject n'est pas un objet, l'une des aleurs désignées (exceptée la dernière) n'est pas un objet ou l'un des arguments "alue-name" n'est pas présent dans l'objet indiqué par le paramètre qui le précède. Un même appel peut être utilisé pour érifier l'existence jusqu'à trois nieaux de profondeur aec les ariantes qui acceptent plusieurs paramètres "aluename". Dans ce cas, les objets sont recherchés dans l'ordre de sorte que si "aluename1" fait référence à un objet dans jsonobject, une aleur intitulée "aluename2" est recherchée dans l'objet auquel "aluename1" fait référence. Si cette aleur correspond à un objet, la aleur "aluename3" y est recherchée, si "aluename3" a également été spécifié. Exemple if( exists( [], "layout"), template( [] ["layout"],"layout.tlt")) if( exists( [], "layout", "coordinates", "x" ), concat("\n<!-- X is : ", ["layout"]["coordinates"]["x""], "-->\n") ) alueinarray(jsonvalue, jsonarray) Renoie true si au moins une aleur dans jsonarray renoie true lorsqu'elle est comparée à jsonvalue pour déterminer si ces aleurs sont égales. Exemple if( alueinarray( [][tltype], ("button", "canas", "label", "grid") ), ("exists", "does not exist") alueinarray( (3, 5, 7), ( (1, 2, 3), (4, 5, 6), (3, 5, 7)) ) Renoie true. ersioneq(jsonversionstring, jsonversionstring) ersionne(jsonversionstring, jsonversionstring) ersionlt(jsonversionstring, jsonversionstring) ersiongt(jsonversionstring, jsonversionstring) ersionle(jsonversionstring, jsonversionstring) ersionge(jsonversionstring, jsonversionstring) Compare deux chaînes de ersion composées d'un ou plusieurs entiers séparés par un point (.) ou une irgule (,), par exemple, de la forme ##.##.## ou ##,##,##. Cette fonction renoie true ou false suiant la condition reflétée par le nom de fonction et les aleurs des chaînes. Voir également les fonctions gettemplatelanguageversion() et gettemplatelibraryversion(). Remarque : Si les deux chaînes de ersion contiennent un nombre différent d'entiers, seuls les entiers qu'ils ont en commun sont comparés. Par exemple, 5 peut être considéré comme étant équialent à 5.*.*.*.*. Les aleurs 5.6 et 5 sont égales. Si ce comportement n'est pas souhaité, l'ajout de chaînes ".0" supplémentaires dans la chaîne de ersion potentiellement plus courte (ou dans les deux chaînes) garantit un classement strict (par exemple, les aleurs "5.6" et " " "ne sont pas égales"). Exemple 94 IBM Tealeaf CX - Guide de configuration

105 ersioneq("5.6", "5.6.3") Renoie true. ersionne("5.6", "5.6.3") Renoie false. ersionle("5.6", "5.6.3") Renoie true. ersiongt("5.6", "5.6.3") Renoie false. ersionlt("5.6", "5.6.3") Renoie false. Bien que selon la logique mathématique, 5.6<5.6.3 est rai, la sémantique de la logique de comparaison des ersions spécifie que la comparaison ne porte que sur le nombre de chiffres partagés. Par conséquent, la comparaison est en fait 5.6<5.6, ce qui est faux. ersionge("5.6", "5.6.3") Renoie true. Bien que selon la logique mathématique, 5.6>=5.6.3 est faux, la sémantique de la logique de comparaison des ersions spécifie que la comparaison ne porte que sur le nombre de chiffres partagés. Par conséquent, la comparaison est en fait 5.6>=5.6, ce qui est rai. Fonctions logiques booléennes and(predicate-expression, predicate-expression) Renoie true si predicate-expressions renoie true, etfalse si predicate-expression renoie false. Remarque : Le prédicat de gauche est éalué en premier et si cette expression renoie false, l'expression du prédicat de droite n'est pas éaluée et la aleur false est renoyée. or(predicate-expression, predicate-expression) Renoie true si predicate-expression renoie true, etfalse si les deux expressions renoient false. Remarque : Le prédicat de gauche est éalué en premier et si cette expression renoie true, l'expression du prédicat de droite n'est pas éaluée et la aleur true est renoyée. xor(predicate-expression, predicate-expression) Renoie true si l'une des expressions predicate-expression renoie true et l'autre, false. Sinon, renoie false. Remarque : Cette fonction est équialente à not(equals(predicateexpression, predicate-expression) ). not(predicate-expression) Renoie true si predicate-expression renoie false et false si l'expression renoie true. Fonctions mathématiques add(jsonnumericvalue, jsonnumericvalue) Si les deux paramètres numériques sont des entiers, cette fonction effectue un ajout d'entiers et renoie le résultat entier. Si l'un des paramètres Chapitre 2. Configuration des composants Tealeaf 95

106 correspond à une irgule flottante, un ajout de irgules flottantes est effectué et le résultat est une irgule flottante. sub(jsonnumericvalue, jsonnumericsubtractedvalue) Si les deux paramètres numériques sont des entiers, cette fonction effectue une soustraction d'entiers et renoie le résultat entier. Si l'un des paramètres correspond à une irgule flottante, une soustraction de irgules flottantes est effectuée et le résultat est une irgule flottante. mult(jsonnumericvalue, jsonnumericvalue) Si les deux paramètres numériques sont des entiers, cette fonction effectue une multiplication d'entiers et renoie le résultat entier. Si l'un des paramètres correspond à une irgule flottante, une multiplication de irgules flottantes est effectuée et le résultat est une irgule flottante. di(jsonnumericvalue, jsonnumericdiiservalue) Si les deux paramètres numériques sont des entiers, cette fonction effectue une diision d'entiers (tronquée) et renoie le résultat entier. Si l'un des paramètres correspond à une irgule flottante, une diision de irgules flottantes est effectuée et le résultat est une irgule flottante. remainder(jsonintegervalue, jsonintegerdiisorvalue) Renoie le reste entier du premier paramètre diisé par le deuxième paramètre (modulo). Les deux paramètres doient être des entiers. numerictofloat(jsonnumeric) Conertit tout type numérique (entier, non signé, réel/aleur flottante, booléen) en aleur réelle/flottante JSON. Normalement, un paramètre entier est conerti en nombre décimal pour qu'une opération mathématique ultérieure (par exemple, di()) renoie un résultat sous forme de fraction au lieu de tronquer le résultat. Exemple roundfloattoint( di( ["anintvalue"], numerictofloat( ["anintdiisor"] ))) stringtofloat(jsonstring) Analyse une chaîne jsong qui contient un nombre en irgule flottante et la renoie sous forme de aleur numérique JSON. Exemple stringtofloat("5.3") Renoie 5.3. truncatefloattoint(jsonfloat) Tronque une aleur JSON en irgule flottante en entier. Exemples truncatefloattoint( 5.8 ) Renoie 5. truncatefloattoint( -5.8 ) Renoie -5. roundfloattoint(jsonfloat) Arrondit une aleur JSON en irgule flottante à l'entier le plus proche. Exemples roundfloattoint( 5.8 ) Renoie IBM Tealeaf CX - Guide de configuration

107 roundfloattoint( -5.8 ) Renoie -6. min(jsonnumericexpr, jsonnumericexpr) max(jsonnumericexpr, jsonnumericexpr) Renoie la plus éleée ou la plus basse de deux aleurs numériques. Les aleurs sont conerties en aleurs doubles pour pouoir être comparées, mais la aleur d'origine et son type sont conserés et renoyés. Remarque : La aleur booléenne false est conertie en 0 / 0.0 et la aleur true, en 1 / 1.0. Exemples min( 5, 5.5) Renoie la aleur entière 5. max( 5, 5.5) Renoie la aleur décimale 5.5. min( false, 3) Renoie la aleur booléenne false. arraymin(jsonarray [, "iter-name", accessorexpression ] ) arraymax(jsonarray [, "iter-name", accessorexpression ] ) Renoie la aleur la plus basse ou la plus éleée dans un tableau. Si la ersion à un argument est utilisée, jsonarray est présumé être un tableau simple de aleurs numériques. Les paramètres facultatifs iter-name et accessorexpression peuent être utilisés pour accéder à des éléments situés plus profondément dans la structure du tableau si jsonarray contient des structures JSON plus complexes. Exemple arraymin( (5, 7, true, 4.3 ) ) Renoie la aleur booléenne true. arraymax( arrayofcontrols, "iter", [@"iter"]["ctrl"]["height"]) Renoie la hauteur maximale d'un contrôle dans un tableau de contrôles. Remarque : Cette fonction est équialente à arraymax( foreach( arrayofcontrols, "iter", [@"iter"]["ctrl"]["height"]) ). str( jsonnumericvalue ) Renoie une aleur de chaîne JSON qui contient une sérialisation d'une aleur numérique. Les aleurs booléennes sont sérialisées en true ou false. Fonctions logiques des modèles size(jsonarrayorobject) Renoie le nombre d'éléments dans un tableau ou un objet. getmembernames(jsonobject) Renoie un tableau JSON qui contient les noms des aleurs contenues dans le paramètre jsonobject. Pour effectuer une itération sur les éléments contenus dans un objet foreach( getmembernames(jsonobject), "iter", jsonobject[ [@"iter"] ] ) assert( predicate-expression, message-string-expression [, assertpassexpression] ) Si predicate-expression renoie false, l'expression message-string- Chapitre 2. Configuration des composants Tealeaf 97

108 expression est éaluée et une exception irrécupérable contenant la chaîne résultante est générée afin d'être traitée par le sereur de relecture. Si predicate-expression renoie true, l'expression facultatie assertpassexpression est éaluée si elle est présente et son résultat est renoyé. Si l'expression facultatie assertpassexpression n'est pas spécifiée, une chaîne ide est renoyée. Remarque : La ersion à deux arguments de la fonction assert() n'est généralement destinée qu'au seul appel de fonction dans une expression autonome, tandis que la ersion à trois arguments de la fonction assert() est destinée à être utilisée dans le contexte d'une expression plus complexe. {{ assert(ersionlt([$"templatelangversion"], "2"), concat("these templates only tested on ersion 1.x of template language; template language ersion is :", [$"templatelangversion"] ) ) }} {{ if(equals([$"ostype"], "Android), "ostype is Android", assert (equals([$"ostype"],"ios"), concat("inalid alue for ostype", [$"ostype"]), "ostype is ios") ) }} arrayconcat( arrayofstringvalues [, separatorstringvalue] ) Chaque aleur contenue dans le paramètre arrayofstringvalues est concaténée en une nouelle aleur de chaîne. Si le paramètre separatorstringvalue facultatif est spécifié, cette aleur est insérée entre chaque aleur du tableau dans la sortie affichée. concat( alue1, alue2 [, alue3 [, alue4 ]]) Entre deux et quatre aleurs de chaîne peuent être spécifiées pour être concaténées en une même chaîne. Si plus de quatre aleurs de chaîne doient être concaténées, des appels de fonction concat() imbriqués peuent être utilisés. template(jsonsubtree/object, "template filename") Cette fonction charge, traite et affiche le résultat d'une instanciation de modèle dans un objet de chaîne JSON. default(expression, expression-on-error) Permet le traitement des erreurs/exceptions pour certaines erreurs/exceptions (récupérables). Si une expression contient une erreur irrécupérable, expression-on-error est éalué et son résultat est utilisé à la place. Remarque : L'utilisation de default() doit être éitée, si possible. Elle place en cache toutes les erreurs sources d'incident, qu'il s'agisse d'erreurs attendues ou non, et masque les problèmes dans les modèles, ce qui rend le débogage de ces derniers bien plus difficile. Utilisez if(..., ) si possible pour tester la condition qui risque de générer une erreur et indiquez le comportement par défaut au lieu de le spécifier aec default(). Si une condition déclenche souent default(), les performances risquent d'être affectées par rapport à un test de la condition à l'aance. 98 IBM Tealeaf CX - Guide de configuration

109 if(predicate-expression, then-expression, else-expression) La aleur JSON renoyée par la fonction if() est le résultat de then-expression ou else-expression, suiant la aleur renoyée par l'expression du prédicat. L'expression du prédicat renoie true si une aleur booléenne est true, un entier ou un entier non signé non égal à0ou une chaîne ou un tableau non ide. Analogue à l'opérateur ternaire C/C++ : predicate? true-alue : false-alue; let("ariable-name", expression-to-assign, expression-usingariable(...[@"ariable-name"]...) ) Cette fonction est une affectation limitée d'une aleur à une ariable temporaire qui n'est alide que pour l'éaluation de l'expression correspondant au troisième paramètre de l'instruction let(). Le résultat d'expression-using-ariable deient la aleur renoyée par let(). "ariable-name" est le texte en clair du nom dans expression-usingariable. Cette aleur est ensuite accessible aec [@"ariable-name"]. Exemple let("hexclr", htmlcolor(["color"]), default(some-expression-using([@"hexclr"]), concat("problem rendering with ", [@"hexclr"])) ) Remarque : Généralement, l'expression expression-using-ariable correspondant au troisième paramètre d'un appel let() est modérément complexe. foreach(json-array, "iter-name", expression(...[@"iter-name"]... ) ) Cette fonction effectue une itération sur le paramètre json-array et affecte un par un chaque élément du tableau au nom d'itérateur (iterator-name) aant d'éaluer l'expression aec ce contexte. La aleur JSON qui résulte de chaque éaluation du tableau est affectée à l'élément correspondant d'un tableau de résultat. Par exemple, un tableau d'entrée contenant 11 éléments génère un tableau de résultat aec exactement 11 éléments. Si l'une des éaluations génère une exception non gérée, tous les résultats sont éliminés et le résultat est l'exception. filter(json-array, "iter-name", predicate_expression(...[@"iter-name"]...) ) Cette fonction effectue une itération sur un tableau, d'une manière similaire à foreach(), mais l'expression est une expression de prédicat où le résultat indique si l'élément correspondant du paramètre json-array doit être copié dans le tableau de résultat. Par exemple, si un tableau d'entrée contient 11 éléments, le tableau résultant contient entre 0 et 11 éléments, en fonction de l'expression de prédicat. Si l'une des éaluations génère une exception non gérée, le tableau de résultat est éliminé et le résultat est l'exception. L'expression predicate_expression renoie true si une aleur booléenne est true, un entier ou un entier non signé non égal à0ouunechaîne ou un tableau non ide. Fonctions de génération HTML htmlcolor( jsonintvalue ) Renoie une chaîne JSON qui contient une représentation hexadécimale du paramètre entier permettant de spécifier une couleur dans HTML. La aleur jsonintvalue doit être comprise entre 0 et 0x00FFFFFF (aleur décimale ). Chapitre 2. Configuration des composants Tealeaf 99

110 htmlescape( jsonstringvalue) Fournit une séquence d'échappement html pour éiter l'injection accidentelle ou maleillante d'un texte qui pourrait interférer aec le contexte html où le texte est inséré. htmlattr( attrvalue, attrname [, attrunits] ) Renoie une chaîne JSON qui contient une déclaration d'attribut html générée. Les guillemets (") inclus dans l'une des aleurs attrvalue, attrname ou attrunits sont remplacés par ". Notez que seuls les guillemets étant remplacés (& ne l'est pas), ous n'aez pas à ous soucier d'un double remplacement accidentel si une chaîne déjà remplacée est transmise. Exemple htmlattr( 5, "id" ) Renoie id="5" cssdecl( attrvalue, attrname [, attrunits] ) Renoie une chaîne JSON qui contient une déclaration css générée. cssdecl( 100, "height","px" ) Renoie height:100px; Traitement des incidents Pour plus d'informations concernant le traitement des incidents, oir "Traitement des incidents - Sereur de relecture" dans le document de dépannage d'ibm Tealeaf. Gestion des modules d'extension de correspondance des données Les données de session capturées par Tealeaf sont composées des demandes soumises par le naigateur du isiteur à une application Web et des réponses series par le sereur Web. Ces messages se présentent généralement sous la forme de demandes GET HTTP ou de demandes POST HTTP au sereur et de la réponse renoyée au demandeur. Les données des demandes POST ont toujours été présentées sous forme de paires nom=aleur et codées par URL ; les données POST ressemblent à une chaîne de requête d'url. Ce type de données est également appelé données de formulaire et représente incontestablement le mécanisme de soumission des formulaires HTML le plus courant. Aec l'apparition des applications Internet enrichies, les demandes et les réponses sont deenues plus compliquées et utilisent une plage de technologies facultaties plus étendue. En plus des données de formulaire, les applications Internet enrichies utilisent maintenant des formulaires de données hiérarchiques, tels que XML et JSON et même des formulaires binaires pour communiquer entre le client et le sereur. Les applications Internet enrichies peuent également utiliser les plateformes de plug-in. De telles applications peuent utiliser les formats de données propriétaires offerts par les fournisseurs de plug-in respectifs. Ces formulaires de données peuent être capturés par IBM Tealeaf CX Passie Capture Application et transmis au système Tealeaf. Lors de la relecture, IBM Tealeaf CX RealiTea Viewer et les clients de relecture sur naigateur doient saoir comment gérer ces formulaires de données. En particulier, pour une demande données lors de la relecture, la paire demande/réponse capturée à laquelle la demande doit être associée risque de ne pas être immédiatement identifiable. 100 IBM Tealeaf CX - Guide de configuration

111 Par exemple, certaines demandes peuent inclure un horodatage ou un paramètre d'identificateur global unique généré par le client. L'horodatage (ou l'identificateur global unique) stocké dans une session Tealeaf correspond à l'heure à laquelle la session a été capturée. Lors de la relecture, un horodatage (ou identificateur global unique) différent correspondant à l'heure de la relecture est généré comme partie intégrante de la demande, ce qui génère une demande de relecture qui ne correspond pas exactement à une demande capturée. Suiant le format de données utilisé, ce paramètre ariable peut également se présenter sous la forme d'une paire nom-aleur, telle que timestamp= ou d'un noeud XML, tel que le suiant : <timestamp> </timestamp> Présentation Des propriétés JSON peuent également être utilisées : {"timestamp": } Ignorer un sous-ensemble spécifique de ariables pour obtenir la meilleure demande correspondante requiert des connaissances détaillées sur le format de données sous-jacent dans lequel le contenu est représenté. A l'aide de la structure des plug-ins de correspondance de données POST, les clients RTV et BBR peuent accéder à un ensemble de plug-ins qui permettent d'identifier la réponse appropriée correspondant à la demande. A l'aide du type de contenu indiqué dans la demande, le client de relecture peut rechercher le plug-in approprié à utiliser pour associer les demandes de ces types de contenu à leurs réponses dans la session. A mesure que le domaine des applications Internet enrichies continue de s'étendre, de noueaux types de plug-in peuent être déeloppés et déployés dans otre enironnement Tealeaf, ce qui permet une relecture Tealeaf pour s'adapter aux technologies émergentes. En outre, les utilisateurs peuent configurer les priorités d'application des plug-ins, pour que les technologies hybrides puissent être gérées par une suite de plug-ins. Voir «Affinité des plug-ins», à la page 104. Cette section fournit des informations générales sur la manière de gérer les plug-ins de RTV et BBR, qui utilisent les plug-ins conserés sur le sereur de relecture. Remarque : Pour les formats personnalisés ou hybrides, il est possible de générer des plug-ins à utiliser dans otre enironnement Tealeaf. Voir «Génération de plug-ins personnalisés», à la page 107. Clients de relecture pris en charge Les plug-ins de correspondance des données POST peuent être déployés sans modification de RTV et BBR sur la ersion 8.3 et les ersions ultérieures. Remarque : Les ersions de RTV ou BBR antérieures à la ersion 8.3 ne reconnaissent pas les plug-ins. Chapitre 2. Configuration des composants Tealeaf 101

112 IBM Tealeaf CX RealiTea Viewer est une application de bureau qui doit être installée sur des bureaux Windows indiiduels. Voir "RealiTea Viewer (RTV) - Guide d'utilisation" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. La relecture basée sur naigateur est une méthode de relecture basée sur naigateur accessible ia le portail Tealeaf. Aucune installation supplémentaire n'est requise. Voir "Relecture sur naigateur CX" dans IBM Tealeaf cximpact - Manuel de l'utilisateur. Les sessions series par l'intermédiaire de la relecture basée sur naigateur sont gérées, présentées et distribuées par le sereur de relecture, sur lequel les plug-ins sont installés. Voir «Configuration du sereur de relecture», à la page 74. Plug-ins par défaut Tealeaf fournit un ensemble de plug-ins de correspondance de données POST pour les types de contenu ci-après. Tableau 3. Plug-ins par défaut Nom du plug-in Données de formulaire Types de contenu pris en charge application/x-www-form-urlencoded DLL TLReplayPluginForm.dll JSON text/json text/x-json application/json Remarque : Pour les transactions JSON, application/json représente le type MIME standard d'iana, dont l'utilisation par les applications est recommandée par Tealeaf. Remarque : Disponible dans la ersion 8.4 et les ersions ultérieures. application/x-json formdata/ text/html jsonp XML application/msbin1 TLReplayPluginJSON.dll TLReplayPluginJSONP.dll TLReplayPluginXML.dll Google Web Toolkit text/xml text/x-gwt-rpc TLReplayPluginGWT.dll Pour une correspondance des données POST précise lors de la relecture, aucune installation supplémentaire n'est requise pour les formats ci-dessus. Les plug-ins sont déployés comme fichiers.dll dans les emplacements de RTV et du sereur de relecture. Voir «Ajout et suppression de plug-ins». Ajout et suppression de plug-ins Selon les besoins, des plug-ins peuent être ajoutés et supprimés des clients de relecture pour permettre une relecture précise de os applications Web. Cette 102 IBM Tealeaf CX - Guide de configuration

113 opération peut être considérée comme une étape de configuration et ne nécessite pas une réinstallation complète de RTV ou du sereur de relecture. RTV Pour les utilisateurs IBM Tealeaf CX RealiTea Viewer, les plug-ins sont actiés et désactiés ia l'onglet Options des plug-ins. Remarque : Les plug-ins doient être fournis aux utilisateurs RTV indiiduels pour être déployés et actiés ia l'application. Pour plus d'informations sur la gestion des plug-ins ia RTV, oir "RealiTea Viewer - Options des plug-ins" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Sereur de relecture et BBR Lorsque le sereur de relecture est démarré, une reconnaissance des plug-ins, stockés sous forme de fichiers DLL, est effectuée sur le répertoire d'installation de Tealeaf, sur le sereur de relecture. Lors de la phase de présentation d'une session, le sereur de relecture utilise ces fichiers DLL pour effectuer la correspondance des données POST des réponses aux demandes aant de distribuer les données de session au client BBR. La structure des plug-ins de correspondance des données POST n'est pas isible par les utilisateurs finaux de BBR. Remarque : Les noueaux plug-ins dans BBR doient être installés dans le répertoire racine de Tealeaf sur le sereur de relecture. Pour les désactier, ous n'aez qu'à les supprimer du répertoire. Si ous n'aez pas accès au sereur de relecture, ces éléments peuent être insérés à l'aide de l'option Placer un fichier ia TMS. Voir "Onglet Aancé de TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. Mise à jour des profils de relecture pour la correspondance de données POST DWR Si ous aez effectué une mise à nieau ers la ersion 8.4 ou une ersion ultérieure, ous deez configurer manuellement le plug-in de correspondance FormData pour qu'ils reconnaisse les données POST DWR et pour appliquer le plug-in approprié correspondant au contenu. Configuration BBR : cette configuration est appliquée ia le profil du sereur de relecture. Voir «Configuration du sereur de relecture», à la page 74. RTV : les utilisateurs indiiduels de RTV doient appliquer cette modification à leur profil local. Voir le chapitre sur la présentation de RealiTea Viewer dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Remarque : Ces informations de configuration n'étant pas partagées entre les profils RTV et BBR (sereur de relecture), les modifications doient être appliquées sur chaque sereur de relecture et chaque instance de RTV. Remarque : A des fins de configuration, Tealeaf recommande l'utilisation du client IBM Tealeaf CX RealiTea Viewer pour effectuer la configuration et tester les opérations du plug-in. Chapitre 2. Configuration des composants Tealeaf 103

114 Pour installer IBM Tealeaf CX RealiTea Viewer : 1. Installez RTV sur otre système Windows local. Voir "RealiTea Viewer (RTV) - Guide d'utilisation" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. 2. Vérifiez que les plug-ins appropriés sont disponibles dans RTV. Voir "RealiTea Viewer - Options des plug-ins" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. 3. Configurez IBM Tealeaf CX Passie Capture Application pour capturer les types de contenu gérés par les plug-ins installés. Voir «Configuration de la PCA pour capturer de noueaux types de contenu». 4. Vérifiez que ous pouez rechercher et extraire les sessions qui utilisent les plug-ins à tester. Voir "RealiTea Viewer - Recherche et sous-recherche dans des sessions" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Configuration de la PCA pour capturer de noueaux types de contenu Par défaut, la PCA capture les types de contenu utilisés par la plupart des applications Web standard. Pour les applications Internet enrichies, la PCA doit généralement être configurée de sorte à autoriser les types de contenu utilisés pour otre application Web. 1. Dans RTV, sélectionnez Outils > Options?. 2. Cliquez sur l'onglet Plug-ins. 3. Pour chaque plug-in répertorié : a. Sélectionnez le plug-in. b. Cliquez sur Propriétés. c. Copiez l'intégralité de la chaîne. Collez-la dans un fichier texte par mesure de sécurité. d. Répétez la procédure ci-dessus pour chaque plug-in répertorié. 4. Vérifiez que la PCA capture chacun des types de contenu que ous aez répertoriés dans le fichier texte. a. Si le type de contenu n'est pas actuellement capturé, il doit être inséré dans la liste des types de capture appropriée, dans l'onglet Pipeline de la console Web de la PCA. Remarque : Lorsque ous actiez un noueau type de capture, la PCA commence immédiatement à capturer le contenu. En fonction du olume de contenu, le noueaux flux de capture peut affecter les performances et le traitement dans tout le système Tealeaf. b. Voir "Console Web de la PCA - Onglet Pipeline" dans le document IBM Tealeaf Passie Capture Application - Guide. Affinité des plug-ins A l'aide de l'onglet Plug-ins de RTV, ous pouez définir la aleur d'affinité de chaque plug-in. Comme il est possible de déployer plusieurs plug-ins de correspondance de données POST pour un même type de contenu, ous pouez configurer la aleur affinité de chaque plug-in pour indiquer la priorité des plug-ins et, par conséquent, l'ordre dans lequel ils sont utilisés. Il est possible d'utiliser plusieurs plug-ins alors qu'un seul est requis pour traiter une URL spécifique ou une zone du site, l'autre plug-in étant le plug-in par défaut du type de contenu ailleurs sur le site. 104 IBM Tealeaf CX - Guide de configuration

115 Les aleurs affinité sont comprises entre 0,0 et 1.0. Les plug-ins possédant une aleur d'affinité plus éleée sont utilisés pour éaluer le même type de contenu en premier. Voir "RealiTea Viewer - Options des plug-ins" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Lorsque les règles de relecture sont déployées sur le sereur de relecture, les aleurs d'affinité définies dans RTV sont appliquées aux plug-ins BBR. Voir «Déploiement de la configuration sur le sereur de relecture», à la page 106. Vérification des opérations de plug-in Emplacement du type de contenu : Dans les hits capturés par Tealeaf, la aleur du type de contenu est insérée dans la section [en] de la demande. Dans l'exemple ci-dessous, le type de contenu est défini sur text/xml : [en] HTTP_CONTENT_TYPE=text/xml Si cette aleur correspond à la aleur insérée pour le type de contenu du plug-in, le plug-in associé est utilisé à des fins de correspondance. Recherche de sessions par type de contenu : Une fois que ous aez actié la capture des types de contenu appropriés et attendu suffisamment pour que Tealeaf capture des sessions utilisant ce type, ous pouez effectuer les étapes ci-après pour rechercher une session dans laquelle le type de contenu apparaît. La méthode de base de recherche de ces sessions consiste à spécifier une recherche à l'aide d'url ers les pages qui utilisent ce type de contenu. Remarque : Si ous ne saez pas quelle URL appropriée utiliser, ous deez contacter otre équipe de déeloppement Web. Vous pouez également contacter les serices professionnels de Tealeaf pour obtenir de l'aide. Voir "Recherche dans les données de session" dans le documentibm Tealeaf cximpact - Guide d'utilisation. Vérification du plug-in : Pour érifier que le plug-in fonctionne, effectuez les étapes ci-après. 1. Chargez une session utilisant le type de contenu dans RTV. Vous pouez le charger à partir de la liste des sessions du portail. Voir "Résultats de recherche - Liste des sessions" dans le document IBM Tealeaf cximpact - Guide d'utilisation. 2. Dans la barre d'outils, cliquez sur le bouton Demande. 3. Examinez les demandes de la session jusqu'à ce que ous trouiez l'entrée appropriée dans la section [en] de la demande : HTTP_CONTENT_TYPE=text/xml où text/xml est remplacé par le type de contenu que ous testez. 4. Dans le menu RTV, sélectionnez Afficher > Détails du chargement de la page. 5. Dans la colonne Détails sur le chargement de page, examinez la colonne Méthode. Recherchez une aleur qui inclut des parenthèses. Par exemple : Post(244) 6. Les objets de page tels que ceux ci-dessus indiquent que les données POST ont été trouées. Cliquez sur l'objet à l'aide du bouton droit de la souris et sélectionnez l'option PostData. Chapitre 2. Configuration des composants Tealeaf 105

116 106 IBM Tealeaf CX - Guide de configuration 7. Vous pouez examiner le contenu du sous-menu pour identifier les données trouées. Si le sous-menu est ide, aucune donnée n'a été trouée pour les données POST. Voir "RealiTea Viewer - Page Charger les détails" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Remarque : Pour plus d'informations sur la érification du plug-in, contactez les serices professionnels de Tealeaf. Déploiement de la configuration sur le sereur de relecture : Remarque : Pour pouoir actier les plug-ins de correspondance de données POST sur BBR ia le sereur de relecture, les fichiers DLL de ces plug-ins doient être installés sur le sereur de relecture. Voir «Sereur de relecture et BBR», à la page 103. Une fois que ous aez installé les fichiers DLL sur le sereur de relecture, ous pouez utiliser les étapes ci-après pour appliquer la configuration des plug-ins de otre installation de RTV au sereur de relecture, qui fournit ces options de configuration à chaque utilisateur BBR de l'enironnement. Remarque : Les étapes ci-après déploient toutes les règles de relecture dans otre configuration RTV sur le sereur de relecture. Vous deez créer une copie de otre fichier de règles de relecture et la modifier pour supprimer les règles de relecture personnelles que ous souhaitez déployer aant de déployer la copie sur le sereur de relecture. 1. Dans le menu RTV, sélectionnez Outils > Options Cliquez sur l'onglet Profils. 3. Pour modifier os règles de profil pour les plug-ins, cliquez sur Modifier le profil brut Dans la partie supérieure du fichier se trouent les plug-ins actuellement installés dans RTV : <Plugins> <ReplayHitMatchPlugin name="amf" ersion=" " interfaceversion="1" errorcode="0" errormessage=""> <HitType contenttype="application/x-amf" handlesquerystring="false" wantresponsedata="false" haecustomoptionsdialog="false" haecustomignoreparamdialog="false" haecustomresponsedisplay="false" haecustompostdatadisplay="false" affinity="0.5"> <URLFilter pattern="" reqvar="" reqvarvalue=""/></hittype> </ReplayHitMatchPlugin> <ReplayHitMatchPlugin name="formdata" ersion=" " interfaceversion="1" errorcode="0" errormessage=""> <HitType contenttype="application/x-www-form-urlencoded" handlesquerystring="true" wantresponsedata="false" haecustomoptionsdialog="false" haecustomignoreparamdialog="false" haecustomresponsedisplay="false" haecustompostdatadisplay="false" affinity="0.5"> <URLFilter pattern="" reqvar="" reqvarvalue=""/></hittype> </ReplayHitMatchPlugin> <ReplayHitMatchPlugin name="formdatacustom" ersion=" " interfaceversion="1" errorcode="0" errormessage=""> <HitType contenttype="application/x-www-form-urlencoded" handlesquerystring="true" wantresponsedata="true" haecustomoptionsdialog="false" haecustomignoreparamdialog="false" haecustomresponsedisplay="false" haecustompostdatadisplay="false" affinity="0.4">

117 <URLFilter pattern=" reqvar="" reqvarvalue=""/></hittype> </ReplayHitMatchPlugin> <ReplayHitMatchPlugin name="xml" ersion=" " interfaceversion="1" errorcode="0" errormessage=""> <HitType contenttype="text/xml" handlesquerystring="false" wantresponsedata="false" haecustomoptionsdialog="false" haecustomignoreparamdialog="false" haecustomresponsedisplay="false" haecustompostdatadisplay="false" affinity="0.5"> <URLFilter pattern="" reqvar="" reqvarvalue=""/></hittype> <HitType contenttype="application/msbin1" handlesquerystring="false" wantresponsedata="false" haecustomoptionsdialog="false" haecustomignoreparamdialog="false" haecustomresponsedisplay="false" haecustompostdatadisplay="false" affinity="0.5"> <URLFilter pattern="" reqvar="" reqvarvalue=""/></hittype> </ReplayHitMatchPlugin> </Plugins> 5. Effectuez des modifications si nécessaire. 6. Pour sauegarder os modifications, cliquez sur Enregistrer les modifications & Fermer. 7. Entrez le sereur de relecture maître dans la zone de texte Profil par défaut. 8. Cliquez sur Téléchargez les paramètres sur le sereur. 9. Votre profil de relecture a été appliqué au sereur de relecture. Génération de plug-ins personnalisés Les plug-ins peuent être conçus pour : 1. effectuer des tâches de décodage des réponses binaires lors de la relecture (Base64) 2. effectuer une correspondance des données pour le format spécifié (XML, JSON) 3. effectuer les deux opérations précédentes (AMF, XML binaire, JSONP) La correspondance des données POST est une exigence unique pour la relecture et n'est pas requise dans les autres domaines de la suite de produits Tealeaf. La correspondance elle-même peut être plus ou moins complexe ; elle peut être simple ou impliquer des règles complexes, des heuristiques et une adaptation des réponses. Remarque : La génération de plug-ins de correspondance de données POST requiert un mandat des serices professionnels. Pour plus d'informations, euillez contacter les serices professionnels de Tealeaf. Chapitre sur la configuration du sereur de recherche Le sereur de recherche implémente plusieurs fonctions de bas nieau utilisées par le système Tealeaf pour extraire les données de session et sureiller les systèmes qui les gèrent. Cette section fournit des informations générales sur le sereur de recherche et des instructions permettant de configurer les paramètres indiiduels du sereur de recherche. Chapitre 2. Configuration des composants Tealeaf 107

118 Présentation Fonctions du sereur de recherche Les fonctions suiantes sont prises en charge : Extraction du statut du Canister : affiche une ersion XML des points de données du Canister à court terme qui peut ous indiquer l'état du Canister à court terme actuel. Extraction d'une liste relisible de toutes les sessions acties : extrait une liste de toutes les sessions acties dans le Canister à court terme aec un lien qui en permet la relecture. Si IBM Tealeaf CX RealiTea Viewer est installé sur la même machine, il peut charger toutes les sessions acties. Pour plus d'informations sur RTV, oir "RealiTea Viewer (RTV) - Guide d'utilisation" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Recherche de session : permet les recherches dans les Canisters à court terme et à long terme. Vous pouez sélectionner le Canister dans lequel les recherches seront effectuées, afin de pouoir effectuer des recherches dans les sessions acties et/ou terminées. Extraction d'éénements de Canister : permet l'extraction de tous les éénements de Canister configurés de la machine sur laquelle le sereur de recherche est exécuté. Régénération d'index : si les fichiers d'index sont endommagés, ous pouez régénérer les index à l'aide de la commande de érification et de résolution. Cette commande extrait les fichiers TLC du Canister et les conertit en index. Vidage du Canister à court terme des sessions : le sereur de recherche offre accès aux opérations du régulateur pour que ous puissiez ider le Canister, commencer à spouler les données et bien plus encore. Extraction de définitions d'éénement : le sereur de recherche qui est également le sereur maître d'éénements peut extraire les définitions d'éénement de la base de données. Distribution des recherches : le sereur de recherche hébergé sur le sereur du portail distribue les recherches exécutées ia l'interface du portail aux sereurs de recherche qui se trouent sur d'autres machines pour extraire les sessions. Le sereur de recherche exécute les commandes d'url et renoie les sessions au format XML. Hôtes du sereur de recherche Le sereur de recherche Tealeaf peut se trouer sur les systèmes qui hébergent les composants Tealeaf ci-après ou être hébergé sur un sereur autonome. En fonction du sereur sur lequel il est installé, sa fonction principale peut arier. Composant Tealeaf Fonction principale du sereur de recherche Sereur du portail L'instance de sereur de recherche sur le portail est généralement définie comme maître des éénements, ce qui signifie qu'il s'agit du sereur désigné pour extraire les définitions d'éénement de la base de données. Ces définitions d'éénement sont placées dans le cache du sereur pour pouoir être extraites si nécessaire. Le sereur de recherche du portail est également chargé de fédérer les requêtes de recherche sur les Canisters contenant les sessions demandées. 108 IBM Tealeaf CX - Guide de configuration

119 Remarque : Dans un enironnement à plusieurs sereurs, le sereur de portail ne contient pas d'index de Canister. Certains paramètres et fonctions du sereur de recherche ne sont pas applicables. Sereur du Canister Le sereur de recherche sur un Canister indiiduel est chargé d'exécuter les recherches qui lui ont été soumises par les autres sereurs et de renoyer les informations de session au format XML au demandeur. IBM Tealeaf cxconnect for Data AnalysisSereur Le sereur de recherche sur un sereur IBM Tealeaf cxconnect for Data Analysis gère les requêtes de recherche exécutées dans le cadre des tâches IBM Tealeaf cxconnect for Data Analysis pour extraire les sessions et les sauegarder dans l'un des formats pris en charge. IBM Tealeaf cxverifysereur Le sereur de recherche sur un sereur IBM Tealeaf cxverify gère les requêtes de recherche exécutées dans le cadre des tâches IBM Tealeaf cxverify pour extraire les sessions et les exporter. Sereur de rapports Dans certains déploiements, le sereur de recherche qui agrège les résultats de recherche des utilisateurs du portail se troue sur le sereur de rapports pour alléger la charge de traitement du sereur de portail. Ce déploiement n'est pas courant. Configuration de la recherche A l'aide de Tealeaf Management System, dans le portail, ous pouez configurer le sereur de recherche en fonction de os besoins. Pour plus d'informations sur l'utilisation de TMS, oir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Pour configurer le sereur de recherche : Remarque : Les modifications apportées à la configuration du sereur de recherche requièrent un redémarrage, ce qui force tous les utilisateurs du portail Tealeaf. Effectuez ces modifications de configuration en conséquence. 1. Connectez-ous au portail en tant qu'administrateur. 2. Dans le menu Portail, sélectionnez Tealeaf > TMS. 3. Cliquez sur l'onglet WorldView. 4. Pour le sereur de otre choix, accédez au composant Sereur de recherche. 5. Sélectionnez Configuration du sereur de recherche. 6. Cliquez sur Afficher. 7. Dans la boîte de dialogue des informations de configuration, cliquez sur Modifier pour lancer la configuration de la recherche. Pour éditer un paramètre indiiduel, cliquez sur son nom. Dans la boîte de dialogue, éditez la aleur et cliquez sur OK. Pour modifier un groupe de paramètres, cliquez sur Modifier. Chapitre 2. Configuration des composants Tealeaf 109

120 Figure 12. Configuration de la recherche Sauegarde des configurations du sereur de recherche Remarque : N'enoyez pas les configurations de sereur de recherche aux autres sereurs de recherche aant d'aoir étudié tous les paramètres. Certains paramètres de sereur de recherche, tels que les définitions de rôle et les emplacements de sereur TLI, ne doient pas être appliqués sur tous les sereurs. Remarque : Une fois que ous aez modifié la configuration du sereur de recherche, les étapes suiantes sont requises : Enoyez la configuration aux sereurs ia TMS. Redémarrez le serice de données Tealeaf. Voir "Configuration du serice de données Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration. Réinitialisez le portail Tealeaf. Paramètres de base Cliquez sur l'une des options ci-après dans ce groupe pour en modifier la aleur. Paramètre Description Port du sereur de recherche Spécifie le port IP du sereur de recherche à utiliser pour interroger le Canister. La aleur par défaut est Journalisation Actie ou désactie la consignation. Les fichiers journaux du sereur de recherche sont sauegardés dans TeaLeaf\Logs sur la machine sur laquelle le sereur de recherche est installé. Nombre de jours de conseration des journaux Définit le nombre de jours pendant lesquels les fichiers journaux du sereur de recherche doient être conserés. 110 IBM Tealeaf CX - Guide de configuration

121 Close Idle Canister Connection After Spécifie le nombre de minutes pendant lesquelles le sereur de recherche doit rester inactif aant que sa connexion au Canister ne soit fermée. Si le nombre de connexions au Canister est supérieur à 16, le Canister interdit aux autres composants de se connecter ; il peut s'aérer intéressant que le sereur de recherche libère sa connexion s'il risque de ne pas être utilisé dans un aenir proche. Serice de données Tealeaf Nom d'hôte et numéro de port du sereur de recherche pour se connecter au serice de données Tealeaf. Par défaut cette aleur est localhost: Le serice de données Tealeaf gère les connexions entre les composants Tealeaf et les bases de données qu'ils utilisent. Voir "Configuration du serice de données Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration. Chemin temporaire Chemin d'accès complet sur la machine du sereur de recherche où les fichiers temporaires doient être stockés. Remarque : Il doit s'agir d'une aleur de chemin d'accès complet. Result Set Path Chemin d'accès sur la machine du sereur de recherche où les résultats de recherche renoyés sont stockés. Remarque : Il doit s'agir d'une aleur de chemin d'accès complet. Paramètres d'authentification Ces paramètres permettent de définir les propriétés d'authentification qui ous permettront de restreindre l'accès au sereur de recherche et donc aux données Tealeaf. Pour plus d'informations sur la configuration de l'authentification, oir «Modification de l'authentification», à la page 113. Pour plus d'informations sur l'authentification ia NT, oir «Authentification NT», à la page 122. Pour plus d'informations sur l'authentification ia le portail, oir «Authentification du portail», à la page 129. Pour plus d'informations sur les interalles d'actualisation des autorisations, oir «Modification de l'interalle de régénération des autorisations», à la page 115. Pour plus d'informations sur la création et la modification des clés de confidentialité du portail, oir «Génération de clés de confidentialité», à la page 118. A l'aide du panneau Authentification, ous pouez modifier les mécanismes d'authentification et les clés de confidentialité qui les sécurisent. Paramètre Description Type Type de méthode d'authentification. Voir «Modification de l'authentification», à la page 113. Domaines Domaines d'authentification utilisés. Cette zone est alimentée par les domaines que ous sélectionnez. Voir «Groupes locaux du domaine», à la page 112. Chapitre 2. Configuration des composants Tealeaf 111

122 112 IBM Tealeaf CX - Guide de configuration Maître d authentification Sereur maître utilisé pour l'authentification. Groupes locaux du domaine Si cette option est actiée, les groupes du domaine local sont utilisés pour l'authentification. Par défaut cette aleur est false. Voir «Groupes locaux du domaine». Interalle de régénération des autorisations Interalle auquel l'autorisation du domaine est érifiée. Voir «Modification de l'interalle de régénération des autorisations», à la page 115. Clés de confidentialité Cliquez sur ce paramètre pour créer, éditer et supprimer les clés de confidentialité utilisées par le filtre de confidentialité dans la PCA et le sereur de recherche. Voir «Génération de clés de confidentialité», à la page 118. Groupes locaux du domaine : Si l'authentification NT est utilisée, le sereur de recherche peut utiliser les groupes locaux du domaine, au lieu des groupes globaux. Les groupes locaux du domaine sont les groupes locaux sur le maître d'authentification. Vous pouez déployer cette option si l'accès au domaine NT et à ses groupes n'est pas possible. Cette méthode ous permet de déployer l'authentification NT sans aoir accès aux groupes du domaine global. Le sereur de recherche peut utiliser les groupes locaux du domaine. Pour plus d'informations de Microsoft sur les groupes locaux du domaine, oir Configuration du maître d'authentification : Sur le maître d'authentification, ous deez effectuer une configuration côté sereur. Par conention, le maître d'authentification est le sereur sur lequel l'application Web du portail est installée. Effectuez les étapes ci-après. 1. Connectez-ous au sereur identifié comme maître d'authentification dans le sereur de recherche. 2. Ourez la console Gestion de l'ordinateur : Démarrer > Outils d administration > Gestion de l ordinateur 3. Sélectionnez les options suiantes dans la console Gestion de l'ordinateur : Gestion de l ordinateur > Outils système > Utilisateurs et groupes locaux > Groupes 4. Cliquez à l'aide du bouton droit de la souris sur Groupes et sélectionnez Noueau groupe. Affectez au groupe un nom significatif. Par exemple : TLusers. 5. Ajoutez des utilisateurs au groupe du domaine. Remarque : Les utilisateurs doient être ajoutés par domaine. Par exemple, les utilisateurs du domaine tealeaf doient être ajoutés sous tealeaf\username. 6. Ajoutez des utilisateurs et des groupes jusqu'à ce que tous les utilisateurs Tealeaf aient été ajoutés au domaine local. Vous deez créer au moins deux groupes ; un pour les utilisateurs et l'autre pour les administrateurs. 7. Dans la configuration du sereur de recherche Tealeaf, cliquez sur Modifier... sous Groupes locaux du domaine. 8. Entrez le nom de la machine locale dans la zone de texte Domaines. N'utilisez pas localhost.

123 9. Cochez la case Groupes locaux du domaine. 10. Vous pouez maintenant ajouter des utilisateurs aux groupes d'utilisateurs et aux groupes d'administrateurs. 11. Cliquez sur Ajouter aux groupes d'utilisateurs La configuration du sereur de recherche répertorie les groupes définis sur la machine locale et non sur le sereur de domaine. Remarque : Les utilisateurs ajoutés aux groupes répertoriés doient faire partie du domaine local. Il ne peut pas s'agir de comptes utilisateur pour la machine locale. 13. Répétez les étapes ci-dessus pour les groupes d'administrateurs. 14. Effectuez le reste de la configuration pour l'authentification NT. Voir «Authentification NT», à la page 122. Modification de l'authentification : Pour modifier l'authentification du sereur de recherche : 1. Pour configurer l'authentification, cliquez sur Modifier... dans la zone Authentification de la boîte de dialogue de configuration Configuration de la recherche principale. 2. Les options de modification suiantes sont disponibles : Figure 13. Options de configuration de la recherche Chapitre 2. Configuration des composants Tealeaf 113

124 114 IBM Tealeaf CX - Guide de configuration La définition du Type d authentification permet de spécifier le type d'authentification à utiliser (par exemple, «Authentification NT», à la page 122 ou «Authentification du portail», à la page 129) ou de désactier l'authentification (Aucune). Groupes d'utilisateurs et d'administrateurs : Vous pouez définir le sereur d'authentification à partir duquel les groupes d'utilisateurs et d'administrateurs utilisés par le sereur de recherche doient être extraits. Paramètre Description Domaine En spécifiant un domaine d'authentification NT, le sereur de recherche localise automatiquement le contrôleur de domaine sur le réseau. Ce menu est alimenté automatiquement. Une fois que ous aez spécifié le domaine, ous pouez ajouter des groupes aux catégories Administrateur ou Utilisateur. Pour ajouter un noueau domaine, sélectionnez Entrez le domaine... dans la liste déroulante. Groupes locaux du domaine Si cette option est actiée, les groupes du domaine local sont utilisés pour l'authentification. Par défaut cette aleur est false. Ajouter aux groupes d utilisateurs Les groupes affectés à la catégorie des utilisateurs ont un accès restreint à IBM Tealeaf CX RealiTea Viewer et au sereur de recherche. Dans la section de segmentation des données, ous pouez spécifier une phrase de recherche associée à l'aide de l'opérateur AND à chaque demande de recherche du sereur de recherche. Les groupes sont répertoriés au format domain\group. Ajouter aux groupes d administrateurs Les groupes affectés à la catégorie des administrateurs ont un accès illimité à IBM Tealeaf CX RealiTea Viewer, ainsi qu'aux commandes et fonctions du sereur de recherche. Les membres administrateurs peuent accéder aux index, configurer des profils IBM Tealeaf CX RealiTea Viewer partagés et effectuer des commandes du sereur de recherche. Supprimer un groupe Permet de supprimer un groupe sélectionné de la liste des utilisateurs ou des administrateurs. Afficher le groupe Répertorie tous les noms d'utilisateur appartenant à un groupe sur le domaine NT. Modifier la clé de confidentialité Permet d'éditer la clé de confidentialité de l'utilisateur sélectionné. Voir «Génération de clés de confidentialité», à la page 118. Filtres de recherche de segmentation des données : Ces filtres restreignent l'accès aux données Tealeaf par groupe d'utilisateurs. La segmentation des données est effectuée en associant à l'aide de l'opérateur AND un éénement spécifique à chaque demande établie ia le sereur de recherche par un membre du groupe d'utilisateurs. Lorsqu'un groupe d'utilisateurs ou d'administrateurs est ajouté à l'aide des commandes Ajouter à, le nom du groupe est affiché dans cette fenêtre aec les éénements qui définissent les sessions auxquelles le groupe peut accéder.

125 Voir «Segmentation des données», à la page 131. Paramètre Description Ajouter des éénements au groupe Indique les éénements qui seront associés à l'aide de l'opérateur AND à la demande de recherche des utilisateurs. Une manière de créer un éénement restreint par les données consiste à déclencher un éénement sur une URL particulière. Par exemple, ous pouez segmenter les données en déclenchant un éénement sur et sur Ces deux éénements peuent être utilisés pour définir deux groupes de segmentation. Supprimer un éénement du groupe Supprime l'éénement sélectionné du groupe. Eénements isibles dans le portail Liste des éénements actuellement configurés qui peut être affichée dans le portail pour les utilisateurs de chaque groupe. Modifier l opérateur du filtre de groupes Si plusieurs éénements sont configurés pour un groupe donné, utilisez cette commande pour associer les éénements à l'aide de l'opérateur AND ou OR. Modifier l opérateur du filtre d éénements Si plusieurs filtres d'éénements sont configurés pour un groupe donné, utilisez cette commande pour associer les filtres à l'aide de l'opérateur AND ou OR. Modification de l'interalle de régénération des autorisations : Ce paramètre contrôle la fréquence à laquelle un sereur de recherche principal, esclae ou d'archiage demande au sereur de domaine la liste des utilisateurs appartenant à l'un des groupes configurés pour l'autorisation NT. Pour modifier l'interalle de régénération, cliquez sur Modifier en regard de l'option Interalle de régénération de l authentification dans la boîte de dialogue Configuration des recherches Tealeaf. Figure 14. Options de l'interalle de régénération de l'authentification Paramètre Description Update eery n minutes Met à jour la régénération de l'autorisation selon l'interalle spécifié. La aleur par défaut est de 5 minutes. Chapitre 2. Configuration des composants Tealeaf 115

126 Ne régénérer à partir du maître qu au démarrage du serice N'effectue une mise à jour qu'au démarrage ou jusqu'à ce que le maître réponde correctement. Effectue une nouelle tentatie toutes les n minutes, comme défini dans le paramètre ci-dessus. Désactier la régénération des autorisations à partir du maître Ne met jamais à jour l'autorisation Configuration de la confidentialité à la demande : Les règles de confidentialité peuent être appliquées aux sessions demandées ia le sereur de recherche par l'application IBM Tealeaf CX RealiTea Viewer ou le sereur de relecture, pour le compte des utilisateurs de la relecture sur naigateur. Ces règles sont appliquées en fonction du groupe auquel l'utilisateur demandeur appartient. Pour plus d'informations sur la configuration de la confidentialité à la demande, oir «Confidentialité à la demande», à la page 136. Paramètres supplémentaires Ces paramètres ous permettent de spécifier l'alias du sereur de recherche et d'autres propriétés. Paramètre Description Alias du sereur de recherche Ce paramètre est utilisé si otre entreprise ne parient pas à accéder au sereur à moins que son nom ne contienne un nom de domaine. Par exemple, le nom du sereur est serer1, mais il n'est isible sur le réseau que sous le nom serer1.mydomain.com. Remarque : Si le réseau de otre entreprise ne reconnaît pas les noms de sereur courts, ous deez entrer dans cette zone le nom de sereur long, faute de quoi les recherches qui utilisent ce sereur de recherche risquent de ne pas renoyer de résultats. Sereur d archiage Ce paramètre indique à un sereur de recherche où se trouent ses archies. Si cette aleur est définie et que ous ous connectez à des index d'ibm Tealeaf CX RealiTea Viewer, il recherche automatiquement les index archiés, au lieu de demander une configuration manuelle. Il n'est pas nécessaire d'ajouter le port à ce paramètre ; IBM Tealeaf CX RealiTea Viewer l'ajoute lorsqu'il recherche des archies. Ce paramètre ne doit être configuré que si ous possédez une licence d'ibm Tealeaf cxverify et que ous aez installé ce dernier. Voir "Guide d'administration de cxverify" dans le document IBM Tealeaf cxverify - Guide d'administration. Port du sereur des archies Port par l'intermédiaire duquel le sereur de recherche communique aec le sereur d'archiage défini plus haut. Cette aleur est insérée dans le fichier.xml du segment, lorsqu'elle est transférée du sereur de traitement ers le sereur d'archiage. Par la suite, les composants Tealeaf qui utilisent ce fichier.xml, tels que RTV, utilisent cette aleur pour déterminer où acquérir les données. Ce paramètre ne doit être configuré que si ous possédez une licence d'ibm Tealeaf cxverify et que ous aez installé ce dernier. Voir "Guide d'administration de cxverify" dans le document IBM Tealeaf cxverify - Guide d'administration. 116 IBM Tealeaf CX - Guide de configuration

127 Maximum number of open LSSN files allowed Cette aleur définit le nombre maximal de fichiers de Canister pouant être ouerts simultanément. La aleur par défaut est 1. Remarque : Ne spécifiez pas une aleur autre que 1 pour ce paramètre sans contacter le serice clients de Tealeaf au préalable. Paramètres du sereur d'éénements Paramètre Description Sereur de portail Sur chaque sereur de traitement, ce paramètre est utilisé par un certain nombre de composants Tealeaf, et notamment RTV, pour contacter le sereur de recherche du portail. Si nécessaire, le paramètre du sereur de portail peut être spécifié sous forme d'adresse IP, de nom d'hôte ou d'alias. Remarque : Que ous spécifiez le sereur de portail aec une adresse IP ou un alias, ous deez utiliser des références cohérentes dans RTV, la page Gestion du portail dans le portail et la configuration du sereur de recherche pour chaque sereur de traitement. Pour plus d'informations sur la configuration du sereur de portail dans la page Gestion du portail, oir "Gestion des sereurs Tealeaf" dans le documentibm Tealeaf cximpact - Guide d'administration. Pour plus d'informations sur la configuration des accès dans RTV, oir "RealiTea Viewer - Onglets Options aancées" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Remarque : Si le sereur de portail et le sereur de rapports sont installés sur des machines distinctes, dans la configuration du sereur de recherche, la zone Sereur de portail doit contenir le nom du sereur de rapports pour tous les Canisters. Sur le sereur de portail et le sereur de rapports, laissez cette zone ide. Sereur d alerte Spécifie le sereur qui héberge le serice d'alerte Tealeaf. Si cette aleur n'est pas spécifiée, l'emplacement du sereur de portail est utilisé. Clés de confidentialité Les clés de confidentialité sont utilisées pour le chiffrement et le déchiffrement par le filtre de confidentialité, qui est disponible dans IBM Tealeaf CX Passie Capture Application et dans le pipeline Windows comme agent de session. Pour plus d'informations sur la confidentialité de l'application PCA, oir "Console Web PCA - Onglet Règles" dans le document IBM Tealeaf Passie Capture Application - Guide. Pour plus d'informations sur la confidentialité du pipeline, oir «Agent de session Confidentialité étendue», à la page 275. Pour plus d'informations sur la création de règles de pipeline, oir «Agent de session Confidentialité», à la page 307. Pour une présentation générale de la manière dont Tealeaf gère la confidentialité, oir chapitre "Gestion de la confidentialité des données dans Tealeaf CX" du Manuel d'installation d'ibm Tealeaf CX. Chapitre 2. Configuration des composants Tealeaf 117

128 Ces clés sont gérées par le sereur de recherche et automatiquement extraites lors de la relecture de la session lorsque le déchiffrement le requiert. Génération de clés de confidentialité : Des clés de confidentialité peuent être générées ia la configuration du sereur de recherche dans TMS. Remarque : Toute clé de chiffrement utilisée par PCA pour chiffrer et par le sereur de recherche pour déchiffrer doit être définie dans la configuration du sereur de recherche et fournie à la PCA. Pour plus d'informations sur la définition de ces clés, oir "Console Web PCA - Onglet Règles" dans le document IBM Tealeaf Passie Capture Application - Guide. 1. Connectez-ous au portail en tant qu'administrateur. 2. Dans le menu Portail, sélectionnez Tealeaf > TMS. 3. Cliquez sur l'onglet WorldView. 4. Pour le sereur de otre choix, accédez au composant Sereur de recherche. 5. Sélectionnez Configuration du sereur de recherche. 6. Cliquez sur Afficher. 7. Dans la boîte de dialogue des informations de configuration, cliquez sur Modifier pour lancer la configuration de la recherche. La boîte de dialogue suiante s'affiche : Figure 15. Configuration de la recherche dans TMS 118 IBM Tealeaf CX - Guide de configuration

129 8. Cliquez sur le premier bouton Modifier de la section Authentification. La boîte de dialogue suiante s'affiche : Figure 16. Configuration de l'authentification illustrant les options d'authentification du portail Remarque : L'authentification NT ou l'authentification du portail doit être actiée pour accéder aux options des clés de confidentialité. 9. Si aucun groupe n'est répertorié sous Groupes d'utilisateurs, ous pouez en ajouter. 10. Une fois qu'un ou plusieurs groupes sont répertoriés, ous pouez affecter des clés de confidentialité. Création de clés de confidentialité : Pour créer/affecter des clés de confidentialité : Remarque : Une seule clé de confidentialité peut être affectée à un groupe donné. Si plusieurs clés de confidentialité sont requises, ous deez créer un groupe pour chaque clé et affecter des utilisateurs aux groupes lorsque cela est nécessaire. Chapitre 2. Configuration des composants Tealeaf 119

130 1. Sélectionnez un groupe dans la zone de liste Groupes d'utilisateurs et cliquez sur Modifier la clé de confidentialité. La boîte de dialogue suiante s'affiche : Figure 17. Configuration des clés de confidentialité 2. Sélectionnez le chiffrement souhaité dans le menu déroulant. Cliquez sur Ajouter une nouelle clé pour créer une clé. 3. Pour affecter la nouelle clé au groupe, sélectionnez-la dans la liste déroulante dans la partie supérieure de la boîte de dialogue. 4. Si ous deez utiliser un ID clé et une aleur de clé dans le fichier de configuration de l'agent de session Confidentialité, copiez-les maintenant à partir de la boîte de dialogue Clé de confidentialité. Vous pouez utiliser les raccourcis claier Windows standard pour copier les aleurs des zones, puis les coller dans Priacy.cfg. Par exemple, l'id clé et la aleur ci-dessus doient être collés dans la section [Keys] au format suiant : Key00001=<aleur_clé>. 5. Une fois que ous aez terminé aec la boîte de dialogue Clé de confidentialité, cliquez sur OK. Pour le groupe d'utilisateurs, ous deez maintenant oir Oui dans la colonne Clé de confidentialité affectée? 6. Répétez cette procédure pour tous les groupes pour lesquels les données sont chiffrées. 7. Une fois que ous aez fini d'affecter des clés de confidentialité à des groupes, cliquez sur OK pour alider les modifications. Ajout ou suppression de clés de confidentialité (indépendantes des paramètres d'authentification) : Pour créer ou supprimer des clés de confidentialité, cliquez sur Modifier en regard du paramètre Clés de confidentialité dans la boîte de dialogue Configuration des 120 IBM Tealeaf CX - Guide de configuration

131 recherches Tealeaf. Figure 18. Boîte de dialogue Clés de confidentialité La liste des clés de confidentialité disponibles est affichée dans la boîte de dialogue Clés de confidentialité. Vous pouez créer des clés de confidentialité dans cette boîte de dialogue sans aoir à configurer des groupes dans la boîte de dialogue Authentification au préalable. Pour créer une clé de confidentialité, sélectionnez le chiffrement à utiliser dans la liste déroulante. Ensuite, cliquez sur Ajouter une clé. Une clé de confidentialité est générée et affichée. Pour supprimer une clé de confidentialité créée, sélectionnez la clé et cliquez sur Supprimer une clé. La clé est supprimée. Pour créer manuellement une clé de confidentialité, cliquez sur Entrer la clé. Figure 19. Saisie de clés de confidentialité Pour créer manuellement une clé de confidentialité : 1. Dans le menu déroulant Chiffrer, sélectionnez la méthode de chiffrement à utiliser pour la clé. Chapitre 2. Configuration des composants Tealeaf 121

132 2. Entrez un identificateur de clé de confidentialité unique dans l'espace fourni. 3. Entrez la aleur de la clé de confidentialité. Pour générer un ID unique, cliquez sur Générer une nouelle aleur de clé. 4. Pour sauegarder la clé de confidentialité entrée, cliquez sur OK. Remarque : Lors de la création manuelle d'une clé de confidentialité, il est important d'utiliser une aleur alide pour cette clé. Cette aleur est une aleur de clé chiffrée et codée, aec les informations sur la clé et le nom de la clé. A moins que ous ne copiez une aleur de clé existante à partir d'une source externe, ous deez utiliser Générer une nouelle aleur de clé pour créer une aleur de clé alide. Si ous modifiez le nom de la clé après aoir généré la aleur de clé, ous deez générer une nouelle aleur de clé car le nom y est stocké. Authentification L'authentification du sereur de recherche permet de définir une liste des utilisateurs disposant de droits d'administration ou de priilèges utilisateur généraux pour effectuer des opérations telles que la recherche dans les données de session, l'extraction de données de session, l'édition d'éénements ou la modification de paramètres système. Si l'authentification est configurée pour le sereur de recherche, les demandes des isiteurs présentent automatiquement le domaine et le nom d'utilisateur Windows du compte actuellement connecté. Les informations de connexion sont érifiées pour déterminer les points suiants : L'utilisateur existe-t-il sur le domaine spécifié? L'utilisateur appartient-il réellement au groupe spécifié et dispose-t-il d'un accès restreint basé sur ce groupe? Ce groupe définit les types de tâches que l'utilisateur peut effectuer dans le client. Par exemple, un utilisateur membre du groupe de l'utilisateur Tealeaf peut effectuer des recherches dans des éénements, mais il ne peut pas configurer des éénements. Si l'utilisateur n'appartient à aucun des groupes, l'accès est complètement refusé. Authentification NT IBM Tealeaf CX peut utiliser les informations du domaine NT pour authentifier les utilisateurs et restreindre l'accès à des fonctionnalités spécifiques en fonction de l'identité de l'utilisateur. Les deux composants d'ibm Tealeaf CX qui peuent être configurés pour utiliser l'authentification NT sont le portail et le serice Sereur de recherche. Remarque : Les noms de connexion des utilisateurs Actie Directory ne doient pas inclure de caractères accentués. Remarque : Il est fortement recommandé que ces deux composants soient configurés pour utiliser l'authentification NT ensemble. Si l'authentification NT du sereur de recherche est actiée, la fonction d'authentification NT du portail doit également être actiée faute de quoi les utilisateurs du portail ne pourront pas rechercher des données de session ou en extraire. L'authentification NT s'appuie sur l'interrogation d'un contrôleur de domaine Windows NT pour déterminer l'existence d'utilisateurs et leur appartenance aux groupes d'utilisateurs NT. 122 IBM Tealeaf CX - Guide de configuration

133 Remarque : Il est recommandé de créer spécifiquement deux groupes NT sur le contrôleur de domaine à utiliser comme groupe des utilisateurs Tealeaf et groupe des administrateurs Tealeaf, bien qu'il soit possible d'utiliser des groupes NT existants à ces fins. Pour plus d'informations de référence, oir "Authentification" dans le document IBM Tealeaf cximpact - Guide d'administration. Pour plus d'informations sur la configuration de l'authentification NT pour le sereur de recherche, oir «Configuration de l'authentification NT pour le sereur de recherche», à la page 124. Pour plus d'informations sur la configuration de l'authentification NT pour le portail, oir «Configuration de l'authentification NT pour le portail», à la page 125. Configuration d'actie Directory : Pour que Tealeaf puisse utiliser l'authentification NT, érifiez et effectuez les étapes de configuration ci-après dans Actie Directory. 1. Dans Actie Directory, créez deux groupes de sécurité globale ; un pour les utilisateurs et un pour les administrateurs. Par exemple : a. TLuser : groupe d'utilisateurs b. TLadmin : groupe d'administrateurs 2. Affectez les utilisateurs Tealeaf à ces groupes. 3. Les administrateurs Tealeaf doient être autorisés à créer des éénements dans Tealeaf. L'accès est octroyé en autorisant l'accès à Tealeaf Eent Manager ia le menu Portail. Voir "Administration des utilisateurs CX" dans le manuel IBM Tealeaf cximpact - Guide d'administration. Le sereur de recherche peut être configuré pour utiliser une méthode basée sur les éénements Tealeaf pour la segmentation des données. Voir Configuration du sereur de recherche. 4. Vérifiez que le sereur de portail Tealeaf dispose des droits requis pour rechercher des informations sur les groupes dans Actie Directory. Pour plus d'informations, reportez-ous à otre documentation Actie Directory. 5. Un compte de serice doit être créé ou utilisé pour exécuter le serice du sereur de recherche. Vous deez créer un compte dans Actie Directory si le compte de l'ordinateur local ne dispose pas de ces droits ou que plusieurs domaines sont impliqués. 6. Testez les comptes des deux groupes d'utilisateurs en ous connectant au portail Tealeaf et en exécutant une recherche. Authentification NT du sereur de recherche : L'authentification du sereur de recherche permet de définir une liste des utilisateurs disposant de droits d'administration ou de priilèges généraux pour effectuer des opérations telles que la recherche et l'extraction de données de session, l'édition d'éénements ou la modification de profils de paramètres IBM Tealeaf CX RealiTea Viewer partagés. Lorsqu'ils sont configurés, les clients du sereur de recherche authentifient l'utilisateur actuellement connecté aant de lui autoriser l'accès aux fonctions du sereur de recherche. Les informations de connexion sont érifiées pour déterminer si l'utilisateur appartient au groupe NT spécifié et restreindre l'accès en fonction du groupe applicable. Par exemple, un utilisateur uniquement membre du groupe des utilisateurs du sereur de recherche peut rechercher des éénements, mais il ne peut pas en configurer. Chapitre 2. Configuration des composants Tealeaf 123

134 Si l'utilisateur n'appartient à aucun des groupes définis dans les paramètre d'authentification du sereur de recherche, l'accès est refusé à cet utilisateur. Dans le cas d'ibm Tealeaf CX RealiTea Viewer, un utilisateur refusé ne peut pas rechercher des sessions ou éditer des éénements. Dans le cas du portail, un utilisateur refusé ne peut pas effectuer de recherches. Configuration de l'authentification NT pour le sereur de recherche : Procédez comme suit pour configurer RTV : 1. Vérifiez que les groupes d'administrateurs et d'utilisateurs à utiliser pour le sereur de recherche existent sur le contrôleur de domaine NT que ous utilisez pour l'authentification. 2. Editez la configuration du sereur de recherche à l'aide de TMS dans le portail. Pour cela, sélectionnez TMS dans le menu Tealeaf. Assurez-ous que l'onglet WorldView est sélectionné. Parcourez le composant Sereur de recherche du sereur de otre choix, sélectionnez "Configuration du sereur de recherche", puis cliquez sur le bouton Afficher. Cliquez ensuite sur Modifier dans la boîte de dialogue Informations de configuration pour éditer la configuration. 3. Dans la zone d'authentification de la fenêtre Configuration de la recherche, cliquez sur Modifier Dans la boîte de dialogue Authentification, effectuez les opérations suiantes : a. Pour Type d'authentification, sélectionnez le bouton d'option Authentification NT. b. Sélectionnez le domaine NT à utiliser dans le menu déroulant Domaines. Pour entrer un autre domaine, sélectionnez Entrez le domaine. Dans la boîte de dialogue, entrez l'identificateur de domaine. Remarque : Pour spécifier un domaine enfant, ous deez essayer les deux formes suiantes : child.domain.com child c. Cliquez sur Ajouter aux groupes d'utilisateurs... Les utilisateurs membres des groupes de la liste des groupes d'utilisateurs peuent utiliser les fonctions du sereur de recherche, telles que la recherche, l'extraction d'informations sur les sessions et l'extraction de sessions. Les utilisateurs qui n'appartiennent qu'à ce groupe ne peuent pas configurer d'éénements de Canister. 1) La boîte de dialogue Ajouter un groupe résultante répertorie les groupes définis sur le contrôleur de domaine du domaine choisi. 2) Choisissez un groupe dans la liste et cliquez sur Afficher le groupe... Une liste des membres de ce groupe est affichée. 3) Cliquez sur OK pour ajouter le groupe à la liste des groupes d'utilisateurs du sereur de recherche. Répétez cette étape si nécessaire. d. Cliquez sur Ajouter aux groupes d'administrateurs... Seuls les utilisateurs appartenant à ce groupe peuent configurer des éénements de Canister et télécharger les profils d'afficheur partagés. 1) La boîte de dialogue Ajouter un groupe résultante répertorie les groupes définis sur le contrôleur de domaine du domaine choisi. 2) Choisissez un groupe dans la liste et cliquez sur Afficher le groupe... Une liste des membres du groupe est affichée. 124 IBM Tealeaf CX - Guide de configuration

135 3) Cliquez sur OK pour ajouter le groupe à la liste des groupes d'utilisateurs du sereur de recherche. Répétez cette étape si nécessaire. e. Cliquez sur OK pour fermer la boîte de dialogue Authentification. 5. Entrez une description pour la modification de configuration dans la zone Description de ersion, dans la partir inférieure de la fenêtre, puis cliquez sur Sauegarder pour sauegarder les modifications. 6. Lorsque ous êtes inité à ajouter des tâches permettant d'enoyer la nouelle ersion, cliquez sur le bouton Oui. Répondez également Oui lorsque le système ous demande si ous souhaitez ajouter des tâches de redémarrage. 7. Entrez une description dans la sous-fenêtre Tâche planifiée actuelle, puis cliquez sur le bouton Soumettre pour soumettre le traail permettant d'enoyer la configuration modifiée et de redémarrer le sereur de recherche. 8. Testez l'authentification en ourant IBM Tealeaf CX RealiTea Viewer et en effectuant une recherche. a. Si ous n'êtes pas membre de l'un des groupes d'utilisateurs du sereur de recherche, ous n'aez pas accès à la recherche. Remarque : Si l'authentification NT du sereur de recherche est actiée et que le serice du sereur de recherche est exécuté par un utilisateur non enregistré sur le domaine NT spécifié dans SearchConfig (par exemple, un membre de l'un des groupes d'utilisateurs locaux de la machine), le serice ne parient pas à démarrer (il peut renoyer le code d'erreur 110). Il est possible d'exécuter le serice Sereur de recherche sous le compte Système local. Configuration de l'authentification NT pour le portail : Procédez comme suit pour configurer RTV : Pour actier cette fonction, ous deez actier l'authentification NT pour la base de données des rapports et modifier les paramètres IIS du répertoire irtuel du portail. Voir «Chapitre sur la configuration du sereur de rapports», à la page 61. Pour utiliser l'authentification NT dans le portail, la machine sur laquelle le portail est exécuté doit être membre d'un domaine NT. Elle doit se trouer dans le domaine du contrôleur de domaine NT ou une relation d'accréditation doit être établie entre le domaine du contrôleur de domaine et celui du sereur de portail. Remarque : Par défaut, le portail crée un compte "interne" pour chaque utilisateur NT alide dans les groupes alides. Voir «Création d'utilisateurs du portail sous l'authentification NT», à la page 126. Actiation de l'authentification NT du portail : 1. Connectez-ous au portail Tealeaf en tant qu'administrateur. 2. Dans le menu, sélectionnez Tealeaf > TMS. Voir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. 3. Ourez le noeud Sereur de recherche. 4. Cliquez sur Configuration du sereur de recherche. 5. Dans le panneau Actions de configuration, cliquez sur Afficher/Modifier. 6. La configuration du sereur de recherche s'affiche. 7. Sous Groupes locaux du domaine, cliquez sur Modifier Dans la boîte de dialogue Authentification, sélectionnez Authentification NT dans la section Type d'authentification. Chapitre 2. Configuration des composants Tealeaf 125

136 9. Pour plus d'informations sur la configuration de l'authentification NT, oir «Modification de l'authentification», à la page 113. Désactiation de l'authentification NT du portail : Pour désactier les accès anonymes dans les paramètres de répertoire irtuel IIS : 1. Ourez le gestionnaire de serices Internet à partir du menu Démarrer de Windows : Démarrer > Panneau de configuration > Outils d'administration > IIS Manager 2. Déeloppez le noeud de la machine et cliquez à l'aide du bouton droit de la souris sur le répertoire irtuel du portail, sous le site Web où il a été installé (généralement le site Web par défaut). Sélectionnez Propriétés. 3. Cliquez sur l'onglet Sécurité du répertoire, puis sur Modifier, sous Authentification et contrôle d'accès. 4. Désélectionnez la case Actier la connexion anonyme et cochez la case Authentification Windows intégrée. 5. Fermer la boîte de dialogue. 6. Pour redémarrer le serice d'administration des serices Internet, cliquez sur le noeud de l'ordinateur à l'aide du bouton droit de la souris dans le gestionnaire de serices Internet et sélectionnez Redémarrer les serices Internet... dans le menu. Toute connexion anonyme au portail est interdite. Les utilisateurs doient être connectés au domaine NT et utiliser Internet Explorer pour se connecter au portail, afin d'être reconnus. Création d'utilisateurs du portail sous l'authentification NT : En fonction de os paramètres de configuration, le portail peut créer automatiquement des comptes d'utilisateur du portail pour les utilisateurs NT lorsqu'ils isitent la page d'accueil du portail pour la première fois. Vous pouez également créer ces comptes en les mappant manuellement. Voir «Mappage manuel d'utilisateurs du portail à des utilisateurs NT», à la page 128. Création automatisée d'utilisateur du portail sous l'authentification NT : Si ous le souhaitez, ous pouez configurer le portail pour qu'il crée automatiquement des comptes d'utilisateur du portail pour les utilisateurs NT qui accèdent à la page de connexion du portail. Vous pouez affecter le compte Portail à un produit (IBM Tealeaf cximpact, IBM Tealeaf cxview ou IBM Tealeaf cxreeal) et à des groupes dans ce produit. Les autres affectations de produit doient être effectuées une fois que l'utilisateur a été créé. Remarque : Si ous souhaitez créer automatiquement des utilisateurs pour plusieurs produits, ous pouez demander aux utilisateurs IBM Tealeaf cximpact de se connecter le lundi et aux utilisateurs IBM Tealeaf cxview de se connecter le mercredi et effectuer les modifications de configuration nécessaires entre ces deux jours. 1. Une fois que ous aez actié l'authentification NT à l'aide du sereur de recherche, ous deez configurer certains paramètres dans chacun des groupes de paramètres du produit. Pour plus d'informations sur la configuration du sereur de recherche, oir «Actiation de l'authentification NT du portail», à la page Dans le menu du portail, sélectionnez Tealeaf > Gestion du portail. 3. Paramètres généraux de création d'utilisateur : a. Cliquez sur IBM Tealeaf CX Paramètres > Utilisateurs. 126 IBM Tealeaf CX - Guide de configuration

137 b. Affectez aux paramètres ci-après les aleurs répertoriées. Pour une description de ces paramètres, oir "Paramètres CX" dans le document IBM Tealeaf cximpact - Guide d'administration. Paramètre Valeur Connexion automatique des utilisateurs NT Actié Création automatique d un utilisateur Actié Inite des options de la création automatique d un utilisateur facultatie Type de création automatique d utilisateur Spécifiez le produit auquel ous souhaitez affecter les utilisateurs initialement. Les utilisateurs du portail sont des utilisateurs IBM Tealeaf cximpact. Remarque : Pour le produit auquel ous affecté les utilisateurs nouellement créés, ous deez actier Création automatique d un utilisateur. c. Sécurité des mots de passe : les paramètres ci-après concernent la longueur, la sécurité et la durée des mots de passe. Si ous ne l'aez pas déjà fait, consultez otre personnel informatique pour déterminer les exigences. Longueur minimale du mot de passe Précédent historique des mots de passe (décompte) Précédent historique des mots de passe (jours) Requérir des mots de passe fiables Les utilisateurs nouellement créés doient créer un mot de passe qui satisfait ces instructions. Pour une description de ces paramètres, oir "Paramètres CX" dans le document IBM Tealeaf cximpact - Guide d'administration. d. Cliquez sur Sauegarder. 4. Paramètres utilisateur IBM Tealeaf cximpact : si ous aez choisi Portail pour Type de création automatique d utilisateur, effectuez la configuration ci-après pour les utilisateurs créés automatiquement par le portail. a. Dans le même jeu de paramètres, configurez les paramètres ci-après en fonction de os besoins. Pour une description de ces paramètres, oir "Paramètres CX" dans le document IBM Tealeaf cximpact - Guide d'administration. Groupe par défaut du nouel utilisateur Page par défaut du nouel utilisateur Fuseau horaire par défaut du nouel utilisateur Langue par défaut du noueau groupe d utilisateurs b. Cliquez sur Sauegarder. 5. Paramètres utilisateur IBM Tealeaf cxreeal : si ous aez choisi cxreeal pour Type de création automatique d utilisateur, effectuez la configuration ci-après pour les utilisateurs créés automatiquement par le portail. a. Dans la page Gestion du portail, cliquez sur IBM Tealeaf cxreeal > Utilisateurs. Chapitre 2. Configuration des composants Tealeaf 127

138 b. Configurez les paramètres ci-après en fonction de os besoins. Pour une description de ces paramètres, oir "Paramètres cxreeal" dans le document IBM Tealeaf cxreeal - Guide d'administration. Création automatique d un utilisateur doit être actié. Page par défaut du nouel utilisateur Fuseau horaire par défaut du nouel utilisateur Groupe par défaut de l utilisateur c. Vous deez également érifier les paramètres relatifs aux mots de passe. d. Cliquez sur Sauegarder. 6. Paramètres utilisateur IBM Tealeaf cxview : si ous aez choisi Portail pour Type de création automatique d utilisateur, effectuez la configuration ci-après pour les utilisateurs créés automatiquement par le portail. a. Dans la page Gestion du portail, cliquez sur IBM Tealeaf cxview > Utilisateurs. b. Configurez les paramètres ci-après en fonction de os besoins. Pour une description de ces paramètres, oir "Paramètres cxview" dans le document IBM Tealeaf cximpact - Guide d'administration. Création automatique d un utilisateur doit être actié. Inite des options de la création automatique d un utilisateur Page par défaut du nouel utilisateur Fuseau horaire par défaut du nouel utilisateur Groupe par défaut de l utilisateur c. Vous deez également érifier les paramètres relatifs aux mots de passe. d. Cliquez sur Sauegarder. Mappage manuel d'utilisateurs du portail à des utilisateurs NT : Pour mapper un utilisateur du portail à un utilisateur NT : 1. Connectez-ous à l'application Web du portail en tant qu'administrateur du portail. 2. Cliquez sur Tealeaf > Gestion du portail. 3. Cliquez sur le lien d'administration des utilisateurs correspondant au type d'utilisateur que ous souhaitez créer : IBM Tealeaf cximpact : Administration des utilisateurs CX IBM Tealeaf cxview : Administration des utilisateurs cxview IBM Tealeaf cxreeal : Administration des utilisateurs cxreeal 4. Cliquez sur Utilisateurs. Cliquez sur Noueau dans la barre d'outils. 5. Entrez le nom d'utilisateur du portail si ous créez un utilisateur. Entrez le domaine NT et le nom d'utilisateur NT (exactement tel qu'il a été saisi par l'utilisateur lors de la consignation dans le domaine NT) auquel cet utilisateur du portail est mappé. 6. Spécifiez les autres propriétés utilisateur. Remarque : Il n'est possible d'associer qu'un seul compte utilisateur du portail à chaque combinaison de domaine/utilisateur NT. 7. Cliquez sur Sauegarder. 8. Lorsque l'utilisateur dont ous enez de modifier le compte demande la page de connexion au portail, son nom d'utilisateur NT est enoyé à la page de connexion et l'utilisateur peut accéder au portail en cliquant sur Connexion. 128 IBM Tealeaf CX - Guide de configuration

139 Voir "Administration des utilisateurs CX" dans le document IBM Tealeaf cximpact - Guide d'administration. Voir "Administration des utilisateurs cxview" dans le document IBM Tealeaf cximpact - Guide d'administration. Voir "Administration des utilisateurs cxreeal" dans le document IBM Tealeaf cxreeal - Guide d'administration. HTTPS/SSL et authentification NT : Si ous utilisez l'authentification NT et actiez HTTPS/SSL sur le portail (dans les paramètres d'iis), ous risquez de ne pas oir la page de connexion authentifiée par NT attendue pour le portail tant que la machine du portail n'a pas été ajoutée à la zone intranet sécurisée d'internet Explorer. Remarque : Si ous rencontrez l'erreur de portail The Tealeaf ASP Utility Object (TLAspUtil) could not be loaded et que ous aez été récemment ajouté au groupe Actie Directory des utilisateurs Tealeaf, effectuez la procédure ci-après. 1. Accédez à Démarrer > Exécuter. 2. Entrez cmd dans la zone Ourir. 3. Entrez la commande suiante : gpudate /force 4. Réinitialisez la machine de l'utilisateur (il est important de la réinitialiser et non pas seulement de se déconnecter.). Authentification du portail Le sereur de recherche peut être configuré pour authentifier les accès des utilisateurs ia les mécanismes d'authentification du portail Tealeaf. La configuration de l'authentification du portail est similaire à celle de l'authentification NT pour le sereur de recherche, à quelques différences : Remarque : L'authentification du portail extrait les informations sur les utilisateurs et les groupes des tables de base de données du portail. Vous ne pouez pas modifier les utilisateurs et les groupes ia la configuration du sereur de recherche. Pour plus d'informations sur la modification d'utilisateurs et de groupes du portail, oir "Guide d'administration de cximpact" dans le document IBM Tealeaf cximpact - Guide d'administration. Remarque : L'authentification du portail ne peut être actiée que sur un sereur qui contient la base de données des utilisateurs du portail. Tous les autres sereurs qui hébergent le sereur de recherche doient pointer ers le sereur d'authentification du portail, qui leur sert de maître d'authentification. Par défaut, le sereur de recherche suppose que les groupes d'utilisateurs du portail suiant disposent de droits d'administration : groupe Admin administrateur d éénements Pour plus d'informations de référence, oir "Authentification" dans le document IBM Tealeaf cximpact - Guide d'administration. Chapitre 2. Configuration des composants Tealeaf 129

140 Figure 20. Configuration de l'authentification du portail Pour afficher les membres d'un groupe d'utilisateurs ou d'administrateurs, sélectionnez le groupe et cliquez sur Afficher le groupe. Pour plus d'informations sur les boutons disponibles, oir «Modification de l'authentification», à la page 113. Comme pour l'authentification NT, l'authentification du portail prend en charge l'utilisation de clés de confidentialité et la segmentation des données. Voir «Génération de clés de confidentialité», à la page 118. Voir «Filtres de recherche de segmentation des données», à la page 114. Configuration d'esclaes d'authentification Remarque : Si ous aez configuré l'authentification NT ou l'authentification du portail, les configurations de sereur de recherche de tous les sereurs esclaes d'authentification doient pointer ers le maître d'authentification. Vérifiez le paramètre Maître d authentification sur chaque sereur esclae d'authentification. Débogage de l'authentification du sereur de recherche Pour l'autorisation, le sereur de recherche utilise l'id utilisateur qui a exécuté la commande de maintenance des éénements pour lire et mettre à jour les sereurs 130 IBM Tealeaf CX - Guide de configuration

141 de recherche esclae. Si un sereur de recherche esclae rejette ces commandes, nous pouons en conclure que les sereurs esclae sont exécutés aec une configuration d'autorisation différente. L'examen des journaux du sereur de recherche permet généralement d'identifier le problème. Lorsque le sereur de recherche redémarre aec l'autorisation actiée, la liste des utilisateurs définies auxquels il a accès est insérée dans le journal. Le sereur de recherche est généralement redémarré à 1h00. Lors du redémarrage, le journal du sereur de recherche répertorie également les paramètres de fonctionnement, qui indiquent le mode d'autorisation et les autres paramètres de fonctionnement. Si ous saez à quelle heure la sauegarde des éénements a échoué, ous pouez examiner le journal du sereur esclae à cette heure pour la commande /NTYP sur le sereur de recherche pour identifier le nom d'utilisateur qu'elle utilise, puis comparer cet ID à la liste des utilisateurs du dernier redémarrage. Segmentation des données La segmentation des données restreint les données de recherche renoyées pour un utilisateur donné en fonction du groupe d'authentification à l'aide des éénements Tealeaf que ous créez. Les éénements configurés pour la segmentation des données permettent de filtrer les sessions opérationnelles de sorte que les sessions acties qui apparaissent dans le portail ne soit isibles que par les utilisateurs qui y ont accès. En outre, ous pouez indiquer quels éénements sont isibles par les membres des groupes spécifiés ; les utilisateurs ne peuent pas oir les sessions des autres groupes et les éénements actifs qui apparaissent dans le portail appartenant aux sessions des autres groupes sont également masqués. Remarque : Pour utiliser la segmentation des données, otre système Tealeaf doit être configuré pour utiliser l'authentification du portail ou l'authentification NT et les groupes d'authentification. Pour toute recherche soumise, le terme est associé à l'aide de l'opérateur AND à un terme de restriction défini pour le groupe d'authentification de l'utilisateur. Le deuxième terme de recherche ajouté au terme de recherche de l'utilisateur est un éénement configuré pour être déclenché sur un type de session spécifique. Exemple de segmentation des données 1 : Supposons par exemple que otre entreprise prenne en charge deux sites Web, et Des groupes de centre de support distincts sureillent chaque site Web et aucun de ces groupes n'est supposé oir les données de session des autres sites. Pour actier la segmentation des données, deux éénements distincts doient être définis. Un éénement est déclenché lorsque la demande ou la réponse appartient à tandis que l'autre répond aux données Le premier éénement reçoit l'identificateur unique 17 et le second, l'id unique 18. Pour actier la segmentation des données de ces deux sites Web : L'authentification est actiée à l'aide de la configuration du sereur de recherche. Deux groupes d'utilisateurs sont créés : Example1group et Example2group. Les utilisateurs appropriés sont ajoutés à chaque groupe. A l'aide de la configuration du sereur de recherche : Chapitre 2. Configuration des composants Tealeaf 131

142 1. Example1group est configuré pour utiliser la chaîne de filtrage suiante : (canisterappeent/uniqueid contains 17) 2. Example2group est configuré pour utiliser la chaîne de filtrage suiante : (canisterappeent/uniqueid contains 18) Lorsque des membres du groupe Example1group effectuent des recherches, ils ne peuent pas oir les sessions de Lorsque des membres du groupe Example2group effectuent des recherches, ils ne peuent pas oir les sessions de Chaque groupe ajouté à la Configuration de recherche peut être associé à plusieurs éénements. Ces éénements peuent être combinés à l'aide des opérateurs booléens AND ou OR. Pour les utilisateurs appartenant à plusieurs groupes, les filtres indiiduels sont associés à l'aide de l'opérateur OR aant d'être joints à la recherche demandée. Pour l'exemple ci-dessus, le filtre suiant est appliqué à chaque terme à rechercher exécuté par un membre des deux groupes : ((canisterappeent/uniqueid contains 18) or (canisterappeent/uniqueid contains 17)) Exemple de segmentation des données 2 : Autre exemple : supposons que ous ayez configuré les trois groupes suiants aec des éénements dans Configuration de la recherche : Groupe Eénements TeaLeaf\users eent 1 TeaLeaf\eng (Eléments reliés par un opérateur AND) eent 2 eent 3 TeaLeaf\qa (Eléments reliés par un opérateur OR) eent 4 eent 5 eent 6 Un utilisateur membre de TeaLeaf\users qui recherche le mot session génère la requête de recherche suiante : (canisterappeent contains 1) and (session) Un utilisateur membre de TeaLeaf\eng qui recherche le mot session génère la requête de recherche suiante : (canisterappeent contains (2 and 3)) and (session) Un utilisateur membre de TeaLeaf\eng et TeaLeaf\qa qui recherche le mot session génère la requête de recherche suiante : (canisterappeent contains (2 and 3) or (4 or 5 or 6)) and (session) Prérequis de la segmentation des données : Aant de commencer à configurer la segmentation des données basées par éénement, érifiez que les conditions suiantes sont remplies : Les utilisateurs doient être ajoutés aux groupes appropriés. L'authentification du portail ou l'authentification NT doit être actiée sur toutes les machines sur lesquelles le sereur de recherche est exécuté. 132 IBM Tealeaf CX - Guide de configuration

143 Un groupe d'administrateurs doit aoir été affecté pour pouoir configurer l'authentification. Vous deez pointer chaque sereur ers le sereur maître d'authentification pour affecter les mêmes groupes à chaque sereur de l'enironnement. La présence de groupes différents sur des sereurs différents peut générer des résultats ariables. Le portail doit également être configuré pour l'authentification NT. Une segmentation des données correcte dépend d'un éénement correctement configuré. Vous deez affecter la aleur appropriée au sereur de Canister sous «Paramètres supplémentaires», à la page 116, si toutes les conditions suiantes sont remplies dans l'enironnement Tealeaf : Segmentation des données aec authentification NT ou portail Le sereur de portail est le maître d'authentification Configuration de la segmentation des données : La segmentation des données fonctionne conjointement aec les autres composants du système IBM Tealeaf CX. Par exemple, ous deez également configurer les profils dans IBM Tealeaf CX RealiTea Viewer pour actier intégralement toutes les fonctions de sécurité de ces programmes client. 1. Configuration des éénements qui effectueront la segmentation des données : Pour configurer correctement la segmentation des données, ous deez créer des définitions d'éénement qui diise efficacement les données en compartiments à isoler des autres groupes. Supposons que otre société possède deux sous-diisions en concurrence, telles que et et que ous ne souhaitiez pas que chacune puisse oir les données de l'autre. Vous pouez configurer une segmentation des données par éénement à l'aide des éénements de nom d'hôte pour segmenter les données. 1. Ourez le gestionnaire d'éénements Tealeaf. Dans le menu du portail, sélectionnez Configurer > Gestionnaire d'éénements. Voir la rubrique "Gestionnaire d'éénements Tealeaf" dans le manuel du Gestionnaire d'éénements Tealeaf d'ibm. 2. Cliquez sur l'onglet Attributs de hit. Voir la section sur la balise des attributs de hit TEM dans le document IBM Tealeaf - Guide du gestionnaire d'éénements. 3. Créez un attribut de hit. a. Entrez le nom d'hôte dans la zone Balise de début. Par exemple : b. Ne spécifiez pas de balise de fin. Cette configuration signifie que l'attribut de hit recherche la balise de début explicite. c. Définissez les autres propriétés si ous le souhaitez. Remarque : Lorsque ous configurez otre éénement de segmentation des données, éitez d'utiliser un opérateur NOT. Le moteur de recherche sous-jacent doit extraire toutes les aleurs possibles de l'éénement, puis appliquer l'opérateur NOT pour générer les résultats appropriés, ce qui peut aoir un impact considérable sur les performances globales du portail. 4. Créez un éénement. Voir "Onglet des éénements TEM" dans le document IBM Tealeaf Eent Manager Manual. a. Affectez à l'option Ealuer la aleur Premier hit de la session. b. Pour la aleur Suire, sélectionnez Premier par session. c. Pour le type de aleur, sélectionnez Texte. Chapitre 2. Configuration des composants Tealeaf 133

144 d. Définissez Recherchable & Signalable sur true. e. Cliquez sur l'étape Condition. Pour la condition de l'éénement, sélectionnez l'attribut de hit que ous enez de créer. f. Cliquez sur l'étape Valeur. Cliquez sur Sélectionnez un article à enregistrer... Sélectionnez l'attribut de hit que ous aez créé. g. Ne configurez pas d'autres attributs. h. Cliquez sur Enregistrer le brouillon. 5. Validez les modifications des deux noueaux objets. Une fois que les modifications ont été alidées, les sessions de l'un ou l'autre des sites Web peuent être segmentées en fonction des éénements du nom d'hôte. 2. Actiation de l'authentification : 1. Connectez-ous au portail Tealeaf. 2. Dans le menu Portail, sélectionnez Tealeaf > TMS. 3. Dans la ue Sereurs, ourez le noeud Sereur de recherche. 4. Cliquez sur Configuration du sereur de recherche. Cliquez ensuite sur Afficher/Modifier. 5. La fenêtre de configuration du sereur de recherche s'oure. 6. Dans la zone Authentification, cliquez sur Modifier. 7. La boîte de dialogue Authentification permet de contrôler les groupes ayant un accès utilisateur ou administrateur au sereur de recherche et donc au Canister. 8. Pour actier l'authentification NT, cliquez sur le bouton Authentification NT. Les options supplémentaires sont affichées. 9. Dans la liste déroulante Domaine, sélectionnez le nom de domaine de otre réseau. Le sereur de recherche déduit automatiquement le contrôleur de domaine sur lequel se trouent les groupes à partir du nom de domaine. 10. Pour ajouter les groupes d'utilisateurs à la liste, cliquez sur Ajouter aux groupes d'utilisateurs. Remarque : Les groupes d'utilisateurs ne peuent afficher que les données spécifiées par le groupe des administrateurs et ne peuent pas utiliser l'interface du sereur de recherche pour interagir aec le sereur IBM Tealeaf CX. 11. La boîte de dialogue Ajouter un groupe affiche tous les groupes disponibles sur le réseau. Pour afficher tous les utilisateurs appartenant à un groupe particulier, cliquez sur Afficher le groupe. Sélectionnez un groupe et cliquez sur Ajouter. 12. Pour ajouter les groupes d'administrateurs, cliquez sur Ajouter aux groupes d'administrateurs. Remarque : Les groupes disposant d'un accès administrateur peuent éditer les définitions d'éénement et afficher toutes les données sur le système IBM Tealeaf CX. 13. Configurez l'authentification. Remarque : Vous deez sélectionner au moins un groupe d'administrateurs à l'aide de l'authentification. Voir "Authentification" dans le document IBM Tealeaf cximpact - Guide d'administration. 134 IBM Tealeaf CX - Guide de configuration

145 14. Ajoutez les groupes d'utilisateurs et les groupes d'administrateurs. Vous deez affecter un groupe d'administrateurs pour administrer les définitions d'éénement et effectuer d'autres tâches d'administration, telles que la configuration de profils dans RTV. 3. Ajout d'éénements aux groupes d'authentification : Pour terminer la configuration de la segmentation des données, ous deez ajouter les éénements aux groupes d'authentification. Cette étape filtre les données en fonction du groupe qui les examine. Le Canister à court terme et l'archie à long terme sont filtrés. Par exemple, si un membre du groupe audio affiche les sessions dans le portail ou IBM Tealeaf CX RealiTea Viewer, seules les sessions du site sont affichées. La segmentation des données est entièrement basée sur les éénements. Chaque groupe ajouté dans la configuration du sereur de recherche peut comporter plusieurs éénements, qui peuent être combinés à l'aide des opérateurs booléens AND ou OR. Pour les utilisateurs membres de plusieurs groupes, chaque ensemble d'éénements de groupe est combiné à l'aide de l'opérateur OR. 1. Dans la boîte de dialogue Authentification, sélectionnez le Nom de groupe dans la section Filtres de recherche de segmentation des données. 2. Cliquez sur Ajouter des éénements au groupe et sélectionnez un éénement dans la boîte de dialogue Sélection d'éénement. Vous pouez ajouter plusieurs éénements à la même liste de groupes. Par défaut les éénements sont regroupés à l'aide de l'opérateur AND, ce qui signifie qu'and est utilisé comme opérateur lors du filtrage des sessions. Si une session contient tous les éénements, elle peut être affichée par ce groupe particulier. La segmentation des données par éénement est essentiellement une recherche de session par éénement. La requête de recherche est ajoutée à toute demande de sereur de recherche effectuée à partir du sereur de rapports ou de l'application Web du portail. Vous trouerez ci-dessous des exemples supplémentaires de filtrage des éénements. Supposons que ous ayez configuré les trois groupes suiants dans Configuration de la recherche : tealeaf\userseent 1tealeaf\eng (Eléments reliés par un opérateur AND) eent 2eent 3tealeaf\qa (Eléments reliés par un opérateur OR) eent 4eent 5eent 6 Un utilisateur membre de tealeaf\users recherche la session : (canisterappeent contains 1) and (session) Un utilisateur membre de tealeaf\eng recherche la session : (canisterappeent contains (2 and 3)) and (session) Un utilisateur membre de tealeaf\eng et tealeaf\qa recherche la session : (canisterappeent contains (2 and 3) or (4 or 5 or 6)) and (session) Dans la fenêtre Authentification, cliquez sur Eénements isibles dans le portail. Cochez les éénements à afficher dans l'application Web du portail pour le groupe sélectionné. Si aucun éénement n'est sélectionné, aucun éénement n'est affiché dans le portail lorsqu'un membre de ce groupe se connecte. Chapitre 2. Configuration des composants Tealeaf 135

146 4. Configuration du portail : Vérifiez que l'authentification NT du portail est actiée. 1. Dans TMS, sélectionnez le noeud Tealeaf. 2. Cliquez sur Informations de configuration partagées. 3. Cliquez sur Afficher/Modifier. 4. Cliquez sur l'onglet Portail. 5. Cliquez sur le paramètre Méthode d'authentification. 6. Vérifiez que NT est sélectionné dans le menu déroulant. Ce qu'un utilisateur oit dans le portail dépend en grande partie de la manière dont l'administrateur a configuré cet utilisateur particulier. Voir «Chapitre sur la configuration du sereur de rapports», à la page 61. Utilisation de la segmentation des données pour masquer les sessions : Dans certains cas, il se peut que ous deiez masquer des sessions spécifiques afin qu'elles ne soient pas isibles par certains utilisateurs Tealeaf. Cette section offre une approche généralisée de la manière de procéder. 1. Créez un éénement déclenché dans toutes les sessions à masquer. Voir "Onglet Eénements TEM" dans le document IBM Tealeaf Eent Manager - Guide. 2. A l'aide du sereur de recherche, créez un groupe qui contiendra tous les utilisateurs Tealeaf non autorisés à afficher les sessions. 3. Ajoutez les utilisateurs au groupe. 4. Dans la segmentation des éénements, ajoutez l'éénement créé à ce groupe. 5. Spécifiez l'opérateur NOT. 6. Sauegardez les modifications. Traitement des incidents Pour plus d'informations concernant le traitement des incidents, oir "Traitement des incidents - Recherche" dans le document de dépannage d'ibm Tealeaf. Confidentialité à la demande Si l'application autonome IBM Tealeaf CX RealiTea Viewer ou le sereur de relecture, qui agit pour le compte des utilisateurs de la relecture sur naigateur, demande une session ou un ensemble de sessions à relire sur l'application client, le sereur de recherche interroge les Canisters pour extraire les sessions. Le sereur de recherche peut éentuellement être configuré pour ourir les sessions extraites et appliquer un ensemble de règles de confidentialité prédéfinies à ces sessions, en fonction du groupe auquel l'utilisateur demandeur appartient. Dans certains cas, ous pouez souhaiter capturer des données des Canisters Tealeaf pour les stocker à long terme et en permettre la recherche, sans exposer ces éléments de données aux utilisateurs ia une relecture. Cet ensemble de règles de confidentialité peut différer des règles de confidentialité appliquées ia la PCA ou le pipeline Windows. Des règles de confidentialité peuent être déeloppées et appliquées pour chaque groupe d'utilisateurs auquel ous appliquez la confidentialité à la demande. Cette section décrit la manière dont la confidentialité à la demande est configurée et appliquée. 136 IBM Tealeaf CX - Guide de configuration

147 Comment la confidentialité à la demande est appliquée Lorsque RTV ou BBR recherche une session à relire sur le sereur de recherche, ce dernier examine les groupes d'utilisateurs auxquels l'utilisateur demandeur appartient. Si un ensemble de règles de relecture a été affecté à l'un des groupes de l'utilisateur, le sereur de recherche oure les données de la session demandée et applique l'ensemble des règles de relecture à la session. La session est ensuite distribuée à l'application qui la demande pour relecture à l'utilisateur. Remarque : Les règles de confidentialité à la demande ne sont appliquées qu'aux Canisters Tealeaf. La confidentialité à la demande ne peut pas être appliquée aux machines HBR. Remarque : Les règles de confidentialité à la demande sont appliquées ia les groupes d'utilisateurs et ne peuent pas être appliquées de manière sélectie à des utilisateurs indiiduels. La confidentialité à la demande permet d'appliquer les règles de confidentialité en fonction de l'appartenance de l'utilisateur à un groupe ou à un autre. Vous pouez configurer et appliquer des ensembles de règles de confidentialité distincts pour chaque groupe d'utilisateurs. Par l'intermédiaire de la configuration du sereur de recherche, ous pouez affecter des règles de confidentialité à tous les utilisateurs ia un fichier de configuration global et des règles de confidentialité à des groupes d'utilisateurs indiiduels à partir de fichiers de configuration distincts. Exemple d'utilisation Les zones chiffrées à l'aide de règles de confidentialité dans les pipelines IBM Tealeaf CX Passie Capture Application ou Windows ne peuent pas être déchiffrées dans le portail. Ces zones chiffrées ne peuent être déchiffrées que lors d'une nouelle exécution. Vous pouez également laisser les zones configurées à l'état non chiffré dans les données de session, puis définir spécifiquement des règles de confidentialité à appliquer lors de la relecture des sessions, afin de permettre l'affichage des données non chiffrées dans le portail, si nécessaire. Authentification requise La confidentialité à la demande fonctionne conjointement aec la méthode d'authentification actiée et configurée. Tealeaf prend en charge deux méthodes d'authentification principales : Authentification du portail : les demandes des utilisateurs du système Tealeaf sont autorisées par l'application du portail Tealeaf. Authentification NT : les demandes des utilisateurs du système Tealeaf sont autorisées initialement par le contrôleur de domaine Windows associé à l'application du portail Tealeaf. Remarque : L'utilisation de la confidentialité à la demande nécessite que l'authentification du portail ou l'authentification NT soit actiée et configurée. Vous ne pouez pas utiliser la confidentialité à la demande si la méthode d'authentification de la configuration du sereur de recherche possède la aleur Néant. Voir «Chapitre sur la configuration du sereur de recherche», à la page 107. Pour plus d'informations sur l'authentification, oir «Chapitre sur la configuration du sereur de recherche», à la page 107. Chapitre 2. Configuration des composants Tealeaf 137

148 Pour plus d'informations sur les méthodes d'authentification généralement prises en charge, oir "Authentification" dans le document IBM Tealeaf cximpact - Guide d'administration. Authentification du portail et RTV Si ous utilisez l'authentification du portail et l'application RTV, ous deez configurer le nom d'utilisateur et le mot de passe de l'utilisateur Tealeaf qui recherche sur le sereur de recherche des sessions dans RTV. Dans le menu RTV, sélectionnez Outils > Options... et cliquez sur l'onglet IBM Tealeaf cximpact. Voir "RealiTea Viewer - Balises des options aancées" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Appartenance à plusieurs groupes La confidentialité est appliquée à tous les groupes pour lesquels des configurations de confidentialité à la demande ont été configurée dans la configuration du sereur de recherche. Les règles de confidentialité sont appliquées aux groupes d'utilisateurs suiant l'ordre alphabétique, par nom de groupe. Par exemple, si l'utilisateur 1 est membre du groupe A et du groupe B, deux groupes pour lesquels des règles de confidentialité ont été spécifiées, les règles du groupe A sont appliquées à la relecture de session aant celles du groupe B, car ce groupe apparaît en premier dans l'ordre alphabétique. Si un utilisateur est membre d'un groupe auquel aucune confidentialité n'est appliquée et d'un groupe auquel la confidentialité est appliquée, la confidentialité est appliquée aux données de relecture de l'utilisateur. Par exemple, supposons que l'utilisateur 2 est membre du groupe C, du groupe D et du groupe E, et que le groupe D possède un ensemble de règles de confidentialité, ce qui n'est pas le cas des deux autres groupes. Dans ce cas, les règles de confidentialité du groupe D sont appliquées. Confidentialité à la demande sur les éénements par ersion de Tealeaf Suiant la ersion de Tealeaf qui a capturé et stocké les données de session, la confidentialité à la demande peut être appliquée différemment sur les éénements : Version 8.0 ou ultérieure : Dans ces ersions, les données d'éénement sont stockées dans la demande de la page sur laquelle elles ont été déclenchées. En fonction de la présence d'un éénement spécifique, ous pouez appliquer des règles de relecture à toutes données de la page. Version 7.2 ou antérieure : Dans ces ersions, les données d'éénement sont stockées dans une page distincte de la page sur laquelle l'éénement s'est produit. Il n'existe pas de moyen simple d'appliquer les règles de relectures basées sur des éénements aux données de la page parent. Configuration de la confidentialité à la demande La confidentialité à la demande doit être configurée sur le sereur Tealeaf correspondant au maître d'authentification. Il s'agit en général du sereur de portail. 138 IBM Tealeaf CX - Guide de configuration Remarque : La confidentialité à la demande est une fonction du sereur de recherche et est configurée par l'intermédiaire de la configuration du sereur de recherche. Toutefois, à ce stade, ous ne pouez pas configurer la confidentialité à la demande ia Tealeaf Management System, la méthode préférée de gestion de la

149 configuration. La confidentialité à la demande doit être configurée ia l'outil SearchConfig.exe dans le répertoire d'installation de Tealeaf du sereur maître de l'authentification. Les captures d'écran et descriptions ci-dessous font référence à cet outil. Chaque Canister autre que le maître d'authentification doit être configuré séparément pour pointer ers le sereur maître de l'authentification. Voir «Configuration des Canisters esclae de l'authentification», à la page 142. Téléchargement des fichiers de configuration de la confidentialité Aant de commencer, ous pouez, si ous le souhaitez, télécharger un ou plusieurs fichiers de configuration de confidentialité sur le sereur maître d'authentification. La confidentialité à la demande utilise le même format de fichier de configuration que les autres formes de confidentialité de Tealeaf. Vous deez copier au moins un fichier Priacy.cfg dans le répertoire suiant du sereur maître d'authentification : répertoire_installation_tealeaf\system L'outil de configuration du sereur de recherche examine ce répertoire pour rechercher les fichiers de configuration de confidentialité disponibles. Tout fichier.cfg correctement formaté pour la configuration de la confidentialité peut être utilisé dans la confidentialité à la demande. Remarque : Vous pouez copier un fichier de confidentialité global, qui applique la confidentialité la plus générale au répertoire. Vous pouez ensuite utiliser ce fichier pour en créer d'autres qui contiendront des règles de confidentialité spécifiques à des groupes d'utilisateurs indiiduels. Version 8.0 ou ultérieure uniquement : si ous n'aez pas directement accès à ce sereur, ous pouez utiliser la commande Placer un fichier de l'onglet Aancé de TMS pour placer les fichiers de configuration dans le répertoire d'installation de Tealeaf. Voir le chapitre sur l'onglet Aancé de TMS dans le document IBM Tealeaf cximpact - Guide d'administration. Confidentialité à la demande dans la configuration du sereur de recherche 1. Une fois que ous aez téléchargé les fichiers de configuration appropriés, pour commencer la configuration de la confidentialité à la demande, cliquez deux fois sur l'exécutable suiant : <répertoire_installation_tealeaf>\searchconfig.exe 2. L'utilitaire SearchConfig externe est affiché. 3. Sous Groupes locaux du domaine, cliquez sur Modifier Sous Type d'authentification, érifiez qu'authentification NT ou Authentification du portail est actié. Voir «Authentification requise», à la page La fenêtre Authentification s'affiche : Chapitre 2. Configuration des composants Tealeaf 139

150 Figure 21. Authentification 6. Pour le type d'authentification sélectionné, les groupes d'utilisateurs disponibles sont affichés : Zone Description Groupes d utilisateurs Groupes d'utilisateurs disponibles de la méthode d'authentification sélectionnée Priacy Filter Key Clé de filtre de confidentialité appliquée au groupe d'utilisateurs. Ce paramètre ne s'applique pas à la confidentialité à la demande. Voir «Chapitre sur la configuration du sereur de recherche», à la page 107. Replay Priacy Encryption Fichier de configuration de confidentialité appliqué aux membres de ce groupe lorsqu'ils demandent des données de session à relire. 140 IBM Tealeaf CX - Guide de configuration

151 Configuration du fichier de confidentialité à utiliser pour un groupe : Pour appliquer un fichier de configuration à un groupe d'utilisateurs spécifique, effectuez les étapes ci-après. 1. Dans la fenêtre Authentification, sélectionnez le groupe auquel un fichier de configuration doit être appliqué. 2. Cliquez sur Priacy Encryption La boîte de dialogue Priacy Encryption Config File s'affiche. Figure 22. Confidentialité à la demande - Sélection d'un fichier de configuration 4. La liste des fichiers de configuration disponibles est affichée. La liste des fichiers est alimentée à partir d'une analyse du répertoire répertoire_installation_tealeaf\system. Voir «Téléchargement des fichiers de configuration de la confidentialité», à la page 139. Si le sereur est également un sereur de traitement, le fichier Priacy.cfg utilisé pour le pipeline Windows n'est pas disponible. Il est stocké dans le répertoire parent du répertoire System. Pour examiner et éditer un fichier de confidentialité, sélectionnez-le et cliquez sur Ouert dans le Bloc-notes... Vous pouez éditer le fichier et le sauegarder sur le sereur. Pour ourir le répertoire System afin d'y rechercher des fichiers, cliquez sur Open System Directory... Pour appliquer un fichier de confidentialité au groupe d'utilisateurs sélectionné, sélectionnez ce fichier et cliquez sur OK. Pour ne pas appliquer de fichier de confidentialité au groupe d'utilisateurs sélectionné, cliquez sur Aucun, puis sur OK. Aucune confidentialité n'est appliquée au groupe. Pour annuler des changements, cliquez sur Annuler. 5. Répétez les étapes ci-dessus pour les autres groupes d'utilisateurs, si nécessaire. Chapitre 2. Configuration des composants Tealeaf 141

152 Configuration des Canisters esclae de l'authentification : Pour les Canisters autres que le portail ou le sereur maître d'authentification NT, ous deez configurer le sereur de recherche afin que ces Canisters pointent ers le sereur maître d'authentification. Cette configuration peut être effectuée ia Tealeaf Management System. Remarque : Cette configuration ne s'applique que si otre enironnement comporte plusieurs Canisters. Remarque : Lorsqu'un noueau Canister est déployé, la configuration du sereur maître d'authentification doit être effectuée dans le cadre de la configuration initiale. Vérifiez les étapes ci-après. 1. Connectez-ous au portail en tant qu'administrateur. 2. Dans le menu Portail, sélectionnez Tealeaf > TMS. 3. Cliquez sur l'onglet WorldView. Voir "Onglet TMS WorldView" dans le document IBM Tealeaf cximpact - Guide d'administration. 4. Sélectionnez un sereur ne correspondant pas au maître d'authentification. 5. Cliquez sur le noeud Sereur de recherche. 6. Sélectionnez Configuration du sereur de recherche. 7. Dans le panneau Actions de configuration, cliquez sur Afficher/Modifier. 8. La configuration du sereur de recherche s'affiche. 9. Sous Groupes locaux du domaine, cliquez sur Modifier Vérifiez que le paramètre Sereur maître d'authentification pointe ers le sereur maître d'authentification, qui est généralement le sereur de portail. Modifiez le paramètre, si nécessaire. Remarque : Pour le sereur qui héberge le sereur de recherche correspondant au maître d'authentification, ce paramètre doit être ide. Le paramètre sur le maître d'authentification est érifié lors d'une étape ultérieure. 11. Cliquez sur OK. 12. Cliquez sur Sauegarder. 13. Lorsque ous y êtes inité, enoyez cette modification à tous les sereurs et soumettez le traail immédiatement. 14. Maintenant, dans l'onglet WorldView, sélectionnez le sereur correspondant au maître d'authentification. 15. Cliquez sur le noeud Sereur de recherche. 16. Sélectionnez Configuration du sereur de recherche. 17. Dans le panneau Actions de configuration, cliquez sur Afficher/Modifier. 18. La configuration du sereur de recherche s'affiche. 19. Sous Groupes locaux du domaine, cliquez sur Modifier Pour le paramètre Sereur maître d'authentification, cette aleur doit être ide. Remarque : Pour le Canister qui héberge le sereur de recherche correspondant au sereur d'authentification, ce paramètre doit être ide. 21. Cliquez sur OK. 22. Cliquez sur Sauegarder. 23. Lorsque ous y êtes inité, n'enoyez pas la modification aux autres sereurs. 142 IBM Tealeaf CX - Guide de configuration

153 Tous les Canisters doient être maintenant correctement configurés pour pointer ers le sereur maître d'authentification. Voir «Chapitre sur la configuration du sereur de recherche», à la page 107. Pour plus d'informations sur TMS, oir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Mise à jour des esclaes : A l'interalle d'actualisation des autorisations spécifié, les sereurs esclaes du maître d'authentification copient les fichiers de configuration de la confidentialité sur leurs sereurs locaux. Par défaut, cette mise à jour est effectuée toutes les cinq minutes. Voir «Chapitre sur la configuration du sereur de recherche», à la page 107. Règles de relecture pour la confidentialité Vous pouez configurer des règles de confidentialité pour la relecture tout comme dans la PCA ou le pipeline Windows. Les exceptions et fonctions spéciales qui s'appliquent à la confidentialité à la demande sont répertoriées ci-après. Pour plus d'informations sur le déeloppement de règles de confidentialité en général, oir «Agent de session Confidentialité», à la page 307. Utilisation du testeur de confidentialité RTV pour le déeloppement de règles de confidentialité à la demande Pour faciliter le déeloppement de règles de confidentialité à la demande, ous pouez utiliser IBM Tealeaf CX RealiTea Viewer, qui inclut un testeur de confidentialité imbriqué pouant être appliqué aux sessions chargées à partir du disque local ou demandées au sereur de recherche. Les cycles d'itération sont très rapides : Editez le fichier de configuration des règles de confidentialité en local dans un éditeur de texte. Enregistrez os modifications. Chargez les sessions dans RTV. Ourez le testeur de confidentialité. Chargez le fichier de configuration des règles de confidentialité. La confidentialité est appliquée aux sessions sélectionnées. Répétez les étapes ci-dessus jusqu'à ce que ous soyez satisfait des résultats. Pour plus d'informations, oir "RealiTea Viewer - Testeur de confidentialité" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Utilisation du blocage La confidentialité Tealeaf prend en charge deux méthodes de masquage des données pour qu'elles ne soient pas isibles par les utilisateurs : le chiffrement et le blocage. Le chiffrement est utile si ous souhaitez masquer les données pour certains utilisateurs et les afficher pour d'autres. Toutefois, la confidentialité à la demande pouant être appliquée de manière sélectie au nieau du groupe, le chiffrement des données de relecture ne présente aucun intérêt. Le chiffrement est également plus coûteux en termes de temps de traitement. Remarque : Pour masquer les données aux utilisateurs ia la confidentialité à la demande, utilisez des règles de blocage au lieu de règles de chiffrement. Fonctions spéciales de la confidentialité à la demande Les sections ci-après décrient les fonctions ou mots clés de confidentialité spéciaux implémentés uniquement pour la confidentialité à la demande. Chapitre 2. Configuration des composants Tealeaf 143

154 Valeur TL_USER_GROUPS de ReqField : Dans la confidentialité à la demande, ous pouez définir des tests pour éaluer les groupes d'utilisateurs auxquels l'utilisateur demandeur appartient. Dans os tests de confidentialité, ous pouez utiliser la paire nom/aleur suiante pour spécifier un test des groupes d'utilisateurs auxquels l'utilisateur qui demande des sessions de relecture appartient : ReqField=TL_USER_GROUPS Exemple Dans l'exemple suiant, la règle ([Rule9]) est définie pour bloquer la réponse en fonction des tests suiants : [SixPageTest] : l'url de la page demandée contient la aleur six. [NotInSuperUserGroup] : l'utilisateur n'appartient pas au groupe SuperUser. Notez que la définition de [Rule9] inclut l'opérateur de test (TestOp) AND, ce qui signifie que les deux tests ci-dessus doient aoir la aleur true pour que les actions spécifiées (BlockRsp, ReqSetBlockedRsp) soient exécutées. [Rule9] Enabled=true TestOp=AND Tests=NotInSuperUserGroup, SixPageTest Actions=BlockRsp, ReqSetBlockedRsp [SixPageTest] ReqField=URL ReqOp=CONTAINS ReqVal=six [NotInSuperUserGroup] ReqField=TL_USER_GROUPS ReqOp=CONTAINS ReqVal=SuperUser CaseSensitie=False Not=True [BlockRsp] Action=Block Section=response Field=body [ReqSetBlockedRsp] Action=ReqSet ReqSetSection=en ReqSetField=RspAltText ReplaceString=<html>Response has been blocked for replay.</html> Valeur TL_USER_NAME de ReqField : Dans os tests, ous pouez également utiliser la aleur TL_USER_NAME de la zone requise pour appliquer des règles de relecture à des utilisateurs Tealeaf spécifiques. Dans l'exemple ci-après, un test est défini pour déterminer si le nom d'utilisateur demandeur est johndoe. Notez que la configuration est insensible à la casse. [isjohndoe] ReqField=TL_USER_NAME ReqVal=johndoe ReqOp=CONTAINS CaseSensitie=False 144 IBM Tealeaf CX - Guide de configuration

155 Mode de débogage Pour la confidentialité dans le pipeline Windows, ous pouez configurer l'agent de session Confidentialité ou Confidentialité étendue dans le fichier TealeafCaptureSocket.cfg afin de générer des messages de journal permettant de déboguer os règles de confidentialité. La confidentialité à la demande n'utilise pas ce fichier de configuration. Pour actier ces messages de débogage pour os règles de confidentialité à la demande, ous pouez ajouter la section suiante au début de chaque fichier de configuration utilisé pour la confidentialité à la demande : [Config] LogLeel=debug Remarque : Le nieau de débogage peut générer de nombreux messages de journal. Il doit être désactié dès que ous aez résolu le problème. Pour désactier la consignation du débogage, affectez à LogLeel une aleur autre que Debug. Vous pouez également supprimer la section ci-dessus du fichier.cfg. Consignation et génération de rapports Lorsque le sereur de relecture distribue des sessions, la confidentialité à la demande est automatiquement appliquée et la relecture est consignée de manière habituelle. Vous pouez rechercher les relectures par le biais du portail Tealeaf. Voir "Sureillance de l'actiité utilisateur" dans le document IBM Tealeaf cximpact - Guide d'administration. Référence Chapitre sur la gestion de la confidentialité des données dans Tealeaf CX dans le document IBM Tealeaf CX Installation Manual «Agent de session Confidentialité», à la page 307 «Agent de session Confidentialité étendue», à la page 275 «Utilitaire Testeur de confidentialité», à la page 416 Confidentialité à la demande "RealiTea Viewer - Testeur de confidentialité" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation «Chapitre sur la configuration du sereur de recherche», à la page 107 Configuration du serice d'alerte Le serice d'alerte de Tealeaf fournit un système d'alerte en temps réel sur les éénements Tealeaf et l'analyse des changements. Chaque alerte peut être configurée pour enoyer des messages électroniques en fonction de aleurs de seuil définies pour l'éénement ou l'analyse des changements. Les données Tealeaf sont analysées toutes les minutes, ce qui permet au moteur d'alerte d'informer rapidement les utilisateurs des problèmes nécessitant une interention. Le serice d'alerte possède les fonctions suiantes : Il est intégré au processus d'éaluation des éénements sur le sereur de traitement Il est lié à la collecte horaire ou quotidienne des données de l'analyse des changements Il utilise une granularité d'une minute dans les calculs de seuil Chapitre 2. Configuration des composants Tealeaf 145

156 Il récapitule les informations d'alerte de plusieurs sereurs de traitement Chaque alerte possède des options de configuration indépendantes : des seuils, des périodes d'aertissement, d'alerte et d'interruption totale, ainsi que des options de messagerie. Fonctionnement des alertes Les données d'éénement insérées dans la base de données incluent un décompte des éénements déclenchés, le nombre de nouelles sessions et le nombre de nouelles pages ajoutées minute par minute. Chaque minute, le serice d'alerte interroge la base de données pour identifier la liste des éénements déclenchés au cours des dernières minutes ou l'analyse des changements calculée. Les éénements et l'analyse des changements sont comparés à l'ensemble des alertes définies et acties pour déterminer si des seuils ont été dépassés. Si c'est le cas, les alertes correspondantes sont déclenchées. L'heure des alertes est basée sur l'horloge système du sereur IBM Tealeaf CX Passie Capture Application. Remarque : Les sessions spoulées par le Canister Tealeaf au moment de l'éaluation des alertes risquent de ne pas être incluses dans les calculs de seuil. Pour les éénements dont le déclencheur est Fin de la Session ou dont la génération de rapports est définie sur Indiquer la dernière occurrence, l'heure d'éénement associée à l'éénement est passée en raison du délai aant expiration de la session. Ces éénements sont synchronisés aec l'heure d'éaluation de la table NALT pour que leur nombre soit inclus dans les calculs des seuils. Chaque minute, deux enregistrements spéciaux sont mis à jour aec les décomptes des nouelles sessions et des nouelles pages, même si aucune n'a été ajoutée. Ces enregistrements serent de signal de présence pour le serice d'alerte. L'heure du hit pour l'enregistrement du signal de présence est considéré comme étant l'heure de distribution de l'enregistrement. Remarque : Le serice d'alerte interrogeant l'ensemble des Canisters toutes les minutes, les performances peuent être considérablement affectées par le temps d'attente du réseau ou d'autres interruptions. Installation Le portail suppose que la machine configurée pour être le sereur de rapports dans le portail est celle sur laquelle le serice d'alerte est exécuté. Le serice d'alerte doit être actif sur cette machine. Terminologie du serice d'alerte Pour comprendre le fonctionnement du serice d'alerte, ous deez aoir assimilé quelques concepts de base. Terme Définition Interalles Les interalles d'alerte peuent être configurés à la minute. L'unité de temps la plus petite pour accumuler les nombres d'éénements est d'une minute. Tous les interalles sont contigus quelle que soit l'actiité des éénements. 146 IBM Tealeaf CX - Guide de configuration

157 Fenêtre de temps mobile Chaque alerte possède une fenêtre de temps configurable dans laquelle les nombres d'éénements s'accumulent. Cette fenêtre n'a pas d'heure de début définie, comme le début de l'heure ou toutes les demi-heures. L'heure de début de la fenêtre est égale à l'heure actuelle moins la taille de l'interalle d'alerte. Cette fenêtre peut être plus petite si une alerte s'est produite au cours de l'interalle d'alerte. La taille de la fenêtre est contrôlée par le paramètre Interalle d'alerte de chaque éénement. Les nombres correspondant à chaque nouelle minute sont ajoutés au nombre cumulé de la fenêtre et le nombre de la minute la plus ancienne est supprimé s'il se troue en dehors des paramètres de l'interalle d'alerte. Seuils Ces aleurs définissent le moment auquel un message d'aertissement ou d'alerte est créé. Si le nombre dépasse l'une de ces aleurs et que l'alerte ne se troue pas dans un interalle de réinitialisation, un message est créé. Les seuils d'alerte sont prioritaires par rapport aux seuils d'aertissement. Les seuils négatifs sont éalués comme "inférieurs ou égaux à" et non comme "supérieurs ou égaux à" la aleur. Un moyen simple de se rappeler de se concept consiste à penser aux nombres petits comme des aleurs sujettes aux alertes. L'inactiité d'un éénement en est un bon exemple ("nous n'aons reçu que trois commandes au cours des 30 dernières minutes"). Interalles de réinitialisation Les interalles de réinitialisation permettent au serice d'alerte de supprimer les aertissements et les alertes pour une période configurable aant de recommencer à enoyer des messages. Cette fonction interdit la répétition des messages d'aertissement/alerte (toutes les minutes) tant qu'un éénement se troue dans un statut d'aertissement ou d'alerte. L'interalle de réinitialisation de ces alertes réinitialise le compteur d'éénements et l'heure de début de l'interalle à la fin de la période de réinitialisation. Les interalles de réinitialisation ne s'appliquent pas aux alertes Analyse des changements et aux alertes Rapport d'analyse des changements. Création d'alertes Vous pouez créer des alertes et les objets permettant de les déclencher ia le portail. Voir la rubrique "Gestionnaire d'éénements Tealeaf" dans le manuel du Gestionnaire d'éénements Tealeaf d'ibm. Voir "TEM Alerts Tab" dans le document IBM Tealeaf Eent Manager Manual. Voir "Onglet Eénements TEM" dans le document IBM Tealeaf Eent Manager Manual. Voir "TEM Top Moers Tab" dans le document IBM Tealeaf Eent Manager Manual. Configuration Vous pouez configurer le serice d'alerte ia TMS. Pour le configurer : 1. Connectez-ous au portail Tealeaf en tant qu'administrateur. 2. Dans le menu Portail, sélectionnez Tealeaf > TMS. Chapitre 2. Configuration des composants Tealeaf 147

158 3. Dans la ue Sereurs, cliquez sur Serice d'alerte. 4. Cliquez sur Configuration du serice d'alerte. 5. Dans le panneau Actions de configuration, cliquez sur Afficher/Modifier. Les paramètres ci-après peuent être modifiés. Voir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Paramètre Description Canister Attempts Nombre de fois que le serice tente de se connecter à un sereur de traitement pour la collecte des données, à des interalles d'une minute, lorsque le serice est démarré. Le serice continue en permanence de tenter d'établir une connexion aec les Canisters manquants, toutes les 10 minutes. From Address Adresse expéditrice de courrier électronique pour tous les messages d'alerte par courrier électronique. Ces adresses peuent se présenter sous les formes suiantes : John Smith<johnsmith@example.com> "John Smith"<johnsmith@example.com> <johnsmith@example.com> johnsmith@example.com Remarque : Certains sereurs de messagerie n'acceptent pas d'adresse électronique expéditrice dont le formatage n'est pas alide. Veillez à bien configurer une adresse électronique alide. Eent Refresh Interal Interalle auquel le serice tente de régénérer les définitions d'éénement/alerte. La aleur par défaut est de 10 minutes ; elle ne doit pas être inférieure à 10 minutes. Logfile Verbosity Ce paramètre contrôle le contenu du fichier TLAlertSr_YYYYMMDD.log conseré dans le répertoire Logs. Par défaut, le nieau de consignation est défini sur 2 et doit y rester à moins qu'un problème ne requiert otre attention. Pour collecter les données de débogage sur plusieurs jours, définissez cette aleur sur 4. Pour collecter les données de débogage sur plusieurs heures d'une même journée, ous pouez définir cette aleur sur 9. Remarque : Une fois que ous aez résolu un problème, ous deez rétablir le nieau de consignation 2. Maximum Length of Subject Line Définit le nombre maximal de caractères qui peuent être utilisés dans la ligne Objet du courrier électronique d'alerte généré. La aleur maximale de ce paramètre est de 255. Message Attempts Nombre de fois que le serice tente d'enoyer un même message Minutes to Inhibit Alerts Si nécessaire, ous pouez appliquer un arrêt d'urgence du traitement des alertes pour le nombre de minutes spécifié. Une fois que cette période 148 IBM Tealeaf CX - Guide de configuration

159 d'arrêt est arriée à expiration, le serice d'alerte reprend automatiquement ses opérations. Voir «Arrêt de la génération d'alertes». Per Minute SQL Updates Si ce paramètre est Actié, le serice d'alerte peut insérer de manière sélectie des enregistrements d'information dans une base de données pour suire le statut du Canister. Ces enregistrements sont insérés toutes les minutes et peuent aoir un impact sur les performances dans les installations comportant un grand nombre de sereurs de Canister. URL du portail Adresse Web du portail. Dans les messages d'alerte par courrier électronique, cette adresse offre un accès utilisateur aux détails des alertes ia le portail. Record XML Data S'il est actié, ce paramètre enregistre les données XML lues par le serice d'alerte. Dans le répertoire Tealeaf\Portal, les fichiers XML suiants sont enregistrés : EentsReadbyAlertSerice.xml, ReportsReadbyAlertSerice.xml et TopMoersReadbyAlertSerice.xml. Remarque : Par défaut, ce paramètre est désactié. Ces données XML ne sont utiles qu'à des fins de débogage, lorsque ous faites appel au serice clients de Tealeaf. Moniteurs SNMP Liste de sereurs SNMP, séparés par des irgules, qui reçoient des messages d'alerte SNMP Fichier journal de maintenance Le serice d'alerte consigne les erreurs et les informations de débogage dans un fichier chaque jour. La aleur par défaut, TLAlertSr.log, génère les fichiers sous la forme TLAlertSr_AAAAMMJJ.log. Cette zone autorise une personnalisation par l'utilisateur du nom de fichier journal de base. Arrêt de la génération d'alertes Si nécessaire, ous pouez forcer un arrêt temporaire du serice d'alerte, ce qui empêche la génération de nouelles alertes. Lorsqu'une aleur non nulle est entrée pour le paramètre Minutes to Inhibit Alerts et que la configuration est sauegardée et appliquée, le serice d'alerte empêche la génération des nouelles alertes pendant le nombre de minutes spécifié, quelle que soit la manière dont les alertes indiiduelles sont définies. Cette fonction peut s'aérer utile pour déboguer les alertes déclenchées trop fréquemment en raison d'une spécification incorrecte de l'éénement source ou d'un autre problème de configuration dans la définition d'alerte. Lorsque la période spécifiée est arriée à expiration, le serice d'alerte reprend son fonctionnement normal. Remarque : Si cette aleur est modifiée ia TMS, elle est appliquée au paramètre de registre correspondant, à partir duquel le serice d'alerte lit et applique son comportement. Une fois que la période d'arrêt est arriée à expiration, le serice d'alerte réinitialise le paramètre de registre à 0, ce qui lui permet de reprendre ses opérations normales, mais le paramètre dans TMS n'est pas réinitialisé automatiquement. Si ous rechargez la configuration du serice d'alerte ia TMS, il reconnaît qu'il existe une différence entre le paramètre de registre (0) et la aleur stockée dans Chapitre 2. Configuration des composants Tealeaf 149

160 TMS (20). Pour resynchroniser les aleurs, ous deez réinitialiser manuellement la aleur dans TMS ou recharger la configuration à partir du système local lorsque ous y êtes inité. Configuration des alertes SNMP Tealeaf permet d'enoyer des alertes SNMP aux programmes d'écoute SNMP. Remarque : Tealeaf ne fournit pas de fichier MIB (Management Information Base) pour sureiller les alertes. Pour l'actier : 1. Dans la configuration du serice d'alerte dans TMS, cliquez sur SNMP Monitors. 2. Entrez une liste de sereurs séparés par des irgules pour enoyer des alertes SNMP. 3. Cliquez sur Sauegarder. 4. Configurez une tâche TMS pour mettre à jour la configuration de tous les sereurs affectés. Pour sureiller les alertes SNMP : Tealeaf ne fournit pas de fichier MIB permettant de sureiller les alertes SNMP. Toutefois, Tealeaf enoie une alerte SNMP en texte simple et ous pouez configurer otre application externe pour qu'elle sureille les éénements Tealeaf à l'aide des informations ci-après. La structure des ID objet des alertes SNMP peut être utilisée pour déterminer quelle alerte a été déclenchée. L'ID société de Tealeaf est Une alerte possède l'id objet suiant : <Eent ID> Le message de l'alerte est au format suiant : ALERT DETAILS: <Alert Title> Vous pouez créer un filtre en fonction de l'id objet pour permettre au destinataire externe de sureiller des filtres spécifiques. Statistiques de Canister Dans le cadre de ses opérations, le serice d'alerte extrait et insère les statistiques de Canister de tous les Canisters identifiés dans le portail dans la base de données TL_STATISTICS. L'enregistrement des statistiques est actié ia le paramètre Per Minute SQL Updates. Voir «Configuration», à la page 147. Certaines de ces statistiques apparaissent dans les rapports Statut du Canister. Voir "Statut système" dans le document IBM Tealeaf cximpact - Guide d'administration. Démarrage/Arrêt/Redémarrage du serice Vous pouez démarrer, arrêter et redémarrer le serice d'alerte ia TMS. Procédez comme suit pour configurer RTV : 1. Connectez-ous au portail Tealeaf en tant qu'administrateur. 2. Dans le menu Portail, sélectionnez Tealeaf > TMS. 150 IBM Tealeaf CX - Guide de configuration

161 3. Dans la ue Sereurs, cliquez sur Serice d'alerte. 4. Dans la sous-fenêtre Actions de composant, ous pouez cliquer sur les boutons Démarrer, Arrêter ou Redémarrer. Configuration du serice de planification Le serice de planification Tealeaf permet de planifier des traaux répétitifs spécifiques à Tealeaf, parmi lesquels les sauegardes, extractions et archiage TLI. Lors de l'installation, le serice de planification Tealeaf est configuré pour démarrer automatiquement, mais certains traaux par défaut sont désactiés. Remarque : Le serice de planification Tealeaf ne doit pas être utilisé pour planifier et exécuter des traaux liés à Tealeaf autres que ceux spécifiés dans cette section. Actiation du serice de planification Tealeaf Par défaut le serice de planification Tealeaf est automatiquement démarré et actié lors de l'initialisation du sereur Tealeaf. Pour actier ou désactier ce serice, utilisez le panneau de configuration des serices Windows afin de démarrer ou d'arrêter le serice de planification Tealeaf. Configuration du serice de planification Tealeaf Le serice est configuré à l'aide d'un fichier.xml stocké dans l'emplacement suiant : <répertoire_installation_tealeaf>\tools\tlschedulersccfg.xml Le fichier de configuration inclus pendant l'installation contient la spécification des traaux de trois types différents. Par défaut, tous sont désactiés. Remarque : Aant de commencer à éditer le fichier ci-dessus, il est recommandé d'en effectuer une copie de sauegarde. Configuration par défaut Le fichier.xml ci-après est la configuration par défaut fournie lors de la procédure d'installation. Pour plus d'informations sur chaque type de configuration de traail : «Configuration des traaux TLBackup», à la page 153 «Extracteur de la base de données de isiteurs», à la page 154 «Configuration des traaux TLI», à la page 154 «Configuration des traaux des statuts Tealeaf», à la page 156 <JobDefinitions> <!-- Aailable repeat commands: RepeatEery5Cmd - runs eery 5 minutes RepeatEery10Cmd - runs eery 10 minutes RepeatEery15Cmd - runs eery 15 minutes RepeatEery30Cmd - runs eery 30 minutes RepeatEery60Cmd - runs eery 60 minutes RepeatDailyCmd - runs eery day at a set time. --> <!-- Run TealeafStatus eery 15 minutes --> <Job Enable="False" Name="TealeafStatus" RunType="RepeatEery15Cmd" DailyStartTime="" CmdString="tools\TealeafStatus.exe" /> Chapitre 2. Configuration des composants Tealeaf 151

162 <!-- Run Cycle Serices at 00:30 AM eery day --> <Job Enable="True" Name="Cycle" RunType="RepeatDailyCmd" DailyStartTime="00:30" CmdString="tools\TLBackup.exe -C" /> <!-- Run Extractor for Visitor DB eery 15 minutes --> <Job Enable="False" Name="VisitorDBExtract" RunType="RepeatEery15Cmd" DailyStartTime="" CmdString="Reporting\TLExtractorVDB.exe" /> <!-- Run TLManageTLI to trim any TLI files old than 31 days, runs at 02:30 AM eery day --> <Job Enable="False" Name="TLI_Trim" RunType="RepeatDailyCmd" DailyStartTime="02:30" CmdString="tools\TLManageTLI.exe -serer serername -trim -days 31" /> <!-- Run TLManageTLI to merge preious days TLI file, runs at 02:30 AM eery day --> <Job Enable="False" Name="TLI_Merge" RunType="RepeatDailyCmd" DailyStartTime="02:30" CmdString="tools\TLManageTLI.exe -serer serername -merge" /> </JobDefinitions> Propriétés de traail : Pour chaque définition de traail, les propriétés suiantes doient être spécifiées : Propriété Description Actier Pour actier le traail, spécifiez la aleur true. Nom Le nom du traail doit être unique dans l'ensemble des définitions de traaux. Type d exécution Définit la fréquence à laquelle le traail est exécuté. Voir «Types d'exécution». DailyStartTime Si le traail est exécuté pour être exécuté une fois par jour, cette aleur définit l'heure de début du traail au format hh:mm. Par exemple, un traail 00:30 est exécuté à 0h30. CmdString Cette aleur correspond à la commande exécutée sur la ligne de commande par le serice de planification à l'heure planifiée. Remarque : Les noms de chemin sont relatifs au répertoire d'installation de Tealeaf. Vous ne pouez pas utiliser de ariables d'enironnement dans les noms de chemin. Types d'exécution : Dans la partie supérieure du fichier, les commandes de configuration de la fréquence d'exécution des traaux sont répertoriées. Remarque : Eitez de modifier la fréquence des traaux des configurations de traaux par défaut. La modification de la fréquence de ces traaux peut affecter le comportement et les performances du système Tealeaf. Remarque : Ne planifiez pas les traaux de sorte qu'ils soient exécutés plus fréquemment que toutes les quinze minutes, sauf instruction contraire de Tealeaf. Commande Description 152 IBM Tealeaf CX - Guide de configuration

163 RepeatEery5Cmd Est exécuté toutes les 5 minutes. RepeatEery10Cmd Est exécuté toutes les 10 minutes. RepeatEery15Cmd Est exécuté toutes les 15 minutes. RepeatEery30Cmd Est exécuté toutes les 30 minutes. RepeatEery60Cmd Est exécuté toutes les 60 minutes. RepeatDailyCmd Est exécuté tous les jours à une heure définie. Ce serice ne peut pas être utilisé pour la planification de traaux non répétitifs. Pour planifier un traail à n'exécuter qu'une seule fois, affectez à la commande repeat la aleur RepeatDailyCmd et désactiez le traail une fois qu'il a été exécuté. Il n'est possible d'exécuter qu'un seul traail planifié à la fois. Si l'exécution d'un traail planifié cheauche l'heure de début d'un autre traail, le deuxième traail est exécuté après le premier. Configuration des traaux TLBackup Le traail TLBackup peut exécuter l'utilitaire de sauegarde de Tealeaf, qui peut effectuer l'un des traaux suiants : Sauegarde partielle Sauegarde intégrale Défilement de tous les serices Tealeaf Remarque : Par défaut, le traail nocturne de défilement des serices est actié et configuré pour être exécuté à 0h30. Tealeaf recommande que le traail par défaut de défilement des serices soit actié et exécuté une fois par jour. Des options de configuration supplémentaires sont disponibles par l'intermédiaire du fichier de configuration de TLBackup. La restauration à partir de la sauegarde requiert un utilitaire distinct. Voir "TLBackup et TLRestore" dans le document IBM Tealeaf cximpact - Guide d'administration. Pour actier le traail TLBackup : Le traail du serice de planification par défaut (Name="Cycle") est configuré pour exécuter un traail de défilement des serices afin de redémarrer tous les serices Tealeaf à 0h30. Effectuez les étapes ci-après pour érifier cette configuration. 1. Ourez le fichier TlSchedulersccfg.xml. 2. Pour le traail Name="Cycle" : a. Définissez Actier sur true. b. Il n'est pas recommandé de modifier le paramètre RunType. Voir «Types d'exécution», à la page 152. c. Si RunType="RepeatDailyCmd", ous deez configurer l'heure de début. Les heures sont spécifiées au format 24 heures. Par exemple, le traail ci-après est exécuté à 0h30, au fuseau horaire de Tealeaf. DailyStartTime="00:30" Chapitre 2. Configuration des composants Tealeaf 153

164 154 IBM Tealeaf CX - Guide de configuration Pour plus d'informations sur les fuseaux horaires, oir "Configuration du fuseau horaire du système" dans le document IBM Tealeaf CX - Guide de configuration. d. Vérifiez que CmdString pointe ers TLBackup.exe dans le répertoire d'installation de Tealeaf. Le traail par défaut inclut les paramètres -C, qui fait défiler tous les serices Tealeaf. Pour plus d'informations sur les paramètres des autres types de traaux, oir "TLBackup et TLRestore" dans le document IBM Tealeaf cximpact - Guide d'administration. 3. Sauegardez le fichier. Aucun redémarrage n'est requis. 4. A l'heure préue, le traail planifié est exécuté. Voir "TLBackup et TLRestore" dans le document IBM Tealeaf cximpact - Guide d'administration. Extracteur de la base de données de isiteurs Le traail Extracteur de la base de données de isiteurs permet d'extraire les données de session des Canisters à long terme et de les insérer au format approprié dans la base de données de transfert d'ibm Tealeaf cxresults. Remarque : Si ous êtes en possession d'une licence IBM Tealeaf cxresults, ce traail doit être actié une fois que tous les logiciels ont été installés et que la connectiité à la base de données a été établie. IBM Tealeaf cxresults ne fonctionne pas tant que ce traail n'a pas été actié et qu'il n'est pas opérationnel. Pour actier le traail VDBExtractor : 1. Ourez le fichier TlSchedulersccfg.xml. 2. Pour le traail Name="VisitorDBExtract" : a. Définissez Actier sur true. b. Ne modifiez aucun autre paramètre. 3. Sauegardez le fichier. Aucun redémarrage n'est requis. 4. A l'heure préue, le traail planifié est exécuté. Configuration des traaux TLI A l'aide du Serice de planification, ous pouez configurer et actier des traaux pour élaguer et fusionner des fichiers TLI stockés sur le sereur TLI désigné. Un fichier TLI contient des objets de contenu statique capturés par Tealeaf et stockés dans des archies quotidiennes à des fins de relecture et de stockage à long terme. Voir "Gestion des archies statiques" dans le document IBM Tealeaf cximpact - Guide d'administration. Remarque : Aant de configurer des traaux TLI, ous deez désigner et actier un sereur Tealeaf comme sereur TLI. Voir "Gestion des archies statiques" dans le document IBM Tealeaf cximpact - Guide d'administration. Vous pouez érifier la capture correcte du contenu statique dans les archies ia RTV. Voir "Utilisation d'archies statiques dans RTV" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Remarque : Pour sauegarder des fichiers TLI aant des opérations d'élagage et de fusion, ajoutez le commutateur -backup à CmdString dans la spécification de traail. Aant d'exécuter le traail spécifié, les fichiers TLI affectés sont sauegardés dans le répertoire de sauegarde sur le sereur.

165 Configuration des traaux de compression TLI : Vous pouez configurer des traaux pour compresser le contenu du sereur TLI lorsque son ancienneté est antérieure à un nombre de jours spécifié. Les opérations de compression TLI compressent les fichiers.tli quotidiens du répertoire opérationnel et du répertoire de sauegarde. Le contenu est supprimé en fonction de l'horodatage modifié de chaque fichier.tli sur le sereur. Vous pouez examiner les fichiers.tli actuellement stockés sur le sereur TLI et notamment la date de leur dernière modification. Voir "Gestion des sereurs Tealeaf" dans le document IBM Tealeaf cximpact - Guide d'administration. Remarque : Vous deez configurer le traail de compression de sorte qu'il soit exécuté tous les jours. Remarque : Tealeaf prend en charge un sereur TLI dans l'enironnement. Les sereurs TLI multiples ne sont actuellement pas pris en charge. Pour plus d'informations sur la création d'un sereur TLI, oir "Gestion des sereurs Tealeaf" dans le document IBM Tealeaf cximpact - Guide d'administration. Pour actier le traail de compression TLI : 1. Ourez le fichier TlSchedulersccfg.xml. 2. Pour le traail Name="TLI_Trim" : a. Définissez Actier sur true. Remarque : Suiant l'espace de stockage disponible, ous pouez modifier le nombre de jours de données TLI conserées sur le sereur. Dans la aleur CmdString, affectez au paramètre -days le nombre de jours pendant lesquels les fichiers TLI doient être conserés. Tealeaf ous recommande d'utiliser les paramètres par défaut, jusqu'à ce que ous connaissiez bien le olume de contenu statique stocké quotidiennement. b. Remplacez la aleur de serername par le nom d'hôte du sereur TLI de otre enironnement. 3. Sauegardez le fichier. Aucun redémarrage n'est requis. 4. A l'heure préue, le traail planifié est exécuté. Configuration des traaux de fusion TLI : Par l'intermédiaire du portail, ous pouez gérer la fusion des fichiers.tli quotidiens dans le fichier mensuel, qui peut être extrait pour le stockage permanent. Lorsqu'ils sont exécutés quotidiennement, les traaux de fusion TLI enregistrent le contenu du fichier.tli du jour précédent dans le fichier mensuel et déplacent éentuellement le fichier source dans le répertoire de sauegarde de TLI. De cette manière, le contenu statique est agrégé pour être distribué à l'entrepôt de données permanent. Dans le cadre de l'opération de fusion, le portail tente d'associer les objets statiques du fichier quotidien aec les autres instances de l'objet dans le fichier mensuel à l'aide d'un composé unique de l'url de l'objet et d'un total de contrôle. En cas de correspondance, une simple référence à l'objet déjà enregistré dans le fichier mensuel est créée, au lieu d'ajouter une deuxième instance d'un objet identique. Vous pouez examiner les fichiers.tli actuellement stockés sur le sereur TLI et notamment la date de leur dernière modification. Voir "Gestion des sereurs Tealeaf" dans le document IBM Tealeaf cximpact - Guide d'administration. Chapitre 2. Configuration des composants Tealeaf 155

166 Une opération de fusion enregistre également le fichier TLI mensuel lorsqu'il est exécuté après le début du noueau mois. Remarque : Vous deez configurer le traail de fusion de sorte qu'il soit exécuté tous les jours. Remarque : Une fois qu'un fichier.tli mensuel a été fermé, le fichier reste sur le sereur. Il est de la responsabilité du client de gérer les archies statiques.tli mensuelles. Pour actier le traail de fusion TLI : 1. Ourez le fichier TlSchedulersccfg.xml. 2. Pour le traail Name="TLI_Merge" : a. Définissez Actier sur true. b. La aleur de DailyStartTime doit correspondre à l'heure configurée pour le traail de compression. c. Remplacez la aleur de serername par le nom d'hôte du sereur TLI de otre enironnement. 3. Sauegardez le fichier. Aucun redémarrage n'est requis. 4. A l'heure préue, le traail planifié est exécuté. Configuration des traaux des statuts Tealeaf Actiation des traaux : Le traail Statut Tealeaf génère le rapport de statut Tealeaf selon des interalles spécifiés pour le distribuer par courrier électronique. Ce traail collecte les données des sereurs de l'enironnement Tealeaf sur leurs conditions de fonctionnement actuelles et les données capturées. Des ersions ad hoc du rapport de statut Tealeaf peuent être générées ia le portail pour être affichées dans une fenêtre de naigateur. Voir "Journaux du portail" dans le document IBM Tealeaf cximpact - Guide d'administration. Le rapport de statut de Tealeaf remplace le rapport de statut du portail deenu obsolète. Voir "Rapport de statut Tealeaf" dans le document IBM Tealeaf cximpact - Guide d'administration. Pour actier le traail Statut Tealeaf : 1. Connectez-ous au portail Tealeaf en tant qu'administrateur. 2. Dans le menu Portail, sélectionnez Tealeaf > TMS. Tealeaf Management System s'affiche. Voir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. 3. Cliquez sur l'onglet WorldView. Voir "Onglet TMS WorldView" dans le document IBM Tealeaf cximpact - Guide d'administration. 4. Dans le menu déroulant Afficher, sélectionnez Sereurs. 5. Cliquez sur le noeud Serice de planification. 6. Cliquez sur Scheduling Serice configuration. 7. Dans le panneau Actions de configuration, cliquez sur Afficher/Modifier. Le fichier TlSchedulersccfg.xml s'affiche. 8. Pour le traail Name="TealeafStatus" : a. Définissez Actier sur true. 156 IBM Tealeaf CX - Guide de configuration

167 b. Il n'est pas recommandé de modifier le paramètre RunType. Voir «Types d'exécution», à la page 152. c. TealeafStatus doit être configuré de sorte à être exécuté toutes les quinze minutes. Spécifiez RunType="RepeatEery15Cmd". d. Vérifiez que CmdString pointe ers TealeafStatus.exe, par rapport au répertoire d'installation de Tealeaf. Cette aleur doit être : Tools\TealeafStatus.exe 9. Enregistrez le fichier. 10. Enoyez les modifications de configuration à tous les sereurs de l'enironnement. Aucun redémarrage n'est requis. 11. A l'heure préue, le traail planifié est exécuté. Voir "Rapport de statut Tealeaf" dans le document IBM Tealeaf cximpact - Guide d'administration. Configuration du rapport de statut Tealeaf : Vous pouez configurer le rapport de statut Tealeaf pour qu'il affiche les messages INFO, AVERTISSEMENT et ERREUR en fonction des aleurs que ous spécifiez dans la configuration. Effectuez les étapes ci-après pour configurer otre rapport de statut Tealeaf. 1. Connectez-ous au portail Tealeaf en tant qu'administrateur. 2. Dans le menu Portail, sélectionnez Tealeaf > TMS. Tealeaf Management System s'affiche. Voir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. 3. Cliquez sur l'onglet WorldView. Voir "Onglet Vue globale de TMS" dans le manuel IBM Tealeaf cximpact - Guide d'administration. 4. Dans le menu déroulant Afficher, sélectionnez Sereurs. 5. Cliquez sur le noeud Serice de planification. 6. Cliquez sur Tealeaf Status configuration. 7. Dans le panneau Actions de configuration, cliquez sur Afficher/Modifier. Le fichier TealeafStatus.ini s'affiche. 8. Configurez chaque section du rapport de statut Tealeaf : «TealeafStatus», à la page 158 «DataSerice», à la page 158 «Courrier électronique», à la page 158 «PcaThresholds», à la page 159 «CanisterThresholds», à la page 159 «ReportThresholds», à la page 160 «IgnoreEentList», à la page 160 «NoErrorEentList», à la page 161 «NoErrorEentList», à la page 161 «RepeatEentList», à la page Enregistrez le fichier. 10. Enoyez les modifications de configuration à tous les sereurs de l'enironnement. Aucun redémarrage n'est requis. Les sections ci-après décrient les blocs de configuration indiiduels dans la configuration du statut Tealeaf. Chapitre 2. Configuration des composants Tealeaf 157

168 TealeafStatus : Paramètres de configuration généraux du rapport de statut Tealeaf. [TealeafStatus] CompanyName=myCompany GeneralReportTime=07:00 MinutesToBetweenErrorReport=180 BlackOutPeriod=00:15,00:45 WriteReportToFile=True ReportFileName=TealeafStatus.html Propriété Description CompanyName Nom de la société ou de l'enironnement pour lequel le rapport de statut Tealeaf est généré. GeneralReportTime Heure de génération du rapport au format 24 heures. MinutesToBetweenErrorReport Nombre de minutes entre les générations de rapports d'erreurs BlackOutPeriod Heures de début et de fin de la période d'interruption. La période d'interruption doit être configurée lors de la période de maintenance du système. WriteReportToFile Si la aleur est True, le rapport est enregistré dans le fichier ReportFileName. Remarque : WriteReportToFile doit être défini sur False pour générer des courriers électroniques sur le statut de Tealeaf. ReportFileName Nom de fichier du HTML dans lequel le rapport est enregistré, si cette option est actiée. DataSerice : Informations de connexion permettant de se connecter au serice de données Tealeaf. Voir "Configuration du serice de données Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration. [DataSerice] serer=sierra port=23000 Propriété Description sereur Identificateur du sereur qui héberge le serice de données Tealeaf. Voir "Configuration du serice de données Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration. port Numéro de port par l'intermédiaire duquel sont établies les communications aec le serice de données Tealeaf Courrier électronique : Paramètres de courrier électronique. Remarque : WriteReportToFile doit être défini sur False pour générer des courriers électroniques sur le statut de Tealeaf. 158 IBM Tealeaf CX - Guide de configuration

169 [ ] Subject=Tealeaf Status Propriété Description From Adresse électronique à partir de laquelle le rapport de statut Tealeaf est enoyé. To Liste séparée par des irgules des adresses électroniques des destinataires de la ersion courrier électronique du rapport de statut Tealeaf. Subject Ligne Objet du courrier électronique PcaThresholds : Définit les seuils d'ibm Tealeaf CX Passie Capture Application. Lorsque ces seuils sont dépassés, une erreur est indiquée dans le rapport Statut Tealeaf. Pour plus d'informations sur ces statistiques, oir "Console Web PCA - Onglet Statistiques" dans le document IBM Tealeaf Passie Capture Application - Guide. [PcaThresholds] MaxIdle=120 MaxCpu=75 MaxRestart=0 MaxCacheSSLMisses=10000 Propriété Description MaxIdle Délai d'inactiité maximal en secondes, après lequel le statut Tealeaf indique une PCA sans réponse MaxCpu Taux d'utilisation maximal de l'uc sous forme de pourcentage, au dessus duquel le statut Tealeaf signale une PCA surchargée MaxRestart Nombre maximal de redémarrages depuis le dernier rapport Statut Tealeaf, au dessus duquel le statut Tealeaf communique le décompte MaxCacheSSLMisses Lorsqu'un enregistrement de session SSL est reçu pour être déchiffré, une érification est effectuée pour oir si le cache contient les informations de l'algorithme de déchiffrement pour cette session. S'il ne les contient pas, l'enregistrement est considéré comme un échec en mémoire cache. Ces échecs peuent se produire lorsque Passie Capture a été redémarré et que le programme commence la capture de sessions SSL en cours, ou qu'il a dépassé la limite par défaut du nombre d'entrées de cache simultanées fixée à et que les entrées LRU ont été supprimées. CanisterThresholds : Seuils du Canister ou des Canisters Tealeaf sur le système. Pour plus d'informations sur ces statistiques, oir "Statut système" dans le document IBM Tealeaf cximpact - Guide d'administration. [CanisterThresholds] CanisterDiskPctFree=5 WaitToBeEal=20000 WaitToBeLongTermed=20000 UnEaluatedHits=10000 UnIndexedSessions=20000 MaxLssnDisplayCount=7 Chapitre 2. Configuration des composants Tealeaf 159

170 Propriété Description CanisterDiskPctFree Espace disque minimal sous forme de pourcentage, sous lequel le statut Tealeaf signale une erreur. WaitToBeEal Nombre maximal de sessions en attente d'éaluation, au-dessus duquel le statut Tealeaf signale une erreur. WaitToBeLongTermed Nombre maximal de sessions en attente de fermeture et de transfert ers le Canister à long terme sur disque, au-dessus duquel le statut Tealeaf signale une erreur. UnEaluatedHits Nombre maximal de hits non encore éalués, au-dessus duquel le statut Tealeaf signale une erreur. UnIndexedSessions Nombre maximal de sessions non encore indexées, au-dessus duquel le statut Tealeaf signale une erreur. MaxLssnDisplayCount Nombre maximal d'enregistrements LSSN mis à jour à afficher. Aucune limite supérieure ne s'applique à ce paramètre. ReportThresholds : Ces seuils concernent les actiités de la base de données de génération de rapports. [ReportThresholds] ReportInalidIndexDelay=86400 DefaultMaxInalidIndexPaths=12 Propriété Description ReportInalidIndexDelay Nombre maximal de secondes à attendre qu'un index non alide soit corrigé, une fois que l'erreur a été signalée DefaultMaxInalidIndexPaths Nombre maximal de chemins d'index non alides, au dessus duquel le statut Tealeaf signale une erreur. IgnoreEentList : Dans cette section, ous pouez configurer les éénements du journal des éénements d'application à ne pas inclure dans le rapport de statut Tealeaf. Eent_<n>=[EentSource],[Category],[EentID],[MessageType] Eent_1=TeaLeaf Report Serice,TeaLeafAlert,ALL,ALL Eent_2=TeaLeaf Eent Reporter,ALL,10241,ALL Eent_3=TeaLeaf Session Indexer,ALL,9833,INFO Propriété Description Property test <n> Nombre ; chaque nombre doit être unique 160 IBM Tealeaf CX - Guide de configuration

171 [EentSource] Nom de la source d'éénement [Category] Catégorie d'éénements ou ALL [EentID] Numéro de l'id éénement ou ALL [MessageType] Type d'éénement à inclure dans un rapport : ALL, ERROR, WARN et INFO NoErrorEentList : Les éénements du journal des éénements d'application peuent être spécifiés dans cette section si ous ne souhaitez pas qu'ils génèrent une erreur dans le rapport de statut Tealeaf. [NoErrorEentList] Eent_1=TeaLeaf Report Serice,TeaLeafRS,200,ERROR Eent_2=TeaLeaf Report Serice,TeaLeafRS,201,ERROR Eent_3=TeaLeaf Session Indexer,ALL,9845,ERROR Eent_4=TeaLeaf Session Indexer,ALL,9745,ERROR Eent_5=TeaLeaf Session Indexer,ALL,9753,ERROR Pour plus d'informations sur le format, oir «IgnoreEentList», à la page 160. RepeatEentList : Dans cette section, ous pouez répertorier les éénements du journal des éénements d'application qui ne doient être répertoriés qu'une seule fois. La configuration de cette section pour des éénements qui risquent de se répéter souent peut réduire considérablement la taille et l'encombrement de os rapports de statut Tealeaf. [RepeatEentList] Eent_1=TeaLeaf Alert Serice,TeaLeafAS,200,INFO Eent_2=TeaLeaf Alert Serice,TeaLeafAS,201,INFO Eent_3=TeaLeaf Session Indexer,Check,12553,INFO Eent_4=TeaLeaf Session Indexer,Control Prog,9834,INFO Eent_5=TeaLeaf Pipeline,All,16,WARN Pour plus d'informations sur le format, oir «IgnoreEentList», à la page 160. Configuration des traaux des statuts du portail Remarque : FONCTION OBSOLETE : Le rapport de statut du portail a été remplacé par le "rapport de statut Tealeaf" dans le document IBM Tealeaf cximpact - Guide d'administration, ce qui ne requiert aucune configuration supplémentaire. Pour les clients existants, la documentation de configuration ci-après est conserée. Il est probable qu'elle soit supprimée dans une prochaine ersion. Si ous utilisez le statut du portail, il ous est recommandé d'utiliser désormais le "rapport de statut Tealeaf" dans le document IBM Tealeaf cximpact - Guide d'administration. Pour plus d'informations, oir «Configuration des traaux des statuts Tealeaf», à la page 156. Le traail de statut du portail collecte un jeu de données utile et le distribue au portail Tealeaf pour l'examiner. Via le statut du portail, ous pouez sureiller les aspects critiques de la plateforme Tealeaf. Pour actier le traail Statut du portail : 1. Ourez le fichier TlSchedulersccfg.xml. 2. Pour le traail Name="Status" : a. Définissez Actier sur true. Chapitre 2. Configuration des composants Tealeaf 161

172 b. Il n'est pas recommandé de modifier le paramètre RunType. Voir «Types d'exécution», à la page 152. c. Si RunType="RepeatDailyCmd", ous deez configurer l'heure de début. Les heures sont spécifiées au format 24 heures. Par exemple, le traail ci-après est exécuté à 23h00, au fuseau horaire de Tealeaf. DailyStartTime="23:30" Pour plus d'informations sur les fuseaux horaires, oir "Configuration du fuseau horaire du système" dans le document IBM Tealeaf CX - Guide de configuration. d. Vérifiez que CmdString pointe ers PortalStatus.exe dans le répertoire d'installation de Tealeaf. 3. Sauegardez le fichier. Aucun redémarrage n'est requis. 4. A l'heure préue, le traail planifié est exécuté. Configuration de traaux supplémentaires Vous pouez spécifier des traaux supplémentaires en effectuant les étapes ci-après. Remarque : Vous deez spécifier l'ensemble de traaux minimal requis pour répondre à os besoins. En fonction du type de traail et du olume de données traité, ces traaux peuent aoir un impact sur les performances du système. Chaque fois que possible, ous deez configurer les traaux de sorte qu'ils soient exécutés pendant les heures creuses. 1. Copiez la spécification XML d'un traail similaire au traail que ous créez. 2. Remplacez la aleur de l'attribut Name par un noueau nom unique parmi les noms de traaux disponibles. 3. Spécifiez les autres propriétés. Remarque : Le traail doit être configuré de sorte à être exécuté à un moment différent de celui des autres traaux planifiés et actiés. 4. Sauegardez la configuration. Chapitre sur la configuration du serice d'extraction Le serice d'extraction Tealeaf est utilisé par les produits Tealeaf pour extraire les données de session des bases de données Tealeaf en ue de les conditionner et les distribuer aux systèmes tiers. Le serice d'extraction Tealeaf est utilisé par IBM Tealeaf cxconnect for Data Analysis et IBM Tealeaf cxverify lors des opérations normales et doit être actié et opérationnel pour pouoir être utilisé aec ces produits. Remarque : Les composants IBM Tealeaf cxconnect for Data Analysis et IBM Tealeaf cxverify font l'objet d'une licence à part de la plateforme IBM Tealeaf CX. Pour plus d'informations sur IBM Tealeaf cxconnect for Data Analysis, Contactez otre interlocuteur IBM Tealeaf. IBM Tealeaf cxverify n'est plus disponible comme noueau produit sous licence à partir de la ersion 8.7. Les clients disposant d'une licence de IBM Tealeaf cxverify dans la ersion 8.6 ou une ersion antérieure peuent continuer à utiliser le produit et à bénéficier de l'assistance technique associée, dans la ersion 8.7 et les ersions ultérieures. Pour plus d'informations, contactez Tealeaf Customer Support. 162 IBM Tealeaf CX - Guide de configuration

173 Lorsqu'une tâche IBM Tealeaf cxconnect for Data Analysis ou IBM Tealeaf cxverify est exécutée, la requête d'extraction des sessions spécifiées est préparée et distribuée au serice d'extraction Tealeaf, qui est chargé d'exécuter la requête et de renoyer les sessions au programme appelant. Configuration Vous pouez configurer le serice d'extraction ia TMS. Procédez comme suit pour configurer RTV : 1. Connectez-ous au portail Tealeaf en tant qu'administrateur. 2. Dans le menu Portail, sélectionnez Tealeaf > TMS. 3. Dans la ue Sereurs, cliquez sur Serice d'extraction. 4. Cliquez sur Configuration du serice d'extraction de Tealeaf. 5. Dans le panneau Actions de configuration, cliquez sur Afficher/Modifier. 6. Les paramètres ci-après peuent être modifiés. Voir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Paramètre Description ConcurrentJobs Nombre maximal de traaux IBM Tealeaf cxconnect for Data Analysis et IBM Tealeaf cxverify pouant être exécutés simultanément. La aleur par défaut est 1. DBThreads Nombre d'unités d'exécution de base de données utilisées par le serice d'extraction Tealeaf pour extraire des sessions. La aleur par défaut est 10. DeferTime Nombre de minutes pendant lequel le traail est retardé aant d'être réexécuté si les index de recherche de session ne sont pas disponibles. Les traaux peuent être exécutés jusqu'au nombre maximal de tentaties (MaxRetries) spécifié. La aleur par défaut est 60. DispReschdJobs Si la aleur est 1, les traaux IBM Tealeaf cxconnect for Data Analysis et IBM Tealeaf cxverify replanifiés sont affichés dans le portail Tealeaf. La aleur par défaut est 0. DisplayDays Nombre de jours pendant lequel un traail planifié IBM Tealeaf cxconnect for Data Analysis ou IBM Tealeaf cxverify doit être affiché dans le portail Tealeaf. La aleur par défaut est 7. Enable-TransactionLog Si sa aleur est True, cette option actie la consignation des transactions pour le serice d'extraction, ce qui permet à IBM Tealeaf cxconnect for Data Analysis de reprendre un traail là où il a été interrompu, si ce dernier échoue pour une raison ou une autre. ExtendedJobLog Si la aleur est 1, le serice d'extraction de Tealeaf enregistre un fichier journal étendu pour chaque traail, à des fins de débogage. Chapitre 2. Configuration des composants Tealeaf 163

174 La aleur par défaut est 1. ExtractorMode Paramètre d'installation. Ne modifiez pas ce paramètre. La aleur par défaut est 1. ExtractorSericePath Chemin d'accès au fichier TLExtractSerice.exe. Par défaut, l'exécutable de ce serice se troue dans le répertoire suiant : <répertoire_installation_tealeaf\dataextractor LogLeel Nieau de consignation su serice d'extraction Tealeaf (1-5). Remarque : Le nieau de consignation 5 est réseré à des fins de débogage. La aleur par défaut est 1. MaxErrors Nombre maximal d'erreurs admis aant qu'un traail n'échoue. La aleur par défaut est 5. MaxRetention Nombre maximal de jours de conseration d'un traail IBM Tealeaf cxconnect for Data Analysis ou IBM Tealeaf cxverify. La aleur par défaut est 5. MaxRetries Lorsqu'un traail IBM Tealeaf cxconnect for Data Analysis ou IBM Tealeaf cxverify échoue, ce paramètre spécifie le nombre maximal de tentaties effectuées par le serice d'extraction Tealeaf pour exécuter le traail aant que ce dernier ne soit considéré comme en échec. La aleur par défaut est 2. PassdueDays Nombre maximal de jours pendant lequel un traail arrié à expiration peut être extrait, aant d'échouer. SSThreads Nombre d'unités d'exécution du sereur de recherche utilisées par le serice d'extraction Tealeaf. La aleur par défaut est 10. Référence IBM Tealeaf cxconnect for Data Analysis : oir le chapitre concernant les tâches de configuration de cxconnect dans le document IBM Tealeaf cxconnect for Data Analysis Administration Manual. IBM Tealeaf cxverify : oir "Tâches de configuration de cxverify" dans le document IBM Tealeaf cxverify - Guide d'administration. 164 IBM Tealeaf CX - Guide de configuration

175 Chapitre 3. Configuration initiale de CX Une fois que ous aez correctement installé les logiciels PCA et Windows, ous pouez utiliser les étapes ci-après pour procéder à la configuration initiale de otre solution IBM Tealeaf CX. Vous pouez effectuer ces tâches de configuration suiant l'ordre que ous souhaitez. Toutefois, pour de meilleurs résultats, il est recommandé de les effectuer suiant l'ordre indiqué. Les étapes de configuration facultaties supplémentaires sont répertoriées ci-après. Sauegarde du modèle d'éénement Configuration de Tealeaf CX Aant d'apporter des modifications à os définitions d'objet d'éénement, ous pouez effectuer une sauegarde, qui pourra être utilisée pour restaurer otre modèle d'éénement à son état précédent. Voir "Sauegarde et restauration du modèle d'éénement" dans le document IBM Tealeaf cximpact - Guide d'administration. Remarque : Pour pouoir effectuer ces étapes, tous les logiciels Linux et Windows requis doient être installés sur l'ensemble des sereurs de l'enironnement Tealeaf. Voir "Installation de CX" dans le document IBM Tealeaf CX - Guide d'installation. Remarque : Cette séquence d'étapes fournit une structure de configuration de la solution IBM Tealeaf CX. Ces étapes doient être conciliées et ajustées aux spécificités de otre solution Tealeaf. Pour toutes questions, contactez Etapes de configuration initiales Configuration facultatie 1. "Configuration initiale de la PCA" dans le document IBM Tealeaf Passie Capture Application - Guide 2. «Configuration initiale de TMS», à la page «Configuration initiale du portail», à la page 166 Les étapes de configuration incluent la configuration d'ibm Tealeaf cxview. Pour plus d'informations sur IBM Tealeaf cxview, oir "cxview - Guide d'utilisation" dans le document IBM Tealeaf cxview - Guide d'utilisation. 4. «Configuration initiale du pipeline», à la page 231 Remarque : Pour des raisons de sécurité d'entreprise, il peut être important d'implémenter immédiatement des règles de confidentialité. Effectuez les étapes sur cette page pour toute implémentation. Configuration initiale des composants facultatifs : les pages ci-après décrient la configuration de plusieurs composants de la solution IBM Tealeaf CX dont la licence s'achète séparément. Contactez otre interlocuteur IBM Tealeaf. 1. "Configuration initiale de RTV" dans le document IBM Tealeaf CX - Guide de configuration Copyright IBM Corp. 1999,

176 RTV est installé à l'aide d'un programme d'installation distinct de celui d'ibm Tealeaf cximpact. Voir "Présentation de RealiTea Viewer" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation 2. "Configuration initiale de cxresults" dans le document IBM Tealeaf cxresults - Guide d'administration 3. "Configuration initiale de cxreeal" dans le document IBM Tealeaf cxreeal - Guide d'administration 4. "Configuration initiale de CX Mobile" dans le document IBM Tealeaf CX - Guide de configuration 5. "Configuration initiale de cxconnect" dans le document IBM Tealeaf CX - Guide de configuration IBM Tealeaf cxconnect for Data Analysis est installé à l'aide d'un programme d'installation distinct de celui d'ibm Tealeaf cximpact. Voir "Installation de cxconnect" dans le document IBM Tealeaf cxconnect for Data Analysis - Guide d'administration. 6. "Configuration initiale de cxverify" dans le document IBM Tealeaf CX - Guide de configuration Vérification de otre solution Tealeaf IBM Tealeaf cxverify est installé à l'aide d'un programme d'installation distinct de celui d'ibm Tealeaf cximpact. Voir "Installation de cxverify" dans le document IBM Tealeaf cxverify - Guide d'administration. Une fois que ous aez terminé l'installation et la configuration initiale de chaque composant de otre solution Tealeaf, ous deez érifier les opérations de tous les composants majeurs. Configuration initiale du portail Voir "Test de otre solution Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration. Remarque : cette section fournit un cadre pour la configuration initiale d'un composant du système IBM Tealeaf CX ia un modèle de déploiement simplifié. En fonction du déploiement de otre solution Tealeaf, une configuration supplémentaire peut être requise. Pour toute question concernant la configuration, contactez Une fois que ous ous êtes connecté au portail pour la première fois, effectuez les tâches répertoriées dans cette section pour effectuer la configuration de base du produit IBM Tealeaf cximpact. Annonces du portail Aec chaque installation ou mise à nieau, il est recommandé de créer une annonce de portail à présenter aux utilisateurs pour leur indiquer la phase actuelle de la machine et son état et leur signaler les éentuels problèmes qui pourraient aoir un impact sur les utilisateurs Tealeaf. Voici des exemples de message : Phase : Etude de faisabilité Phase : Etude de faisabilité Etat : Fonctionnel Remarques : Ce système n est destiné qu à montrer les fonctionnalités de Tealeaf. Il ne doit pas être utilisé pour des fonctions autres que la démonstration des fonctionnalités du système. 166 IBM Tealeaf CX - Guide de configuration

177 Pour plus d informations, contactez otre administrateur Tealeaf. Dans le menu Portail, sélectionnez Aide > Contacter un administrateur Tealeaf. Phase : Déeloppement Phase : Déeloppement Etat : Fonctionnel Remarques : Ce système est en construction. Les utilisateurs peuent rencontrer des problèmes lors de l utilisation du système. Pour plus d informations, contactez otre administrateur Tealeaf. Dans le menu Portail, sélectionnez Aide > Contacter un administrateur Tealeaf. Phase : Transfert Phase : Transfert Etat : Fonctionnel Remarques : Ce système est en cours de test pour la ersion de production. Signalez les éentuels problèmes. Pour plus d informations, contactez otre administrateur Tealeaf. Dans le menu Portail, sélectionnez Aide > Contacter un administrateur Tealeaf. Phase : Production Remarque : Pour la plupart des enironnements de production, une annonce de portail n'est pas nécessaire. Si ous en créez une à l'aide du modèle ci-dessus, elle doit arrier à expiration à quelques jours du lancement de l'enironnement de production. Pour plus d'informations sur la configuration et l'actiation des annonces de portail, oir "Annonces du portail" dans le document IBM Tealeaf cximpact - Guide d'administration. Configuration du fuseau horaire du système Tealeaf Le fuseau horaire du système Tealeaf est utilisé par tous les sereurs Tealeaf pour synchroniser dierses tâches. Lors de la procédure d'installation, ce paramètre à l'échelle du système doit être défini et appliqué à chaque sereur de l'enironnement. Voir «Configuration du fuseau horaire du système», à la page 13. Paramètres diers Dans le panneau Paramètres diers, ous pouez définir de nombreux paramètres et notamment les informations de contact de l'administrateur Tealeaf. Voir "Paramètres CX" dans le manuel IBM Tealeaf cximpact - Guide d'administration. Configuration du sereur Chapitre sur l'authentification A ce stade, ous pouez configurer la méthode d'authentification utilisée par le portail Tealeaf et les autres serices. Le sereur de recherche doit connaître le mode d'authentification utilisé. Voir «Chapitre sur la configuration du sereur de recherche», à la page 107. Pour des informations générales sur les méthodes d'authentification, oir "Authentification" dans le document IBM Tealeaf cximpact - Guide d'administration. Chapitre 3. Configuration initiale de CX 167

178 Configuration des aleurs de référence des machines Lors de la procédure d'installation, les aleurs de référence des machines hébergeant les serices et sereurs Tealeaf sont insérées dans la base de données pour être utilisées par le portail. Les sections ci-après décrient les aleurs recommandées en fonction de otre scénario de déploiement. Remarques générales : Pour le sereur de recherche, le paramètre Sereur de portail de toutes les machines sur lesquelles le sereur de recherche est installé doit pointer ers la machine sur laquelle le portail est installé. Ce paramètre doit être ide sur la machine du portail. Toutefois, si le serice de données est exécuté sur la machine des rapports, le sereur de portail de tous les sereurs de recherche doit pointer sur la machine des rapports. Déploiement - Tout en un : Page Gestion du portail : Nom du sereur Valeur recommandée Sereur de rapports Nom de la machine actuelle (différent de localhost) Serice de données Nom de la machine actuelle (différent de localhost) Ces aleurs peuent être examinées et modifiées par l'intermédiaire de la page Gestion du portail. Voir "Gestion des sereurs Tealeaf" dans le document IBM Tealeaf cximpact - Guide d'administration. Configuration du sereur de recherche : Nom du sereur Valeur recommandée Sereur du portail Laisser ide Serice de données Nom de la machine actuelle (différent de localhost) Ces aleurs peuent être examinées et modifiées par l'intermédiaire de la configuration du sereur de recherche. Voir «Chapitre sur la configuration du sereur de recherche», à la page 107. Déploiement - Sereurs multiples : Dans un déploiement standard sur plusieurs systèmes, les sereurs Windows sont configurés comme suit : 1 portail et une machine de génération de rapports 1 ou plusieurs machines sereur de traitement (Canister(s)) Portail et machine de génération de rapports : Page Gestion du portail : Nom du sereur Valeur recommandée Sereur de rapports Nom de la machine actuelle (différent de localhost) Serice de données Nom de la machine actuelle (différent de localhost) 168 IBM Tealeaf CX - Guide de configuration

179 Ces aleurs peuent être examinées et modifiées par l'intermédiaire de la page Gestion du portail. Voir "Gestion des sereurs Tealeaf" dans le document IBM Tealeaf cximpact - Guide d'administration. Configuration du sereur de recherche : Remarque : Si le sereur de portail et le sereur de rapports sont installés sur des machines distinctes, dans la configuration du sereur de recherche, la zone Sereur de portail doit contenir le nom du sereur de rapports pour tous les Canisters. Sur le sereur de portail et le sereur de rapports, laissez cette zone ide. Nom du sereur Valeur recommandée Sereur du portail Laisser ide Serice de données Nom de la machine actuelle (différent de localhost) Sereur d'alerte Si cette aleur n'est pas spécifiée, l'emplacement du sereur de portail est utilisé. Ces aleurs peuent être examinées et modifiées par l'intermédiaire de la configuration du sereur de recherche. Voir «Chapitre sur la configuration du sereur de recherche», à la page 107. Canister(s) : Configuration du sereur de recherche : Nom du sereur Valeur recommandée Sereur du portail Nom de la machine du portail serice de données Nom de la machine du portail Ces aleurs peuent être examinées et modifiées par l'intermédiaire de la configuration du sereur de recherche. Voir «Chapitre sur la configuration du sereur de recherche», à la page 107. Déploiement - Sereurs multiples aec portail et sereur de rapports sur des machines différentes : Dans la plupart des déploiements, l'application de portail et le sereur de rapports sont installés sur la même machine. Toutefois, lors de l'installation initiale, ous pouez choisir d'installer ces deux composants sur des machines différentes. Si le sereur de rapports est installé sur une machine distincte, le paramètre de l'alias du sereur de recherche doit pointer ers la machine de génération de rapports. Machine du portail : Page Gestion du portail : Nom du sereur Valeur recommandée Sereur de rapports Nom de la machine de génération des rapports Serice de données Nom de la machine de génération des rapports Chapitre 3. Configuration initiale de CX 169

180 Ces aleurs peuent être examinées et modifiées par l'intermédiaire de la page Gestion du portail. Voir "Gestion des sereurs Tealeaf" dans le document IBM Tealeaf cximpact - Guide d'administration. Configuration du sereur de recherche : Nom du sereur Valeur recommandée Sereur du portail Laisser ide Serice de données Nom de la machine de génération des rapports Ces aleurs peuent être examinées et modifiées par l'intermédiaire de la configuration du sereur de recherche. Voir «Chapitre sur la configuration du sereur de recherche», à la page 107. Machine de génération de rapports : Configuration du sereur de recherche : Nom du sereur Valeur recommandée Sereur du portail Laisser ide Serice de données Nom de la machine actuelle (différent de localhost) Ces aleurs peuent être examinées et modifiées par l'intermédiaire de la configuration du sereur de recherche. Voir «Chapitre sur la configuration du sereur de recherche», à la page 107. Canister(s) : Configuration du sereur de recherche : Nom du sereur Valeur recommandée Sereur du portail Nom de la machine de génération des rapports serice de données Nom de la machine de génération des rapports Ces aleurs peuent être examinées et modifiées par l'intermédiaire de la configuration du sereur de recherche. Voir «Chapitre sur la configuration du sereur de recherche», à la page 107. Serice d'alerte : Le portail suppose que la machine configurée pour être le sereur de rapports dans le portail est celle sur laquelle le serice d'alerte est exécuté. Le serice d'alerte doit être actif sur cette machine. Voir «Configuration du serice d'alerte», à la page 145. Ajout de sereurs Si l'enironnement contient d'autres sereurs Tealeaf, le portail doit en être conscient. Voir "Gestion des sereurs Tealeaf" dans le document IBM Tealeaf cximpact - Guide d'administration. Serice de données Tealeaf Le serice de données Tealeaf établit des connexions entre les serices et sereurs Tealeaf et les bases de données qu'ils utilisent. En fonction de otre déploiement, il 170 IBM Tealeaf CX - Guide de configuration

181 se peut que ous deiez configurer les références du serice de données Tealeaf dans la configuration du sereur de recherche. Voir "Configuration du serice de données Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration. Pour plus d'informations sur la configuration du sereur de recherche, oir «Chapitre sur la configuration du sereur de recherche», à la page 107. Administration des utilisateurs CX Configuration des utilisateurs et des groupes cximpact Une fois que ous aez configuré les paramètres d'application, ous pouez configurer les paramètres des utilisateurs et des groupes IBM Tealeaf cximpact. Pour érifier les utilisateurs IBM Tealeaf cximpact actuellement connectés, cliquez sur le lien Utilisateurs actuels dans la sous-fenêtre de naigation de gauche de la page Gestion du portail. Voir "Administration des utilisateurs CX" dans le document IBM Tealeaf cximpact - Guide d'administration. Pour les utilisateurs IBM Tealeaf cximpact, les droits d'accès sont définis comme sur-ensemble de tous les droits d'accès des groupes dont ils sont membres. Les paramètres de nieau groupe des utilisateurs IBM Tealeaf cximpact sont hérités du groupe principal de l'utilisateur. Lorsque ous définissez des droits d'accès pour des utilisateurs IBM Tealeaf cximpact, ous deez d'abord les affecter au nieau groupe, puis apporter des ajustements pour des utilisateurs indiiduels. Si IBM Tealeaf cximpact est installé, deux groupes d'utilisateurs sont automatiquement créés : Groupe admin : administrateurs IBM Tealeaf cximpact. ADMIN : compte administrateur IBM Tealeaf cximpact par défaut. Utilisateur de portail : utilisateurs IBM Tealeaf cximpact. Aucun compte utilisateur de portail par défaut n'est créé. Configuration du compte ADMIN : Le compte ADMIN est le compte maître du portail Tealeaf. Aant de configurer les autres comptes du système, ous deez configurer ce compte. Pour configurer le compteadmin, cliquez sur le lien Administration des utilisateurs IBM Tealeaf CX dans le panneau de naigation de gauche. Cliquez sur Utilisateurs. Sélectionnez ensuite ADMIN. Les paramètres du compte sont affichés. Examinez les éléments suiants : Paramètre Description Nom d utilisateur Par défaut, ce nom d'utilisateur de compte est défini sur ADMIN. Remarque : Il n'est pas possible de renommer ce compte. Nom d utilisateur NT Si ous utilisez l'authentification NT, entrez le nom d'utilisateur du domaine NT de ce compte. Pour plus d'informations sur l'authentification NT, oir "Authentification" dans le document IBM Tealeaf cximpact - Guide d'administration. Domaine NT Si ous utilisez l'authentification NT, entrez le domaine NT de ce compte. Chapitre 3. Configuration initiale de CX 171

182 172 IBM Tealeaf CX - Guide de configuration Pour plus d'informations sur l'authentification NT, oir "Authentification" dans le document IBM Tealeaf cximpact - Guide d'administration. Entrez une adresse électronique alide pour l'administrateur Tealeaf qui gère IBM Tealeaf cximpact. Fuseau horaire (utilisé dans la recherche) Sélectionnez le fuseau horaire préféré de l'administrateur. Lors de l'affichage de données de session, les informations sur la date et l'heure sont conerties dans le fuseau horaire configuré. Il s'agit par défaut du Groupe principal par défaut. L'administrateur peut ensuite ajuster ce paramètre en sélectionnant un autre fuseau horaire parmi ceux disponibles. Enironnement local du système Sélectionnez le paramètre d'enironnement local du système pour configurer le portail Tealeaf de sorte qu'il utilise les paramètres d'enironnement local régionaux pour l'administrateur. Le paramètre d'enironnement local du système définit la manière dont la deise, les aleurs numériques, la date et l'heure sont formatées et affichées. Au nieau utilisateur, il s'agit par défaut du Groupe principal par défaut. L'administrateur peut ensuite ajuster ce paramètre en sélectionnant un autre enironnement local de système parmi ceux disponibles. Format de date Sélectionnez le format, tel que mm/jj/aaaa, dans la liste déroulante. Au nieau utilisateur, le format de date de l'administrateur utilise par défaut le Groupe principal par défaut, à saoir, le format de date du groupe Admin. Au nieau groupe, le format de date du groupe Admin utilise par défaut le format de date de l'enironnement local de système sélectionné par le groupe Admin. Toutefois, l'administrateur peut remplacer le format de date Groupe principal par défaut par Utiliser l'enironnement local du système (par défaut) pour appliquer le paramètre Enironnement local du système sélectionné au format de date. Vous pouez également sélectionner un format de date spécifique dans la liste des formats disponibles. Menu de naigation du portail Ce compte doit aoir accès à toutes les options de menu du portail Tealeaf. Vous pouez conserer la aleur par défaut. Groupe principal d utilisateurs Le groupe d'utilisateurs principale de ce compte doit être le Groupe Admin (aleur par défaut). Modification du mot de passe ADMIN : A ce stade, il est recommandé de modifier le mot de passe du compte ADMIN. Sélectionnez le compte ADMIN et cliquez sur Mot de passe. Entrez le noueau mot de passe et cliquez sur Sauegarder. Configuration des groupes : Initialement, ces deux groupes disposent des mêmes droits, excepté pour la page d'accueil par défaut. Les administrateurs IBM Tealeaf cximpact démarrent sur la page Gestion du portail par défaut, tandis que les utilisateurs IBM Tealeaf cximpact démarrent sur la page du modèle de recherche par défaut. Pour chaque groupe, ous deez au moins examiner les paramètres suiants :

183 Paramètre Description Expiration de mot de passe par défaut Nombre de jours pendant lesquels un mot de passe peut être utilisé aant que tous les membres du groupe doient en choisir un noueau. Période d aertissement d expiration de mot de passe Nombre de jours aant expiration du mot de passe à partir desquels un utilisateur commence à receoir des messages d'aertissement du portail pour qu'il modifie le mot de passe aant que ce dernier n'arrie à expiration. Menu de naigation du portail par défaut Si la aleur Désactier est spécifiée, les membres de ce groupe ne peuent pas oir le menu de naigation du portail de nieau supérieur et ne peuent accéder qu'aux pages du portail disponibles ia leur page par défaut définie. Déconnecter par défaut l utilisateur s il est inactif Si la aleur Actier est spécifiée, les membres de ce groupe sont automatiquement déconnectés du portail si leur compte est inactif pendant une période spécifiée. Vous pouez modifier le paramètre du délai d'inactiité. Voir «Chapitre sur la configuration du sereur de rapports», à la page 61. Bloquer par défaut le mode relecture Si la aleur Désactier est spécifiée, les membres de ce groupe ne peuent pas modifier leur Mode de relecture. Mode relecture par défaut Définit le mode de relecture du groupe. Si les membres de ce groupe n'ont pas accès à l'application IBM Tealeaf CX RealiTea Viewer, définissez cette aleur sur BBR, qui est une application de relecture Web. Modèle de recherche par défaut Vous pouez sélectionner le modèle de recherche par défaut à afficher aux membres de ce groupe à partir du menu déroulant. En outre, ous deez examiner les options disponibles en sélectionnant chacun des boutons suiants dans la partie supérieure de la sous-fenêtre des paramètres : Affecter les utilisateurs : pour affecter un utilisateur au groupe sélectionné, cochez la case Affecté et cliquez sur Sauegarder. Profil de menu : sélectionnez des options dans l'arborescence des menus pour définir les pages auxquelles les membres de ce groupe peuent accéder. Les paramètres par défaut des groupes IBM Tealeaf cximpact doient offrir un accès approprié. Remarque : Par défaut, le groupe des administrateurs IBM Tealeaf cximpact dispose de permissions de menu supplémentaires pour afficher les rapports de sureillance, tels que les rapports d'actiités et le statut actif, qui peuent être utilisés pour érifier le statut du système et diagnostiquer les problèmes signalés par les membres du groupe des utilisateurs. Profil d'administration : ous pouez sélectionner les zones de la page Gestion du portail auxquelles les membres du groupe ont accès. Remarque : Le groupe doit aoir la page Gestion du portail dans son profil de menu. L'accès à ces zones doit être réseré aux groupes d'administrateurs. Chapitre 3. Configuration initiale de CX 173

184 Profil de recherche le profil de recherche définit les options disponibles pour les membres de ce groupe dans la page Recherche, ainsi que les modèles de recherche spécifiques auxquels ils peuent accéder. Profil de relecture du naigateur : pour les groupes ayant accès à la relecture basée sur un naigateur, ce profil contrôle les actions et les droits disponibles pour les membres du groupe lorsqu'ils utilisent BBR. Une fois que ous aez configuré les paramètres de nieau groupe, ous pouez apporter des ajustements aux comptes utilisateur indiiduels. Pour afficher les paramètres utilisateur, cliquez sur le lien Utilisateurs dans la sous-fenêtre de naigation de gauche, sous Administration des utilisateurs IBM Tealeaf CX. Voir "Administration des utilisateurs CX" dans le document IBM Tealeaf cximpact - Guide d'administration. Configuration de rapport Vous pouez également définir et configurer des rapports à utiliser dans le système. Pour plus d'informations sur la configuration des rapports, oir "Configuration de rapport" dans le document IBM Tealeaf cximpact - Guide d'administration. Les tableaux d'analyse sont utilisés pour communiquer sous forme de graphiques ou de tableaux des mesures utiles sur les données capturées par Tealeaf. Pour plus d'informations sur la configuration des tableaux d'analyse, oir "Configuration de tableaux d'analyse" dans le document IBM Tealeaf cxview - Guide d'utilisation. Les tableaux de bord peuent être utilisés pour organiser plusieurs composants de génération de rapports dans une même page. Pour plus d'informations sur la configuration des tableaux de bord, oir "Configuration des tableaux de bord" dans le document IBM Tealeaf cxview - Guide d'utilisation. Le rapport Statut Tealeaf offre des informations de statut sur les composants du système Tealeaf. Pour plus d'informations sur la configuration du rapport Statut Tealeaf, oir "Rapport de statut Tealeaf" dans le document IBM Tealeaf cximpact - Guide d'administration. Les modèles de recherche et de liste peuent être configurés afin d'actier des zones de recherche spécifiques pour des groupes spécifiés. Pour plus d'informations sur la configuration des modèles de recherche, oir "Configuration des modèles de recherche" dans le document IBM Tealeaf cximpact - Guide d'administration. Remarque : Si le nombre de jours de conseration des données horaires de rapport sur les éénements est modifié, les rapports risquent de ne pas afficher les données actuelles aant que le système ne soit normalisé. Test de otre configuration Après aoir terminé la configuration initiale, ous pouez effectuer les étapes suiantes afin de la érifier. Un ensemble plus complet de tests peut être exécuté une fois que tous les composants Tealeaf ont été configurés. Voir "Test de otre solution Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration. 1. Testez un compte utilisateur IBM Tealeaf cximpact : une fois que ous aez configuré les paramètres des utilisateurs et des groupes, ous deez créer un exemple d'utilisateur pour chaque groupe et tester l'accès aux menus, son modèle de recherche par défaut et les fonctions de relecture. a. Vérifiez un compte correspondant à un utilisateur de base du portail. 174 IBM Tealeaf CX - Guide de configuration

185 b. Essayez de rechercher des données de session. Voir "Recherche de données de session" dans le document IBM Tealeaf cximpact - Guide d'utilisation. Si ous ne parenez pas à effectuer une recherche, il se peut que otre configuration d'authentification soit erronée. Voir "Authentification" dans le document IBM Tealeaf cximpact - Guide d'administration. c. Pour plus d'informations sur la relecture ia le portail, oir "Relecture sur naigateur CX" dans le document IBM Tealeaf cximpact - Guide d'utilisation. 2. Connectez-ous sous ADMIN : ous deez érifier que le compte ADMIN est correctement configuré. a. Connectez-ous à l'aide de ce compte et assurez-ous que toutes les options de menu sont disponibles. b. Si ous aez configuré les annonces de portail, sélectionnez Aide > Annonces du portail. c. Si ous aez configuré l'administrateur Tealeaf, sélectionnez Aide > Contacter un administrateur Tealeaf. 3. Exécutez les tests du portail : a. Dans le menu Portail, sélectionnez Aide > A propos du portail IBM Tealeaf CX. b. Dans le panneau Tests de performance du portail, cliquez sur le lien Exécuter tout. c. Une fois les tests terminés, un message Succès ou une aleur temporelle doit être affiché dans la colonne Résultats. Ces messages indiquent que le portail est opérationnel et qu'il peut communiquer aec ses structures de composants requises et la base de données Tealeaf. 4. Générez le rapport Statut Tealeaf : le rapport Statut Tealeaf peut être configuré pour fournir des informations de statut utiles à partir des bases de données, des sereurs et des composants Tealeaf, y compris IBM Tealeaf CX Passie Capture Application. Le portail ous permet de générer l'un de ces rapports. a. Pour exécuter le statut Tealeaf, sélectionnez Aide > Gestion du portail. b. Dans la page Gestion du portail, cliquez sur la section Journaux dans le panneau de naigation de gauche. c. Sous l'en-tête Journaux, cliquez sur le lien Voir le statut de Tealeaf. d. Le rapport Statut Tealeaf est généré dans le portail. e. Recherchez les conditions d'erreur ou d'aertissement dans le rapport généré. 5. Examinez les journaux : a. Dans la page Gestion du portail sous l'en-tête Journaux, ous pouez regrouper les journaux Tealeaf en un fichier.zip en ue d'une réision externe. Cliquez sur le lien Journaux Tealeaf et fichiers de configuration. Sauegardez le fichier localement. b. Recherchez dans chacun des fichiers journaux zippés les entrées Erreur. 6. Vérifiez les sereurs Tealeaf : a. Dans le menu Portail, sélectionnez Tealeaf > Gestion du portail. b. Sous Sereurs Tealeaf, cliquez sur le lien Gérer les sereurs. c. Examinez la liste des sereurs disponibles. Pour chaque sereur, utilisez les boutons de la barre d'outils pour effectuer les opérations suiantes : 1) Enoyer une commande Ping au sereur. 2) Examiner le journal des éénements Windows. 3) Examiner les journaux Tealeaf. Chapitre 3. Configuration initiale de CX 175

186 Configuration initiale de TMS d. Vous deez afficher les sereurs inactifs pour érifier qu'aucun des sereurs répertoriés ne doie être actif. Une fois que tous les composants Tealeaf ont été configurés, ous deez effectuer un test de bout en bout. Voir "Test de otre solution Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration. Remarque : cette section fournit un cadre pour la configuration initiale d'un composant du système IBM Tealeaf CX ia un modèle de déploiement simplifié. En fonction du déploiement de otre solution Tealeaf, une configuration supplémentaire peut être requise. Pour toute question concernant la configuration, contactez Tealeaf Management System offre un point central unique à partir duquel ous pouez gérer tous les sereurs et les composants Tealeaf, ainsi que leur configuration. A l'aide de TMS, ous pouez définir les propriétés de composants Tealeaf indiiduels, puis planifier et exécuter des traaux pour insérer ces modifications de configuration sur tous les sereurs dépendants. Voir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. A l'aide de TMS, ous pouez définir, configurer et sureiller les pipelines Windows qui traitent les données de hit transmises d'ibm Tealeaf CX Passie Capture Application ers os sereurs de traitement afin de générer des rapports. Pour plus d'informations sur la définition et la configuration de pipelines Windows, oir "Editeur de pipeline TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. Pour plus d'informations sur la sureillance des pipelines Windows, oir "Onglet Statut du pipeline TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. TMS ous fournit également les moyens de gérer otre base de données Tealeaf, et notamment la sauegarde et l'importation, ainsi que l'exportation des rapports de configuration XML sur le contenu de TMS. Voir "Onglet Aancé de TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. Cette section fournit une séquence de tâches permettant d'effectuer la configuration initiale de Tealeaf Management System. Lisez les sections dans l'ordre indiqué afin d'effectuer les étapes nécessaires pour que TMS soit actif. Exemple d'architecture Cette section suppose le déploiement ci-après de otre solution Tealeaf. En fonction de otre déploiement Tealeaf, une configuration supplémentaire peut être requise. 1 sereur PCA : IBM Tealeaf CX Passie Capture Application gère la capture des demandes et des réponses transmises à partir de otre application Web et assemble ces dernières en données de session significaties qui pourront être utilisées par le reste du système Tealeaf. Remarque : Aant de procéder à la configuration de TMS, ous deez aoir installé et configuré au moins une instance d'ibm Tealeaf CX Passie Capture 176 IBM Tealeaf CX - Guide de configuration

187 Application sur un sereur Linux distinct. Voir "Configuration initiale de la PCA" dans le document IBM Tealeaf Passie Capture Application - Guide. 1 sereur HBR : Health-Based Routing (HBR) gère l'équilibrage de charge et la reprise en ligne dans les enironnements Tealeaf qui incluent plusieurs sereurs de Canister. Dans le cadre de cette configuration initiale, il est supposé que HBR a été déployé dans otre pipeline Windows et correctement configuré. Pour plus d'informations sur HBR, oir «Agent de session Health-Based Routing (HBR)», à la page sereurs de Canister : ces sereurs de Canister (ou sereurs de traitement) effectue le traitement essentiel des hits qu'ils reçoient et les enregistrent sur disque en ue de l'indexation et des recherches. 1 sereur de génération de rapports : le sereur de génération de rapports comprend l'interface Web du portail, le sereur de données et les bases de données IBM Tealeaf CX. Prérequis Remarque : TMS est généralement installé et hébergé sur le sereur de rapports. 1. Il est supposé que tous les logiciels Tealeaf ont été installés sur des sereurs Windows et Linux. Aant de commencer, installez tous les logiciels. Voir "Installation de CX" dans le document IBM Tealeaf CX - Guide d'installation. 2. En outre, ous deez déjà aoir effectué les étapes de configuration initiales des composants du produit IBM Tealeaf CX. Voir Chapitre 1, «Présentation de la configuration de CX», à la page 1. Prérequis de TMS Aant de commencer à utiliser TMS, ous deez effectuer les étapes suiantes : 1. Procurez-ous la dernière build de TMS pour otre ersion Tealeaf. Les logiciels Tealeaf peuent être téléchargés. Pour plus d'informations sur le téléchargement du logiciel Tealeaf, oir Tealeaf CX Downloads. 2. Affectez le sereur maître de TMS. Remarque : Dans presque tous les déploiements, le sereur maître de TMS doit être le sereur de portail, sauf si une contrainte impose de l'affecter à un autre sereur. Initialisation de TMS Les fichiers de configuration tels que TealeafCaptureSocket.cfg sont disponibles dans le répertoire d'installation de Tealeaf. Si des modifications sont apportées en dehors de TMS, le système peut ous demander ces modifications externes lorsque ous essayez d'éditer la configuration associée dans TMS. Remarque : Eitez d'éditer directement les fichiers de configuration Windows. Premier démarrage Si TMS est démarré pour la première fois, les étapes ci-après sont effectuées. 1. Sereur maître de TMS : a. Le magasin de données TMS est créé. b. Le dictionnaire de données est chargé à partir du fichier TMSManifest.dll. c. TMS effectue une reconnaissance des composants et des configurations sur le sereur maître de TMS. d. Le sereur maître de TMS commence à écouter les demandes. Chapitre 3. Configuration initiale de CX 177

188 2. Tous les sereurs esclae de TMS : a. Les sereurs esclae de TMS tentent de contacter le maître TMS. b. Si la tentatie de connexion échoue : 1) La tentatie de connexion est renouelée toutes les 10 secondes. 2) Une erreur est consignée toutes les cinq minutes jusqu'à ce que la connexion aboutisse. c. Le magasin de données TMS est créé. d. Le sereur esclae demande des données au sereur maître de TMS. e. TMS effectue une reconnaissance des composants et des configurations sur le sereur esclae de TMS. Les éléments nouellement reconnus sont acheminés au maître TMS pour mise à jour. f. Le sereur esclae commence à écouter les demandes. Démarrages suiants Une fois que TMS a été démarré pour la première fois, les démarrages ou redémarrages suiants de TMS génèrent les étapes suiantes : 1. Sereur maître de TMS : a. Le sereur maître de TMS recherche les mises à jour de dictionnaire de données dans le fichier TMSManifest.dll. b. TMS effectue une reconnaissance des composants et des configurations sur le sereur maître de TMS. c. Le sereur maître de TMS commence à écouter les demandes. 2. Tous les sereurs esclae de TMS : a. Les sereurs esclae de TMS tentent de contacter le maître TMS. b. Si la tentatie de connexion échoue : 1) La tentatie de connexion est renouelée toutes les 10 secondes. 2) Une erreur est consignée toutes les cinq minutes jusqu'à ce que la connexion aboutisse. c. Le magasin de données TMS est créé. d. Le sereur esclae demande des données au sereur maître de TMS. e. TMS effectue une reconnaissance des composants et des configurations sur le sereur esclae de TMS. Les éléments nouellement reconnus sont acheminés au maître TMS pour mise à jour. f. Le sereur esclae commence à écouter les demandes. Paramètres TMS Lorsque le portail deient disponible, ous deez ous y connecter et configurer le sereur maître TMS. Voir «Configuration initiale du portail», à la page Connectez-ous au portail Tealeaf en tant qu'administrateur. 2. Dans le menu Portail, sélectionnez Tealeaf > TMS. 3. Dans la ue Sereur, cliquez sur le noeud Sereur de gestion Tealeaf. 4. Cliquez sur Configuration du sereur de gestion Tealeaf. 5. Dans la sous-fenêtre Actions de configuration, cliquez sur Afficher/Modifier. 6. La configuration du sereur de gestion Tealeaf s'affiche : 178 IBM Tealeaf CX - Guide de configuration

189 Tableau 4. Paramètres TMS zone Description Valeur requise Nombre de jours de conseration des notifications Nieau de journal Port maître Sereur maître Nombre de jours de conseration des messages de notification. Nieau de journal pour l'enregistrement des messages dans le journal TMS. Numéro de port du sereur maître TMS à utiliser. Pour plus d'informations sur les ports utilisés par Tealeaf, oir "Liste de contrôle préinstallation CX" dans le document IBM Tealeaf CX - Guide d'installation. Entrez le nom du sereur correspondant au sereur maître TMS. Remarque : Lorsque ous spécifiez le sereur maître de TMS sur les sereurs esclae de TMS, utilisez le nom de machine résolable par le sereur de noms de domaine, que ous pouez acquérir en exécutant la commande hostname à partir de la ligne de commande Windows. Conserez la aleur par défaut pour le moment Conserez la aleur par défaut pour le moment La aleur par défaut est Ne modifiez cette aleur que si nécessaire. Spécifiez le nom de la machine. Si le sereur maître TMS est installé sur le sereur de portail, utilisez localhost. Remarque : Sauf cas de force majeure, le sereur de portail doit toujours être le maître TMS. L'utilisation d'un sereur autre que le maître TMS peut nécessiter une configuration et un traitement supplémentaires. Remarque : Il est recommandé d'effectuer d'abord l'installation sur le sereur, puis de lancer le sereur TMS. S'il se troue sur le sereur de portail, il n'est pas nécessaire de démarrer le portail. Vous pouez installer et démarrer les autres sereurs en premier ; ces sereurs interrogent le sereur maître de TMS jusqu'à ce qu'il soit en ligne. Pour plus d'informations sur ces paramètres, oir "Administration TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. Définition du maître des éénements Via TMS, ous pouez spécifier le sereur Tealeaf correspondant au sereur maître des éénements pour les sereurs d'éénements esclae. Le sereur maître des éénements tient à jour la copie de l'enregistrement des définitions d'éénement Tealeaf, dont les modifications sont publiées aux sereurs d'éénements esclae. Le maître des éénements est spécifié à l'aide de la configuration du sereur de recherche. Voir «Chapitre sur la configuration du sereur de recherche», à la page Connectez-ous au portail Tealeaf en tant qu'administrateur. 2. Dans le menu Portail, sélectionnez Tealeaf > TMS. 3. Dans l'onglet WorldView, sélectionnez Sereurs dans la liste déroulante. 4. Pour chaque sereur répertorié qui ne se troue pas sur le sereur maître des éénements : a. Dans la ue Sereur, cliquez sur le noeud Sereur de recherche. b. Cliquez sur Configuration du sereur de recherche. c. Dans la sous-fenêtre Actions de configuration, cliquez sur Afficher/Modifier. Chapitre 3. Configuration initiale de CX 179

190 d. La configuration du sereur de recherche s'affiche. e. Cliquez sur l'élément Sereur maître des éénements. f. Entrez le nom de machine du sereur maître des éénements. g. Cliquez sur Appliquer. h. Cliquez sur Sauegarder. 5. Répétez les étapes de configuration ci-dessus pour chaque sereur d'éénements esclae dans l'enironnement Tealeaf. Voir «Chapitre sur la configuration du sereur de recherche», à la page 107. Ajout de noueaux sereurs Lorsqu'un sereur est ajouté au système Tealeaf, il s'enregistre automatiquement auprès du maître TMS et télécharge ses données de configuration. Gestion de la configuration Vous pouez maintenant configurer TMS pour qu'il gère os configurations Tealeaf dans tous les composants Tealeaf de otre enironnement. Utilisation des mots clés Vous pouez affecter des mots clés à des configurations spécifiques, puis filtrer l'écran WorldView pour n'afficher que les éléments qui partagent le même mot clé. Par exemple, ous pouez affecter le mot clé SearchSerer à la configuration du sereur de recherche sur tous les sereurs Tealeaf. Voir "Onglet TMS WorldView" dans le document IBM Tealeaf cximpact - Guide d'administration. Partage de configurations A l'aide de TMS, ous pouez spécifier les éléments TMS de différents sereurs qui doient partager la même configuration. 1. Dans TMS WorldView, sélectionnez l'élément qui doit partager une configuration. 2. Dans la sous-fenêtre Actions de configuration, cliquez sur Affecter (partager). 3. Dans la boîte de dialogue, sélectionnez les éléments deant partager la même configuration. 4. Cliquez sur Affecter. 5. La prochaine fois qu'un traail d'enoi de configuration est exécuté, tous les sereurs sont mis à jour aec la configuration partagée la plus récente du maître TMS. Voir "Onglet TMS WorldView" dans le document IBM Tealeaf cximpact - Guide d'administration. Planification des traaux Via l'onglet Traaux TMS, ous pouez planifier l'exécution des traaux dont ous spécifiez les actions. Ces traaux peuent entre autres enoyer ou affecter une configuration ou arrêter ou redémarrer un composant. Voir "Onglet Traaux TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. Enoi de configurations : Une fois que ous aez spécifié tous les composants qui doient partager des configurations, ous pouez configurer un traail pour enoyer ces configurations aux sereurs et composants dépendants. Gestion des réisions Dans l'onglet TMS WorldView, ous pouez gérer les réisions des configurations de chaque configuration affichée. 180 IBM Tealeaf CX - Guide de configuration

191 Pour accéder à une ersion de configuration antérieure : 1. Dans l'onglet TMS WorldView, sélectionnez la configuration dont ous souhaitez examiner une ersion antérieure. 2. Dans le panneau Informations de configuration, sélectionnez la ersion de otre choix dans le menu déroulant Versions. 3. Cliquez sur Afficher/Modifier. 4. La ersion antérieure de la configuration est affichée. Remarque : Si ous sauegardez la configuration, elle est sauegardée comme une nouelle ersion du sereur sélectionné. Vous deez spécifier un traail d'enoi de la configuration pour que la ersion sauegardée deienne actie sur les sereurs. Pour plus d'informations sur les réisions, oir "Onglet TMS WorldView" dans le document IBM Tealeaf cximpact - Guide d'administration. Tâches de mise à jour Suiant otre solution Tealeaf, il se peut que ous deiez effectuer toutes les tâches ci-après ou certaines d'entre elles de manière régulière ia TMS. Edition de la confidentialité ia TMS La confidentialité Tealeaf permet de supprimer ou de masquer les données client sensibles qui font partie du flux de transactions Web. Pour plus d'informations sur la manière dont Tealeaf gère la confidentialité, oir "Gestion de la confidentialité des données dans Tealeaf CX" dans le document IBM Tealeaf CX - Guide d'installation. En général, il est recommandé d'appliquer les règles de confidentialité ia IBM Tealeaf CX Passie Capture Application. Toutefois, en fonction du olume de trafic Web, il se peut que ous deiez déplacer certains filtres de confidentialité dans le pipeline Windows. Pour plus d'informations sur la confidentialité de l'application PCA, oir "Console Web PCA - Onglet Règles" dans le document IBM Tealeaf Passie Capture Application - Guide. A mesure que otre application Web change dans le temps, il se peut que ous deiez mettre à jour les règles de confidentialité appliquées aux données de session qui transitent ia le pipeline Windows. Les étapes ci-après fournissent une approche générale de la gestion des mises à jour de confidentialité ia TMS. Remarque : Les règles de confidentialité doient être déeloppées sur des données de production. Au lieu de cela, ous deriez utiliser l'utilitaire Testeur de confidentialité autonome pour itérer os règles de confidentialité aant d'utiliser TMS pour les déployer dans le flux de données de production. Voir «Utilitaire Testeur de confidentialité», à la page 416. Lorsque ous êtes prêt à déployer les modifications apportées aux règles de confidentialité sur le flux de transactions de production, effectuez les étapes suiantes : 1. Dans l'onglet TMS WorldView, sélectionnez le noeud Serice de transport. Chapitre 3. Configuration initiale de CX 181

192 2. Si ous n'aez pas encore ajouté l'agent de session Confidentialité ou Confidentialité étendue à otre pipeline, ous pouez le faire maintenant. Voir "Editeur de pipeline TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. 3. Pour éditer des règles de confidentialité d'un agent de session existant, sous le noeud Serice de transport, cliquez sur Configuration du filtre de confidentialité. 4. Dans la sous-fenêtre Actions de configuration, cliquez sur Afficher/Modifier. 5. La boîte de dialogue Configuration du filtre de confidentialité s'affiche pour que ous puissiez créer ou éditer les règles, les tests et les actions à appliquer aux données transactionnelles transmises ia le filtre de confidentialité dans le pipeline Windows. Pour la documentation sur les règles de confidentialité, oir «Agent de session Confidentialité», à la page 307 et «Agent de session Confidentialité étendue», à la page Pour sauegarder les modifications, cliquez sur Sauegarder. 7. Définissez un traail d'enoi de la configuration pour affecter les modifications de configuration aux autres sereurs de traitement de l'enironnement Tealeaf. Voir "Onglet Traaux TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. Mise à jour de la clé de licence Lorsque ous mettez à nieau ou achetez sous licence de noueaux composants Tealeaf, il se peut que ous deiez entrer une nouelle clé de licence. Vous pouez utiliser les étapes ci-après pour modifier la clé de licence ia TMS sans aoir à ous connecter au sereur de portail. 1. Dans TMS WorldView, cliquez sur le noeud Tealeaf. 2. Cliquez sur Informations de configuration partagées. 3. Dans la sous-fenêtre Actions de configuration, cliquez sur Afficher/Modifier. 4. La configuration du sereur de rapports s'affiche. Cliquez sur l'onglet Portail. Voir «Chapitre sur la configuration du sereur de rapports», à la page Cliquez sur l'entrée Clé de licence du portail. 6. Entrez la nouelle clé de licence qui ous a été fournie par Tealeaf 7. Pour sauegarder la nouelle clé de licence, cliquez sur Sauegarder. 8. Dans l'onglet Traail TMS, configurez un noueau traail aec les actions suiantes : a. Un traail d'enoi de la configuration pour affecter la configuration à la machine qui héberge le sereur de portail b. Un traail de redémarrage du composant pour redémarrer le sereur de portail une fois que l'affectation a été exécutée. Cet traail effectue un redémarrage sur le sereur. Voir "Onglet Traaux TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. Test de otre configuration Une fois que tous les composants Tealeaf ont été configurés, ous deez effectuer un test de bout en bout. Voir "Test de otre solution Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration. 182 IBM Tealeaf CX - Guide de configuration

193 Configuration initiale de cxconnect Il est nécessaire de procéder à certaines configurations de otre déploiement IBM Tealeaf CX. En fonction du déploiement de otre solution Tealeaf, une configuration supplémentaire peut être requise. Remarque : cette section fournit un cadre pour la configuration initiale d'un composant du système IBM Tealeaf CX ia un modèle de déploiement simplifié. En fonction du déploiement de otre solution Tealeaf, une configuration supplémentaire peut être requise. Pour toutes questions sur la configuration, contactez Tealeaf IBM Tealeaf cxconnect for Data Analysis ous offre la possibilité d'analyser et de communiquer les données capturées par Tealeaf dans dierses solutions tiers et notamment des outils et bases de données de génération de rapports personnalisés, des entrepôts de données, des enironnements d'aide à la décision et des produits d'analyse Web. En outre, IBM Tealeaf cxconnect for Data Analysis permet de créer un magasin persistant de données de session à partir de os applications Web. Remarque : IBM Tealeaf cxconnect for Data Analysis est un composant faisant l'objet d'une licence distincte du système IBM Tealeaf CX. Contactez otre interlocuteur IBM Tealeaf. Cette page décrit la configuration initiale d'ibm Tealeaf cxconnect for Data Analysis. Pour plus d'informations sur IBM Tealeaf cxconnect for Data Analysis, oir "cxconnect for Data Analysis - Guide d'administration" dans le document IBM Tealeaf cxconnect for Data Analysis - Guide d'administration. Prérequis Certains prérequis sont nécessaires pour effectuer la configuration initiale d'ibm Tealeaf cxconnect. Il est supposé que tous les logiciels Tealeaf ont été installés sur des sereurs Windows et Linux. Aant de commencer, installez tous les logiciels. Voir "Installation de CX" dans le document IBM Tealeaf CX - Guide d'installation. En outre, ous deez effectuer les étapes de configuration initiales des composants du produit IBM Tealeaf cximpact. Voir "Présentation de la configuration de CX" dans le document IBM Tealeaf CX - Guide de configuration. Installation de cxconnect Aant de commencer, ous deez installer IBM Tealeaf cxconnect for Data Analysis ia le programme d'installation distinct. Voir le chapitre sur l'installation de cxconnect dans le document IBM Tealeaf cxconnect for Data Analysis Administration Manual. Ajout d'un sereur cxconnect IBM Tealeaf cxconnect for Data Analysis requiert son propre sereur Tealeaf pour gérer l'extraction et la génération de données. 1. Accédez au portail Tealeaf en tant qu'administrateur. 2. Dans le menu Portail, sélectionnez Tealeaf > Gestion du portail. 3. La page Gestion du portail apparaît. 4. Dans la sous-fenêtre de naigation de gauche, cliquez sur Sereurs Tealeaf. Chapitre 3. Configuration initiale de CX 183

194 5. Cliquez sur le lien Gérer les sereurs. La liste des sereurs Tealeaf actuellement disponibles s'affiche. 6. S'il n'existe aucun sereur IBM Tealeaf cxconnect for Data Analysis, cliquez sur Noueau. Sélectionnez Sereur CxConnect dans le menu déroulant. S'il existe un sereur IBM Tealeaf cxconnect for Data Analysis, sélectionnez-le et cliquez sur Modifier. 7. Editez les propriétés du sereur IBM Tealeaf cxconnect for Data Analysis. a. Cochez la case Actie. b. Entrez le nom d'affichage du sereur. La aleur par défaut Sereur cxconnect est recommandée. c. Dans la liste déroulante, sélectionnez le sereur qui héberge le sereur IBM Tealeaf cxconnect for Data Analysis. d. Entrez le numéro de port à utiliser. La aleur par défaut d'ibm Tealeaf cxconnect for Data Analysis est e. Cliquez sur Sauegarder. 8. Le sereur est ajouté à la liste. Voir "Gestion des sereurs Tealeaf" dans le document IBM Tealeaf cximpact Administration Manual. Ajout d'une tâche configurée Maintenant que le logiciel IBM Tealeaf cxconnect for Data Analysis a été installé et que le sereur IBM Tealeaf cxconnect for Data Analysis a été configuré, ous pouez créer otre première tâche IBM Tealeaf cxconnect for Data Analysis. Pour plus d'informations sur la configuration des tâches IBM Tealeaf cxconnect for Data Analysis, oir "Tâches de configuration de cxconnect" dans le document IBM Tealeaf cxconnect for Data Analysis - Guide d'administration. Les étapes ci-après décrient comment créer une simple tâche Fichiers de données IBM Tealeaf cxconnect for Data Analysis. La méthode d'exportation Fichiers de données extrait des sessions Tealeaf sélectionnées dans un format texte à plat. Ces sessions peuent ensuite être insérées dans le système d'entreprise de otre choix. Remarque : La méthode d'exportation Fichiers de données est la méthode d'intégration Tealeaf recommandée. 1. Accédez au portail Tealeaf en tant qu'administrateur. 2. Dans le menu Portail, sélectionnez Tealeaf > IBM Tealeaf cxconnect for Data Analysis. 3. La page IBM Tealeaf cxconnect for Data Analysis s'affiche. La liste des tâches planifiées est affichée. 4. Dans la sous-fenêtre de naigation de gauche, cliquez sur Tâches configurées. 5. Cliquez ensuite sur le signe Les sections ci-après décrient les propriétés de chaque onglet de la tâche configurée à alimenter. Onglet Général Vous pouez examiner les données de session en sélectionnant une période comprises entre les aleurs Extract From et Extract To efin de définir un interalle de données de session à érifier. 1. Cliquez sur l'onglet Général. 2. Entrez une aleur pour le nom de tâche. Par exemple, test_task. 3. Pour Planification, cliquez sur Run Now. 184 IBM Tealeaf CX - Guide de configuration

195 4. Pour les paramètres d'extraction, entrez une période au cours de laquelle ous saez que des données de session ont été générées. A des fins de test, limitez-ous à une période d'une heure. Ne cheauchez pas les dates pour ce test. Pour spécifier une date, cliquez sur l'une des zones de date. Utilisez l'outil Calendrier pour sélectionner une date. Pour spécifier une heure, cliquez sur l'une des zones d'heure. Utilisez les touches de direction ou saisissez la aleur. Pour définir l'heure, cliquez sur Définir. Vérifiez que os aleurs Extract From et Extract To définissent une période d'une heure qui se produit à un moment où des données de session risquent d'être capturées. 5. Cochez la case Actif. Onglet Sereurs CX 1. Cliquez sur l'onglet Sereurs IBM Tealeaf CX. 2. Cochez la case en regard du sereur duquel ous souhaitez extraire les sessions. Si plusieurs sereurs sont répertoriés, n'en sélectionnez qu'un seul. Onglet Ensemble de données Pour ce test, ignorez l'onglet Ensemble de données. Onglet Filtres de données Pour ce test, ignorez l'onglet Filtres de données. Onglet Destination 1. Cliquez sur l'onglet Destination. 2. Sélectionnez l'option Fichiers de données. Les options ci-après apparaissent. a. Cochez la case Actif. b. Si nécessaire, spécifiez la aleur du répertoire des données exportées. Vous deez aoir accès à ce répertoire sur le sereur IBM Tealeaf cxconnect for Data Analysis. c. Pour ce test, spécifiez la aleur 1 pour le nombre d'exportations simultanées. Onglet Notification 1. Cliquez sur l'onglet Notification. 2. Cliquez sur A. 3. Entrez otre adresse électronique dans l'espace fourni. Sauegarde de la tâche Une fois que ous aez effectué les étapes ci-dessus dans chaque onglet IBM Tealeaf cxconnect for Data Analysis, cliquez sur Sauegarder. La tâche est sauegardée. Vérification du statut de la tâche La tâche ayant été spécifiée de sorte à être immédiatement exécutée, IBM Tealeaf cxconnect for Data Analysis commence le traitement dès que possible. Vous pouez effectuer les étapes ci-après pour érifier le statut de la tâche. Remarque : Comme ous aez configuré la tâche pour qu'elle notifie otre adresse électronique, ous pouez attendre que le courrier électronique ous soit distribué. Chapitre 3. Configuration initiale de CX 185

196 Toutefois, en cas de problème de configuration aec les paramètres de messagerie, utilisez cette fois IBM Tealeaf cxconnect for Data Analysis pour sureiller le statut du traail. 1. Dans la sous-fenêtre de naigation de gauche d'ibm Tealeaf cxconnect for Data Analysis, cliquez sur Tâches planifiées. 2. Le traail est affiché dans la liste des tâches planifiées. Recherchez le nom explicite que ous aez spécifié dans l'onglet Général de la liste. 3. Dans la colonne Informations, ous pouez sureiller la progression de l'exécution de la tâche. Pour actualiser l'écran qui inclut la colonne Informations, cliquez sur Rafraîchir. Si la aleur de zone de la colonne Informations se termine par Traité, IBM Tealeaf cxconnect for Data Analysis a effectué la tâche. 4. Le courrier électronique de notification arrie rapidement. Il contient le journal d'extraction de la tâche, qui peut s'aérer utile pour résoudre les problèmes. Vérification de la sortie dans le répertoire de destination Une fois que la tâche a été traitée, ous pouez érifier que les fichiers de sortie ont été générés dans le répertoire de destination, sur le sereur IBM Tealeaf cxconnect for Data Analysis. Dans le répertoire de sortie spécifié, des fichiers similaires aux suiants doient être générés : BulkAppData _120000_ _ test_task_30_ _1.dat BulkAttrb _120000_ _ test_task_30_ _1.dat BulkEent _120000_ _ test_task_30_ _1.dat BulkHit _100000_ _ test-spo_40_ _1.dat BulkSesn _120000_ _ test_task_30_ _1.dat BulkUrlField _120000_ _ test_task_30_ _1.dat Pour plus d'informations sur le schéma de ces fichiers, oir "Tâches de configuration de cxconnect" dans le document IBM Tealeaf cxconnect for Data Analysis - Guide d'administration. Intégration aec les bases de données d'entreprise Ces fichiers sont prêts à être intégrés aec la base de données d'entreprise de destination. Tealeaf fournit un ensemble d'exemples de script qui peuent être modifiés pour effectuer cette étape d'intégration. Voir le chapitre sur les tâches de configuration de cxconnect dans le document IBM Tealeaf cxconnect for Data Analysis Administration Manual. Autres options de configuration En plus de la méthode de sortie Fichiers de données, IBM Tealeaf cxconnect for Data Analysis offre les options de sortie suiantes : Fichiers journaux : permet d'extraire les sessions dans des fichiers journaux compatibles à W3C. Voir le chapitre sur les tâches de configuration de cxconnect dans le document IBM Tealeaf cxconnect for Data Analysis Administration Manual. Test de otre configuration Après aoir terminé la configuration initiale, ous pouez effectuer les étapes suiantes afin de la érifier. 186 IBM Tealeaf CX - Guide de configuration

197 Si ous aez effectué la configuration de test initiale dans les étapes précédentes, ous pouez érifier les opérations IBM Tealeaf cxconnect for Data Analysis en examinant les résultats dans le répertoire de sortie, si ous ne l'aez pas déjà fait. Voir «Vérification de la sortie dans le répertoire de destination», à la page 186. Une fois que tous les composants Tealeaf ont été configurés, effectuez un test de bout en bout. Voir "Test de otre solution Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration. Références Pour plus d'informations sur IBM Tealeaf cxconnect for Data Analysis, oir "cxconnect for Data Analysis - Guide d'administration" dans le document IBM Tealeaf cxconnect for Data Analysis - Guide d'administration. Pour plus d'informations sur les tâches de configuration, oir "Tâches de configuration de cxconnect" dans le document IBM Tealeaf cxconnect for Data Analysis - Guide d'administration. Pour plus d'informations sur les tâches de planification, oir "Tâches de planification de cxconnect" dans le document IBM Tealeaf cxconnect for Data Analysis - Guide d'administration. Pour un autre exemple d'intégration utilisant la méthode Fichiers de données, oir "Tâches de configuration de cxconnect" dans le document IBM Tealeaf cxconnect for Data Analysis - Guide d'administration. Configuration initiale d'ibm Tealeaf cxverify Remarque : Vous trouerez ci-après une structure de configuration d'un composant du système IBM Tealeaf CX dans un modèle de déploiement simplifié. En fonction de otre déploiement, une configuration supplémentaire peut être requise. Pour toute question concernant la configuration, contactez IBM Tealeaf cxverify génère un enregistrement précis des interactions de chaque isiteur aec otre site Web. A interalles planifiés, IBM Tealeaf cxverify stocke les données de session capturées dans un magasin de données permanent à partir duquel ous pouez par la suite les extraire et les relire. Remarque : IBM Tealeaf cxverify est un composant faisant l'objet d'une licence distincte du système IBM Tealeaf CX. IBM Tealeaf cxverify n'est plus disponible comme noueau produit sous licence à partir de la ersion 8.7. Les clients disposant d'une licence IBM Tealeaf cxverify dans la ersion 8.6 ou une ersion antérieure peuent continuer à utiliser le produit et à bénéficier de l'assistance technique associée, dans la ersion 8.7 et les ersions ultérieures. Pour plus d'informations, contactez Tealeaf Customer Support. Prérequis Aant de commencer, installez tous les logiciels IBM Tealeaf sur des sereurs Windows ou Linux. Pour plus d'informations, oir le document IBM Tealeaf CX - Guide d'installation. En outre, ous deez effectuer les étapes de configuration initiales d'ibm Tealeaf cximpact. Pour plus d'informations, oir le document IBM Tealeaf CX - Guide de configuration. Chapitre 3. Configuration initiale de CX 187

198 Installation d'ibm Tealeaf cxverify Aant de commencer, ous deez installer IBM Tealeaf cxverify. Types d'archiage IBM Tealeaf cxverify prend en charge un type d'archiage. Sereurs Tâche de fichier de session : pour exporter les données de session dans un PDF, configurez une Tâche de fichier de session permettant de distribuer les fichiers de données de session à un sereur IBM Tealeaf cxverify. Pour chaque session exportée, un fichier PDF est généré et peut éentuellement inclure des informations de consignation, ainsi qu'un lien permettant de relire la session. Voir «Tâches Fichier de session», à la page 189. Ajout d'un sereur IBM Tealeaf cxverify Le portail IBM Tealeaf requiert une référence pour communiquer aec le sereur IBM Tealeaf cxverify. Vous deez créer cette référence ia la page Gestion du portail. Ajout du sereur d'archies sélectif L'archiage sélectif requiert son propre sereur IBM Tealeaf, que ous créez par l'intermédiaire de la page Gestion du portail. Le sereur d'archies sélectif permet d'archier les sessions extraites du Canister. Tâches d'archiage Si ous exportez des sessions IBM Tealeaf auxquelles ous souhaitez toujours accéder ia des opérations de recherche et de relecture, ous pouez configurer une tâche d'archiage. Les tâches d'archiage distribuent un ensemble de sessions configurable par l'utilisateur à une archie sélectie à des heures planifiées de manière régulière. 188 IBM Tealeaf CX - Guide de configuration Création de la nouelle archie sélectie Sur le sereur sur lequel ous aez l'intention de stocker os sessions, ous deez créer une archie sélectie. Ajout d'une tâche configurée Maintenant que le sereur IBM Tealeaf cxverify est configuré, ous pouez créer otre première tâche IBM Tealeaf cxverify. Les étapes suiantes ont ous montrer comment créer une tâche Fichier de session IBM Tealeaf cxverify simple. 1. Connectez-ous au portail IBM Tealeaf en tant qu'administrateur. 2. Dans le menu Portail, sélectionnez Tealeaf > IBM Tealeaf cxverify. La page IBM Tealeaf cxverify s'oure et affiche la liste des tâches planifiées. 3. Dans la sous-fenêtre de naigation de gauche, cliquez sur Tâches configurées. 4. Cliquez sur le signe +. Les sections ci-après décrient les propriétés de chaque onglet de la tâche configurée à alimenter. Edition de l'onglet Général 1. Cliquez sur l'onglet Général. 2. Entrez une aleur pour le nom de tâche. Par exemple, entrez test_task.

199 3. Pour Planification, cliquez sur Run Now. 4. Pour les paramètres d'extraction, entrez une période au cours de laquelle ous saez que des données de session ont été générées. A des fins de test, limitez-ous à une période d'une heure. Ne cheauchez pas les dates pour ce test. Pour spécifier une date, cliquez sur l'une des zones de date. Utilisez l'outil Calendrier pour sélectionner une date. Pour spécifier une heure, cliquez sur l'une des zones d'heure. Utilisez les touches de direction ou saisissez la aleur. Pour définir l'heure, cliquez sur Définir. Vérifiez que les aleurs Extract From et Extract To définissent une période d'une heure qui s'est produite précédemment à un moment où des données de session on dû être capturées. 5. Cochez la case Actif. Edition de l'onglet Sereurs CX 1. Cliquez sur l'onglet Sereurs IBM Tealeaf CX. 2. Cochez la case en regard du sereur duquel ous souhaitez extraire les sessions. Si plusieurs sereurs sont répertoriés, n'en sélectionnez qu'un seul. Onglet Ensemble de données Pour ce test, ignorez l'onglet Ensemble de données. Edition de l'onglet Destination 1. Cliquez sur l'onglet Destination. 2. Sélectionnez l'option Archie sélectie. Sélectionnez l'une des options disponibles. Cochez la case Actif. Archie sélectie dans laquelle ous exportez les sessions. Edition de l'onglet Notification 1. Cliquez sur l'onglet Notification. 2. Cliquez sur A. 3. Entrez otre adresse électronique dans l'espace fourni. Etapes suiantes Vous pouez maintenant sauegarder la tâche. Tâches Fichier de session Si ous distribuez des fichiers PDF indiiduels pour chaque session extraite, effectuez les étapes de configuration ci-après pour configurer une tâche Fichier de session. Ajout d'un sereur cxverify IBM Tealeaf L'exportation d'un fichier de session requiert un sereur IBM Tealeaf cxverify pour gérer l'extraction et la sortie des données. 1. Connectez-ous au portail IBM Tealeaf en tant qu'administrateur. 2. Dans le menu Portail, sélectionnez Tealeaf > Gestion du portail. La page Gestion du portail s'oure. 3. Dans la sous-fenêtre de naigation de gauche, cliquez sur Sereurs Tealeaf. Chapitre 3. Configuration initiale de CX 189

200 4. Cliquez sur le lien Gérer les sereurs. La liste des sereurs actuellement disponibles s'affiche. La liste des sereurs actuellement disponibles s'affiche. 5. S'il n'existe aucun sereur IBM Tealeaf cxverify, cliquez sur Noueau et sélectionnez Sereur IBM Tealeaf cxverify dans le menu. S'il existe un sereur IBM Tealeaf cxverify, sélectionnez-le et cliquez sur Modifier. 6. Editez les propriétés du sereur IBM Tealeaf cxverify. a. Cochez la case Actie. b. Entrez le Nom d'affichage du sereur. La aleur par défaut est cxverify Serer. c. Dans la liste, sélectionnez le sereur qui héberge le sereur IBM Tealeaf cxverify. d. Entrez le numéro de port à utiliser. La aleur par défaut est e. Cliquez sur Sauegarder. Le sereur est ajouté à la liste. Edition de l'onglet Général 1. Cliquez sur l'onglet Général. 2. Entrez une aleur pour le nom de tâche. Par exemple, test_task. 3. Pour Planification, cliquez sur Run Now. 4. Pour les paramètres d'extraction, entrez une période au cours de laquelle ous saez que des données de session ont été générées. A des fins de test, limitez-ous à une période d'une heure. Ne cheauchez pas les dates pour ce test. Pour spécifier une date, cliquez sur l'une des zones de date et utilisez l'agenda pour sélectionner une date. Pour spécifier une heure, cliquez sur l'une des zones d'heure. Utilisez les touches de direction ou saisissez la aleur. Pour définir l'heure, cliquez sur Définir. Vérifiez que os aleurs Extract From et Extract To définissent une période d'une heure qui s'est produite à un moment où des données de session on dû être capturées. 5. Cochez la case Actif. Edition de l'onglet Sereurs IBM Tealeaf CX 1. Cliquez sur l'onglet Sereurs IBM Tealeaf CX. 2. Cochez la case en regard du sereur duquel ous souhaitez extraire les sessions. Si plusieurs sereurs sont répertoriés, n'en sélectionnez qu'un seul. Edition de l'onglet Ensemble de données Pour ce test, ignorez l'onglet Ensemble de données. Edition de l'onglet Destination 1. Cliquez sur l'onglet Destination. 2. Cliquez sur le lien Fichiers de session. 190 IBM Tealeaf CX - Guide de configuration

201 Vous pouez sélectionner l'option Session Files with Images. Toutefois, les sorties dans ce format peuent être beaucoup plus longues. a. Cochez la case Actif. b. Spécifiez le répertoire du sereur IBM Tealeaf cxverify dans lequel les fichiers PDF en sortie doient être enregistrés. Assurez-ous d'aoir accès à ce répertoire. Onglet Signature numérique Pour ce test, ignorez l'onglet Signature des données. Onglet Zones de page PDF Pour ce test, ignorez l'onglet Zones de page PDF. Les aleurs par défaut sont correctes. Onglet Notification 1. Cliquez sur l'onglet Notification. 2. Cliquez sur le bouton A. 3. Entrez otre adresse électronique dans l'espace fourni. Sauegarder la tâche Une fois que ous aez effectué les étapes ci-dessus dans chaque onglet IBM Tealeaf cxverify, cliquez sur Sauegarder. La tâche est sauegardée. Vérification du statut de la tâche La tâche ayant été spécifiée de sorte à être immédiatement exécutée, IBM Tealeaf cxverify commence le traitement dès que possible. Effectuez les étapes ci-après pour érifier le statut de la tâche. Remarque : Comme ous aez configuré la tâche pour qu'elle enoie le statut de otre adresse électronique, ous pouez attendre que le courrier électronique ous soit distribué. Toutefois, en cas de problème de configuration aec les paramètres de messagerie, utilisez IBM Tealeaf cxverify pour sureiller le statut du traail. 1. Dans la sous-fenêtre de naigation de gauche d'ibm Tealeaf cxverify, cliquez sur Tâches planifiées. Le traail est affiché dans la liste des tâches planifiées. Dans la colonne Informations, ous pouez sureiller la progression de l'exécution de la tâche. Si la tâche est terminée, la aleur de zone de la colonne Information se termine par Traité. 2. Pour actualiser l'affichage, cliquez sur Rafraîchir. Le courrier électronique de notification arrie rapidement. Il contient le journal d'extraction de la tâche, qui peut s'aérer utile pour résoudre les problèmes. Test de otre configuration Une fois otre configuration initiale terminée, ous pouez effectuer les étapes ci-après pour érifier la configuration. Par l'intermédiaire des sections ci-dessous, ous pouez érifier qu'ibm Tealeaf cxverify a généré les sessions dans l'emplacement approprié. Chapitre 3. Configuration initiale de CX 191

202 n ensemble complet de tests peut être exécuté une fois que tous les composants IBM Tealeaf ont été configurés. Pour plus d'informations, oir le document IBM Tealeaf CX - Guide de configuration. Vérification de la tâche d'archiage 1. Relisez l'une des sessions sauegardées. Pour plus d'informations, oir le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. 2. Recherchez l'archie. Vérification de la tâche de fichier de session 1. Accédez au répertoire de sortie sur le sereur IBM Tealeaf cxverify. Le nombre de fichiers PDF doit correspondre au nombre de sessions répertoriées dans la colonne Information de la page Tâches planifiées, traitées pour otre tâche. 2. Pour érifier la sortie, ourez un échantillon des fichiers PDF. Une fois que tous les composants IBM Tealeaf ont été configurés, effectuez un test de bout en bout. Pour plus d'informations, oir le document IBM Tealeaf CX - Guide de configuration. Références Pour plus d'informations sur IBM Tealeaf cxverify, oir le chapitre concernant cxverify Administration Manual dans le document IBM Tealeaf cxverify Administration Manual. Pour plus d'informations sur les tâches de configuration, oir le chapitre concernant les tâches de configuration de cxverify dans le document IBM Tealeaf cxverify Administration Manual. Pour plus d'informations sur les tâches de planification, oir le chapitre concernant les tâches de planification de cxverify dans le document IBM Tealeaf cxverify Administration Manual. Configuration initiale de cxresults Remarque : cette section fournit un cadre pour la configuration initiale d'un composant du système IBM Tealeaf CX ia un modèle de déploiement simplifié. En fonction du déploiement de otre solution Tealeaf, une configuration supplémentaire peut être requise. Pour toute question concernant la configuration, contactez Remarque : IBM Tealeaf cxresults n'est plus disponible comme noueau produit sous licence à partir de la ersion 8.7. Les clients disposant d'une licence de IBM Tealeaf cxresults dans la ersion 8.6 ou une ersion antérieure peuent continuer à utiliser le produit et à bénéficier de l'assistance technique associée, dans la ersion 8.7 et les ersions ultérieures. Pour plus d'informations, contactez Tealeaf Customer Support. IBM Tealeaf cxresults permet le suii et la génération de rapports sur un riche référentiel de données capturé à partir des isiteurs de otre site Web. A l'aide d'ibm Tealeaf cxresults, ous pouez collecter des informations détaillées sur les caractéristiques des isiteurs et leur comportement afin de mieux comprendre l'expérience client. 192 IBM Tealeaf CX - Guide de configuration

203 Prérequis Cette page décrit la configuration initiale d'ibm Tealeaf cxresults. Pour plus d'informations sur IBM Tealeaf cxresults, oir "Guide d'utilisation de cxresults" dans le document IBM Tealeaf cxresults - Guide d'utilisation. 1. Il est supposé que tous les logiciels Tealeaf ont été installés sur des sereurs Windows et Linux. Aant de commencer, installez tous les logiciels. Voir "Installation de CX" dans le document IBM Tealeaf CX - Guide d'installation. 2. En outre, ous deez déjà aoir effectué les étapes de configuration initiales des composants du produit IBM Tealeaf cximpact. Voir "Présentation de la configuration de CX" dans le document IBM Tealeaf CX - Guide de configuration. Vérification de la base de données des isiteurs Cette section contient les étapes de érification permettant de s'assurer que la base de données des isiteurs est installée et configurée correctement. Vérification de la disponibilité Une fois que ous aez terminé la procédure d'installation, ous deez érifier que la base de données des isiteurs, qui est utilisée par IBM Tealeaf cxresults, a été correctement installée et qu'elle est accessible. 1. Connectez-ous au portail. 2. Dans le menu Portail, sélectionnez Aide > A propos du portail IBM Tealeaf CX. 3. Dans le rapport d'informations sur le portail, recherchez le panneau Base de données dans la partie gauche de l'écran. 4. Si les bases de données IBM Tealeaf cxresults ont été correctement installées, ous deez trouer des entrées pour : TL_VISREPORT TL_VISSTAGE Voir "Rapport d'informations sur le portail" dans le document IBM Tealeaf cximpact - Guide d'administration. Vérification des paramètres du sereur La page Gestion du portail ous permet de érifier les paramètres de connexion du sereur de isiteurs. 1. Connectez-ous au portail Tealeaf en tant qu'administrateur. 2. Dans le menu, sélectionnez Tealeaf > Gestion du portail. 3. Cliquez sur le lien Gérer les sereurs. 4. Dans la liste de sereurs affichée, cliquez sur le sereur de rapport des isiteurs. 5. Vérifiez que le nom d'hôte et le numéro de port du sereur sont corrects pour la connexion. 6. Pour tester la connexion, cliquez sur l'icône Sereur de pings de la barre d'outils. 7. Vous pouez également érifier d'autres paramètres relatifs au sereur des isiteurs. Voir "Paramètres cxresults" dans le document IBM Tealeaf cximpact - Guide d'administration. Chapitre 3. Configuration initiale de CX 193

204 Paramètres de conseration des données : Pour plus d'informations sur la configuration des paramètres de conseration des données de la base de données, oir "Agrégation et conseration des données" dans le document IBM Tealeaf cximpact - Guide d'administration. Paramètres cximpact : Parmi les paramètres d'ibm Tealeaf cximpact, certains affectent IBM Tealeaf cxresults. 1. Connectez-ous au portail Tealeaf en tant qu'administrateur. 2. Dans le menu, sélectionnez Tealeaf > Gestion du portail. 3. Dans le panneau de naigation de gauche, sélectionnez Paramètres IBM Tealeaf CX. a. Examinez tous les paramètres dont le nom contient Visiteur. Voir "Paramètres CX" dans le document IBM Tealeaf cximpact - Guide d'administration. Voir "Paramètres CX" dans le document IBM Tealeaf cximpact - Guide d'administration. a. Examinez tous les paramètres dont le nom contient Segment de session. Voir "Paramètres CX" dans le document IBM Tealeaf cximpact - Guide d'administration. Actiation du traail de l'extracteur de base de données de isiteurs A l'aide du serice de planification de Tealeaf, ous deez actier le traail de l'extracteur de base de données de isiteurs, qui recherche dans chaque Canister actif les sessions à ajouter à la base de données des isiteurs, à des interalles réguliers planifiés. Remarque : Tant que ce traail n'a pas été configuré, actié et correctement exécuté, aucune donnée n'est disponible pour la recherche de isiteurs. Voir "Configuration du serice de planification" dans le document IBM Tealeaf CX - Guide de configuration. Configuration de la mise en isites Pour identifier les isiteurs indiiduels, ous deez définir la zone des données de session qui indique un identificateur de isiteur unique. Cette zone doit ensuite être insérée dans l'emplacement approprié de la demande de sorte à pouoir être définie dans le portail comme identificateur du isiteur. Voir "Configuration de la mise en isites" dans le document IBM Tealeaf cxresults - Guide d'administration. Administration des utilisateurs cxresults Voir "Gestion des utilisateurs et des groupes de cxresults" dans le document IBM Tealeaf cxresults - Guide d'administration. Configuration des modèles de recherche et des listes de sessions Pour des performances de recherche optimales, il se peut que ous deiez conceoir des modèles de recherche spécifiques à mettre à disposition des utilisateurs. Un modèle de recherche définit les zones auxquelles un utilisateur 194 IBM Tealeaf CX - Guide de configuration

205 ayant accès au modèle peut accéder. La conception d'un modèle de recherche permet de ne fournir que les zones de recherche nécessaires tout en interdisant l'accès aux zones inutiles ou sensibles. Lors de l'exécution d'une recherche, les résultats sont affichés dans la page des résultats de recherche, qui utilise un modèle de liste de sessions pour définir les zones à afficher. Un modèle de liste de sessions peut aider les utilisateurs à trouer les informations les plus appropriées. Zone de recherche d'id isiteur Si la zone TLT_VID a été renseignée aec l'identificateur du isiteur est insérée dans la section [appdata] de la demande, ous pouez configurer une zone de recherche permettant de rechercher ces identificateurs de isiteur dans os modèles de recherche. Lorsque ous configurez un modèle de recherche pour la recherche de isiteurs, ous deez ajouter une nouelle zone de recherche dont le mot clé est défini sur TLTVID. Ce mot clé recherche automatiquement dans la zone appropriée des données de demande les correspondances de la chaîne d'entrée que les utilisateurs Tealeaf fournissent ia le portail. Pour plus d'informations sur la configuration des modèles de recherche et des modèles de liste de sessions, oir "Configuration des modèles de recherche" dans le document IBM Tealeaf cximpact - Guide d'administration. Pour plus d'informations sur la sélection du modèle de recherche pour les utilisateurs qui peuent effectuer des recherches de isiteur, oir "Gestion des utilisateurs et des groupes de cxresults" dans le document IBM Tealeaf cxresults - Guide d'administration. Test de la recherche Une fois que ous aez effectué les étapes de configuration ci-dessus, ous deriez pouoir rechercher des isiteurs. Utilisez le modèle de recherche de isiteurs pour rechercher les identificateurs de isiteur des sessions qui, selon ous, sont terminées. Voir "Recherche de isiteurs" dans le document IBM Tealeaf cxresults - Guide d'utilisation. Configuration des éénements de filtrage des sessions cxresults Par défaut, Tealeaf fournit et actie deux éénements permettant de filtrer les sessions d'ibm Tealeaf cxresults. Pour l'optimisation du stockage, ces éénements effectuent les actions ci-après par défaut. Nom d'éénement Comportement par défaut cxresults - Inclure les sessions Toutes les sessions dont le nombre de hits est supérieur à 1 sont incluses dans IBM Tealeaf cxresults. cxresults - Exclure les sessions Toutes les sessions identifiées comme du trafic bot par Tealeaf sont exclues d'ibm Tealeaf cxresults. Voir "Filtrage des éénements et des sessions cxresults" dans le document IBM Tealeaf cxresults - Guide d'administration. Chapitre 3. Configuration initiale de CX 195

206 Etapes suiantes Maintenant que l'identificateur de isiteur a été configuré pour otre système, ous deez configurer les modèles de recherche des isiteurs, de sorte que les données indiiduelles des isiteurs puissent être trouées. Voir «Configuration des modèles de recherche et des listes de sessions», à la page 194. Autres paramètres cxresults Dans le cadre de otre configuration initiale, ous deez examiner les paramètres d'ibm Tealeaf cxresults. 1. Connectez-ous au portail Tealeaf en tant qu'administrateur. 2. Dans le menu Portail, sélectionnez Tealeaf > Gestion du portail. 3. Dans la barre de naigation de gauche, cliquez sur le lien Paramètres IBM Tealeaf cxresults. 4. Vous deez examiner les paramètres spécifiques répertoriés ci-dessous pour les catégories ci-après. Pour plus d'informations sur les paramètres de recherche, oir «Extraction de isiteurs». Pour plus d'informations sur les paramètres utilisateur, oir «Sereur de isiteurs». Extraction de isiteurs Lors de la configuration initiale, examinez les éléments de configuration suiants : Paramètre Description Alimenter la colonne TextFound de l éénement dans l extrait de isiteur Remarque : Si cette aleur est définie sur Désactié, les aleurs des éénements ne peuent pas être recherchées dans la base de données des isiteurs. En l'absence de contraintes d'espace de stockage, Tealeaf recommande de érifier que ce paramètre possède la aleur Actié. Données de isiteur de la production de rapports - Jours de conseration Le nombre de jours de données à conserer dans la base de données des isiteurs est défini sur 30 par défaut. Remarque : Ce paramètre a un impact direct sur la taille de otre base de données des isiteurs. Voir "Paramètres cxresults" dans le document IBM Tealeaf cximpact - Guide d'administration. Sereur de isiteurs Aucun paramètre n'est à érifier à ce stade. Pour plus d'informations sur ces paramètres, oir "Paramètres cxresults" dans le document IBM Tealeaf cximpact - Guide d'administration. Tableaux de bord des isiteurs Tealeaf fournit un ensemble de tableaux de bord à utiliser aec les données des isiteurs. Ces tableaux de bord de isiteurs peuent ous donner des indications précises quant au comportement agrégé des isiteurs. Procédure : Pour accéder à ces rapports : 196 IBM Tealeaf CX - Guide de configuration

207 1. Dans le portail Tealeaf, sélectionnez Analyser > Segments > Analyser segments de isiteur. 2. Sélectionnez un segment à analyser. 3. Cliquez sur le lien Galerie de rapports, dans la partie inférieure de la sous-fenêtre de naigation de gauche. Voir "Analyse des segments de isiteurs" dans le document IBM Tealeaf cxresults - Guide d'utilisation. A ce stade, aucune autre configuration ne doit être requise pour afficher les tableaux de bord de isiteurs. Pour plus d'informations sur la configuration, oir "Configuration des tableaux de bord des isiteurs" dans le document IBM Tealeaf cxresults - Guide d'utilisation. Références Pour plus d'informations sur IBM Tealeaf cxresults, oir "Guide d'utilisation de cxresults" dans le document IBM Tealeaf cxresults - Guide d'utilisation. Test de otre configuration Après aoir terminé la configuration initiale, ous pouez effectuer les étapes suiantes afin de la érifier. Pour IBM Tealeaf cxresults, la configuration principale a sureiller est la création, la capture et le suii d'un identificateur de isiteur unique entre les sessions. Les étapes ci-après décrient comment sureiller les identificateurs de isiteur et autres éléments de configuration d'ibm Tealeaf cxresults. Un ensemble plus complet de tests peut être exécuté une fois que tous les composants Tealeaf ont été configurés. Voir "Test de otre solution Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration. 1. Base de données : ous deez déjà aoir érifié que la base de données des isiteurs IBM Tealeaf cxresults est installée et disponible. Voir «Vérification de la disponibilité», à la page Comptes utilisateur IBM Tealeaf cxresults : connectez-ous en tant qu'utilisateur IBM Tealeaf cxresults et érifiez que le compte a accès à toutes les options de menu requises. Voir «Administration des utilisateurs cxresults», à la page Test de la recherche : si ous ne l'aez pas déjà fait, ous deez érifier que le compte utilisateur peut rechercher des identificateurs isiteur à l'aide du modèle de recherche IBM Tealeaf cxresults par défaut. Voir "Recherche de isiteurs" dans le document IBM Tealeaf cxresults - Guide d'utilisation. 4. Examen des identificateurs isiteur uniques : lorsque ous analysez les segments de isiteurs, la liste générée indique les isiteurs qui ont accès à otre application Web. Vous deez examiner les aleurs supérieures à un dans la colonne Correspondances pour érifier que l'identificateur isiteur est utilisé pour référencer le même isiteur. Voir "Analyse des segments de isiteurs" dans le document IBM Tealeaf cxresults - Guide d'utilisation. 5. Tableaux de bord des isiteurs : les tableaux de bord des isiteurs doient contenir des données. Voir "Analyse des segments de isiteurs" dans le document IBM Tealeaf cxresults - Guide d'utilisation. Une fois que tous les composants Tealeaf ont été configurés, ous deez effectuer un test de bout en bout. Voir "Test de otre solution Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration. Chapitre 3. Configuration initiale de CX 197

208 Configuration initiale de RTV Remarque : Ces informations présentent une série d'étapes permettant d'acheer la configuration initiale d'un composant du système IBM Tealeaf CX dans un modèle de déploiement simplifié. En fonction du déploiement de otre solution Tealeaf, une configuration supplémentaire peut être requise. IBM Tealeaf CX RealiTea Viewer permet aux utilisateurs Tealeaf de rechercher et d'effectuer une relecture des sessions Tealeaf sur leur système bureautique local. L'application RTV autonome se connecte ia le réseau disponible à la plateforme IBM Tealeaf CX pour rechercher les sessions acties ou terminées, puis les affiche en reproduisant les conditions initiales dans un naigateur Web personnalisé. Cette page décrit les différentes étapes à exécuter pour compléter la configuration initiale de RTV. Pour plus d'informations sur RTV, oir "RealiTea Viewer (RTV) - Guide d'utilisation" dans le manuel IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Installation de RTV IBM Tealeaf CX RealiTea Viewer est une application Windows autonome qui doit être installée sur le système bureautique de chaque utilisateur Tealeaf. Aant de configurer RTV, ous deez érifier si le logiciel est installé sur otre système. Remarque : Pour les utilisateurs du gestionnaire d'éénements Tealeaf, le numéro de ersion majeure et mineure installées d'ibm Tealeaf CX RealiTea Viewer sur le bureau doit correspondre aux numéros de ersion majeure et mineure d'ibm Tealeaf cximpact. 1. Dans le menu Démarrer de Windows, sélectionnez Paramètres... > Panneau de configuration. 2. Cliquez deux fois sur Ajout/Suppression de programmes. 3. S'il existe une entrée pour Tealeaf RealiTea Viewer dans la liste, cela signifie que l'application est installée. Pour plus d'informations sur la configuration système requise minimale de RTV, oir le chapitre sur la présentation de RealiTea Viewer dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Pour plus d'informations sur l'installation de RTV, oir le chapitre sur la présentation de RealiTea Viewer dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Connexion à Tealeaf Si ous ne l'aez pas déjà fait, ous deez connecter otre ersion installée de RTV au sereur IBM Tealeaf cximpact. Voir le chapitre sur la présentation de RealiTea Viewer dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Configuration Aant de commencer à configurer et utiliser RTV, ous deez déterminer les rôles des utilisateurs Tealeaf indiiduels. Les rôles RTV peuent être classés dans les catégories suiantes. Rôle Description Administrateur RTV Chargé de la gestion des règles de relecture et des profils globaux. Ce rôle 198 IBM Tealeaf CX - Guide de configuration

209 peut cheaucher celui d'administrateur de l'application Tealeaf. Pour plus d'informations sur les tâches de configuration des administrateurs RTV, oir «Configuration de RTV pour les administrateurs». Les administrateurs RTV peuent être amenés à configurer des règles de relecture pour obtenir une relecture haute fidélité de l'application Web sureillée dans RTV. Voir "RealiTea Viewer - Règles de relecture" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Utilisateur RTV Utilisateur Tealeaf indiiduel qui doit utiliser l'application RTV pour rechercher les données de session, relire les sessions sélectionnées et exécuter les actions appropriées suite aux résultats. Pour plus d'informations sur les tâches de configuration relaties aux utilisateurs de RTV, oir «Configuration de RTV pour les utilisateurs RTV», à la page 202. Utilisateur RTV qui modifie les éénements Utilisateur ou administrateur Tealeaf chargé de la création et de la gestion des définitions d'éénements utilisées dans le système Tealeaf. Pour plus d'informations sur les tâches de configuration relaties à ces utilisateurs, oir «Configuration de RTV pour les utilisateurs qui modifient les éénements», à la page 203. Configuration de RTV pour les administrateurs Ces informations décrient les étapes de configuration que doient exécuter les administrateurs RTV afin de permettre aux utilisateurs Tealeaf d'accéder aux données de session. Configuration des comptes utilisateur RTV : Un utilisateur Tealeaf disposant d'un accès basique au portail peut également utiliser l'application IBM Tealeaf CX RealiTea Viewer. Le mode Relecture par défaut des comptes affectés aux utilisateurs RTV ne peut pas être défini sur BBR au nieau du groupe ou de l'utilisateur indiiduel. Il doit être défini sur RTV ou Inite de commande de relecture. Pour plus d'informations : "Administration des utilisateurs CX" dans le manuel IBM Tealeaf cximpact - Guide d'administration "Administration des utilisateurs cxreeal" dans le manuel IBM Tealeaf cxreeal - Guide d'administration Création ou acquisition d'un profil utilisateur par défaut : Une fois l'installation initiale d'ibm Tealeaf cximpact terminée, un profil par défaut doit être créé et stocké sur le sereur. Pour plus d'informations sur la création des règles de relecture, oir «Configuration du profil utilisateur», à la page 204. Vous pouez rechercher les sessions et effectuer une relecture basique de ces sessions en obtenant le profil. Remarque : La qualité de la relecture de la session dépend de la nature de l'application Web. Les sites Web employant des technologies d'affichage sophistiquées ou reposant sur des éénements d'interaction de l'utilisateur client peuent demander la personnalisation du profil de relecture et des règles de relecture. Ces étapes sont décrites dans les sections ultérieures. Pour obtenir le profil utilisateur RTV par défaut, procédez comme suit. Chapitre 3. Configuration initiale de CX 199

210 1. Exécutez RTV. 2. Dans le menu RTV, sélectionnez Tools > Options Cliquez sur l'onglet Profiles. Dans la partie supérieure du panneau, le message suiant doit s'afficher : You are using the default built-in profile. 4. Sous la zone Default Profile, indiquez le sereur à partir duquel obtenir le profil par défaut. Cliquez sur Rechercher les mises à jour maintenant. Test de la connexion RTV : Ces informations décrient les étapes que doient exécuter les administrateurs RTV pour tester le fonctionnement de la connexion RTV. Test de la recherche : Vous pouez maintenant effectuer des tests pour érifier si la recherche fonctionne. 1. Sur la barre d'outils RTV, cliquez sur le bouton Rechercher. 2. Indiquez une recherche qui doit renoyer un nombre de sessions différent de zéro. 3. Pour exécuter la recherche, cliquez sur Rechercher Dans la boîte de dialogue Search Progress, les résultats de la recherche doient être affichés. Test de la relecture : Remarque : La relecture est un processus complexe et peut nécessiter l'optimisation de os paramètres RTV et éentuellement une modification de l'application Web afin qu'elle fonctionne correctement. Vous pouez désormais tester la fonctionnalité de base de la relecture des sessions. Vous pouez également détecter les problèmes qui doient être traités aant le déploiement de la production. 1. Une fois la recherche exécutée, un nombre de sessions doit être répertorié dans l'onglet Résultats de la recherche. 2. Sélectionnez une session qui contient un nombre éleé de pages, comme indiqué dans la colonne Nombre de pages. 3. Sur la barre d'outils RTV, cliquez sur le bouton Relecture. 4. Dans l'onglet Relecture, un nombre de pages différent de zéro doit être répertorié dans la liste des pages affichables. Dans la sous-fenêtre située à droite, la première page figurant dans la liste des pages affichables s'affiche. 5. Pour tester la relecture de cette session, cliquez sur le bouton Relecture dans la barre d'outils. 6. Si otre installation de RTV fonctionne correctement, la relecture de la session s'exécute en reproduisant les conditions initiales dans lesquelles se trouait l'utilisateur. Sauegarder la session : Si otre session sert d'exemple représentatif d'une expérience utilisateur standard aec otre application Web, ous pouez la sauegarder localement pour ous aider aec os tâches de configuration ultérieures. 1. Lorsque la session est ouerte dans RTV, sélectionnez Fichier > Sauegarder... dans le menu. 2. Enregistrez la session dans un répertoire sur otre poste de traail local qui se troue en dehors du répertoire d'installation RTV. 200 IBM Tealeaf CX - Guide de configuration

211 Autres onglets Options : Ces informations décrient les autres options de profil qui sont disponibles pour les administrateurs RTV. Test des modifications apportées au profil : Aant de sauegarder otre profil sur le sereur, ous pouez enregistrer une copie locale et la tester sur les sessions qui sont sauegardées dans les fichiers.tls. Copie du profil hôte pour d'autres hôtes : Si ous disposez de plusieurs hôtes de otre application Web, ous pouez rapidement créer des profils d'hôtes en copiant le profil d'hôte créé et en modifiant le profil cible selon les besoins. Pour copier le profil, procédez comme suit : 1. Dans le menu RTV, sélectionnez Tools > Options Cliquez sur l'onglet Profils. 3. Cliquez sur Edit Raw Profile... Le fichier XML brut du profil s'affiche. 4. Cliquez dans le texte du profil. Appuyez sur CTRL + A pour sélectionner l'intégralité du texte. 5. Collez le texte dans l'éditeur de texte. 6. Pour conserer une sauegarde, enregistrez le fichier texte. 7. Recherchez la chaîne suiante dans le fichier texte : <HostProfile 8. Vérifiez que la aleur de l'attribut name correspond à l'hôte que ous aez configuré. 9. Sélectionnez le texte qui commence à partir de la chaîne précédente jusqu'à : </HostProfile> 10. Copiez le texte et collez la copie juste après la chaîne précédente. 11. Modifiez l'attribut name dans la première ligne du texte copié afin qu'il corresponde au nom d'hôte pour lequel ous appliquez le profil d'hôte copié. 12. Enregistrez le fichier texte sous un noueau nom. 13. Appuyez sur CTRL + A pour sélectionner l'intégralité du profil. 14. Collez le texte dans RTV. 15. Cliquez sur Sauegarder les changements & Exit. 16. Cliquez sur Modifier un profil Le noueau noeud de profil d'hôte doit être affiché. 18. Modifiez les règles du profil pour le nouel hôte si nécessaire. Sauegarde de otre profil sur le sereur : Une fois satisfait de otre profil utilisateur et des règles pour tous les hôtes, ous pouez le publier sur le sereur commun pour les autres utilisateurs Tealeaf. 1. Dans RTV, sélectionnez Outils > Options Cliquez sur l'onglet Profils. 3. Si ous ne l'aez pas déjà fait, sauegardez une copie de otre profil localement. Copiez le contenu du profil brut dans un éditeur de texte et sauegardez-le dans un répertoire local. 4. Dans la zone de texte Default Profile, érifiez que le sereur et le numéro de port correspondent au sereur hébergeant l'application de portail. 5. Pour érifier si le profil du sereur a été mis à jour depuis la dernière synchronisation, cliquez sur Check for Updates. Chapitre 3. Configuration initiale de CX 201

212 202 IBM Tealeaf CX - Guide de configuration Si d'autres utilisateurs Tealeaf peuent modifier le profil du sereur, ous deez sélectionner l'option Check for Updates at Startup. 6. Si le profil du sereur a été mis à jour, ous deez synchroniser ces mises à jour aec otre copie locale sauegardée. 7. Pour télécharger le profil utilisateur stocké dans RTV, cliquez sur Upload Settings to Serer. Pour appliquer des paramètres spécifiques au profil BBR, cliquez sur Sync to BBR... Sélectionnez les paramètres à appliquer au profil BBR et cliquez sur Commit Dans la fenêtre Options, cliquez sur OK. Distribution des informations de connexion aux utilisateurs RTV : Après aoir téléchargé les modifications apportées à os paramètres sur le profil du sereur, ous pouez distribuer les informations de connexion aux utilisateurs Tealeaf. Configuration de RTV pour les utilisateurs RTV Ces informations décrient les étapes que doient exécuter les utilisateurs RTV pour acquérir leur profil utilisateur. Configuration automatique de RTV à partir du sereur principal Tealeaf : Une fois que l'administrateur RTV a configuré le profil utilisateur, les utilisateurs RTV peuent entrer les informations de connexion au sereur de relecture principal et acquérir le profil utilisateur. 1. Démarrez RTV. 2. Dans le menu RTV, sélectionnez Outils > AutoConfig from TeaLeaf Master Dans la liste des systèmes IBM Tealeaf cximpact disponibles, sélectionnez le noeud supérieur du sereur principal aec lequel ous souhaitez effectuer la synchronisation. Sous chaque noeud de sereur principal, ous pouez isualiser les différents sereurs et numéros de port pertinents pour RTV qui font partie du déploiement d'ibm Tealeaf cximpact. Si le sereur principal n'est pas répertorié, entrez le nom d'hôte simple dans la zone de texte d'ibm Tealeaf cximpact Serer et cliquez sur Ajouter. SiRTV peut se connecter au sereur, il est ajouté à la liste. 4. Pour effectuer une synchronisation aec un sereur répertorié, cliquez sur le nom du sereur dans l'arborescence du sereur. a. Pour utiliser le profil partagé qui est stocké sur le sereur, cochez la case Used Shared Profile. Remarque : Si aucun profil partagé n'est disponible sur le sereur, otre profil local n'est pas modifié. b. Pour configurer otre installation locale de RTV afin qu'elle fonctionne aec le sereur IBM Tealeaf cximpact sélectionné, cliquez sur Configure RealiTeaViewer to use this system. Remarque : Il est recommandé de configurer RTV à des fins de configuration automatique en utilisant des sereurs de la même ersion que celle de l'installation RTV. Par exemple, si ous utilisez RTV ersion 7.2, ous deez ous connecter uniquement aux sereurs IBM Tealeaf cximpact ersion 7.2. Pour supprimer un sereur de la liste des sereurs disponibles, sélectionnez le noeud de sereur dans la liste et cliquez sur Supprimer. 5. Une fois la configuration automatique terminée, cliquez sur Exit.

213 Voir le chapitre sur la présentation de RealiTea Viewer dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Mise à jour de otre profil local : Si otre administrateur RTV met à jour périodiquement le profil commun, ous deez configurer RTV pour rechercher des mises à jour au moment du démarrage. 1. Dans le menu RTV, sélectionnez Tools > Options Cliquez sur l'onglet Profils. 3. Sous la zone Default Profile, indiquez le sereur à partir duquel obtenir le profil par défaut. 4. Cochez la case Check for Updates at Startup. 5. Cliquez sur Rechercher les mises à jour maintenant. 6. Pour sauegarder les modifications, cliquez sur OK. Pour restaurer otre profil utilisateur au profil utilisateur par défaut fourni par Tealeaf, cliquez sur Restaurer le profil par défaut. Configuration de RTV pour les utilisateurs qui modifient les éénements Le gestionnaire d'éénements Tealeaf permet aux utilisateurs disposant des droits appropriés de créer, modifier et supprimer les éénements Tealeaf et les données connexes. Ces informations décrient les étapes de configuration dans RTV pour les utilisateurs qui doient accéder à TEM. Voir le chapitre sur le gestionnaire d'éénements Tealeaf dans le document IBM Tealeaf Eent Manager Manual. 1. Si ous ne l'aez pas déjà fait, ous deez exécuter les étapes de configuration pour les utilisateurs RTV. Voir «Configuration de RTV pour les utilisateurs RTV», à la page Dans le menu RTV, sélectionnez Tools > Options Cliquez sur l'onglet IBM Tealeaf cximpact. a. Si l'authentification portail est actiée, RTV doit disposer du nom d'utilisateur et du mot de passe de portail qui seront utilisés pour établir une connexion aec le sereur de portail. Entrez le nom d'utilisateur et le mot de passe à utiliser pour la connexion au sereur. Voir "RealiTea Viewer - Balises des options aancées" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. 4. Pour sauegarder les modifications apportées à la configuration, cliquez sur OK. 5. Les utilisateurs du gestionnaire d'éénements doient faire partie du groupe Eent Admin dans IBM Tealeaf cximpact. Voir "Administration des utilisateurs CX" dans le manuel IBM Tealeaf cximpact - Guide d'administration. Voir "Administration d'éénement" dans le document IBM Tealeaf Eent Manager Manual. 6. Pour tester la connexion, sélectionnez Modifier > Editeur d'éénement... dans le menu RTV. 7. L'onglet Eénements du gestionnaire d'éénements Tealeaf s'oure et affiche toutes les définitions d'éénements figurant sur le sereur. Voir le chapitre sur le gestionnaire d'éénements Tealeaf dans le document IBM Tealeaf Eent Manager Manual. Chapitre 3. Configuration initiale de CX 203

214 Acquisition de la licence mobile Si ous aez acquis la licence du module IBM Tealeaf CX Mobile, RTV doit être fourni aec la clé de licence pour actier les fonctions de relecture spécifiques des mobiles. Cette configuration est également complétée ia l'onglet Options d'ibm Tealeaf cximpact. Voir "RealiTea Viewer - Balises des options aancées" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Configuration du profil utilisateur Une fois la connectiité de base établie, les administrateurs RTV peuent configurer le profil utilisateur afin qu'il contienne des suggestions sur le mode d'affichage du contenu lors de la relecture. A l'aide des règles de relecture, ous pouez fournir des instructions à RTV concernant la gestion de pages spécifiques ou d'autres aspects de l'application Web au cours de la relecture. Ces informations décrient les différentes étapes de la configuration du profil utilisateur RTV. Le profil utilisateur est stocké en tant que fichier XML dans le répertoire d'installation RTV local. Remarque : Il est recommandé de commencer le processus de configuration en modifiant le profil utilisateur ia l'interface graphique RTV, plutôt que de modifier le fichier XML brut. Le profil RTV local peut éentuellement être synchronisé aec un profil utilisateur commun qui est stocké sur le sereur. Ce profil utilisateur commun peut éentuellement être synchronisé aec le profil utilisateur utilisé par la relecture sur naigateur. Voir "RealiTea Viewer - Options de profil" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Modification du profil RTV : 1. Dans le menu RTV, sélectionnez Tools > Options Cliquez sur l'onglet Profils. 3. Cliquez sur Modifier le profil Les noeuds du profil RTV sont affichés. Les noeuds spécifiques qui doient être modifiés sont décrits dans les sections suiantes. Pour plus d'informations sur les profils utilisateur, oir "RealiTea Viewer - Options de profil" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Sauegarde du profil RTV : Voir "RealiTea Viewer - Options de profil" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Remappage de l'hôte/du port : Si nécessaire, ous pouez remapper les hôtes et les ports détectés dans le flux de transaction ers une autre passerelle de numéro d'hôte/de port. Si cela ne s'aère pas pratique ou s'il n'est pas souhaitable que la relecture enoie des demandes au sereur de production opérationnel, ous pouez modifier toutes les références au sereur opérationnel dans les données de relecture afin qu'elles désignent l'autre sereur ou un sereur NULL. Remarque : Dans un profil utilisateur, ous ne pouez disposer que d'un seul remappage d'hôte/de port. 1. Dans la boîte de dialogue Modifier un profil, cliquez deux fois sur le noeud Remapper l'hôte. 204 IBM Tealeaf CX - Guide de configuration

215 2. Cliquez sur Ajouter un nom d'hôte. Entrez le nom d'hôte de otre application Web au format suiant : 3. Cliquez sur OK. 4. Pour actier le remappage, sélectionnez l'une des options de remappage suiantes : Remapper l hôte ers : entrez l'hôte ers lequel ous souhaitez remapper le nom d'hôte source, en utilisant le même format. Remap host to NULL serer : si ous ne disposez pas d'un sereur de remappage et ne souhaitez pas receoir les demandes enoyées au sereur Web source, cette option annule toutes les demandes qui sont imbriquées dans les données de relecture. Remarque : Si cette option est actiée, une partie du contenu ne s'affiche pas correctement lors de la relecture. 5. Si ous le souhaitez, ous pouez remapper les numéros de port depuis le trafic de l'application Web source ers des noueaux numéros de port sur le sereur de remappage. Cliquez sur Ajouter un port. Indiquez les ports de remappage From et To, puis cliquez sur OK. Vous pouez entrer plusieurs numéros de port à remapper. 6. Dans le menu déroulant Protocole, ous pouez sélectionner le protocole à utiliser lorsque ous ous connectez au sereur de remappage. L'option Auto détecte automatiquement le protocole approprié à utiliser. 7. Pour sauegarder les paramètres de otre remappage, cliquez sur OK. Ignorer les URL : Certaines URL de otre application Web ne sont pas des pages affichables, générant ainsi des problèmes d'affichage dans RTV. Pour éiter ces pages, ous pouez configurer RTV afin d'ignorer les masques d'url, y compris les paramètres de requête. 1. Dans la boîte de dialogue Modifier un profil, cliquez deux fois sur le noeud IgnoreURL. 2. Entrez les informations de chemin d'accès des URL à ignorer. Le chemin d'accès /app/.asp? indique à RTV d'ignorer les fichiers.asp qui contiennent des paramètres de requête dans l'arborescence app de l'hôte source. Les caractères génériques * et? sont acceptés. Lorsque ous spécifiez les URL à ignorer, faites-le simplement et de manière spécifique. Vous pouez télécharger une session et la sauegarder localement en tant que fichier.tls, puis l'utiliser pour effectuer une itération sur les règles IgnoreURL. 3. Pour sauegarder la règle IgnoreURL dans otre profil, cliquez sur OK. 4. Pour créer la règle IgnoreURL, cliquez sur Noueau... dans la boîte de dialogue Modifier un profil. Dans le menu déroulant, sélectionnez Add IgnoreUrl... Pour plus d'informations sur la configuration de otre profil, oir "RealiTea Viewer - Options de profil" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. URL de popup : Si nécessaire, ous pouez configurer RTV pour la reconnaissance des URL qui doient être affichées dans une fenêtre en incrustation. Lorsque ous accédez aux URL qui correspondent au motif PopupURL dans la liste Naigation, RTV les affiche dans une fenêtre en incrustation. Chapitre 3. Configuration initiale de CX 205

216 Dans une relecture sur naigateur, les URL de popup sont affichées dans la liste Naigation bien qu'elles soient affichées sous forme de pages standard lors de la relecture. 1. Dans la boîte de dialogue Modifier un profil, cliquez deux fois sur le noeud PopupURL. 2. Entrez les informations de chemin d'accès des URL à traiter en tant que popups. La configuration du chemin d'accès des URL de popup respecte les mêmes exigences que celles de la spécification des URL à ignorer. Voir «Ignorer les URL», à la page Pour sauegarder la règle PopupURL dans otre profil, cliquez sur OK. Pour plus d'informations sur la configuration de otre profil, oir "RealiTea Viewer - Options de profil" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Modifications des réponses : Vous pouez modifier la réponse des données de relecture en effectuant un remplacement basé sur motif du texte. Par exemple, les modifications des réponses peuent être utilisées pour empêcher l'exécution non souhaitée des scripts JaaScript qui sont référencés ou inclus dans la réponse. 1. Dans la boîte de dialogue Modifier un profil, cliquez deux fois sur le noeud ResponseMod. 2. Pour le nom d'hôte spécifié, ous pouez sélectionner si la modification de réponse doit être appliquée à toutes les réponses ou à celles qui correspondent à un motif d'expression régulière. Les expressions régulières sont un mécanisme puissant pour la spécification de la correspondance de modèle. Voir "Expressions régulières dans RealiTea Viewer" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. 3. Dans la zone de texte Motif, ous pouez indiquer le texte pour lequel rechercher la réponse à l'aide d'une expression régulière. 4. Dans la zone de texte Remplacement, spécifiez le texte qui a remplacer le motif apparié. 5. Sélectionnez si seule la première occurrence (First) dans la réponse ou toutes les occurrences (All) doient être remplacées. 6. Pour sauegarder otre règle de modification de réponse, cliquez sur OK. 7. Une fois otre règle de modification de réponse spécifiée, ous deez la tester sur les échantillons de données. Voir «Test de modification de réponse». Test de modification de réponse : Une fois otre règle de modification de réponse spécifiée, ous deez la tester sur les échantillons de données. 1. Chargez une session que ous pouez utiliser pour tester la règle. 2. Cliquez sur le bouton Vue Réponse dans la barre d'outils. 3. Sélectionnez un exemple de texte dans la réponse à des fins de test. 4. Cliquez aec le bouton droit de la souris sur le texte sélectionné, puis sélectionnez Règles de modification des réponses au test La fenêtre Test Modify Rules s'oure. 6. Pour tester le texte sélectionné par rapport aux règles de modification des réponses de la page, cliquez sur Test. 7. Pour éditer les règles de modification des réponses, cliquez sur Modifier une règle IBM Tealeaf CX - Guide de configuration

217 Pour plus d'informations sur la configuration de otre profil, oir "RealiTea Viewer - Options de profil" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Configuration de la modification de réponse dynamique : Si otre application Web inclut des données proenant d'un tiers, ce contenu doit être associé à une demande spécifique. Vous pouez utiliser les règles de modification de réponse dynamiques pour modifier les modèles de réponse basés sur la détection des éénements Tealeaf dans le flux de transaction. Voir "RealiTea Viewer - Création d'éénements" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Modifications de fichier externe : Si otre application Web fait référence à des fichiers externes tels que JaaScripts, ous pouez configurer un ensemble de modifications de fichier afin que des actions non souhaitables ne soient pas exécutées dans le naigateur Web RTV lors de la relecture. Généralement, cette fonction est utilisée pour désactier l'exécution de script. 1. Dans la boîte de dialogue Modifier un profil, cliquez deux fois sur le noeud ExternalFileMod. 2. Pour le nom d'hôte spécifié, entrez le motif d'expression régulière des noms de fichier à modifier. Les expressions régulières sont un mécanisme puissant pour la spécification de la correspondance de modèle. Voir "Expressions régulières dans RealiTea Viewer" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. 3. Dans la zone de texte Motif, ous pouez indiquer le texte à rechercher à l'aide d'une expression régulière. 4. Dans la zone de texte Remplacement, spécifiez le texte qui a remplacer le motif apparié. 5. Sélectionnez si seule la première occurrence (First) ou toutes les occurrences (All) doient être remplacées. 6. Une fois otre règle de modification de fichier externe spécifiée, ous deez la tester sur les échantillons de données. Voir «Test de modification de réponse», à la page Pour sauegarder otre règle de modification de fichier externe, cliquez sur OK. Pour plus d'informations sur la configuration de otre profil, oir "RealiTea Viewer - Options de profil" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Configuration des modifications de fichier externe dynamiques : Vous pouez utiliser les règles de modification de fichier externe dynamiques pour modifier les données de fichier externe en fonction de la détection des éénements Tealeaf dans le flux de transaction. Vous pouez configurer ces modifications en utilisant la même interface que celle utilisée pour la configuration de la modification de réponse dynamique. Voir "RealiTea Viewer - Création d'éénements" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Création de règles de cadre : Si otre application Web utilise des agencements pour l'organisation de la page d'affichage, ous pouez créer des règles de cadre pour enoyer des URL aux cadres nommés dans l'agencement. Chapitre 3. Configuration initiale de CX 207

218 1. Dans la boîte de dialogue Modifier un profil, cliquez deux fois sur le noeud FrameRule. 2. Entrez le nom du cadre ers lequel le masque d'url doit être mappé. 3. Dans la zone de texte Matching URL, entrez le masque d'url de la page source ou des pages source à mapper dans le cadre. Les caractères génériques * et? sont acceptés. 4. Pour appliquer la règle de cadre à otre profil utilisateur, cliquez sur OK. Pour plus d'informations sur la configuration de otre profil, oir "RealiTea Viewer - Options de profil" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Remarque : En ce qui concerne les cadres chargés de manière dynamique, ous pouez créer des règles à partir de la liste Pages affichables pour gérer le placement des cadres. Cliquez aec le bouton droit de la souris sur la page dans la liste Pages affichables, sélectionnez Règles de relecture... > Place this page in a frame..., puis sélectionnez le cadre. La règle est alors créée et est configurée de sorte à toujours placer la page dans le cadre sélectionné. Voir "RealiTea Viewer - Liste des pages affichables" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Configuration de la relecture pour les actions de l'interface utilisateur côté client L'émergence des technologies d'application Internet enrichie a entraîné une augmentation conséquente de l'utilisation des éénements d'interface utilisateur côté client dans les applications Web. Il se peut que ces éénements d'interface utilisateur ne soient pas transmis au sereur hôte par défaut, empêchant Tealeaf d'effectuer leur suii. En tant que composant facultatif de la plateforme IBM Tealeaf CX, Tealeaf IBM Tealeaf CX UI Capture for AJAX peut être déployé dans otre application Web afin de fournir une sureillance détaillée des éénements d'interface utilisateur côté client. IBM Tealeaf CX UI Capture for AJAX peut nécessiter un déeloppement, une configuration et une intégration supplémentaires à l'aide de otre application Web. Remarque : IBM Tealeaf CX UI Capture for AJAX n'est disponible que pour les utilisateurs existants. Pour plus d'informations sur UI Capture, oir "Guide d'ui Capture for AJAX" dans le document IBM Tealeaf UI Capture for Ajax Guide. Si ous ne pouez pas déployer UI Capture actuellement, ous pouez configurer RTV à des fins de sureillance limitée des éénements d'interface utilisateur côté client. Voir "Sureillance des éénements IU client ia RTV" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Si otre application Web utilise les technologies Ajax, une configuration supplémentaire peut être requise. Voir "RealiTea Viewer - Relecture AJAX" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Test de otre configuration Une fois otre configuration initiale terminée, ous pouez exécuter les étapes suiantes pour érifier la configuration. 208 IBM Tealeaf CX - Guide de configuration

219 Pour RTV, ous deez tester la configuration pour les utilisateurs de base, les administrateurs RTV et les utilisateurs du gestionnaire d'éénements Tealeaf. Les étapes suiantes sont répertoriées. Un ensemble complet de tests peut être exécuté une fois que tous les composants Tealeaf ont été configurés. Voir "Test de otre solution Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration. 1. Administrateurs RTV : les administrateurs RTV doient érifier s'ils peuent modifier les règles de relecture et s'assurer que la fonctionnalité de relecture est opérationnelle. Si ous ne l'aez pas déjà fait, érifiez que ous pouez modifier une règle de relecture et la sauegarder sur le sereur. Il se peut que ous créez une règle IgnoreURL pour une URL qui ne sera jamais affichée dans l'application Web. Une fois ce test terminé, ous deez supprimer la règle. Testez la relecture de base. Voir "RealiTea Viewer - ue Relecture" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Remarque : La relecture est un processus complexe qui peut nécessiter un examen régulier des règles de relecture pour assurer un bon fonctionnement. Vous pouez maintenant tester la fonctionnalité de relecture de base. 2. Utilisateurs RTV : les utilisateurs RTV doient être en mesure de rechercher des sessions et les relire. Si ous ne l'aez pas déjà fait, ous deez tester un compte utilisateur RTV de base pour érifier que la recherche et la relecture fonctionnent correctement. Voir «Test de la recherche», à la page 200. Voir «Test de la relecture», à la page Utilisateurs du gestionnaire d'éénements Tealeaf : ces utilisateurs doient maintenant être en mesure d'accéder à l'application. Dans le menu RTV, sélectionnez Modifier > Editeur d'éénement... Si RTV est correctement configuré, les éénements actuellement disponibles sont affichés. Modifiez une définition d'éénement ; changez la description, par exemple, et alidez cette modification sur le sereur pour érifier que otre compte utilisateur peut modifier les définitions d'éénement. Une fois tous les composants Tealeaf configurés, ous deez exécuter un test de bout en bout. Voir "Test de otre solution Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration. Références Pour plus d'informations sur IBM Tealeaf cxverify, oir le chapitre concernant cxverify Administration Manual dans le document IBM Tealeaf cxverify Administration Manual. Pour plus d'informations sur les tâches de configuration, oir le chapitre concernant les tâches de configuration de cxverify dans le document IBM Tealeaf cxverify Administration Manual. Pour plus d'informations sur les tâches de planification, oir le chapitre concernant les tâches de planification de cxverify dans le document IBM Tealeaf cxverify Administration Manual. Chapitre 3. Configuration initiale de CX 209

220 Configuration initiale de CX Mobile Remarque : cette section fournit un cadre pour la configuration initiale d'un composant du système IBM Tealeaf CX ia un modèle de déploiement simplifié. En fonction du déploiement de otre solution Tealeaf, une configuration supplémentaire peut être requise. Pour toute question concernant la configuration, contactez Le module IBM Tealeaf CX Mobile étend les fonctionnalités de détection, d'analyse et de génération de rapports des agents utilisateur d'ibm Tealeaf cximpact pour rechercher les agents utilisateurs des périphériques mobiles. A l'aide d'ibm Tealeaf CX Mobile, ous pouez identifier et suire les expériences de os clients qui se connectent à otre application Web à l'aide de périphériques mobiles. Remarque : Le module IBM Tealeaf CX Mobile est un module sous licence séparée de la plateforme IBM Tealeaf CX. Contactez otre interlocuteur IBM Tealeaf. Pour plus d'informations sur l'actiation, oir "Présentation de CX Mobile" dans le document IBM Tealeaf CX Mobile - Guide d'utilisation. Pour plus d'informations sur les données acquises auprès de périphériques mobiles, consultez la section "Présentation de CX Mobile" dans le document IBM Tealeaf CX Mobile - Guide d'utilisation. Cette page explique comment effectuer la configuration initiale d'ibm Tealeaf CX Mobile for Mobile Web, qui gère la capture des propriétés système et des éénements de l'interface graphique sur les périphériques mobiles qui interagissent aec otre application Web ia un naigateur mobile auto-identifié. Remarque : IBM Tealeaf CX Mobile for Mobile App permet la capture des éénements de l'interface graphique et des propriétés d'application à partir d'applications naties mobiles. Il nécessite une installation, un déploiement et une configuration distincts. Voir «Configuration initiale de CX Mobile for Mobile App», à la page 212. Prérequis Aant de commencer, installez tous les logiciels IBM Tealeaf sur des sereurs Windows ou Linux. Pour plus d'informations, oir le document IBM Tealeaf CX - Guide d'installation. En outre, ous deez effectuer les étapes de configuration initiales d'ibm Tealeaf cximpact. Pour plus d'informations, oir le document IBM Tealeaf CX - Guide de configuration. UI Capture pour la relecture Remarque : Pour les utilisateurs RTV, la licence IBM Tealeaf CX Mobile doit être déployée sur l'application à partir de l'un des sereurs Tealeaf hébergeurs pour permettre une relecture correcte des sessions Web mobiles. Voir "Recherche et relecture pour Web mobile" dans le document IBM Tealeaf CX Mobile - Guide d'utilisation. RTV Remarque : Pour relire des sessions Web mobiles dans la ersion 8.1 ou une ersion ultérieure, ous deez installer IBM Tealeaf CX UI Capture for AJAX ou le mettre à nieau ers la build ou une build ultérieure. 210 IBM Tealeaf CX - Guide de configuration

221 Voir "Foire aux questions UI Capture" dans la foire aux questions d'ibm Tealeaf UI Capture for Ajax. Voir "Guide d'ui Capture for AJAX" dans le document IBM Tealeaf UI Capture for Ajax - Guide. La relecture des sessions capturées à partir d'applications naties possède un autre ensemble d'exigences. Voir "Recherche et relecture pour application mobile" dans le document IBM Tealeaf CX Mobile - Guide d'utilisation. Configuration de Tealeaf CX Mobile IBM Tealeaf CX Mobile for Mobile Web s'appuie sur la norme WURFL pour détecter les agents utilisateur mobiles. Ce fichier.cs doit être téléchargé, conerti en un format utilisable par Tealeaf et mis à disposition de la plateforme IBM Tealeaf CX. Cette norme doit être mise à jour de manière régulière. Voir "Configuration de Tealeaf pour des isiteurs mobiles" dans le document IBM Tealeaf CX Mobile - Guide d'administration. Configuration des éénements pour CX Mobile Le tableau de bord du trafic des mobiles importé à l'étape précédente inclut des éénements permettant de détecter les isiteurs mobiles et autres informations significaties liées à leur expérience. Ces éénements testent la présence de paires nom/aleur spécifiques dans la section [ExtendedUserAgent] de la demande. La section [ExtendedUserAgent] est ajoutée à la demande en actiant l'analyse étendue des agents utilisateur. Pour plus d'informations sur l'actiation de cette fonction, oir "Agent de session de référence Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration. Pour plus d'informations sur les éénements des isiteurs mobiles qui deiennent disponibles ia l'analyse étendue des agents utilisateur, oir "Eénements pour isiteurs mobiles" dans le document IBM Tealeaf CX Mobile - Guide d'utilisation. Test de otre configuration Après aoir terminé la configuration initiale, ous pouez effectuer les étapes suiantes afin de la érifier. Pour IBM Tealeaf CX Mobile, ous deez érifier que le tableau de bord mobile a été correctement importé et que des éénements mobiles apparaissent dans les rapports. Remarque : Il se peut que ous deiez attendre quelques minutes après aoir actié la détection des agents utilisateur et importé le tableau de bord mobile aant que des éénements mobiles ne soient déclenchés par les données de session. Si ous rencontrez des difficultés aec l'un des deux premiers tests ci-dessous, essayez à noueau après quelques minutes. 1. Recherchez des éénements : A partir du portail ou de RTV, recherchez l'un des éénements mobiles importés aec le tableau de bord. Pour plus d'informations sur les éénements inclus dans le tableau de bord, oir "Eénements pour isiteurs mobiles" dans le document IBM Tealeaf CX Mobile - Guide d'utilisation. Pour plus d'informations sur la recherche ia le portail, oir "Recherche dans les données de session" dans le document IBM Tealeaf cximpact - Guide d'utilisation. Chapitre 3. Configuration initiale de CX 211

222 Pour plus d'informations sur la recherche ia RTV, oir "RealiTea Viewer - Recherche et recherche secondaire de session" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. 2. Examinez le tableau de bord mobile : si ous aez installé le tableau de bord du trafic des mobiles, dans le menu Tableau de bord, sélectionnez le tableau de bord mobile. a. Examinez le contenu du tableau de bord pour érifier qu'il contient des données. 3. Examinez les autres rapports Tealeaf : érifiez que les autres rapports sur les isiteurs mobiles dans Tealeaf contiennent des données. Voir "Génération de rapports pour Web mobile" dans le document IBM Tealeaf CX Mobile - Guide d'utilisation. Une fois que tous les composants Tealeaf ont été configurés, ous deez effectuer un test de bout en bout. Voir "Test de otre solution Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration. Configuration initiale de CX Mobile for Mobile App Pour capturer des données d'applications naties mobiles, ous deez déployer une ou plusieurs des structures de consignation ci-après aec otre application. Lorsqu'elles sont déployées et configurées, les structures de consignation ci-après capturent les éénements d'interface graphique et les propriétés d'application des applications naties déeloppées pour les systèmes d'exploitation mobiles répertoriés. Références Remarque : L'utilisation des enironnements de capture de consignation Tealeaf pour des applications naties mobile nécessite la licence Tealeaf CX Mobile pour application mobile. Pour plus d'informations, contactez otre interlocuteur Tealeaf. Remarque : Les détenteurs de licence doient utiliser le code fourni par Tealeaf dans leurs applications. Pour plus d'informations sur le téléchargement du logiciel Tealeaf, oir Tealeaf CX Downloads. Structure de consignation Description Structure de consignation Android Structure de consignation des applications Android. Voir "Guide de référence Tealeaf d'enironnement de capture de consignation sous Android" dans le document IBM Tealeaf Android Logging Framework - Guide de référence. Structure de consignation ios Structure de consignation des applications ios. Voir "Guide de référence Tealeaf d'enironnement de capture de consignation sous ios" dans le document IBM Tealeaf ios Logging Framework - Guide de référence. Pour plus d'informations sur IBM Tealeaf CX Mobile en général, oir "TLTopic - Mobile" dans les rubriques IBM Tealeaf. Pour plus d'informations sur l'utilisation d'ibm Tealeaf CX Mobile, oir "Tealeaf CX Mobile - Guide d'utilisation" dans le document IBM Tealeaf CX Mobile - Guide d'utilisation. 212 IBM Tealeaf CX - Guide de configuration

223 Test de otre solution Tealeaf Pour plus d'informations sur la configuration d'ibm Tealeaf CX Mobile, oir "Tealeaf CX Mobile - Guide d'administration" dans le document IBM Tealeaf CX Mobile - Guide d'administration. Pour plus d'informations sur IBM Tealeaf CX UI Capture for AJAX, oir "Foire aux questions UI Capture" dans la Foire aux questions d'ibm Tealeaf UI Capture for Ajax. Une fois que ous aez effectué les tâches d'installation et de configuration initiale de chaque produit et module Tealeaf sous licence, érifiez les opérations de otre solution Tealeaf. Cette section fournit une procédure simple permettant de tester les opérations de bout en bout de la solution Tealeaf, aec des modifications basées sur les composants facultatifs que ous aez éentuellement installés. Méthodologie Cette procédure de test nécessite de générer d'une session de test sur l'application Web et de capturer la session ia Tealeaf et en local à l'aide de l'utilitaire Tealeaf Client-Side Capture. Lorsque ous parcourez la session, ous pouez tester des fonctionnalités pour les sessions acties, y effectuer des recherches, les relire ou en générer des rapports, puis effectuer des tests similaires une fois la session terminée. Dans une session actie, les hits sont actuellement ajoutés à la session stockée dans le Canister à court terme en mémoire ou la session n'est pas encore fermée ou arriée à expiration. Une session terminée est une session fermée transférée du Canister à cours terme ers le Canister à long terme pour indexation et stockage. Les sessions archiées en dehors du Canister à long terme sont également considérées comme des sessions terminées. La méthodologie teste les fonctions fondamentales ci-après de la solution Tealeaf en recherchant os données de session capturées dans dierses parties des zones de capture, de traitement et de génération de rapports de la solution Tealeaf. Fonctions Capture : capture de sessions par IBM Tealeaf CX Passie Capture Application. Recherche : recherche des données de session en tant que session actie ou terminée. Relecture : relecture de la session ia une relecture sur naigateur et IBM Tealeaf CX RealiTea Viewer comme session actie et terminée Génération de rapports : affichage des données dans le portail en tant que session actie ou terminée Exportation de données : exportation des données capturées et traitées Modifications de configuration temporaires Les étapes précédentes reflètent le flux de données généralisé à traers la solution, qui est présenté ci-après. Tous les éléments ci-après s'appliquent à des sessions terminées. Les éléments également marqués (actie) s'appliquent également aux sessions acties. Chapitre 3. Configuration initiale de CX 213

224 Flux de données général des données de session ia IBM TealeafCX La session actie commence. La session (actie) est disponible pour relecture dans le portail et dans RTV. La session est terminée. La session est déplacée du Canister à court terme ers le Canister à long terme. La session est indexée pour la recherche dans LTC. La session (terminée) accepte maintenant les recherches à l'aide de modèles de recherche terminés disponibles dans le portail et RTV. Les données de session sont agrégées à des fins de génération de rapports. Les données de session (terminée) alimentent les rapports du portail. Les données de session sont compressées à partir du Canister à long terme et éentuellement archiées. A des fins de test, ous pouez raccourcir les interalles de certaines des étapes afin d'accélérer la procédure de test. Ces interalles peuent être configurés en modifiant les options de configuration ci-après. Remarque : N'effectuez pas ces modifications sur un sereur de production. Ces modifications ne doient être appliquées que dans un enironnement de test et doient être annulées une fois les tests terminés. La session est indexée pour la recherche dans LTC : pour plus d'informations sur la configuration de l'indexation, oir "Configuration de l'indexation CX" dans le document IBM Tealeaf CX - Guide de configuration. 1. Le programme de contrôle de l'indexation (indexprogram) recherche les sessions à indexer en fonction du paramètre Sleep Time When No Work. 2. Si des sessions à indexer sont détectées, le processus d'indexation commence. Les index ne sont pas enregistrés sur le disque, ce qui permet les recherches jusqu'à ce que le paramètre Direct Pull Timeout arrie à expiration ou que la taille d'index dépasse le seuil Maximum Index Size. Les données de session sont agrégées à des fins de génération de rapports : par défaut, le collecteur de données recherche les données à agréger dans le Canister à long terme toutes les cinq minutes. 1. Si nécessaire, ous pouez redémarrer le serice du collecteur de données Tealeaf ia le panneau de configuration des serices Windows pour procéder immédiatement à une collecte de données. Toutefois, ous deez être certain que les données à collecter ont déjà été générées pour que cette étape fonctionne. Installation Aant de commencer, installez les composants ci-après si ous ne l'aez pas déjà fait. Client-Side Capture : Tealeaf Client-Side Capture est un plug-in pour Fiddler qui permet de capturer otre expérience de naigation IE sur otre bureau local. La session que ous explorez sur l'application Web sureillée est capturée en local comme contrôle pour tester les résultats des captures, traitements et relectures ia les fonctions de relecture de Tealeaf. Pour plus d'informations sur l'installation de Client-Side Capture, oir "Utilisation de Client-Side Capture for Fiddler" dans le document IBM Tealeaf Client-Side Capture - Guide. IBM Tealeaf CX RealiTea Viewer : l'application RTV peut être installée sur les systèmes de bureau des utilisateurs Tealeaf pour permettre la recherche et la 214 IBM Tealeaf CX - Guide de configuration

225 relecture de données de session. En outre, par l'intermédiaire de RTV, les utilisateurs disposant des droits appropriés peuent éditer les définitions d'éénement appliquées au flux de capture Tealeaf. Si RTV est utilisé par les utilisateurs Tealeaf dans otre entreprise, ous deez tester ses fonctionnalités dans le cadre de la procédure de test. Pour plus d'informations sur l'installation de RTV, oir "Présentation de RealiTea Viewer" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Considérations à prendre en compte lors de la génération de otre session de test Aant de capturer otre session de test, ous deez étudiez les points suiants, qui peuent affecter les pages que ous tentez de capturer : Identificateur de session : ous deez choisir comment ous allez explorer l'application Web de sorte à identifier de manière unique la session à l'aide des recherches et relectures. Lorsque ous testez la session capturée, ous deez pouoir l'identifier de manière unique. Si aucun identificateur unique n'est disponible, il est possible d'identifier la session à l'aide des horodatages. Si ous posséder une licence d'ibm Tealeaf cxresults et que ous aez déployé ce dernier, ous pouez utiliser l'utiliser de isiteur que ous aez configuré pour le produit. Voir "Configuration initiale de cxresults" dans le document IBM Tealeaf cxresults - Guide d'administration. Eénement de suii : ous deez conceoir otre session de sorte à déclencher au moins un éénement connu que ous aez configuré pour l'application Web. Par la suite, ous pourrez utiliser cet éénement comme clé pour explorer les données de rapport Tealeaf à la recherche de la session terminée. Tableau d'analyse : pour tester les fonctions de rapport, ous deez déclencher un éénement qui s'enregistre dans un tableau d'analyse d'indicateur clé de performance ou de processus. Pour plus d'informations sur tableaux d'analyse d'indicateur clé de performance, oir "Utilisation de tableaux d'analyse" dans le document IBM Tealeaf cxview - Guide d'utilisation. Pour plus d'informations sur les tableaux d'analyse de processus, oir "Utilisation de tableaux d'analyse" dans le document IBM Tealeaf cxview - Guide d'utilisation. PCA : aant la capture, ous pouez ourir l'onglet Récapitulatif de la console Web de la PCA, dans lequel ous deriez pouoir sureiller le trafic s'il existe peu d'autres actiités sur l'application Web. Si ous aez actié les règles de filtrage des données, configuré le trafic à ignorer ou spécifier d'autres paramètres d'optimisation, ous pouez conceoir otre session de capture de sorte à tester ces paramètres. Par exemple, si ous saez qu'un trafic hôte spécifique a été configuré pour être ignoré, ous deez conceoir otre session afin de générer des données de session de cet hôte, qui seront transmises à la PCA, puis ignorées. Consultez la section "Console Web PCA - Onglet Interface" du document IBM Tealeaf Passie Capture Application - Guide. Si la PCA capture du trafic SSL, ous deez conceoir otre session de sorte qu'elle explore les zones sécurisées de l'application Web. Consultez la section "Console Web PCA - Onglet Interface" du document IBM Tealeaf Passie Capture Application - Guide. La PCA prend en charge la mise en sessions des données, plusieurs modes de capture, l'inclusion et l'exclusion d'extensions de fichier spécifiques et d'autres Chapitre 3. Configuration initiale de CX 215

226 fonctions. Vous deez pouoir conceoir otre capture de sorte que les données capturées et traitées reflètent correctement le mode de capture, les paramètres d'extension de fichier et toute configuration de la mise en sessions des données gérée par la PCA. Voir "Console Web de la PCA - Onglet Pipeline" dans le document IBM Tealeaf Passie Capture Application - Guide. Les zones de configuration ci-après peuent nécessiter des captures distinctes permettant de les tester. Les règles de confidentialité appliquées à la PCA doient être testées minutieusement. Suiant la complexité de os règles configurées, ous deez enisagez d'examiner chacune d'elles ia une session capturée séparément. Voir "Console Web PCA - Onglet Règles" dans le document IBM Tealeaf Passie Capture Application - Guide. - Les règles du testeur de confidentialité peuent également être testées à l'aide de l'utilitaire externe Testeur de confidentialité. Voir "Utilitaire de test de confidentialité" dans le document IBM Tealeaf CX - Guide de configuration. TMS : aucun autre test n'est requis. Voir "Configuration initiale de TMS" dans le document IBM Tealeaf CX - Guide de configuration. IBM Tealeaf cximpact : aucun autre test n'est requis. Voir "Configuration initiale du portail" dans le document IBM Tealeaf CX - Guide de configuration. Pipeline : aucun autre test n'est requis. Voir "Configuration initiale du portail" dans le document IBM Tealeaf CX - Guide de configuration. Composants facultatifs RTV : des tests RTV sont inclus dans le flux de traaux de cette procédure de test. IBM Tealeaf cxresults : les principaux critères de configuration d'ibm Tealeaf cxresults sont l'établissement d'un identificateur multi-session unique pour chaque isiteur et la possibilité de rechercher des isiteurs. Voir «Test d'unicité d'un identificateur cxresults», à la page 221. IBM Tealeaf cxreeal : aucun autre test n'est requis. Voir "Configuration initiale de cxreeal" dans le document IBM Tealeaf cxreeal - Guide d'administration. Module IBM Tealeaf CX Mobile : ous pouez éentuellement effectuer ces tests à l'aide d'un périphérique mobile pour érifier que le module IBM Tealeaf CX Mobile est correctement configuré. Voir «Test des isiteurs mobiles», à la page 221. IBM Tealeaf cxconnect for Data Analysis : aucun autre test n'est requis. Voir "Configuration initiale de cxconnect" dans le document IBM Tealeaf CX - Guide de configuration. IBM Tealeaf cxverify : aucun autre test n'est requis. Voir "Configuration initiale de cxverify" dans le document IBM Tealeaf CX - Guide de configuration. Pour capturer tous les éléments de configuration ci-dessus, ous deez décider d'effectuer plusieurs captures de différents aspects de l'application Web. Certains des tests ci-après étant appliqués alors que la session est toujours actie, ous deez effectuer tous les tests de la page pour la première session aant de commencer à capturer et à tester des sessions suiantes. Voir «Capture de sessions de test supplémentaires», à la page 221. Génération d'une session 216 IBM Tealeaf CX - Guide de configuration 1. Ourez Internet Explorer. 2. Accédez à la page d'accueil de l'application Web. 3. Démarrez Client-Side Capture.

227 4. Notez l'heure à laquelle ous aez démarré la capture locale. Cet horodatage doit être corrélé aec les horodatages qui apparaissent plus tard dans le portail. 5. Accédez aux pages de l'application Web que ous deez capturer pour effectuer les tests des systèmes ci-dessus. 6. Ne fermez pas la session. Continuez aec les tests suiants. Remarque : Suiant le olume de données, le débit du réseau et les performances du sereur, ous pouez constater un délai entre le début de otre session et l'apparition des hits dans Tealeaf. Tests de la session actie Les tests ci-après peuent être appliqués à la session actie que ous capturez. Capture Si ous ous trouez dans un enironnement de production aec un trafic Web général, il se peut que ous ne puissiez pas tester uniquement le processus de capture. Il peut s'aérer difficile de détecter les données de hit de otre session actie spécifique ia la console Web de la PCA ou le pipeline Windows, qui reçoit les données de la PCA. Toutefois, si ous ous trouez dans un enironnement de test sans autre trafic, il se peut que ous puissiez érifier la capture en sureillant les sections suiantes dans l'onglet Récapitulatif de la console Web de la PCA : La section Current Per Seconds Stats indique les taux de transfert de chaque processus PCA dans le pipeline. La section Homologues indique la distribution de données PCA au sereur de traitement de destination et à son pipeline Windows. Voir "Console Web PCA - Onglet Récapitulatif" dans le document IBM Tealeaf Passie Capture Application - Guide. Génération de rapports Le portail ous permet d'examiner toutes les sessions acties. Dans le menu Portail, sélectionnez Sessions > Acties. La liste des sessions affiche toutes les sessions acties. Si ous trouez la session que ous créez, ous aez érifié que le pipeline Windows fonctionne correctement. Dans la liste des sessions du portail, ous pouez cliquer sur l'icône Info pour examiner les informations de session à des fins de érification. Voir "Recherche dans les données de session" dans le documentibm Tealeaf cximpact - Guide d'utilisation. Dans la liste des sessions, cliquez sur l'icône Liste de pages pour afficher une liste des pages dans la session. Vous pouez explorer des pages indiiduelles pour examiner les données capturées. Cette section est utile pour examiner les opérations de pipeline Windows, telles que la confidentialité, les aleurs de référence Tealeaf, etc. Vous pouez également relire la session actie à partir de cet écran. Voir "Recherche dans les données de session" dans le documentibm Tealeaf cximpact - Guide d'utilisation. Recherche Pour rechercher les sessions acties ia le portail, sélectionnez Rechercher > Sessions acties. Voir "Recherche dans les données de session" dans le documentibm Tealeaf cximpact - Guide d'utilisation. Chapitre 3. Configuration initiale de CX 217

228 Si ous aez déclenché un éénement connu dans otre session, ous pouez rechercher des sessions en fonction de cet éénement. Pour rechercher les sessions acties dans RTV, cochez la case Rechercher des sessions acties dans l'onglet Générateur de recherche. Pour plus d'informations sur la recherche RTV, oir "RealiTea Viewer - Recherche et recherche secondaire de session" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Relecture Si ous trouez la session actie dans le portail, ous pouez cliquer sur l'icône Appareil photo dans la liste des sessions pour relire la session. Selon otre configuration, ous pourrez utiliser la méthode de relecture dans le portail et/ou RTV. Voir "Relecture sur naigateur CX" dans IBM Tealeaf cximpact - Manuel de l'utilisateur. Pour plus d'informations sur la relecture RTV, oir "RealiTea Viewer - ue Relecture" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Tests de session terminés Si os tests ont abouti, ous pouez mettre fin à la session, qui est alors mise en file d'attente afin d'être transférée au Canister à long terme pour indexation. Arrêtez Client-Side Capture et sauegardez le fichier de capture dans un répertoire local. Capture Aucun test supplémentaire n'est requis. Recherche Si ous parenez à trouer la session terminée à l'aide d'un modèle de session terminée, ous aez érifié les opérations d'indexation. Plus spécifiquement, ous deez rechercher des données connues dans la section [appdata] de la demande, qui est toujours indexée. Si ous aez déclenché un éénement connu dans otre session, ous pouez également rechercher des sessions en fonction de cet éénement. Voir "Recherche dans les données de session" dans le documentibm Tealeaf cximpact - Guide d'utilisation. Pour plus d'informations sur la recherche RTV, oir "RealiTea Viewer - Recherche et recherche secondaire de session" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Recherche de isiteurs : Si ous aez actié IBM Tealeaf cxresults, ous pouez rechercher la session en fonction de l'identificateur du isiteur. En explorant les résultats, ous deriez pouoir extraire la même session que ci-dessus. Pour plus d'informations, oir "Recherche de isiteurs" dans le document IBM Tealeaf cxresults - Guide d'utilisation. Réexécution Dans la page Liste des sessions, ous pouez cliquer sur l'icône Appareil photo pour relire la session. Dans ce cas, pour la relecture, érifiez les points suiants pour la ersion que ous aez capturée à l'aide de Client-Side Capture : Vérifiez le nombre de pages de chaque capture. Vérifiez que la dernière page de chaque capture correspond à l'autre capture. 218 IBM Tealeaf CX - Guide de configuration

229 Pour RTV : Examinez plusieurs pages de la capture RTV pour érifier que l'intégralité du contenu significatif est affiché. Si la mise en éidence est actiée dans RTV, érifiez que les éléments de page appropriés ont été correctement mis en éidence. Si UI Capture est déployé dans otre application Web, ous deez érifier qu'une sélection d'éénements d'interface graphique est capturée et affichée correctement dans RTV. UI Capture requiert un déploiement distinct de JaaScript dans otre infrastructure d'application Web. Voir "Guide d'ui Capture for AJAX" dans le document IBM Tealeaf UI Capture for AJAX Guide. Les écarts entre la relecture Tealeaf et la relecture de otre Canister à court terme doient être rapprochés à l'aide des règles de relecture de otre profil. Voir "RealiTea Viewer - Options de profil" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Rapport Génération de rapport d'éénements : Si les éénements de otre session capturée ont été tabulés pour la génération de rapports, effectuez les étapes ci-après. 1. Dans le menu Portail, sélectionnez Analyser > Générateur de rapports. 2. Cliquez sur Ajouter un éénement. 3. Sélectionnez l'éénement que ous aez déclenché dans otre session capturée. Cliquez sur Sélectionner. 4. Vérifiez que la date cible est configurée pour aujourd'hui ou pour la date à laquelle ous aez créé la session. 5. Cliquez sur Rafraîchir si nécessaire. 6. Dans le graphique affiché, recherchez l'heure à laquelle la session a été établie. Si ous ne trouez pas le lien approprié, cliquez sur le lien Total dans la partie inférieure de l'écran. 7. La liste des sessions appropriées s'affiche. Recherchez otre session dans la liste affichée. 8. Si ous parenez à effectuer le test, ous aez érifié que les données d'éénement de otre session étaient disponibles pour la génération de rapports. Voir "Générateur de rapports Tealeaf" dans le document IBM Tealeaf - Guide de génération de rapports. Génération de rapports de données agrégées : Déterminez si les données agrégées de la session capturée sont tabulées pour la génération de rapports ; effectuez les étapes ci-après. 1. Dans le menu Portail, sélectionnez Analyser > Tableaux d'analyse. L'écran Tableaux d'analyse s'affiche. 2. Vérifiez que la date cible est configurée pour aujourd'hui ou pour la date à laquelle ous aez créé la session. 3. Pour Période cible, sélectionnez Jour. 4. Cliquez sur Modifier. Sélectionnez un tableau d'analyse qui inclut les éénements déclenchés lors de otre session capturée. Cliquez sur Sélectionner. 5. Cliquez sur Rafraîchir si nécessaire. Chapitre 3. Configuration initiale de CX 219

230 6. Dans le tableau d'analyse affiché, cliquez sur un lien qui affiche un nombre de sessions pour l'éénement déclenché lors de otre capture. 7. Un graphique de l'éénement sélectionné s'affiche. 8. Dans le graphique affiché, recherchez l'heure à laquelle la session a été établie. Si ous ne trouez pas le lien approprié, cliquez sur le lien Total dans la partie inférieure de l'écran. 9. La liste des sessions appropriées s'affiche. Recherchez otre session dans la liste affichée. 10. Si ous parenez à effectuer le test, ous aez érifié que os données de session étaient bien agrégées pour la génération de rapports. Voir "Utilisation de tableaux d'analyse" dans le document IBM Tealeaf cxview - Guide d'utilisation. Exportation de données Vous pouez tester les fonctions d'exportation de données du système Tealeaf en effectuant les procédures ci-après. Exportation d'un graphique 1. Dans le menu Portail, sélectionnez Analyser > Générateur de rapports. 2. Sélectionnez un éénement, une période de génération de rapports et les options du sereur pour que ous puissiez oir les données affichées à l'écran. 3. Utilisez les boutons dans le coin supérieur droit pour tester l'exportation au format Microsoft Excel et PDF. Voir "Générateur de rapports Tealeaf" dans le document IBM Tealeaf - Guide de génération de rapports. 4. Vérifiez les données du graphique exporté par rapport à la ersion affichée. Exportation d'un tableau d'analyse 1. Dans le menu Portail, sélectionnez Analyser > Tableaux d'analyse. 2. Sélectionnez un tableau d'analyse et une période de génération de rapports qui contient des données. 3. Utilisez les boutons dans le coin supérieur droit pour tester l'exportation au format Microsoft Excel et PDF. Voir "Utilisation de tableaux d'analyse" dans le document IBM Tealeaf cxview - Guide d'utilisation. 4. Vérifiez les données du tableau d'analyse exporté par rapport à la ersion affichée. Tableau de bord d'exportation 1. Dans le menu Portail, sélectionnez un tableau de bord dans le menu Tableaux de bord. 2. Vérifiez que le tableau de bord contient des données significaties. 3. Dans le coin supérieur droit, cliquez sur Options. 4. Enoyez-ous le tableau de bord par courrier électronique. 5. Une ersion PDF du tableau de bord est jointe au courrier électronique. Vérifiez les données du tableau de bord exporté par rapport à la ersion affichée. 220 IBM Tealeaf CX - Guide de configuration

231 Capture de sessions de test supplémentaires Vous pouez créer des sessions pour tester les situations suiantes : Test des isiteurs mobiles Si ous aez actié le module IBM Tealeaf CX Mobile, ous pouez effectuer les tests à l'aide d'un périphérique mobile pour érifier que Tealeaf est correctement configuré pour capturer les actiités des utilisateurs mobiles. Test d'unicité d'un identificateur cxresults Si ous aez acheté sous licence et actié IBM Tealeaf cxresults, générez et fermez une deuxième session pour érifier que ous aez généré un identificateur de isiteur dans la liste des sessions qui correspond à deux sessions. Voir "Analyse des segments de isiteurs" dans le document IBM Tealeaf cxresults - Guide d'utilisation. Alertes Si ous aez actié le serice d'alerte, effectuez la procédure ci-après pour tester les alertes. Pour plus d'informations sur l'actiation du serice d'alerte, oir "Configuration du serice d'alerte" dans le document IBM Tealeaf CX - Guide de configuration. Cette procédure définit une alerte qui est déclenchée si le nombre de sessions acties est supérieur à 1. Une fois que ous aez défini l'alerte et alidé os modifications, lorsque ous commencez à explorer l'application Web, ous receez un courrier électronique d'alerte. Les alertes sont générées ia le gestionnaire d'éénements dans le portail Tealeaf. Voir "Tealeaf Eent Manager" dans le document IBM Tealeaf Eent Manager - Guide. Pour plus d'informations sur la configuration des alertes, oir "Onglet Alertes TEM" dans le document IBM Tealeaf Eent Manager - Guide. 1. Connectez-ous au portail en tant qu'administrateur. 2. Dans le menu Portail, sélectionnez Configurer > Gestionnaire d'éénements. 3. Dans Tealeaf Eent Manager, cliquez sur l'onglet Alertes. 4. Cliquez sur Nouelle alerte de Canister. 5. Cochez la case Actif. 6. Pour Type d'alerte, sélectionnez Décompte. 7. Cliquez sur Sélectionner un éénement. Sélectionnez l'éénement Sessions acties. 8. Pour Fonction d'alerte, sélectionnez Positie. 9. Cochez la case Seuil d'alerte uniquement. 10. Dans la zone de texte Seuil, entrez la aleur Pour Interalle, entrez la aleur Pour Réinitialiser, entrez la aleur 100. Remarque : Cette alerte ne doit se déclencher qu'une seule fois. Une fois que ous aez érifié le test, modifiez les propriétés d'alerte ou supprimez l'alerte. 13. Décochez la case Actier les aertissements. 14. Dans le panneau Notification, cochez la case de l'adresse électronique et désélectionnez toutes les autres cases. 15. Entrez otre adresse électronique dans l'espace fourni. Chapitre 3. Configuration initiale de CX 221

232 16. Dans le panneau Interruption totale, érifiez que la case Actier l'interruption totale des alertes n'est pas cochée. 17. Cliquez sur Enregistrer le brouillon. 18. L'alerte doit être affichée en rouge dans l'onglet Alertes. 19. Pour alider les modifications sur le sereur, cliquez sur Sauegarder les changements. 20. Ourez une fenêtre de naigateur pour explorer l'application sureillée par Tealeaf. 21. Ourez un second naigateur pour explorer l'application. Vous deez maintenant aoir deux sessions acties, qui dépassent le seuil d'alerte. 22. Une copie de l'alerte doit ous être enoyée par courrier électronique. 23. N'oubliez pas de supprimer l'alerte une fois que ous l'aez reçue et érifiée. Voir "Onglet Alertes TEM" dans le document IBM Tealeaf Eent Manager - Guide. Etapes suiantes Si tous les tests aboutissent, otre solution Tealeaf est opérationnelle. N'oubliez pas de rétablir les aleurs précédentes des paramètres de configuration temporaires. Voir «Modifications de configuration temporaires», à la page IBM Tealeaf CX - Guide de configuration

233 Chapitre 4. Agents de session de pipeline CX Les agents de session Tealeaf peuent être déployés dans le processus de capture des données pour filtrer les données conserées par le système Tealeaf. Vous pouez définir des agents de session pour supprimer les données inintéressantes ou répétities, déelopper des données compressées, filtrer des données priées ou sensibles, et bien plus encore. Cette section décrit comment autoriser la configuration des agents de session pour le pipeline et sureiller la santé du pipeline aec un ensemble d'utilitaires. «Configuration du pipeline CX», à la page 224 «Présentation du pipeline de capture et des agents de session», à la page 235 «Ajout d'un agent de session», à la page 237 «Agent de session Archiage», à la page 238 "Agent de session Indexation des attributs" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session Canister», à la page 249 «Agent de session Analyseur de cookie», à la page 252 «Agent de session Dépose de données», à la page 254 «Agent de session Analyseur de données», à la page 260 «Agent de session Decouple», à la page 264 «Agent de session DecoupleEx», à la page 266 «Agent de session Confidentialité étendue», à la page 275 «Agent de session Health-Based Routing (HBR)», à la page 278 «Agent de session Déploiement», à la page 285 «Agent de session Analyseur mobile JSON», à la page 289 «Agent de session Code géré», à la page 303 «Agent de session Null», à la page 306 «Agent de session Confidentialité», à la page 307 «Agent de session RTA (Real-Time Monitoring and Alert)», à la page 341 «Agent de session Balises de réponse pour la demande», à la page 346 «Agent de session Fractionnement RTA», à la page 348 «Agent de session de mise en sessions», à la page 353 «Agent de session Routeur de session», à la page 350 «Agent de session Socket», à la page 356 «Agent de session Consignateur de statistiques», à la page 358 "Agent de session de référence Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session de référence Tealeaf - Mode existant», à la page 380 «Agent de session Mise en sessions Tealeaf», à la page 384 «Agent de session TimeGrades», à la page 390 «Agent de session TLI», à la page 392 «Agent de session de décodage d'url», à la page 408 «Utilitaires du pipeline CX», à la page 409 «Lecteur d'archie TeaLeaf - Exécuter les sessions archiées», à la page 410 Copyright IBM Corp. 1999,

234 Configuration du pipeline CX «Utilitaire Testeur de confidentialité», à la page 416 «Statut de capture TeaLeaf - Utilitaire de sureillance des pipelines», à la page 412 "Onglet Statut du pipeline TMS" dans le document IBM Tealeaf cximpact - Guide d'administration Le pipeline IBM Tealeaf CX est composé d'une série de modules que ous actiez et configurez pour créer un ensemble spécifique d'opérations sur les données capturées. Chaque module (ou agent de session) effectue une manipulation spécifique sur les données capturées et réachemine ces dernières ers l'agent de session suiant. A la fin d'un pipeline IBM Tealeaf CX, un agent de terminaison procède à la disposition finale des données de session dans le pipeline, qui peut inclure la transmission de ces données à un Canister à court terme (Canister dans le diagramme ci-dessous), une archie, un autre port du sereur en ue de leur traitement par un autre pipeline, ou l'agent de session NULL, qui supprime les données. Figure 23. Exemple de pipeline IBM Tealeaf CX Une fois que le trafic a été capturé par IBM Tealeaf CX Passie Capture Application, il est transmis au sereur de traitement, où les données capturées sont transmises au pipeline. Les données sont transmises d'un agent de session au suiant dans le pipeline, chaque agent effectuant une ou plusieurs manipulations sur les données. La sortie de l'agent de session #1 correspond à l'agent de session #2. Les agents de session Tealeaf dans le pipeline peuent modifier les données sans effet sur le isiteur. Dans le diagramme ci-dessous, ous pouez oir comment plusieurs instances d'ibm Tealeaf CX Passie Capture Application peuent alimenter le même pipeline. Chaque instance d'ibm Tealeaf CX Passie Capture Application pouant être configurée aec des options de distribution indiiduelles, la destination en aal de chaque instance de la PCA peut correspondre au même pipeline sur le même sereur. Voir "Configuration de capture passie ia console Web" dans le document IBM Tealeaf Passie Capture Application - Guide. 224 IBM Tealeaf CX - Guide de configuration

235 Figure 24. Plusieurs instances IBM Tealeaf CX Passie Capture Application alimentant le même pipeline Cette section coure les bases de la configuration du pipeline IBM Tealeaf CX. Modes de capture La technologie Tealeaf fournit les modes de capture suiants : Le mode Business capture les données HTML. Il ne capture pas les données binaires telles que les fichiers aux formats GIF, JPEG et PDF. Le mode BusinessIT capture les mêmes informations que le mode de capture Business, mais il capture également les fichiers de demande de toutes les données, y compris les demandes de données binaires. Le mode BusinessIT ne capture pas les fichiers binaires eux-mêmes. Les modes ci-dessus sont configurés dans IBM Tealeaf CX Passie Capture Application. Voir "Configuration de capture passie ia console Web" dans le document IBM Tealeaf Passie Capture Application - Guide. Pipelines par défaut Suiant le rôle du sereur sur lequel ous installez le pipeline, les pipelines ci-après correspondent aux configurations par défaut du déploiement. Dans les sections ci-après, les agents de session requis sont répertoriés suiant l'ordre dans lequel ils apparaissent dans le pipeline. Remarque : Tous les agents de session répertoriés sont requis. Vous pouez en ajouter au pipeline. Sereur de traitement sans HBR Pour un sereur de traitement (Canister) non précédé d'un sereur HBR (Health-Based Routing), le pipeline ci-après est le pipeline par défaut. Chapitre 4. Agents de session de pipeline CX 225

236 Configuration du serice de transport «Agent de session Dépose de données», à la page 254 «Agent de session DecoupleEx», à la page 266 «Agent de session Déploiement», à la page 285 «Agent de session Confidentialité», à la page 307 "Agent de session de référence Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session Canister», à la page 249 Sereur de traitement aec HBR Pour un sereur de traitement précédé d'un sereur HBR, le pipeline qui suit est le pipeline par défaut. Pour cette configuration, le sereur HBR contient la plupart des agents de session de traitement. Voir «Sereur HBR». Pour plus d'informations sur HBR, oir «Agent de session Health-Based Routing (HBR)», à la page 278. Configuration du serice de transport «Agent de session Dépose de données», à la page 254 «Agent de session DecoupleEx», à la page 266 «Agent de session Routeur de session», à la page 350 «Agent de session Canister», à la page 249 Sereur HBR Pour le sereur HBR (Health-Based Routing) de otre enironnement, le pipeline ci-après est la configuration par défaut. Pour plus d'informations sur HBR, oir «Agent de session Health-Based Routing (HBR)», à la page 278. Configuration du serice de transport «Agent de session Dépose de données», à la page 254 «Agent de session DecoupleEx», à la page 266 «Agent de session Déploiement», à la page 285 «Agent de session Confidentialité», à la page 307 "Agent de session de référence Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session Health-Based Routing (HBR)», à la page 278 Comment configurer le pipeline Dans la plupart des enironnements, le programme d'installation de Tealeaf préconfigure automatiquement le pipeline en fonction des composants sélectionnés pour l'installation. Par exemple, si le composant Traitement a select été sélectionné, le programme d'installation ajoute l'agent de session Canister au pipeline. Ainsi, dans la plupart des cas, aucune autre configuration des agents de session de pipeline n'est requise. Vous pouez configurer des pipelines indiiduels pour chaque port auquel IBM Tealeaf CX Passie Capture Application transmet les données capturées. Les pipelines peuent également être organisés en relations parent/enfant. Si nécessaire, ous pouez configurer les pipelines principaux et enfant à l'aide de l'éditeur de pipeline, disponible ia TMS. L'éditeur de pipeline est une interface 226 IBM Tealeaf CX - Guide de configuration

237 graphique accessible par les administrateurs Tealeaf ia TMS dans le portail Tealeaf. Vous pouez faire glisser des éléments pour générer os pipelines afin de traiter les données Tealeaf capturées. Pour plus d'informations sur TMS et l'éditeur de pipeline, oir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Remarque : En fonction des produits Tealeaf dont ous possédez une licence, certaines fonctionnalités d'agent de session risquent de ne pas être disponibles. Remarque : La configuration du pipeline peut également être effectuée en éditant un fichier de configuration. Dans les futures ersions, cette option ne sera peut-être plus disponible ; il est donc recommandé d'utiliser l'éditeur de pipeline pour configurer les pipelines. Pour plus d'informations sur la configuration manuelle, oir «Configuration manuelle des pipelines», à la page 228. Configuration aec filtre de capture Configuration du filtre de capture Dans le cadre d'une étude de faisabilité, ous pouez configurer un filtre de capture pour effectuer des serices de capture ia Microsoft IIS. Cette méthode de capture permet un déploiement rapide du système Tealeaf sans aoir à implémenter un sereur IBM Tealeaf CX Passie Capture Application dédié. Toutefois, la capture ia IID a une incidence sur les performances. Les paramètres de capture sont contrôlés par le fichier de configuration du filtre de capture. Chaque plateforme prise en charge possède son propre fichier de configuration de capture. Ce chapitre explique comment modifier le fichier de configuration de capture pour contrôler les données capturées résultantes. Serice ou source de capture Nom du fichier de configuration Microsoft IIS TeaLeafIIS.cfg Capture Tealeaf côté client Configurée à l'aide de la barre d'outils Tealeaf que ous pouez installer dans Microsoft Internet Explorer. Le logiciel Client-Side Capture est fourni aec la distribution Tealeaf. Serice de transport Tealeaf TeaLeafCaptureSocket.cfg Schéma des cookies Tealeaf Le filtre de capture Web de Tealeaf utilise trois types de cookies pour identifier le contenu appartenant à une session et déterminer où chaque session démarre et s'arrête. Le format du cookie consiste en un identificateur global unique de 32 octets. Les trois cookies suiants sont utilisés : TLTSID (Session) est un cookie temporaire, actif uniquement pendant la durée d'une session de naigation, qui permet de regrouper les hits dans une session. L'utilisateur final peut choisir ou non d'autoriser ce cookie. TLTHID (Hit) Affecté au sereur, un cookie de hit permet d'identifier un hit dans une session. Ce cookie temporaire est utile pour le traitement côté sereur du hit. Par exemple, si le hit est traité par un sereur d'applications ou un sereur qui gère l'instrumentation aec l'api des éénements, TLTHID est utilisé par ce sereur pour identifier le hit. L'utilisateur final n'est aucunement en mesure de décider si TLTHID doit être autorisé ou non. Chapitre 4. Agents de session de pipeline CX 227

238 TLTUID (Utilisateur) est un cookie persistant aec un long délai d'expiration permettant de déterminer l'utilisateur qui a généré la session. L'utilisateur final peut décider si ce cookie doit être autorisé ou non. Ce cookie n'est disponible que pour les applications exécutées sous Internet Information Serices (IIS). Le filtre de capture Web de Tealeaf génère ces cookies et doit être installé sur le sereur Web. Les cookies sont isibles par le sereur d'applications en aal. Sureillance du statut de capture des sockets A l'aide de TMS, ous pouez sureiller les informations statistiques sur le processus de capture des sockets pour chaque pipeline de otre enironnement. Dans l'onglet Statut du pipeline, ous pouez oir les connexions acties, les itesses de transfert en octets et les ues de page actuellement testées dans les données du pipeline. Vous pouez également examiner la manière dont les données sont transmises par l'intermédiaire de chaque agent de session dans le pipeline. Voir "Onglet Statut du pipeline TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. Configuration manuelle des pipelines Par l'intermédiaire d'un même fichier de configuration, ous pouez définir un ou plusieurs pipelines pour manipuler les données capturées. Dans le répertoire d'installation de Tealeaf, le fichier TeaLeafCaptureSocket.cfg contient les configurations de chaque agent de session disponible dans otre solution Tealeaf. Génération d'un pipeline dans le fichier de configuration Vous pouez configurer des pipelines indiiduels pour chaque port auquel IBM Tealeaf CX Passie Capture Application transmet les données capturées. 1. Dans un éditeur de texte, ourez TeaLeafCaptureSocket.cfg. 2. Dans la section [Globals], ous pouez spécifier le numéro de port qui recera le trafic standard ou SSL. Dans l'exemple ci-après, le trafic standard (Port) est capturé sur le port 1966 et transmis à l'agent de session DataDrop. Le trafic SSL (SSLPort) est capturé sur le port 1967 et transmis à l'agent de session DecoupleSSL : Port=1966:DataDrop #SSLPort=1967:DecoupleSSL 228 IBM Tealeaf CX - Guide de configuration #* Pour plus d'informations sur la configuration d'ibm Tealeaf CX Passie Capture Application pour enoyer le trafic à un port spécifique, oir "Configuration" dans le document IBM Tealeaf Passie Capture Application - Guide. 3. Notez que le pipeline SSL est en commentaire (#), ce qui signifie qu'il est actuellement désactié. Pour actier un pipeline, supprimez le #. 4. Configurez la section [firewall]. Voir «Configuration des paramètres du pare-feu», à la page Pour le pipeline du port du trafic standard, l'agent de session DataDrop lance le pipeline. Recherchez la chaîne suiante dans le fichier : [DataDrop]. 6. Dans l'agent de session Dépose de données, configurez tous les paramètres de l'agent de session, y compris l'élément de configuration suiant : DownStreamConfigSection=DecoupleEx #* Les paramètres des agents de session indiiduels sont décrits ailleurs. Pour une liste des agents de session disponibles, oir «Présentation du pipeline de capture et des agents de session», à la page La propriété DownStreamConfigSection indique l'agent de session suiant auquel les données générées par DataDrop doient être transmises. Si ous

239 recherchez la chaîne suiante dans le fichier : [DecoupleEx], ous pouez oir la propriété DownStreamConfigSection, qui pointe ers l'agent de session suiant, etc. 8. De cette manière, ous pouez générer otre pipeline jusqu'à ce que ous atteigniez les agents de session de pipeline finaux : a. L'agent de session [Canister] transmet les données de session à un Canister Tealeaf à court terme. Voir «Agent de session Canister», à la page 249. b. L'agent de session [Archie] enregistre les données de session dans un fichier d'archiage Tealeaf (TLA) sur le disque dur du sereur. Voir «Agent de session Archiage», à la page 238. c. L'agent de session [Null] supprime les données, à des fins de débogage. d. Vous pouez également pointer la fin d'un pipeline ers le début du suiant. Voir «Configuration de plusieurs pipelines», à la page 231. Configuration des paramètres du pare-feu : Par défaut, le processus TealeafCaptureSocket accepte les connexions à partir d'une machine éloignée, en supposant qu'elle respecte le protocole du serice de transport Tealeaf. La section Pare-feu du fichier TealeafCaptureSocket.cfg permet de restreindre les unités de capture éloignées autorisées à communiquer aec le sereur IBM Tealeaf CX. Cette section contient les adresses des hôtes éloignés autorisés à enoyer des données au serice de transport Tealeaf. Lorsqu'une connexion est acceptée pour la première fois, les adresses expéditrices sont érifiées par rapport à l'ensemble d'adresses spécifié dans le paramètre RemoteHosts. Toute adresse qui ne se troue pas dans la liste est recherchée, déconnectée et consignée lors du prochain ReportingInteral si la consignation est actiée. Paramètres du pare-feu : Les aleurs Nom d affichage sont affichées dans TMS, cette méthode étant recommandée pour configurer les agents de session. Voir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Les aleurs Nom sont affichées dans TealeafCaptureSocket.cfg. Tableau 5. Configuration des paramètres du pare-feu Nom d'affichage Nom Description Remote Hosts RemoteHosts Liste séparée par des irgules d'adresses IP ou de noms d hôte résolables par le nom de source de données (DSN). Vous pouez également spécifier une plage d'adresses, séparée par un tiret. Toute adresse comprise dans la plage spécifiée est autorisée à se connecter. Dans l'exemple suiant, une adresse IP, une adresse DSN et une plage d'adresses sont spécifiées pour acceptation :RemoteHosts= , freebird2, Chapitre 4. Agents de session de pipeline CX 229

240 Tableau 5. Configuration des paramètres du pare-feu (suite) Nom d'affichage Nom Description Interalle de rapport ReportingInteral Ce paramètre définit le délai d'attente en secondes entre les générations de rapports sur les connexions rejetées. La configuration d'un interalle de génération de rapports alide éite d'encombrer le journal aec des rapports sur les connexions rejetées lorsqu'un sereur tente de se reconnecter plusieurs fois. La aleur par défaut est de 900 secondes (15 minutes). Report to Eent Log ReportToEentLog Si ce paramètre a la aleur true, les rapports sur les connexions rejetées sont également consignés dans le journal des éénements d'application Tealeaf. La aleur par défaut est false. Paramètres de l'agent de session Chaque agent de session possède des paramètres que ous pouez définir pour personnaliser les performances. Certains agents de session sont spécifiques à une source de capture particulière. Remarque : Les options de configuration ne sont pas sensibles à la casse. Paramètres communs à tous les agents de session : Chaque agent de session possède un ensemble unique d'options de configuration. En outre, certaines options sont communes à tous les agents de session. C'est notamment le cas des options suiantes : Paramètre Description DLL Nom de la bibliothèque de liaison dynamique (DLL) de l'agent de session. Si ous ne spécifiez pas de chemin complet, la DLL doit se trouer dans le même répertoire que la source de la capture (par exemple, TeaLeafIIS.dll). Les méthodes de recherche suiantes permettent de rechercher les DLL des agents de session : Recherche de la DLL à l'aide du chemin spécifié dans le fichier de configuration du pipeline de capture Recherche de la DLL dans le répertoire actuel (par exemple, le même répertoire que le fichier de configuration de capture Recherche de la DLL à l'aide de la ariable d'enironnement TEALEAFPATH Recherche de la DLL à l'aide de la ariable d'enironnement PATH TypeName Identifie le type d'agent de session. Cette aleur doit normalement être modifiée. DownStreamConfigSection Indique le composant suiant dans le pipeline. Cette zone est requise pour 230 IBM Tealeaf CX - Guide de configuration

241 tous les agents de session du pipeline, exceptés Archiage, Socket et Null, qui peuent interrompre un pipeline et ne requièrent donc pas le paramètre DownStreamConfigSection. Configuration de plusieurs pipelines Si otre application Web transmet un contenu ia des protocoles standard et SSL, ous pouez créer un pipeline dédié pour gérer le trafic SSL aant que ce dernier ne soit transmis ia le pipeline standard pour traitement. Ce pipeline peut être chargé de supprimer les informations sensibles. Une fois que le pipeline a terminé ses opérations, il peut acheminer le trafic au pipeline qui gère le trafic standard des actiités de pipeline générales. 1. Créez le pipeline SSLPort. 2. Spécifiez tous les agents de session requis pour le trafic SSL exclusif. En générale, le pipeline SSL supprime toutes les informations sensibles. Voir «Agent de session Confidentialité», à la page Une fois que ous aez créé la chaîne d'agents de session SSL, définissez la aleur suiante dans le dernier : DownStreamConfigSection=Socket 4. Dans la section [Socket], spécifiez les propriétés ci-après pour pointer ers le début du pipeline standard. Si ous utilisez un port autre que le port 1966, insérez cette aleur dans l'emplacement ci-dessous : Serer=localhost Port=1966 UseSSL=False 5. Créez le deuxième pipeline pour le port 1966 de manière standard. 6. Une fois que ous aez créé les deux pipelines, le trafic SSL est transmis au pipeline SSL, qui l'achemine ensuite au pipeline port=1966 pour un traitement standard. Configuration initiale du pipeline Remarque : cette section fournit un cadre pour la configuration initiale d'un composant du système IBM Tealeaf CX ia un modèle de déploiement simplifié. En fonction du déploiement de otre solution Tealeaf, une configuration supplémentaire peut être requise. Pour toute question concernant la configuration, contactez Une fois que les logiciels des sereurs PCA et Windows ont été installés, dans la plupart des configurations, le pipeline Windows ne requiert qu'une configuration minime pour être opérationnel. Ports d'écoute autres que les ports par défaut Si ous aez configuré la PCA à distribuer à HBR ou au sereur de traitement sur un port autre que le port 1966, ous deez configurer le destinataire pour qu'il écoute sur le port approprié. Les ports d'écoute de pipeline sont définis à l'aide de l'éditeur de pipeline dans Tealeaf Management System. Voir "Editeur de pipeline TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. 1. Aant de commencer, ous deez déterminer si ous deez utiliser SSL pour la transmission de données entre la PCA et le pipeline Windows. Voir «Configuration de la PCA et des sereurs de traitement pour utiliser SSL», à la page 233 ci-après. 2. Connectez-ous au portail Tealeaf en tant qu'administrateur. Chapitre 4. Agents de session de pipeline CX 231

242 3. Pour ourir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration, sélectionnez Tealeaf > TMS dans le menu Portail. 4. Dans la ue Sereurs, cliquez sur le noeud Serice de transport. 5. Cliquez sur Configuration du serice de transport. 6. Dans les actions de configuration, cliquez sur Afficher/Modifier. L'éditeur de pipeline s'affiche. 7. Sélectionnez le noeud supérieur du pipeline. Son nom doit être Pipeline:1966 dans une configuration par défaut. 8. Cliquez sur Modifier dans la partie inférieure de la fenêtre. 9. Dans la boîte de dialogue d'édition des paramètres de pipeline : a. Entrez le numéro de port sur lequel le sereur de traitement doit écouter ce pipeline. b. Si ous utilisez SSL entre la PCA et le sereur de traitement, cochez la case Utiliser SSL. 10. Cliquez sur Appliquer. 11. Pour fermer l'éditeur de pipeline, cliquez sur Sauegarder. Configuration de la confidentialité Remarque : Aant d'actier la capture, ous derez peut-être configurer les règles de confidentialité afin d'éiter toute capture inolontaire d'informations sensibles, par exemple le numéro de carte de crédit des clients. Si la capture est actiée alors qu'aucune règle de confidentialité appropriée n'est définie, les données des clients non filtrées peuent être enoyées ers le pipeline de Windows et stockées dans les bases de données de Tealeaf, qui peuent être consultées par tous les utilisateurs Tealeaf bénéficiant des droits nécessaires. La confidentialité Tealeaf permet de manipuler, de masquer ou de supprimer des informations sensibles dans le trafic des demandes ou des réponses. En fonction des règles de confidentialité que ous aez définies, il est possible de masquer ces données dans le trafic stocké dans les bases de données de Tealeaf. Pour plus d'informations sur la confidentialité, oir "Gestion de la confidentialité des données dans Tealeaf CX" dans le document IBM Tealeaf CX - Guide d'installation. Lors de la configuration initiale, les règles et les actions de confidentialité sont généralement définies au plus tôt dans la capture et le traitement des données de session, qui a lieu dans la PCA. En bloquant toutes les données priées ia la PCA, ous ous assurez qu'aucune information sensible n'est disponible sur le système. Pour plus d'informations sur la gestion de la confidentialité dans la PCA, oir "Console Web PCA - Onglet Règles" dans le document IBM Tealeaf Passie Capture Application - Guide. Pour des étapes de configuration initiale supplémentaires pour la confidentialité basée sur la PCA, oir "Configuration initiale de la PCA" dans le document IBM Tealeaf Passie Capture Application - Guide. En fonction du olume et du type de règles de confidentialité adoptés sur la PCA et du olume de trafic global, le sereur PCA n'arriera peut-être pas à suire le rythme de tous les hits capturés et risquera de deoir en supprimer certains. Pour réduire la charge de traitement sur la PCA, ous pouez alors choisir de transférer une partie du traitement des règles de confidentialité ers le pipeline Windows, qui est géré sur un sereur différent de celui de la PCA. 232 IBM Tealeaf CX - Guide de configuration

243 D'autres problèmes peuent entraîner la suppression de hits dans la PCA. Pour plus d'informations, accédez au site Le sereur PCA et chaque sereur de traitement peuent être configurés pour transmettre des données chiffrées, si cette couche de sécurité supplémentaire est requise. Voir «Configuration de la PCA et des sereurs de traitement pour utiliser SSL». Dans le pipeline Windows, la confidentialité est gérée en incluant les agents de session Confidentialité ou Confidentialité étendue dans otre configuration de pipeline. Par l'intermédiaire de l'un de ces deux agents de session, ous pouez définir les mêmes règles et actions de confidentialité que celles disponibles dans la PCA. L'agent de session Confidentialité étendue est l'agent de session recommandé. Voir «Agent de session Confidentialité étendue», à la page 275. Pour plus d'informations sur les règles et les actions de confidentialité, oir «Agent de session Confidentialité», à la page 307. La confidentialité est configurée ia l'éditeur de pipeline disponible dans TMS. Voir "Editeur de pipeline TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. Configuration de la PCA et des sereurs de traitement pour utiliser SSL Si otre enironnement de sécurité requiert une transmission sécurisée des données entre le sereur PCA et chaque sereur de traitement, effectuez les étapes ci-après. Remarque : L'utilisation de SSL pour la transmission de données entre les sereurs peut aoir un impact sur les performances. 1. Aant de commencer, ous deez ous procurer le texte de la clé priée à utiliser entre les sereurs. La clé est le fichier.pem, qui est placé dans le dossier Tealeaf des machines de traitement. La PCA recherche une copie du certificat Web, puis utilise ce certificat pour coder les données aant de les transmettre. 2. Pour configurer la transmission SSL sur la PCA : a. Ourez la console web PCA. Voir "Configuration de capture passie ia console Web" dans le document IBM Tealeaf Passie Capture Application - Guide. b. Cliquez sur "Console Web de PCA - Onglet Distribution" dans le document IBM Tealeaf Passie Capture Application - Guide. c. Cliquez sur le bouton d'édition en regard de la cible qui reçoit des données de la PCA. d. Dans la configuration, cochez la case Actier la distribution sécurisée. e. Dans la fenêtre affichée, collez le contenu de la clé priée. f. Cliquez sur OK. Voir "Console Web de PCA - Onglet Distribution" dans le document IBM Tealeaf Passie Capture Application - Guide. 3. Pour configurer la transmission SSL dans le pipeline Windows : a. Connectez-ous au portail Tealeaf en tant qu'administrateur. b. Pour ourir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration, sélectionnez Tealeaf > TMS dans le menu Portail. c. Dans la ue Sereurs, cliquez sur le noeud Serice de transport. d. Cliquez sur Configuration du serice de transport. e. Dans les actions de configuration, cliquez sur Afficher/Modifier. L'éditeur de pipeline s'affiche. Chapitre 4. Agents de session de pipeline CX 233

244 f. Sélectionnez le noeud supérieur du pipeline. Son nom doit être Pipeline:1966 dans une configuration par défaut. g. Cliquez sur Modifier dans la partie inférieure de la fenêtre. h. Dans la boîte de dialogue d'édition des paramètres de pipeline, cochez la case Utiliser SSL. i. Cliquez sur Appliquer. j. Pour fermer l'éditeur de pipeline, cliquez sur Sauegarder. Health-Based Routing (HBR) L'agent de session Health-Based Routing (HBR) peut être déployé pour gérer l'équilibrage de charge et la reprise en ligne dans les enironnements comportant plusieurs sereurs de traitement. Pour pouoir actier le traitement, HBR doit être ajouté à os pipelines et ous deez configurer HBR de sorte qu'il reconnaisse et achemine un olume de données approprié à chaque sereur de traitement de l'enironnement. Voir «Agent de session Health-Based Routing (HBR)», à la page 278. HBR n'est pas nécessaire dans les enironnements à un Canister. Dépose de données Si ous rencontrez des problèmes de performances dans otre pipeline Windows, ous pouez choisir de déployer l'agent de session Dépose de données, qui peut être configuré pour supprimer les données non nécessaires. Par exemple, ous pouez configurer l'agent de session Dépose de données pour qu'il supprime les images binaires, qui consomment une quantité importante de données et ne sont pas toujours utiles. L'agent de session Dépose de données est généralement déployé assez tôt dans le pipeline pour rationaliser le traitement des données. Voir «Agent de session Dépose de données», à la page 254. Test de otre configuration Après aoir terminé la configuration initiale, ous pouez effectuer les étapes suiantes afin de la érifier. Une fois que ous aez terminé la configuration d'un pipeline de base, TMS fournit le mécanisme permettant d'en examiner le traitement. Utilisez les étapes ci-après pour érifier les opérations du pipeline. Remarque : Un ensemble plus complet de tests peut être exécuté une fois que tous les composants Tealeaf ont été configurés. Voir "Test de otre solution Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration. 1. Connectez-ous au portail Tealeaf en tant qu'administrateur. 2. Dans le menu Portail, sélectionnez Tealeaf > TMS. 3. Cliquez sur l'onglet Statut du pipeline. 4. Dans la zone de texte Pipelines, sélectionnez le pipeline que ous enez de configurer, si plusieurs pipelines sont disponibles. 5. Dans le panneau supérieur droit, ous pouez examiner les agents de session actuellement configurés dans le pipeline. Vérifiez que les hits sont transmis entre les agents de session pour être distribués. Voir "Onglet Statut du pipeline TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. 6. Si le pipeline distribue les hits à un Canister Tealeaf, ous pouez rechercher les sessions acties dans le Canister. Des hits doient aoir été ajoutés à ces sessions acties. Il peut s'aérer utile d'ourir une session qui ous est propre 234 IBM Tealeaf CX - Guide de configuration

245 sur l'application Web sureillée par Tealeaf. En parcourant l'application Web, ous pourrez peut-être suire os actiités comme dans une session actie. Voir "Recherche de données de session" dans le document IBM Tealeaf cximpact - Guide d'utilisation. Une fois que tous les composants Tealeaf ont été configurés, ous deez effectuer un test de bout en bout. Voir "Test de otre solution Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration. Présentation du pipeline de capture et des agents de session Le pipeline de capture comprend une série de modules appelés agents de session. Chaque agent de session contrôle une partie du processus de capture. En fonction du type de pipeline, l'ensemble des agents de session utiles peut différer : A propos des agents de session Le pipeline Serice de transport peut utiliser tous les agents de session ci-dessous. Le pipeline Filtre de capture IIS doit normalement être limité aux agents de session Decouple et Socket. Des agents de session peuent être ajoutés et configurés ia l'éditeur de pipeline TMS. Voir «Ajout d'un agent de session», à la page 237. Agents de session disponibles Tableau 6. Agents de session disponibles Nom de l'agent Symbole de l'agent Description «Agent de session Archiage», à la page 238 "Agent de session Indexation des attributs" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session Canister», à la page 249 «Agent de session Analyseur de cookie», à la page 252 «Agent de session Dépose de données», à la page 254 «Agent de session Analyseur de données», à la page 260 [Archie] [AttrIndexer] [Canister] [CookieParser] [DataDrop] [DataParser] Sauegarde les données capturées sur disque en tant que fichiers TLA. Capture les informations d'attribut de session et les insère dans la base de données IBM Tealeaf cxreeal. Enoie les données de session au Canister à court terme. Facilite les recherches par les cookies d'analyse. Supprime les hits de demandes binaires spécifiques sans intérêt. Recherche une aleur dans la mémoire tampon REQ ou RSP, puis la définit dans une paire nom/aleur choisie par l'utilisateur dans la section [appdata] de REQ. Il est possible d'agir sur la aleur détectée à l'aide d'une expression régulière et cette aleur peut être codée au format MD5. Chapitre 4. Agents de session de pipeline CX 235

246 Tableau 6. Agents de session disponibles (suite) Nom de l'agent Symbole de l'agent Description «Agent de session Decouple», à la page 264 «Agent de session DecoupleEx», à la page 266 «Agent de session Confidentialité étendue», à la page 275 «Agent de session Health-Based Routing (HBR)», à la page 278 «Agent de session Déploiement», à la page 285 «Agent de session Analyseur mobile JSON», à la page 289 «Agent de session Code géré», à la page 303 «Agent de session Null», à la page 306 «Agent de session Confidentialité», à la page 307 «Agent de session RTA (Real-Time Monitoring and Alert)», à la page 341 «Agent de session Balises de réponse pour la demande», à la page 346 «Agent de session Fractionnement RTA», à la page 348 «Agent de session de mise en sessions», à la page 353 «Agent de session Routeur de session», à la page 350 [Decouple] [DecoupleEx] [PriacyEx] [HBR] [Inflate] diers diers [Null] [Priacy] [RTA] [RSPTags2REQ] [RTASplit] [Sessioning] [SessionRouter] Dissocie le pipeline de capture de l'unité d'exécution principale du sereur et met les hits en file d'attente uniquement en mémoire. Gère les hausses soutenues du olume de trafic en régulant le olume de hits qui entrent dans le Canister pour l'empêcher d'être surchargé. Agent de session [Priacy] étendu aec fonctions de hachage MD5 et total de contrôle. Routeur dynamique du trafic basé sur la santé des sereurs de traitement. Déeloppe les données du pipeline de capture qui ont été compressées aec GZIP pour le transfert HTTP. Actie la capture des éénements des applications naties sur les périphériques mobiles à l'aide des structures de consignation de Tealeaf. Les messages sont soumis ia JSON. Autorise les fonctionnalités personnalisées écrites en C# ou VB.NET. Arrête le pipeline et n'effectue aucune action sur les données. Offre le blocage par règles ou le chiffrement des données sensibles. Identifie les erreurs dans les données capturées et effectue une ou plusieurs des actions suiantes : enregistre un éénement dans le journal des éénements Windows, génère un éénement d'application TeaLeaf dans le fichier de demande enregistré, supprime le hit ou enoie un courrier électronique. Recherche dans la mémoire tampon de la réponse des balises à ajouter à la section [appdata] de la demande. Permet d'acheminer le trafic ers les pipelines enfant. Utilise un hachage MD5 ou une zone de demande spécifiée pour générer l'id session. Conçu pour les cas de simple routage ou échantillonnage des sessions. 236 IBM Tealeaf CX - Guide de configuration

247 Tableau 6. Agents de session disponibles (suite) Nom de l'agent Symbole de l'agent Description «Agent de session Socket», à la page 356 «Agent de session Consignateur de statistiques», à la page 358 "Agent de session de référence Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session Mise en sessions Tealeaf», à la page 384 «Agent de session TimeGrades», à la page 390 [Socket] [StatsLogger] [TLTRef] [TLSessioning] [TimeGrades] Transfère les données capturées ers une autre machine ia un réseau TCP/IP. Gère l'assemblage et l'insertion des statistiques sur les hits dans la base de données des statistiques. Normalise certaines informations sur les hits, telles que l'url, le sereur, l'hôte et l'application. Met en session dans le pipeline pour les cas complexes. Attribue un nieau à un hit dans les trois zones suiantes : Durée de génération des pages, Durée d'aller-retour et Durée réseau. «Agent de session TLI», à la page 392 [TLI] Capture le contenu statique et l'insère dans des fichiers TLI stockés sur le sereur TLI. «Agent de session de décodage d'url», à la page 408 [URLDecode] Conertit les caractères de la demande URL représentés en données hexadécimales en caractères ASCII. Ajout d'un agent de session Des agents de session peuent être ajoutés, configurés et supprimés de os pipelines ia l'éditeur de pipeline dans TMS. Cette interface graphique permet le déeloppement, le déploiement et le test rapides de pipelines et d'agents de session indiiduels tout en éliminant les erreurs de configuration potentielles. Pour un récapitulatif de chaque agent de session, oir «Présentation du pipeline de capture et des agents de session», à la page 235. Pour plus d'informations sur des agents de session spécifiques, utilisez les liens ci-après. 1. Connectez-ous au portail Tealeaf en tant qu'administrateur. 2. Sélectionnez Tealeaf > TMS. 3. Cliquez sur le noeud Serice de transport. 4. Cliquez sur Configuration du serice de transport. 5. Dans le panneau Actions, cliquez sur Afficher/Modifier. 6. L'éditeur de pipeline s'affiche. Pour ajouter un agent de session à otre pipeline, faites-le glisser du panneau Agents de session disponibles ers le pipeline. L'agent de session est ajouté. Vous pouez le faire glisser de la liste des agents de session ers le pipeline pour le repositionner. Lorsque ous ajoutez ou déplacez un agent de session, les modifications de configuration permettant de connecter les agents de session d'un pipeline sont gérées automatiquement. Pour éditer un agent de session dans le pipeline, sélectionnez-le. Pour éditer l'instance sélectionnée de l'agent, cliquez sur Modifier. Chapitre 4. Agents de session de pipeline CX 237

248 Pour renommer l'agent sélectionné, cliquez sur Renommer. Entrez un noueau nom et appuyez sur ENTREE. Pour supprimer un agent de session d'un pipeline, faites-le glisser du pipeline ers l'un des panneaux de droite. Si ous souhaitez sauegarder l'agent de session, faites-le glisser dans le panneau Agents de session sauegardés. Agent de session Archiage L'agent de session Archiage sauegarde les données capturées sur disque. Les fichiers résultants sont nommés comme suit : TLT_MachineName_ID_GMT_YYYYMMDD_StartTime_EndTime.ext Remarque : L'agent de session Archiage étant un agent de session final, l'option -DownStreamConfigSection n'est pas requise. Ajout de l'agent de session Des agents de session peuent être ajoutés ia l'éditeur de pipeline dans TMS. Voir «Ajout d'un agent de session», à la page 237. Pour plus d'informations sur l'éditeur de pipeline et TMS, oir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Le reste de cette page décrit les options de configuration et la manière de les modifier ia le fichier TealeafCaptureSocket.cfg stocké sur le sereur. Ces paramètres sont également disponibles ia l'éditeur de pipeline, cette méthode étant recommandée pour configurer les agents de session. Options Paramètre Description MachineName Nom du sereur qui capture les données ID Identifie le type de données capturées. AAAAMMJJ représente la date à laquelle la capture a eu lieu dans le fichier d'archie. StartTime et EndTime Représente la plage horaire dans le temps moyen de Greenwich entre les première et dernière pages des données capturées contenues dans le fichier d'archie. EndTime inclut les millisecondes. ext Extension de fichier spécifiée par l'utilisateur. Paramètres de configuration Vous disposez des paramètres de configuration suiants : Les aleurs Nom d affichage sont affichées dans TMS, cette méthode étant recommandée pour configurer les agents de session. Voir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Les aleurs Nom sont affichées dans TealeafCaptureSocket.cfg. 238 IBM Tealeaf CX - Guide de configuration

249 Tableau 7. Agent de session Archiage Nom Nom d'affichage Archie FileID Prefix Max Archie Size Archie Directory Archie Roll Time Disk Quota Scan Interal MaxLogSize LogDirectory RollTime QuotaScanTime Description Définit l'id qui apparaît dans le nom de fichier TLA de sorte que le type de capture d'un fichier soit plus facile à identifier. Spécifiez cette aleur comme suit : FileID=id où id représente la description de type de capture à ajouter au nom de otre fichier d'archie. Les noms Web et BusinessEent représentent des exemples de noms FileID. Indique la taille maximale du fichier TLA de l'archie en octets. La aleur par défaut est de 32 Mo. Les aleurs alides peuent être entrées comme suit : number numberkb pour spécifier le nombre de kilooctets numbermb pour spécifier le nombre de mégaoctets numbergb pour spécifier le nombre de gigaoctets Remarque : La taille minimale du fichier TLA d'une archie est de 10 Mo. Indique le répertoire dans lequel sont stockés les fichiers de données. Par défaut, les fichiers sont stockés dans C:\temp. Cette liste délimitée par des irgules spécifie les heures au format GMT de 24 heures auxquelles le fichier d'archie actuel doit être fermé et un noueau doit être créé. L'exemple suiant crée un fichier journal à 1h00, 4h30 et 17h00 GMT tous les jours : RollTime=01:00, 04:30, 17:00 Indique l'interalle en secondes entre les érifications de quota de disque. Les aleurs alides sont comprises entre 20 et 3600 (ingt secondes et soixante minutes). Par exemple, ous pouez définir le délai d'analyse du quota comme suit : QuotaScanTime=60 La aleur minimale de QuotaScanTime est de 20. Chapitre 4. Agents de session de pipeline CX 239

250 Tableau 7. Agent de session Archiage (suite) Nom d'affichage % du disque disponible Nom QuotaPctFree Description Indique le pourcentage de disponibilité du répertoire spécifié à l'aide de l'option QuotaDir. Si la quantité d'espace disponible deient inférieure à ce seuil, le filtre de capture se désactie pour éiter de consommer trop d'espace disque. Sous Microsoft Windows NT 4.0, l'espace disque des répertoires correspond à l'espace disque global. Sous Microsoft Windows 2000 ou une ersion ultérieure, ous pouez établir des quotas de répertoires. Agents de session Tealeaf «Ajout d'un agent de session», à la page 237 Agent de session Archiage "Agent de session Indexation des attributs" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session Canister», à la page 249 «Agent de session Analyseur de cookie», à la page 252 «Agent de session Dépose de données», à la page 254 «Agent de session Analyseur de données», à la page 260 «Agent de session Decouple», à la page 264 «Agent de session DecoupleEx», à la page 266 «Agent de session Confidentialité étendue», à la page 275 «Agent de session Health-Based Routing (HBR)», à la page 278 «Agent de session Déploiement», à la page 285 «Agent de session Analyseur mobile JSON», à la page 289 «Agent de session Code géré», à la page 303 «Agent de session Null», à la page 306 «Agent de session Confidentialité», à la page 307 «Agent de session RTA (Real-Time Monitoring and Alert)», à la page 341 «Agent de session Balises de réponse pour la demande», à la page 346 «Agent de session Fractionnement RTA», à la page 348 «Agent de session de mise en sessions», à la page 353 «Agent de session Routeur de session», à la page 350 «Agent de session Socket», à la page 356 «Agent de session Consignateur de statistiques», à la page 358 "Agent de session de référence Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session de référence Tealeaf - Mode existant», à la page 380 «Agent de session Mise en sessions Tealeaf», à la page IBM Tealeaf CX - Guide de configuration

251 «Agent de session TimeGrades», à la page 390 «Agent de session TLI», à la page 392 «Agent de session de décodage d'url», à la page 408 Agent de session Indexation des attributs L'agent de session Indexation des attributs peut être déployé pour extraire les informations sur les attributs de session des données d'éénement Tealeaf et insérer ce contenu dans la base de données IBM Tealeaf cxreeal (TL_SEARCH). Cet agent de session est déployé dans un pipeline Windows qui reçoit les données d'éénement ia le bus d'éénements Tealeaf actié et configuré sur chaque sereur de traitement de l'enironnement. Remarque : Le bus d'éénements Tealeaf est un composant de cxconnect pour l'analyse des données, inclus dans la plateforme Tealeaf CX et dont la licence s'achète séparément. Contactez otre interlocuteur IBM Tealeaf. Disponible ia IBM Tealeaf cxreeal, la base de données IBM Tealeaf cxreeal permet aux utilisateurs Tealeaf de rechercher rapidement des sessions Tealeaf, quel que soit leur état de capture et de traitement, en recherchant des attributs de session. Ces attributs de session peuent être spécifiés dès que le premier hit a été éalué dans le pipeline Windows. Par exemple, la aleur de l'identificateur de connexion est généralement définie de sorte à alimenter l'attribut SessionAttribute00 dès que le isiteur se connecte à l'application Web. Lorsque le premier attribut de session est détecté par l'agent de session, un nouel enregistrement de la session est inséré dans la base de données IBM Tealeaf cxreeal. Remarque : La base de données cxreeal est un composant de cxreeal, inclus dans la plateforme Tealeaf CX et dont la licence s'achète séparément. Contactez otre interlocuteur IBM Tealeaf. Cet enregistrement de base de données peut être immédiatement interrogé et extrait ia une recherche de portail par les utilisateurs IBM Tealeaf cxreeal, ce qui permet à ces derniers de rechercher rapidement des sessions de isiteur, si nécessaire. Ces enregistrements de isiteur étant stockés dans une même base de données SQL Serer, la recherche et l'extraction d'informations sur les isiteurs est extrêmement rapide. Pour plus d'informations sur la recherche par attribut de session, oir "cxreeal - Recherche de sessions par attribut de session" dans le document IBM Tealeaf cxreeal - Guide d'utilisation. Remarque : Le déploiement de plusieurs sereurs IBM Tealeaf cxreeal est pris en charge pour les applications Web de olume supérieur. Prérequis Remarque : Cette section décrit comment configurer le pipeline et le sereur IBM Tealeaf cxreeal pour la capture des attributs de session. Pour actier la solution de bout en bout pour la capture, la recherche et la relecture des attributs de session, une configuration supplémentaire est requise dans le portail. Aant de commencer, ous deez examiner les autres étapes de configuration. Voir "Configuration de la recherche d'attributs de session" dans le document IBM Tealeaf cxreeal - Guide d'administration. Chapitre 4. Agents de session de pipeline CX 241

252 1. IBM Tealeaf cximpact : l'agent de session Indexation des attributs est disponible ia IBM Tealeaf cximpact. 2. IBM Tealeaf cxconnect for Data Analysis : la capture des informations d'attribut de session de chaque Canister requiert l'utilisation du bus d'éénements Tealeaf pour enoyer des éénements au pipeline désigné pour la capture. Voir "Bus d'éénement Tealeaf" dans le document IBM Tealeaf cxconnect for Data Analysis - Guide d'administration. 3. IBM Tealeaf cxreeal : la base de données IBM Tealeaf cxreeal est un composant d'ibm Tealeaf cxreeal, un produit du système IBM Tealeaf CX dont la licence s'achète séparément. IBM Tealeaf cxreeal requiert une installation distincte sur chaque sereur IBM Tealeaf cxreeal. Voir "Installation de cxreeal" dans le document IBM Tealeaf cxreeal - Guide d'administration. L'actiation de la recherche d'attributs de session requiert une configuration supplémentaire. Voir "Configuration de la recherche d'attributs de session" dans le document IBM Tealeaf cxreeal - Guide d'administration. Remarque : L'agent de session Indexation des attributs ne doit pas être déployé dans un pipeline Windows où un autre traitement est effectué. Cet agent de session requiert un pipeline Windows dédié et un sereur IBM Tealeaf cxreeal distinct. Installation de cxreeal : Aant que ous ne commenciez, le serice de transport Tealeaf et la base de données IBM Tealeaf cxreeal doient être installés sur chaque sereur IBM Tealeaf cxreeal. Voir "Installation de cxreeal" dans le document IBM Tealeaf cxreeal - Guide d'administration. La base de données IBM Tealeaf cxreeal peut être installée séparément sur le même système, à l'aide du gestionnaire de base de données de Tealeaf. Voir "Utilisation du gestionnaire de base de données Tealeaf" dans le Guide des bases de données IBM Tealeaf. Voir "Base de données cxreeal" dans le Guide des bases de données IBM Tealeaf. Flux de traaux de configuration L'architecture de base des pipelines d'indexation des attributs consiste à extraire le contenu de l'un de os pipelines Windows existants et de l'enoyer à un pipeline Windows sur le sereur IBM Tealeaf cxreeal afin d'insérer les informations sur les attributs de session dans la base de données IBM Tealeaf cxreeal. 1. Si ous ne l'aez pas déjà fait, ous deez installer le sereur de traitement et la base de données IBM Tealeaf cxreeal sur chaque sereur IBM Tealeaf cxreeal dédié. Plusieurs modèles de déploiement sont pris en charge pour la base de données IBM Tealeaf cxreeal. Voir "Installation de cxreeal" dans le document IBM Tealeaf cxreeal - Guide d'administration. 2. Dans le cadre de la procédure d'installation, un pipeline par défaut est créé. Il contient le nombre minimal d'agents de session pour capturer et insérer les informations sur les attributs de session dans la base de données, y compris l'agent de session Indexation des attributs. Pour plus d'informations sur la configuration des pipelines, oir "Editeur de pipeline TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. Voir «Pipeline de traitement Indexation des attributs», à la page Configurez les paramètres de l'agent de session Indexation des attributs. Voir «Configuration de l'agent de session Indexation des attributs», à la page IBM Tealeaf CX - Guide de configuration

253 4. Dans les pipelines Windows principaux qui enoient des hits ia le bus d'éénements au sereur de traitement qui gère l'indexation des attributs, actiez le bus d'éénements et configurez-le. Voir «Configuration du bus d'éénements», à la page Une fois que le bus d'éénements a été actié et testé en local, le pipeline Bus d'éénements doit être configuré pour enoyer des éénements Tealeaf au système de destination. Voir «Pipeline Bus d'éénements minimal», à la page Répétez la configuration du bus d'éénements pour chaque sereur de traitement pour enoyer les éénements aux sereurs IBM Tealeaf cxreeal. 7. Une fois que ous aez effectué les étapes de configuration, ous pouez tester la capture dès que des données arrient dans le pipeline. Voir «Test de capture des attributs», à la page 248. Pipeline de traitement Indexation des attributs : Dans les sections suiantes, ous étudier la configuration de pipeline minimale requise pour permettre la capture des attributs de session. Il s'agit d'exigences minimales. Le pipeline requis pour otre enironnement Tealeaf peut arier. Remarque : Le programme d'installation d'ibm Tealeaf cxreeal configure le pipeline à utiliser par défaut ci-après. Si ce pipeline répond à os besoins, il se peut qu'aucune autre configuration ne soit requise. Si ous le souhaitez, ous pouez examiner les paramètres disponibles pour l'agent de session. Voir «Configuration de l'agent de session Indexation des attributs», à la page 245. Le pipeline utilisé pour capturer les attributs de session et les insérer dans la base de données IBM Tealeaf cxreeal requiert la configuration minimale suiante : DataDrop > DecoupleEx > SessionRouter > AttrIndexer > Null Tealeaf recommande d'utiliser l'agent de session de pipeline DecoupleEx. DecoupleEx permet le spoulage des hits dans le pipeline en cas de surcharge (par exemple, si une recherche étendue est exécutée). Si l'agent de session DecoupleEx est déployé, les statistiques sur les performances du pipeline performance peuent être affichées dans le portail. Voir "Statut système" dans le document IBM Tealeaf cximpact - Guide d'administration. Eitez d'utiliser Decouple dans le pipeline de recherche d'ibm Tealeaf cxreeal. Voir "Agent de session DecoupleEx" dans le document IBM Tealeaf CX - Guide de configuration. Remarque : L'agent de session Indexation des attributs doit être configuré de sorte que son agent de session en aal soit l'agent de session Null. Voir «Configuration de l'agent de session Indexation des attributs», à la page 245. Remarque : Dans pratiquement tous les enironnements, les règles de confidentialité Tealeaf ne sont pas nécessaires pour ce pipeline car l'agent de session final est l'agent de session Null. Si la confidentialité est requise pour satisfaire os exigences de sécurité, ous pouez insérer l'agent de session Confidentialité ou Confidentialité étendue après l'agent de session Decouple dans le pipeline ci-dessus. Voir "Agent de session Confidentialité" dans le document IBM Tealeaf CX - Guide de configuration. Voir "Agent de session Confidentialité étendue" dans le document IBM Tealeaf CX - Guide de configuration. Chapitre 4. Agents de session de pipeline CX 243

254 Pour plus d'informations sur la configuration des pipelines Windows, oir "Editeur de pipeline TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. Ajout de l'agent de session : Des agents de session peuent être ajoutés ia l'éditeur de pipeline dans TMS. Pour plus d'informations, oir : "Ajout d'un agent de session" dans le document IBM Tealeaf CX - Guide de configuration "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration Configuration du bus d'éénements Le bus d'éénements Tealeaf permet la distribution d'éénements Tealeaf à d'autres systèmes ou pipelines pour une analyse ou une utilisation hors ligne. Remarque : Le bus d'éénements Tealeaf est un composant de cxconnect pour l'analyse des données, inclus dans la plateforme Tealeaf CX et dont la licence s'achète séparément. Contactez otre interlocuteur IBM Tealeaf. Aant de déployer l'agent de session, ous deez effectuer les tâches de configuration suiantes sur chaque sereur de traitement de l'enironnement qui enoie des données d'éénement à capturer par l'agent de session : 1. Actiez le bus d'éénements. Remarque : Lorsque ous actiez le bus d'éénements, n'incluez pas les données de réponse. L'agent de session Indexation des attributs ne collectant que des informations au nieau session, l'inclusion de données de réponse indiiduelles consomme inutilement de la bande passante pour transférer ces données au sereur IBM Tealeaf cxreeal. 2. Actiez le pipeline Bus d'éénements qui se troue sur le sereur de traitement l'hébergeant. 3. Configurez le pipeline Bus d'éénements. 4. Testez le pipeline Bus d'éénements en enregistrant des données d'éénement dans une archie Tealeaf. Ces étapes sont décrites dans la documentation du bus d'éénements. Voir "Bus d'éénement Tealeaf" dans le document IBM Tealeaf cxconnect for Data Analysis - Guide d'administration. Pipeline Bus d'éénements minimal : Une fois que le bus d'éénements a été actié, configuré et testé sur chaque sereur de traitement qui soumet des données d'éénement à capturer, ous pouez configurer les pipelines Bus d'éénements pour transmettre des données à la machine dédiée à la capture des données d'attribut de session. 1. Dans le menu Portail, sélectionnez Tealeaf > TMS. 2. Cliquez sur l'onglet WorldView. 3. Dans le menu déroulant Sereur, sélectionnez l'un des sereurs de traitement qui enoie des données à la machine des attributs de session. 4. Cliquez sur le noeud Canister. 5. Cliquez sur Eent Bus configuration. Dans la sous-fenêtre Actions de configuration, cliquez sur Afficher/Modifier. 6. Le pipeline Bus d'éénements s'affiche dans l'éditeur de pipeline. Voir "Editeur de pipeline TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. 244 IBM Tealeaf CX - Guide de configuration

255 7. Lors des tests, il se peut que ous ayez déployé l'un des agents de session ci-après comme dernier agent de session du pipeline (agent de session final). "Agent de session Null" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session Archiage" dans le document IBM Tealeaf CX - Guide de configuration 8. Une fois que ous êtes prêt à enoyer des données à la machine de capture des attributs de session, remplacez l'agent de session final par l'agent de session Socket. 9. Faites glisser l'agent de session final du pipeline dans la sous-fenêtre des agents de session disponibles. 10. Faites glisser l'agent de session Socket de la sous-fenêtre des agents de session disponibles de sorte qu'il deienne le dernier agent de session du pipeline. 11. Le pipeline doit ressembler à ceci : Decouple > <autres_agents> > Socket où : <autres_agents> peut correspondre à zéro, un ou plusieurs agents de ssesion, suiant les exigences du bus d'éénements. 12. Configurez l'agent de session Socket. Voir «Configuration de l'agent de session Socket». 13. Enregistrez os modifications. 14. Enoyez les modifications aux autres sereurs. 15. Répétez ces modifications de configuration pour chaque bus d'éénements sur les sereurs de traitement de otre enironnement. Configuration de l'agent de session Socket : Cet agent de session arrête tous les pipelines Bus d'éénements qui enoient des données d'éénement en ue de leur traitement par un autre pipeline. Les paramètres ci-après doient être configurés pour le pipeline Bus d'éénements pour chaque sereur de traitement qui distribue des éénements. Voir "Editeur de pipeline TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. Paramètre Description Port Spécifiez le port utilisé par le pipeline qui capture les informations d'attribut sur le sereur IBM Tealeaf cxreeal. Sereur Spécifiez le nom d'hôte du sereur IBM Tealeaf cxreeal. Voir "Agent de session Socket" dans le document IBM Tealeaf CX - Guide de configuration. Configuration de l'agent de session Indexation des attributs Une fois que ous aez configuré le pipeline pour capturer les informations d'attribut de session, ous deez configurer l'agent de session Indexation des attributs dans le pipeline. Cet agent de session analyse le contenu des attributs de session définis par l'utilisateur. Si de nouelles aleurs d'attribut ou modifications de aleurs d'attribut sont détectées, l'agent de session utilise les informations de session disponibles pour tenter de rechercher l'enregistrement de session dans la base de données IBM Tealeaf cxreeal. Chapitre 4. Agents de session de pipeline CX 245

256 En l'absence de correspondance aec un enregistrement existant, un nouel enregistrement de session est inséré dans la base de données. Paramètres : Si le pipeline Windows est installé, les éléments de configuration des agents de session sont spécifiés automatiquement. Remarque : Ne modifiez pas les aleurs des paramètres de configuration disponibles autres que ceux répertoriés ci-dessous. Paramètre Description LogLeel Définissez le nieau de consignation de l'agent de session. Voir «Journalisation». RolloerHour Définissez l'heure à laquelle une table de base de données est créée pour stocker les attributs de session capturés du jour. MasterPipeline Un pipeline doit être configuré comme pipeline maître à des fins de maintenance. Si ous n'utilisez qu'un seul pipeline pour capturer les attributs de session, définissez cette aleur sur true. Pour plus d'informations sur la configuration de ces paramètres, oir "Editeur de pipeline TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. Journalisation : L'agent de session Indexation des attributs peut être configuré pour générer des informations de consignation. Pour actier la consignation : 1. Dans l'agent de session Indexation des attributs, ous deez configurer le paramètre LogLeel en lui affectant l'une des aleurs suiantes : status info warn error (par défaut) debug Remarque : N'utilisez le nieau debug que pour identifier et résoudre des problèmes spécifiques. Une fois que le problème a été résolu, spécifiez un nieau inférieur. 2. Sauegardez les modifications. Les fichiers journaux sont enregistrés dans le répertoire de journaux principale de Tealeaf. Le journal ci-après est enregistré à partir de l'agent de session. <répertoire_installation_tealeaf>\logs\ TLSessionAgentAttrIndex_PipelineId_YYYYMMDD.log où : PipelineId - identifie le numéro de port du pipeline. Généralement, cette aleur est de 1966 ou IBM Tealeaf CX - Guide de configuration

257 YYYYDDMM : horodatage Ce journal reçoit les informations de statut de l'agent de session une fois par minute. <répertoire_installation_tealeaf>\logs\ ReealStatus_YYYYMMDD.log où : YYYYDDMM : horodatage Zones des journaux : Les zones ci-après sont affichées dans le fichier journal ReealStatus, qui est mis à jour toutes les minutes. Les fichiers journaux ne sont mis à jour qu'à partir du pipeline maître sur chaque sereur IBM Tealeaf cxreeal. Zone(s) Description ReealStatus Statut actuel de la connexion à la base de données IBM Tealeaf cxreeal (up ou down) ReealDownReason Si le statut est down, cette zone en indique la raison. SessionsUpdated Nombre de sessions Tealeaf mises à jour au cours de la dernière minute aec des attributs de session noueaux ou modifiés. HitsSkippedAttributesUnchanged Nombre de hits ignorés au cours de la dernière minute en l'absence d'attributs de session noueaux ou mis à jour. SearchAttribute1 - SearchAttribute5 Attributs de session actuellement configurés pour accepter les recherches. IBM Tealeaf cxreeal prend en charge jusqu'à cinq attributs de session acceptant les recherches. Les attributs disponibles pour les recherches IBM Tealeaf cxreeal sont définis à l'aide du gestionnaire d'éénements. Voir "Onglet Attributs de session TEM" dans le document IBM Tealeaf Eent Manager - Guide. TrackedAttribute1 - TrackedAttribute32 Attributs de session actuellement configurés pour être suiis. IBM Tealeaf cxreeal prend en charge le suii dans la base de données d'un maximum de 32 attributs de session. Les attributs disponibles pour le suii d'ibm Tealeaf cxreeal sont définis à l'aide du gestionnaire d'éénements. Voir "Onglet Attributs de session TEM" dans le document IBM Tealeaf Eent Manager - Guide. Téléchargement des journaux : Les fichiers journaux peuent être téléchargés à l'aide de la page Gestion du portail. 1. Dans le menu Portail, sélectionnez Tealeaf > Gestion du portail. 2. Cliquez sur le lien Gérer les sereurs. 3. Sélectionnez le sereur qui héberge l'agent de session Indexation des attributs et le pipeline de capture d'ibm Tealeaf cxreeal. Chapitre 4. Agents de session de pipeline CX 247

258 4. Cliquez sur l'icône Journaux Tealeaf dans la barre d'outils. 5. Dans la liste déroulante Filtrer par, sélectionnez Attribut de session SA. Cliquez sur Rafraîchir. 6. Cliquez sur le lien du fichier journal à télécharger. Les noms des fichiers journaux doient être au format suiant : TLSessionAgentAttrIndex_YYYYMMDD.log Voir "Gestion des sereurs Tealeaf" dans le document IBM Tealeaf cximpact - Guide d'administration. Test de capture des attributs Cette section décrit comment tester la capture des attributs de session. Vérification du pipeline : A l'aide de TMS, ous pouez érifier que le pipeline fonctionne dans l'onglet Statut du pipeline. 1. Dans le menu Portail, sélectionnez Tealeaf > TMS. 2. Cliquez sur l'onglet Statut du pipeline. 3. Dans le menu Sereur, sélectionnez le sereur sur lequel les attributs de session sont éalués. 4. Vérifiez que le pipeline approprié est sélectionné dans le panneau Pipelines. 5. Dans la sous-fenêtre supérieure droite, ous pouez érifier le nombre de caractères et de hits transmis par l'intermédiaire de chaque agent de session. Les aleurs non nulles indiquent que le pipeline capture du contenu. Voir "Onglet Statut du pipeline TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. Vérification de la recherche : Le meilleur moyen de tester la capture des attributs de session consiste à effectuer une recherche ia le portail à l'aide du modèle IBM Tealeaf cxreeal pour les sessions acties. Remarque : Pour permettre les recherches, une configuration supplémentaire est requise. Voir "Configuration de la recherche d'attributs de session" dans le document IBM Tealeaf cxreeal - Guide d'administration. Si des sessions sont renoyées, l'agent de session capture les attributs de session et crée des enregistrements alides dans la base de données IBM Tealeaf cxreeal. Voir "cxreeal - Recherche de sessions par attribut de session" dans le document IBM Tealeaf cxreeal - Guide d'utilisation. Agent de session Tealeaf "Ajout d'un agent de session" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session Archiage" dans le document IBM Tealeaf CX - Guide de configuration Agent de session Indexation des attributs "Agent de session Canister" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session Analyseur de cookie" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session Dépose de données" dans le document IBM Tealeaf CX - Guide de configuration 248 IBM Tealeaf CX - Guide de configuration

259 "Agent de session Analyseur de données" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session Decouple" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session DecoupleEx" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session Confidentialité étendue" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session Health-Based Routing (HBR)" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session Déploiement" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session Analyseur mobile JSON" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session Code géré" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session Null" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session Confidentialité" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session RTA (Real-Time Monitoring and Alert)" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session Balises de réponse pour la demande" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session Fractionnement RTA" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session Mise en sessions" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session Routeur de session" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session Socket" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session Consignateur de statistiques" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session de référence Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session Mise en sessions Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session TimeGrades" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session TLI" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session Décodage d'url" dans le document IBM Tealeaf CX - Guide de configuration Agent de session Canister Cet agent de session représente l'interface aec le magasin de données Tealeaf. Les données capturées sont compressées, mises en sessions et insérées dans le magasin de données. Chapitre 4. Agents de session de pipeline CX 249

260 Remarque : Pour certains déploiements du sereur de traitement, cet agent de session est inclus dans le pipeline par défaut et est requis. Voir «Configuration du pipeline CX», à la page 224. Ajout de l'agent de session Des agents de session peuent être ajoutés ia l'éditeur de pipeline dans TMS. Voir «Ajout d'un agent de session», à la page 237. Pour plus d'informations sur l'éditeur de pipeline et TMS, oir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Le reste de cette page décrit les options de configuration et la manière de les modifier ia le fichier TealeafCaptureSocket.cfg stocké sur le sereur. Ces paramètres sont également disponibles ia l'éditeur de pipeline, cette méthode étant recommandée pour configurer les agents de session. Paramètres globaux de l'agent de session Les paramètres ci-après sont disponibles pour cet agent de session. Paramètre Description TypeName Cette option doit être définie sur Canister. DLL Indique le nom de l'agent de session Canister : SessionAgentCanister.dll. Vous deez spécifier le chemin d'accès complet si le fichier.dll ne se troue pas dans le même répertoire que le filtre de capture. CanisterPath Nom de la base de données dans laquelle les données capturées sont stockées. CanisterPath doit être défini sur CANISTER.dbs comme suit : CanisterPath=CANISTER.dbs. CanisterSrr Nom du sereur de Canister. CanisterSrr doit être défini sur FAIRCOMS comme suit : CanisterPath= FAIRCOMS. Limites de sécurité du Canister Tealeaf fournit un ensemble de contrôles permettant de définir la taille maximale d'une session en termes de hits, d'octets ou de durée. Ces contrôles peuent être configurés ia le mode Aancé dans le gestionnaire d'éénements. Voir "Tutoriel EES Tealeaf" dans le document IBM Tealeaf Eent Manager - Guide. Paramètres de compression Les aleurs Nom d affichage sont affichées dans TMS, cette méthode étant recommandée pour configurer les agents de session. Voir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Les aleurs Nom sont affichées dans TealeafCaptureSocket.cfg. 250 IBM Tealeaf CX - Guide de configuration

261 Tableau 8. Agent de session Canister Afficher nom Type de compression Nom CompressionType Description Contrôle la manière dont les données capturées sont compressées : 0 : aucune compression n'est effectuée. 1 : seul le fichier de réponses est compressé. 2 : les fichiers de demandes et de réponses sont compressés. La aleur par défaut est 2. Agents de session Tealeaf «Ajout d'un agent de session», à la page 237 «Agent de session Archiage», à la page 238 "Agent de session Indexation des attributs" dans le document IBM Tealeaf CX - Guide de configuration Agent de session Canister «Agent de session Analyseur de cookie», à la page 252 «Agent de session Dépose de données», à la page 254 «Agent de session Analyseur de données», à la page 260 «Agent de session Decouple», à la page 264 «Agent de session DecoupleEx», à la page 266 «Agent de session Confidentialité étendue», à la page 275 «Agent de session Health-Based Routing (HBR)», à la page 278 «Agent de session Déploiement», à la page 285 «Agent de session Analyseur mobile JSON», à la page 289 «Agent de session Code géré», à la page 303 «Agent de session Null», à la page 306 «Agent de session Confidentialité», à la page 307 «Agent de session RTA (Real-Time Monitoring and Alert)», à la page 341 «Agent de session Balises de réponse pour la demande», à la page 346 «Agent de session Fractionnement RTA», à la page 348 «Agent de session de mise en sessions», à la page 353 «Agent de session Routeur de session», à la page 350 «Agent de session Socket», à la page 356 «Agent de session Consignateur de statistiques», à la page 358 "Agent de session de référence Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session de référence Tealeaf - Mode existant», à la page 380 «Agent de session Mise en sessions Tealeaf», à la page 384 «Agent de session TimeGrades», à la page 390 «Agent de session TLI», à la page 392 «Agent de session de décodage d'url», à la page 408 Chapitre 4. Agents de session de pipeline CX 251

262 Agent de session Analyseur de cookie Pour faciliter les recherches, l'agent de session CookieParser analyse les cookies qui apparaissent après la aleur HTTP_COOKIE dans la demande en paires nom/aleur. Les données des cookies sont placées à la fin de la demande, dans une section intitulée [cookies] Voici un exemple : [cookies] TLTSID=CF37A9C511D67E7F F87C9647z0 TLTHID=CF37A9C511D67E7F F87C9647 TLTUID=CC50ED7C11D67E1C90003B95BC7A8A27 SITESERVER=ID=3c d32c21e27fa781a689ac7 TLT_NumCookies=4 TLT_CookiesBytes=165 Ajout de l'agent de session Des agents de session peuent être ajoutés ia l'éditeur de pipeline dans TMS. Voir «Ajout d'un agent de session», à la page 237. Pour plus d'informations sur l'éditeur de pipeline, oir "Editeur de pipeline TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. Paramètres de configuration Vous disposez des paramètres de configuration suiants : Les aleurs Nom d affichage sont affichées dans TMS, cette méthode étant recommandée pour configurer les agents de session. Voir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Les aleurs Nom sont affichées dans TealeafCaptureSocket.cfg. Tableau 9. Agent de session Analyseur de cookie Nom d'affichage Nom Description Cookie Delimiter CookieDelimiter Délimiteur utilisé dans l'en-tête Cookies. La aleur par défaut est ;. Extract Extract Permet d'extraire des sous-aleurs d'une aleur de cookie. La aleur par défaut est YES. Fragment Delimiter FragmentDelimiter Utilisé conjointement aec l'option Extract, ce paramètre spécifie le délimiteur de fragment de cookie. La aleur par défaut est `. URL Decode URLDecode Indique si la aleur du cookie doit être décodée par URL. La aleur par défaut est YES. Le reste de cette page décrit les options de configuration et la manière de les modifier ia le fichier TealeafCaptureSocket.cfg stocké sur le sereur. Ces paramètres sont également disponibles ia l'éditeur de pipeline, cette méthode étant recommandée pour configurer les agents de session. 252 IBM Tealeaf CX - Guide de configuration

263 Délimiteur de cookie L'analyseur de cookie permet aux utilisateurs de dénoter leur propre délimiteur de cookie, qui permet de traiter un plus grand nombre de formats de cookie. Si aucun délimiteur n'est spécifié, le point-irgule ( ; ) est utilisé. Si ous utilisez plusieurs caractères, l'analyseur de cookie n'utilise que le premier de la chaîne comme délimiteur. «Eiter d'utiliser une perluète comme délimiteur» Pour dénoter otre propre délimiteur, ajoutez ce qui suit à la section CookieParser du fichier de configuration : CookieDelimiter=<somechar> Eiter d'utiliser une perluète comme délimiteur Eitez d'utiliser la perluète (&) comme délimiteur. Ce caractère est couramment utilisé pour dénoter des fragments dans un cookie parent. Par exemple : HTTP_COOKIE=TLTUID= &id=1234&page=0; TLTRUID=234567; Ce la génère normalement la sortie suiante : TLT_NumCookies=2 TLT_CookiesBytes=48 TLT_NumCookieFragments=2 TLT_CookieFragmentBytes=15 Toutefois, l'utilisation d'une perluète (&) comme délimiteur génère ce qui suit : TLT_NumCookies=3 TLT_CookiesBytes=48 TLT_NumCookieFragments=0 TLT_CookieFragmentBytes=0 Notez les figures incorrectes ci-dessus. Agents de session Tealeaf «Ajout d'un agent de session», à la page 237 «Agent de session Archiage», à la page 238 "Agent de session Indexation des attributs" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session Canister», à la page 249 Agent de session Analyseur de cookie «Agent de session Dépose de données», à la page 254 «Agent de session Analyseur de données», à la page 260 «Agent de session Decouple», à la page 264 «Agent de session DecoupleEx», à la page 266 «Agent de session Confidentialité étendue», à la page 275 «Agent de session Health-Based Routing (HBR)», à la page 278 «Agent de session Déploiement», à la page 285 «Agent de session Analyseur mobile JSON», à la page 289 «Agent de session Code géré», à la page 303 «Agent de session Null», à la page 306 «Agent de session Confidentialité», à la page 307 «Agent de session RTA (Real-Time Monitoring and Alert)», à la page 341 Chapitre 4. Agents de session de pipeline CX 253

264 «Agent de session Balises de réponse pour la demande», à la page 346 «Agent de session Fractionnement RTA», à la page 348 «Agent de session de mise en sessions», à la page 353 «Agent de session Routeur de session», à la page 350 «Agent de session Socket», à la page 356 «Agent de session Consignateur de statistiques», à la page 358 "Agent de session de référence Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session de référence Tealeaf - Mode existant», à la page 380 «Agent de session Mise en sessions Tealeaf», à la page 384 «Agent de session TimeGrades», à la page 390 «Agent de session TLI», à la page 392 «Agent de session de décodage d'url», à la page 408 Agent de session Dépose de données Cet agent de session supprime les données non souhaitées. DataDrop se trouant généralement entre CSS et l'agent de session DecoupleEx, les données sont supprimées aant d'être transmises ia le découpleur. Ce positionnement réduit considérablement la taille des fichiers du spouler. Remarque : Pour certains déploiements du sereur de traitement, cet agent de session est inclus dans le pipeline par défaut et est requis. Voir «Configuration du pipeline CX», à la page 224. Présentation Vous trouerez ci-dessous une description approximatie de l'arbre de décisions DataDrop pour déterminer si un hit doit être conseré, dans l'ordre d'éaluation. Si un hit réussit un test, le test suiant de la séquence est éalué : S'il s'agit d'un hit aller-retour, ne le supprimez que si l'option KeepRoundTripHits a la aleur false. Si DelImages est défini sur Oui et que le hit est un hit binaire inintéressant, supprimez-le. Si le hit proient d'ibm Tealeaf CX RealiTea Viewer, supprimez-le si l'option KeepRealiTeaViewerHits a la aleur false. Si l'une des règles de suppression personnalisées s'applique au hit, supprimez le hit. Conserez le hit et transmettez-le au prochain agent de session. Ajout de l'agent de session Des agents de session peuent être ajoutés ia l'éditeur de pipeline dans TMS. Voir «Ajout d'un agent de session», à la page 237. Pour plus d'informations sur l'éditeur de pipeline et TMS, oir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Le reste de cette page décrit les options de configuration et la manière de les modifier ia le fichier TealeafCaptureSocket.cfg stocké sur le sereur. Ces paramètres sont également disponibles ia l'éditeur de pipeline, cette méthode étant recommandée pour configurer les agents de session. 254 IBM Tealeaf CX - Guide de configuration

265 Paramètres de configuration Les aleurs Nom d affichage sont affichées dans TMS, cette méthode étant recommandée pour configurer les agents de session. Voir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Les aleurs Nom sont affichées dans TealeafCaptureSocket.cfg. Tableau 10. Paramètres de configuration Afficher nom Nom Description DelImages DelImages Actie les actions DelImages, telles que la suppression d'images ou d'autres hits binaires. La aleur par défaut est YES. Voir «DelImages». Conserer les hits RealiTea Viewer KeepRealiTeaViewerHits Consere les hits générés par l'afficheur de session. La aleur par défaut est NO. Voir «KeepRealiTeaViewerHits», à la page 256. Conserer les hits aller-retour KeepRoundTripHits Consere les hits utilisés pour déterminer les durées des boucles. La aleur par défaut est YES. Voir «KeepRoundTripHits», à la page 256. Consigner les statistiques LogStatistics Actiez la consignation des statistiques. La aleur par défaut est NO. Voir «LogStatistics», à la page 256. Interalle de consignation des statistiques LogStatisticsInteral Durée en secondes entre les consignations des statistiques. La aleur par défaut est de 3600 secondes (une heure). Voir «LogStatisticsInteral», à la page 256. Règle de suppression des données Drop Voir «Règles de suppression personnalisées», à la page 256. DelImages Par défaut, l'option DelImages permet à l'agent de session Dépose de données de supprimer les hits binaires inintéressants. Affectez à DelImages la aleur YES pour supprimer ces types de hit. Généralement, un hit inintéressant fait référence à un fichier binaire ou de configuration courant qui ne contient pas d'informations offrant un intérêt pour Tealeaf. Un hit inintéressant possède les propriétés suiantes : Type de capture : 3 Code de statut : ou 304 La zone d'url ne possède pas de suffixe spécifié par le paramètre KeepSuffixes. Remarque : A partir de la PCA Build 3502, cette fonctionnalité peut être actiée dans le pipeline PCA, ce qui limite le olume des données traitées et transmises Chapitre 4. Agents de session de pipeline CX 255

266 aux sereurs de traitement. Voir "Console Web de la PCA - Onglet Pipeline" dans le document IBM Tealeaf Passie Capture Application - Guide. KeepRealiTeaViewerHits Affectez à KeepRealiTeaViewerHits la aleur OUI si ous souhaitez conserer les hits de RealiTeaViewer. Un hit de RealiTeaViewer est un hit dont la zone HTTP_USER_AGENT a la aleur RealiTeaViewer ou TealeafFileGetter. Par défaut, KeepRealiTeaViewerHits est défini sur NO. KeepRoundTripHits Affectez à KeepRoundTripHits la aleur YES si ous souhaitez conserer les hits aller-retour afin qu'ils soient traités par RoundTrip.Action.tcl. Un hit aller-retour est défini lorsque la zone TealeafRoundTrip est définie sur YES. Par défaut, KeepRoundTripHits est défini sur YES. LogStatistics Affectez à LogStatistics la aleur YES si ous souhaitez que les statistiques sur les hits supprimés soient enregistrés dans un fichier délimité par des tabulations. Le fichier des statistiques possède le préfixe SADataDropStats et est enregistré dans le même répertoire que le journal de l'agent de session. Par défaut, LogStatistics est défini sur NO. LogStatisticsInteral Affectez à LogStatisticsInteral le nombre de secondes à attendre aant que les statistiques ne soient enregistrées dans le fichier des statistiques de l'agent de session. Par défaut, LogStatisticsInteral est défini sur 86400, ce qui correspond au nombre de secondes dans une journée. Règles de suppression personnalisées Les sections ci-après expliquent les dierses options de configuration spécifiques à l'agent de session Dépose de données. Ces options doient être placées dans le fichier de configuration de la source de capture. En plus des règles de suppression préconfigurées, ous pouez définir jusqu'à 100 règles personnalisées qui sélectionnent des hits à supprimer. Pour définir une règle, ajoutez une règle Drop à la section de configuration, comme dans l'exemple suiant : Drop1=reqfield url contains /company/\ L'agent de session Dépose de données charge les règles Drop1 à Drop100 et les éalue dans cet ordre. Vous pouez spécifier les types de règle ci-après. 256 IBM Tealeaf CX - Guide de configuration

267 Les règles REQFIELD recherchent les aleurs des zones dans la mémoire tampon des demandes. Voir «Règles REQFIELD». Les règles REQSECTION testent l'existence de texte dans une section spécifiée de la mémoire tampon des demandes. Voir «Règles REQSECTION», à la page 258. Les règles REQUEST et RESPONSE testent l'existence de texte dans les mémoire tampon des demandes et des réponses, respectiement. Voir «Règles REQUEST et RESPONSE», à la page 258. Règles REQFIELD Ces règles respectent le format suiant : REQFIELD NAME OPERATOR TEXT MODIFIER Où : NAME représente le nom sensible à la casse de la ariable de zone à examiner. OPERATOR correspond à l'un des opérateurs suiants : CONTAINS EQ GE GT LE LT NE PARTOF Opérateur Description CONTAINS la aleur de zone contient la aleur TEXT. Par exemple, la aleur d'url contient.asp. EQ GE GT LE LT NE la aleur de zone est égale à la aleur TEXT (zones numériques uniquement) la aleur de zone est supérieure ou égale à la aleur TEXT (zones numériques uniquement) la aleur de zone est supérieure à la aleur TEXT (zones numériques uniquement) la aleur de zone est inférieure ou égale à la aleur TEXT (zones numériques uniquement) la aleur de zone est inférieure à la aleur TEXT (zones numériques uniquement) la aleur de zone est non égale à la aleur TEXT PARTOF la aleur de zone correspond à une entrée de la liste des aleurs TEXT. Les aleurs doient être séparées par des point-irgules. Par exemple, l'abréiation d'état CA est un sous-ensemble de la liste CA;OR;WA;HI;AK. Remarque : Les correspondances sont des correspondances de chaîne entière. Les correspondances partielles ne sont pas prises en charge. Voir «Exemple de configuration PARTOF», à la page 259. Vous pouez annuler les opérateurs ci-dessus aec l'opérateur NOT. Par exemple: NOT CONTAINS NOT GE TEXT représente le texte à utiliser aec l'opérateur. MODIFIER est un mot clé facultatif qui indique aux opérateurs d'ignorer ou de respecter la casse de la aleur de zone et du texte. Par exemple: REQFIELD remote_host EQ serer1 IGNORECASE REQFIELD remote_host EQ ExactSerer MATCHCASE Chapitre 4. Agents de session de pipeline CX 257

268 Si ous ne spécifiez pasmodifier, les opérateurs ignorent la casse des lettres dans la aleur et le texte. Pour inclure des espaces dans le nom ou le texte, placez ce dernier entre guillemets. Par exemple: reqfield "name with spaces" contains "text with spaces" Si la aleur de zone et le texte peuent tous deux être éalués comme des nombres, les opérateurs suiants effectuent des tests numériques : EQ GE GT LE LT NE Sinon, la aleur et le texte sont créés en tant que texte. Règles REQSECTION Ces règles respectent le format suiant : REQSECTION NAME CONTAINS TEXT MODIFIER où : NAME représente le nom de la section à rechercher. TEXT représente le texte que ous recherchez. Il peut également s'agir d'une liste délimitée. MODIFIER est le même mot clé facultatif que dans REQFIELD. Vous pouez annuler l'opérateur CONTAINS à l'aide de l'opérateur NOT. Par exemple: REQSECTION en NOT CONTAINS Règles REQUEST et RESPONSE Ces règles respectent le format suiant : REQUEST CONTAINS TEXT MODIFIER RESPONSE CONTAINS TEXT MODIFIER Exemple de configuration où : TEXT représente le texte que ous recherchez. Il peut également s'agir d'une liste délimitée. MODIFIER est le même mot clé facultatif que dans REQFIELD. Vous pouez annuler l'opérateur CONTAINS à l'aide de l'opérateur NOT. Par exemple: RESPONSE NOT CONTAINS "something went wrong" Configuration complète L'exemple de configuration ci-après est extrait du fichier TealeafCaptureSocket.cfg sur le sereur de traitement. Remarque : TMS est la méthode recommandée pour configurer les pipelines Windows. Voir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. 258 IBM Tealeaf CX - Guide de configuration

269 [DataDrop]... DelImages=YES KeepRealiTeaViewerHits=YES KeepRoundTripHits=YES LogStatistics=NO LogStatisticsInteral=3600 Drop1=reqfield URL contains /company/ Drop2=reqfield HTTP_USER_AGENT contains bot Drop3=reqfield URL contains /company/ IGNORECASE Drop4=reqsection en contains CaptureType=2 Drop5=response contains "cache-control: priate" Exemple de configuration PARTOF Dans l'exemple ci-après, la règle de suppression doit supprimer le hit si la zone de demande (reqfield) appelée PCA_NAME contient l'une des aleurs répertoriées : ceres, io ou pluto. Drop6=reqfield PCA_NAME partof ceres;io;pluto Cette zone de demande se troue dans la section [en] de la demande et est affectée par l'instance IBM Tealeaf CX Passie Capture Application ayant capturée le hit. Cet exemple de configuration peut s'aérer utile si ous disposez d'une ou plusieurs instances de déeloppement d'ibm Tealeaf CX Passie Capture Application, dont ous ne souhaitez pas capturer et traiter les données ia le pipeline Windows. Agents de session Tealeaf «Ajout d'un agent de session», à la page 237 «Agent de session Archiage», à la page 238 "Agent de session Indexation des attributs" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session Canister», à la page 249 «Agent de session Analyseur de cookie», à la page 252 Agent de session Dépose de données «Agent de session Analyseur de données», à la page 260 «Agent de session Decouple», à la page 264 «Agent de session DecoupleEx», à la page 266 «Agent de session Confidentialité étendue», à la page 275 «Agent de session Health-Based Routing (HBR)», à la page 278 «Agent de session Déploiement», à la page 285 «Agent de session Analyseur mobile JSON», à la page 289 «Agent de session Code géré», à la page 303 «Agent de session Null», à la page 306 «Agent de session Confidentialité», à la page 307 «Agent de session RTA (Real-Time Monitoring and Alert)», à la page 341 «Agent de session Balises de réponse pour la demande», à la page 346 «Agent de session Fractionnement RTA», à la page 348 «Agent de session de mise en sessions», à la page 353 «Agent de session Routeur de session», à la page 350 «Agent de session Socket», à la page 356 «Agent de session Consignateur de statistiques», à la page 358 Chapitre 4. Agents de session de pipeline CX 259

270 "Agent de session de référence Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session de référence Tealeaf - Mode existant», à la page 380 «Agent de session Mise en sessions Tealeaf», à la page 384 «Agent de session TimeGrades», à la page 390 «Agent de session TLI», à la page 392 «Agent de session de décodage d'url», à la page 408 Agent de session Analyseur de données L'agent de session Analyseur de données est un agent de pipeline de "recherche et d'extraction" à caractère général qui recherche des masques définis par l'utilisateur dans les mémoires tampon REQ ou RSP d'un hit. Ces masques peuent ensuite être manipulés. Tout comme l'agent de session Confidentialité, des règles peuent être créées pour l'agent de session Analyseur de données pour permettre l'ajout de paires nom/aleur à des sections de la mémoire tampon REQ. Si des aleurs sont détectées dans la demande ou la réponse, les types d'opération suiants peuent être appliqués à la aleur trouée : Une expression régulière Un hachage MD5 Les aleurs détectées peuent être concaténées ou répertoriées aec un délimiteur Ajout de l'agent de session Des agents de session peuent être ajoutés ia l'éditeur de pipeline dans TMS. Voir «Ajout d'un agent de session», à la page 237. Pour plus d'informations sur l'éditeur de pipeline et TMS, oir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Configuration des règles de modèle Une fois que l'agent de session a été ajouté à un pipeline ia l'éditeur de pipeline, ous pouez configurer les modèles de recherche Analyseur de données ia TMS. Pour éditer, procédez comme suit : Paramètres de configuration 1. Dans TMS, sélectionnez l'onglet WorldView. 2. Sélectionnez la ue Sereurs. 3. Ourez le noeud Serice de transport. 4. Cliquez sur DataParser Search Templates. 5. Dans la sous-fenêtre Actions de configuration, cliquez sur Afficher/Modifier. 6. Les modèles de recherche sont affichés. Voir «Génération des règles de l'analyseur de données», à la page 261. Lorsque l'agent de session Analyseur de données est ajouté au pipeline, les paramètres d'agent de session ci-après peuent être modifiés pour affecter considérablement ses performances et son comportement. Les aleurs Nom d affichage sont affichées dans TMS, cette méthode étant recommandée pour configurer les agents de session. Voir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. 260 IBM Tealeaf CX - Guide de configuration

271 Les aleurs Nom sont affichées dans TealeafCaptureSocket.cfg. Tableau 11. Paramètres de configuration Nom d'affichage Nom Description Longueur de balise maximale MaxTagLength Ce paramètre représente le nombre de caractères collectés une fois que le masque a été détecté si aucune balise de fin ou expression régulière n'est fournie. La minimisation de cette aleur est important pour optimiser la itesse. La aleur par défaut est de 1024 caractères. Fichier de configuration ConfigFile Ce chemin identifie le fichier contenant les règles à appliquer à l'analyseur de données. Si ce chemin est introuable, l'agent de session n'est pas chargé. Nom de stockage StorageName Ce nom de section défini par l'utilisateur dans la mémoire tampon des demandes indique où les paires nom/aleur créées sont insérées. S'il n'est pas spécifié, les aleurs créées sont automatiquement insérées dans la section [appdata], qui est créée en l'absence de section. L'insertion de données dans la section [appdata] permet l'indexation des nouelles aleurs. Génération des règles de l'analyseur de données Pour l'agent de session Analyseur de données, ous pouez créer des règles dans le fichier DataParserSearchTemplates.cfg ou le fichier spécifié dans la propriété ConfigFile de la configuration de l'analyseur de données. Vous pouez éditer ce fichier par l'intermédiaire du noeud Serice de transport dans TMS. Voir «Configuration des règles de modèle», à la page 260. Options de configuration des règles Plusieurs permutations des règles DataParser sont possibles : Paramètre Description Action Pour toutes les règles de l'analyseur de données, l'action doit être Rechercher. Ce paramètre permet d'éiter toute confusion aec les autres types d'action autorisés par les autres agents de session. SearchType Le type de recherche accepte deux aleurs : Single Pass ou XML. Single Pass utilise les méthodes de recherche de texte normales pour collecter des chaînes de la mémoire tampon. XML utilise une transformation XSL distincte pour effectuer toutes les manipulations de données. Les transformations XSL sont puissantes, mais très lentes à exécuter. L'utilisation de XSL n'est pas recommandée dans les enironnements à fort trafic. Chapitre 4. Agents de session de pipeline CX 261

272 DisplayName Ce paramètre représente le nom utilisé dans la paire nom/aleur, si le masque est détecté. SearchString Ce paramètre représente le masque de recherche dans la mémoire tampon. StartPattern peut également être utilisé. Expression régulière Dénote l'expression régulière utilisée, si le masque de chaîne de recherche est détecté. regular expression= et regex= sont reconnus dans la configuration des règles. Les expressions d'assertion arrière de longueur non fixe ne sont pas prises en charge. Si ous deez utiliser une expression telle que (?<=start).*end, ous deez dénoter explicitement le nombre de caractères que ous souhaitez capturer. Exemple : (?<=start). {1,200} end Remarque : Si une expression régulière est fournie et qu'elle ne correspond pas au texte détecté une fois que la chaîne de recherche a été trouée, aucune paire nom/aleur n'apparaît dans la mémoire tampon REQ. SearchURL URL de déclenchement de cette action. Si aucune URL de recherche n'est spécifiée, l'action est déclenchée sur tous les hits. EndTag Dénote une séquence de caractères de balise de fin qui termine la collection de caractères. Vous pouez utiliser une balise de fin et une expression régulière pour collecter, puis nettoyer, une chaîne de caractères. EndPattern peut également être utilisé. MD5 Spécifiez la aleur True pour appliquer MD5 à la aleur finale, une fois que les expressions régulières et les balises de fin ont été appliquées. Remarque : Seule la aleur est codé en MD5. Le nom d'affichage ne l'est pas. Section Ce paramètre indique si la recherche doit porter sur la mémoire tampon REQ ou RSP. Seules deux aleurs sensibles à la casse sont admises : Réponse ou Demande. Si aucune aleur n'est fournie, la mémoire tampon RSP est utilisée par défaut. DelimMatches Si la aleur est True, l'analyseur de données place toutes les correspondances détectées sous le nom d'affichage délimité par une irgule par défaut. Vous pouez fournir un délimiteur différent dans le paramètre Delimiter. Delimiter Délimiteur défini par l'utilisateur utilisé si DelimMatches est défini sur True. S'il n'est pas spécifié, la irgule est utilisée par défaut. 262 IBM Tealeaf CX - Guide de configuration

273 Remarque : Si plusieurs masques de recherche sont détectés à partir d'une même règle, l'analyseur de données les numérote et les place dans la mémoire tampon REQ suiant l'ordre dans lequel ils ont été détectés. Par exemple, si plusieurs recherches de Title ont renoyé des résultats, la sortie se présente comme suit : Title=firstfind Title2=secondfind Title3=thirdfind RegGroup Vous pouez éentuellement spécifier la sortie et le format de la correspondance d'expression régulière en fonction des groupes de l'expression régulière. Par exemple, si l'expression régulière est (tom)(/sis)(/s.)(*), la spécification de RegGroup={g1}={g2} renoie la aleur tom=is. Dans ce cas, le deuxième signe égal (=) est un littéral transmis à la sortie. Les aleurs sont renoyées suiant l'ordre dans lequel elles sont détectées dans la mémoire tampon. Exemples de règle Règle Obtention du titre L'exemple de règle ci-après pour l'agent de session Analyseur de données utilise une recherche en un seul passage de la balise <title>stuff</title> d'un document HTML sur la mémoire tampon RSP. S'il détecte cette balise, il applique une expression régulière pour acquérir le contenu des balises et appliquer la aleur au paramètre Title de la mémoire tampon des demandes : [Title] Action=Search SearchType=SinglePass DisplayName=Title SearchString=<title> Regular expression=<title.*</title> Règle Obtenir l'id utilisateur Tealeaf Cette règle utilise une recherche en un seul passage sur la mémoire tampon des demandes pour rechercher TLTUID=. S'il est détecté, la paire nom/aleur comprend TLTUID_MD5= et tout jusqu'au prochain retour chariot. Un hachage MD5 est appliqué à la aleur. [TLTUID] Action=Search SearchType=SinglePass DisplayName=TLTUID_MD5 SearchString=TLTUID= EndTag=\r MD5=True Section=Request Règle Application du XSL à la mémoire tampon des demandes Cette règle applique le fichier de transformation ClientEentXSL.xsl pour transformer la mémoire tampon REQ. Notez que le paramètre DisplayName est défini sur none. Le paramètre DisplayName est requis dans une règle dont la syntaxe est correcte, mais le XSL dénote le nom de la paire nom/aleur et ce paramètre n'est pas utilisé. Chapitre 4. Agents de session de pipeline CX 263

274 [ClientXSL] Action=Search SearchType=XML DisplayName=None SearchString=ClientEentXSL.xsl Section=Request Agents de session Tealeaf «Ajout d'un agent de session», à la page 237 «Agent de session Archiage», à la page 238 "Agent de session Indexation des attributs" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session Canister», à la page 249 «Agent de session Analyseur de cookie», à la page 252 «Agent de session Dépose de données», à la page 254 Agent de session Analyseur de données «Agent de session Decouple» «Agent de session DecoupleEx», à la page 266 «Agent de session Confidentialité étendue», à la page 275 «Agent de session Health-Based Routing (HBR)», à la page 278 «Agent de session Déploiement», à la page 285 «Agent de session Analyseur mobile JSON», à la page 289 «Agent de session Code géré», à la page 303 «Agent de session Null», à la page 306 «Agent de session Confidentialité», à la page 307 «Agent de session RTA (Real-Time Monitoring and Alert)», à la page 341 «Agent de session Balises de réponse pour la demande», à la page 346 «Agent de session Fractionnement RTA», à la page 348 «Agent de session de mise en sessions», à la page 353 «Agent de session Routeur de session», à la page 350 «Agent de session Socket», à la page 356 «Agent de session Consignateur de statistiques», à la page 358 "Agent de session de référence Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session de référence Tealeaf - Mode existant», à la page 380 «Agent de session Mise en sessions Tealeaf», à la page 384 «Agent de session TimeGrades», à la page 390 «Agent de session TLI», à la page 392 «Agent de session de décodage d'url», à la page 408 Agent de session Decouple L'agent de session Decouple dissocie le pipeline de capture du socket qui reçoit le composant et du reste du pipeline et régule les pics de trafic à l'aide d'une file d'attente en mémoire. Par exemple, en cas de hausse du trafic dépassant la capacité des agents de pipeline restants, l'agent de session Decouple met ce surplus de trafic dans la file d'attente en mémoire afin qu'aucun hit ne soit perdu. Contrairement à l'agent de session DecoupleEx, cet agent de session ne fonctionne qu'en mémoire et ne peut pas spouler les hits sur disque lors leur olume est 264 IBM Tealeaf CX - Guide de configuration

275 important. Par conséquent, cet agent de session est bien plus simple à configurer. Il n'existe qu'une seule option de configuration ; la taille de la file d'attente en mémoire. Remarque : Si le nombre de hits en mémoire dépasse la taille maximale de la file d'attente, les hits qui suient sont supprimés et perdus. Cet agent de session n'est pas conçu pour être utilisé pendant des périodes de mise en file d'attente prolongées. Il ne peut être utilisé que pour atténuer les hausses de trafic d'une minute ou deux. Remarque : L'agent de session DecoupleEx inclut des fonctions et options de configuration supplémentaires non disponibles dans l'agent de session Decouple. Pour toute mise en file d'attente prolongée préue qui dure plus de deux minutes, ous deez enisager de déployer l'agent de session DecoupleEx. Voir «Agent de session DecoupleEx», à la page 266. Ajout de l'agent de session Des agents de session peuent être ajoutés ia l'éditeur de pipeline dans TMS. Voir «Ajout d'un agent de session», à la page 237. Pour plus d'informations sur l'éditeur de pipeline et TMS, oir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Le reste de cette page décrit les options de configuration et la manière de les modifier ia le fichier TealeafCaptureSocket.cfg stocké sur le sereur. Ces paramètres sont également disponibles ia l'éditeur de pipeline, cette méthode étant recommandée pour configurer les agents de session. Options Les aleurs Nom d affichage sont affichées dans TMS, cette méthode étant recommandée pour configurer les agents de session. Voir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Les aleurs Nom sont affichées dans TealeafCaptureSocket.cfg. Tableau 12. Agent de session Decouple Afficher nom Taille maximale de la file d attente Nom MaxQueueSize Description Indique le nombre maximal de hits que la file d'attente en mémoire peut contenir. L'augmentation de la taille de la file d'attente en mémoire augmente la compétition pour les ressources de mémoire. La aleur par défaut est Agents de session liés aux périphériques mobiles Cet agent de session peut être utilisé dans le cadre de la capture et du traitement des messages JSON soumis à partir de l'une des structures client de Tealeaf et du fractionnement de ces messages en hits distincts dans le pipeline Windows. Il s'agit de la méthode existante. Ces ersions de structure client ont été introduites dans la ersion 8.4 et remplacées par la messagerie basée sur des étapes, à partir de la ersion 8.5. Pour plus d'informations sur ces structures client et notamment sur les étapes d'implémentation, utilisez les liens ci-dessous : Chapitre 4. Agents de session de pipeline CX 265

276 Agents de session Tealeaf «Ajout d'un agent de session», à la page 237 «Agent de session Archiage», à la page 238 "Agent de session Indexation des attributs" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session Canister», à la page 249 «Agent de session Analyseur de cookie», à la page 252 «Agent de session Dépose de données», à la page 254 «Agent de session Analyseur de données», à la page 260 Agent de session Decouple «Agent de session DecoupleEx» «Agent de session Confidentialité étendue», à la page 275 «Agent de session Health-Based Routing (HBR)», à la page 278 «Agent de session Déploiement», à la page 285 «Agent de session Analyseur mobile JSON», à la page 289 «Agent de session Code géré», à la page 303 «Agent de session Null», à la page 306 «Agent de session Confidentialité», à la page 307 «Agent de session RTA (Real-Time Monitoring and Alert)», à la page 341 «Agent de session Balises de réponse pour la demande», à la page 346 «Agent de session Fractionnement RTA», à la page 348 «Agent de session de mise en sessions», à la page 353 «Agent de session Routeur de session», à la page 350 «Agent de session Socket», à la page 356 «Agent de session Consignateur de statistiques», à la page 358 "Agent de session de référence Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session de référence Tealeaf - Mode existant», à la page 380 «Agent de session Mise en sessions Tealeaf», à la page 384 «Agent de session TimeGrades», à la page 390 «Agent de session TLI», à la page 392 «Agent de session de décodage d'url», à la page 408 Agent de session DecoupleEx L'agent de session DecoupleEx dans le pipeline du serice du socket Capture gère les hausses soutenues du olume de trafic. Pour les sites Web qui connaissent des hausses soutenues du olume de trafic en première partie de journée ou à la fin de chaque mois, cet agent de session est primordial. Le olume de hits entrant dans le Canister à court terme est régulé pour éiter toute surcharge du Canister à court terme. En plaçant les données en file d'attente de cette manière, IBM Tealeaf CX réduit considérablement la perte de données partout dans le pipeline. Remarque : Pour certains déploiements du sereur de traitement, cet agent de session est inclus dans le pipeline par défaut et est requis. Voir «Configuration du pipeline CX», à la page IBM Tealeaf CX - Guide de configuration

277 Ajout de l'agent de session Des agents de session peuent être ajoutés ia l'éditeur de pipeline dans TMS. Voir «Ajout d'un agent de session», à la page 237. Pour plus d'informations sur l'éditeur de pipeline et TMS, oir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Le reste de cette page décrit les options de configuration et la manière de les modifier ia le fichier TealeafCaptureSocket.cfg stocké sur le sereur. Ces paramètres sont également disponibles ia l'éditeur de pipeline, cette méthode étant recommandée pour configurer les agents de session. Processus du découpleur étendu Le découpleur étendu sureille les statistiques itales du Canister à court terme et les compare aux seuils prédéfinis pour l'agent de session. Si un seuil est dépassé, le découpleur étendu commence à stocker les hits dans une file d'attente. Les hits sont tout d'abord placé en file d'attente dans la mémoire. Lorsque la file d'attente de la mémoire atteint sa capacité maximale, les hits sont mis en file d'attente sur le disque. Le Canister à court terme étant une base de données en mémoire, il n'accepte des olumes supérieurs à la capacité maximale que pour une période comprise entre 10 et 50 minutes. Au delà, le Canister commence la pagination sur disque pour obtenir de la mémoire supplémentaire. La pagination force une réduction de la itesse à laquelle le Canister à court terme accepte les hits, jusqu'à ce que sa capacité soit restaurée. Vidage du Canister à court terme Le idage du Canister à court terme consiste à laisser le Canister traiter les données de session existantes lorsqu'un ou plusieurs des seuils utilisés pour en sureiller la santé est dépassé et que le découpleur étendu commence le processus de mise en file d'attente. Par exemple, si le nombre maximal de hits non éalués atteint un seuil, le découpleur étendu commence à placer les hits en file d'attente, ce qui permet au Canister à court terme de ider son magasin de hits non éalués, en agrégeant les hits dans des sessions, en enoyant les hits intéressants à l'archie à long terme et en supprimant les données de session inintéressantes. Le découpleur étendu sureille les seuils suiants pour déterminer si le Canister doit ider : le nieau d'utilisation du cache ctree ; les hits non éalués par le traitement ; les sessions de traitement en attente d'archiage ; les sessions de traitement en attente d'indexation ; Le découpleur étendu consere une trace du débit d'arriée des hits et du débit de départ des hits à mesure que ces derniers passent par le pipeline du socket de capture dans le Canister. Si l'état du Canister est correct, les hits transitent sans passer par la file d'attente. L'état du Canister est déterminé en examinant les conditions suiantes dans le Canister à court terme : Chapitre 4. Agents de session de pipeline CX 267

278 Nombre de hits non éalués par rapport aux hits éalués Nombre de sessions en attente d'archiage à long terme Nombre de sessions en attente d'indexation Pourcentage maximal de cache Faircom utilisé Génération de rapports Consignation Chacune des aleurs ci-dessus est configurable. La taille des aleurs dépend énormément de celle de l'ordinateur sur lequel le sereur IBM Tealeaf CX est installé. Ces aleurs reçoient une priorité égale. Si une aleur est supérieure au seuil, le découpleur étendu arrête d'enoyer les hits au Canister et commence à les placer en file d'attente jusqu'à ce que la aleur du seuil minimal soit atteinte. Par exemple, si la taille du Canister à court terme est supérieure à 1 Go, la mise en file d'attente peut commencer, et les hits sont placés en file d'attente jusqu'à ce que la taille du Canister à court terme soit inférieure à 500 Mo. Une fois que le système a retroué un statut correct, le découpleur étendu enoie les données en file d'attente au Canister à un débit de sortie spécifié dans les paramètres de configuration de l'agent de session. Le débit de sortie sert de régulateur du flux de données pour que le Canister ne soit pas immédiatement débordé par les hits. Une fois que le découpleur étendu est passé par la phase de mise en file d'attente et qu'il a libéré des hits dans le Canister, la génération de rapports horaire est décalée car le Canister prend en compte les horodatages d'arriée des données dans le Canister et non ceux de leur capture d'origine. Toutefois, les rapports quotidiens qui comptent le nombre total de hits ne sont pas affectés par le décalage horaire. Le découpleur étendu crée un fichier journal sous forme tabulaire, qui peut être importé dans d'autres applications, telles qu'excel. Le fichier journal consigne également l'utilisation de l'uc sur la machine du Canister actuellement, au cours des 10 dernières minutes et au cours de la dernière heure. Configuration du découpleur étendu Les options de configuration du découpleur étendu sont regroupées dans les catégories suiantes : «Paramètres généraux», à la page 269 «Seuils du Canister à court terme», à la page 271 «Génération de rapports DecouplerEx», à la page 272 «Paramètres de disque de DecouplerEx», à la page 273 Les aleurs Nom d affichage sont affichées dans TMS, cette méthode étant recommandée pour configurer les agents de session. Voir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Les aleurs Nom sont affichées dans TealeafCaptureSocket.cfg. 268 IBM Tealeaf CX - Guide de configuration

279 Paramètres généraux Remarque : Le découpleur étendu est toujours exécuté en mode EXTENDED, dans lequel le spoulage est toujours actié. Pour désactier le spoulage, utilisez l'agent de session Découpleur. Voir «Désactiation de la mise en file d'attente sur disque», à la page 274. Tableau 13. Paramètres généraux Nom Nom d'affichage Control ControlMaxOutRate Outflow Rate Max Outflow Hits Per Second Max Outflow Bytes Per Second Outflow Control Mode MaxOutHitsPerSec MaxOutBytesPerSec OutflowControlMode Description Actie le paramètre qui contrôle la itesse à laquelle les hits circulent de la file d'attente au Canister. Les aleurs possibles sont ON et OFF. Si la aleur est ON, ous deez également configurer les paramètres MaxOutMode, MaxOutHitsPerSec et MaxOutBytesPerSec. Indique le débit auquel les hits sont transmis de la file d'attente au Canister. Cette aleur est définie en hits par seconde. La aleur appropriée dépend de la configuration matérielle du sereur IBM Tealeaf CX. Indique le débit en octets par seconde auquel les hits sont transmis de la file d'attente au Canister. Indique le mode de mesure des débits en sortie de la file d'attente. Les paramètres suiants mesurent le débit de hits en sortie de la file d'attente : La aleur Hits est mesurée dans le paramètre MaxOutHitsPerSec. La aleur Octets est mesurée dans le paramètre MaxOutBytesPerSec. La aleur Les deux est mesurée dans le seuil du paramètre MaxOutHitsPerSec ou MaxOutBytesPerSec. Les paramètres suiants mesurent le débit de hits en entrée dans le Canister : La aleur CANHITS est mesurée dans le paramètre MaxOutHitsPerSec. La aleur CANBYTES est mesurée dans le paramètre MaxOutBytesPerSec. La aleur CANBOTH est mesurée dans le seuil du paramètre MaxOutHitsPerSec ou MaxOutBytesPerSec. Chapitre 4. Agents de session de pipeline CX 269

280 Tableau 13. Paramètres généraux (suite) Nom d'affichage Nom Description Persistence Persistence Indique s'il existe des fichiers en spoule et si le découpleur étendu est arrêté. Après un redémarrage, ce paramètre permet au découpleur étendu de poursuire le traitement des fichiers en spoule créés lors d'une précédente file d'attente de fichiers. Spool At Startup SpoolAtStartup Reient à exécuter une commande StartQ à partir du sereur de recherche au démarrage. Calcul et configuration du débit du flux de sortie Pour réguler correctement l'agent de session, ous deez configurer le flux de sortie des données approprié afin d'éiter certains des problèmes suiants : Le Canister ne parient pas à traiter les hits pour satisfaire le débit entrant L'espace adresse de mémoire deient in suffisant dans le Canister à court terme La limite de mémoire ctree configurée est trop proche de l'espace adresse maximal La mise en tampon Utilisez les étapes ci-après pour configurer le débit du flux de sortie. 1. Aant de configurer l'agent de session, ous deez acquérir la quantité de mémoire maximale disponible dans le Canister à court terme. Cette aleur est affichée comme paramètre Max Ctree Bytes dans l'onglet Contrôles de serices de la configuration du Canister dans TMS. Releez cette aleur pour pouoir l'utiliser ultérieurement. Voir «Configuration du Canister CX», à la page Dans la section des seuils de Canister à court terme de la configuration de l'agent de session DecoupleEx, examinez la aleur du paramètre Canister Max % Memory Used et notez-la. 3. Dans la section Globals de la configuration de l'agent de session DecoupleEx, affectez à ControlMaxOutRate la aleur ON. Si ce paramètre est défini sur ON, la régulation de base des hits ers les Canisters est actiée. 4. Configurez le paramètre Outflow Control Mode, qui gère la manière dont l'agent de session gère le débit maximal du flux en sortie. Spécifiez Octets, qui rattache le débit du flux en sortie au paramètre Max Outflow Bytes Per Second. 5. Affectez à Max Outflow Hits Per Second la aleur Affectez à Max Outflow Bytes Per Second la formule suiante : Max Ctree Bytes * Canister Max % Memory Used + (Max Outflow Hits Per Second *60) Pour Canister Max % Memory Used, conertissez la aleur en aleur décimale. Par exemple, la aleur 85% est insérée dans la formule sous la forme Si cette aleur est supérieure à la aleur Max Ctree Bytes, spécifiez la aleur Max Ctree Bytes -1. Remarque : N'essayez pas de spécifier un débit de sortie supérieur au nombre maximal d'octets disponibles dans un Canister à court terme de destination. 270 IBM Tealeaf CX - Guide de configuration

281 Pour les systèmes 32 bits, Tealeaf ne prend pas en charge l'utilisation du commutateur de système d'exploitation /3GB. L'utilisation d'un système d'exploitation 64 bits permet d'accéder à daantage de mémoire pour le Canister à court terme. Seuils du Canister à court terme Les seuils ci-après du Canister à court terme sont comparés aux statistiques du Canister interrogées par le serice Statistiques et stockées en mémoire partagée. Cette interrogation est effectuée toutes les 30 secondes. Si l'un de ces seuils est dépassé, le serice du socket TealeafCapture arrête d'enoyer les hits au Canister et commence à les mettre en file d'attente. Si le paramètre CanCheckEentLog est défini sur ON, les messages apparaissent dans le journal d'application des éénements une fois qu'un seuil du Canister a été dépassé. Remarque : Ces paramètres de seuil doient prendre en compte la taille des systèmes sur lesquels ils sont installés. Si les seuils sont trop faibles, le Canister arrête d'accepter les hits trop souent et interrompt le flux du trafic. Si les seuils sont trop éleés, la mémoire du Canister peut être saturée. Tableau 14. Seuils du Canister à court terme Nom d'affichage Nom Description Canister Check Cancheck Actie la érification du Canister. Consignation des canisters Canister Max % Memory Used Canister Min % Memory Used Max Unealuated Canister Hits CanCheckLog CanCheckMaxCtreeMemUsedPct CanCheckMinCtreeMemUsedPct CanCheckMaxUnealHits Génère les statistiques du Canister dans un fichier journal dont l'emplacement est spécifié par le paramètre LogDir Pourcentage de mémoire maximal autorisé alloué par le sereur de Canister Tealeaf. Si la aleur est 0, la aleur du cache est ignorée, tout comme le paramètre CanCheckMinCtreeMemUsedPct. Spécifie le pourcentage minimal du cache FairCom en cours d'utilisation. Cette aleur n'est érifiée que si le paramètre CanCheckMaxCtreeMemUsedPct est actié. Si la aleur maximale a été dépassée, le découpleur étendu place les hits en file d'attente jusqu'à ce que la aleur minimale soit atteinte. Si le nombre de hits non éalués dans le Canister dépasse ce nombre, la santé du Canister est compromise Chapitre 4. Agents de session de pipeline CX 271

282 Tableau 14. Seuils du Canister à court terme (suite) Nom d'affichage Nom Description Min Unealuated Canister Hits Max Sessions Waiting for LTC Min Sessions Waiting For LTC Max Sessions Waiting For IDX Min Sessions Waiting for IDX Drain STC on Error CanCheckMinUnealHits CanCheckMaxSesnWaitForLtc CanCheckMinSesnWaitForLtc CanCheckMaxSesnWaitForIdx CanCheckMinSesnWaitForIdx CanCheckDrainSTCOnError Spécifie le nombre minimal de hits non éalués. Si la aleur maximale a été atteinte, le découpleur étendu place les hits en file d'attente jusqu'à ce que la aleur minimale soit atteinte. Si CanCheckMaxUnealHits a la aleur 0, ce paramètre est ignoré. Si le nombre de sessions en attente d'archiage dépasse cette aleur, la santé du Canister est compromise. Spécifie le seuil minimal de sessions en attente d'archiage. Si le seuil maximal est dépassé, le découpleur étendu place les données en file d'attente jusqu'à ce que le nombre minimal ait été atteint. Si le nombre de sessions en attente d'indexation dépasse le nombre spécifié, la santé du Canister est compromise. Spécifie le seuil minimal de sessions en attente d'indexation. Si le seuil maximal est dépassé, le découpleur étendu place les données en file d'attente jusqu'à ce que le nombre minimal ait été atteint. Lorsqu'un seuil maximal est dépassé, le découpleur étendu signale au Canister de fermer toutes les sessions et de se ider sans attendre que la session arrie à expiration. La aleur par défaut est OFF. Génération de rapports DecouplerEx DecouplerEx possède plusieurs paramètres qui actient les statistiques DecouplerEx et en déterminent la sortie. Tableau 15. Génération de rapports DecouplerEx Afficher Nom nom Répertoire LogDir du journal Description Indique le répertoire du journal. Si le paramètre Log, StatsMeter ou CanCheckLog est actié, la consignation a lieu dans ce répertoire. La aleur par défaut correspond au répertoire de journal global de Tealeaf. 272 IBM Tealeaf CX - Guide de configuration

283 Tableau 15. Génération de rapports DecouplerEx (suite) Afficher nom Nom Description Report Statistics Write Stat Report To Log File Generate Stats Hits StatsMeter StatsMeterLogToFile StatsMeterHits Actie ou désactie la mesure des statistiques. La mesure des statistiques sureille le débit de hits ou d'octets qui entrent dans le découpleur étendu et en sortent. Le nombre d'octets par seconde qui entrent dans le découpleur étendu permet de calculer la quantité de données enoyées au Canister à court terme. Les rapports sont générés au format texte dans le répertoire spécifié par le paramètre LogDir. Vous pouez également définir le format du journal..csv est recommandé pour l'importation des feuilles de calcul. Indique si les rapports sur les statistiques doient être générés dans le fichier journal. La aleur par défaut est ON. Contrôle les hits des statistiques. La aleur par défaut est OFF. Journal Log Actie ou désactie la consignation. La aleur par défaut est ON. Nieau de journal LogLeel Indique le nieau de consignation des détails. Les aleurs possibles sont : Erreur, Aertissement, Info et Débogage. La aleur par défaut est Débogage. Les nieaux de journal sont inclusifs. Par exemple, Info inclut Aertissement et Erreur. Paramètres de disque de DecouplerEx Ce groupe de paramètres contrôle la taille de la file d'attente, la durée du spoulage sur le disque par le découpleur étendu et la quantité de données à spouler. Vous pouez également configurer la quantité d'espace disque qui dera rester disponible, sous forme de pourcentage. Le mécanisme de quota utilisé ici est le même que celui utilisé pour l'agent de session Archiage. Chapitre 4. Agents de session de pipeline CX 273

284 Tableau 16. Paramètres de disque de DecouplerEx Nom Nom d'affichage Taille MaxQueueSize maximale de la file d attente en mémoire Spool File Roll Size Répertoire spoule Spool Write Chunk Size % du disque disponible SpoolRollSizeMB SpoolDir SpoolChunkSizeMB DiskQuotaPctFree Description Indique le nombre maximal de hits que la file d'attente en mémoire peut contenir. La file d'attente en mémoire est conçue pour gérer de brèes pointes du flux de hits. Les hits sont placés en file d'attente sur le disque lorsque la file d'attente en mémoire est saturée. L'augmentation de la taille de la file d'attente en mémoire augmente la compétition pour les ressources de mémoire. La aleur par défaut est de Indique la taille maximale de chaque fichier spoule en mégaoctets. La aleur par défaut est de 500 Mo. Indique l'emplacement du répertoire dans lequel le fichier spoule doit être enregistré. La aleur par défaut correspond au sous-répertoire Spool du répertoire d'installation. Taille des blocs à enregistrer lors du spoulage des données, en mégaoctets. Indique le pourcentage de disponibilité du répertoire spécifié dans l'option QuotaDir. Si la quantité d'espace disponible deient inférieure à ce seuil, le filtre de capture se désactie pour éiter de consommer trop d'espace disque. Sur les systèmes Microsoft Windows NT 4.0, l'espace disque des répertoires correspond à l'espace disque global. Sous Microsoft Windows 2000 ou une ersion ultérieure, ous pouez établir des quotas de répertoires. La aleur par défaut est de 2 pourcent. Désactiation de la mise en file d'attente sur disque Prédécesseur simple de l'agent de session DecoupleEx, l'agent de session Découpleur utilise une file d'attente en mémoire pour mettre les hits en file d'attente en ue de leur traitement et ne place aucun hit en file d'attente sur le disque. Si la file d'attente en mémoire est saturée, les hits sont supprimés. L'agent de session DecoupleEx est configuré de sorte à toujours mettre en file d'attente les sessions sur disque si la file d'attente en mémoire est saturée. Les paramètres de configuration de l'agent de session Découpleur constituent un sous-ensemble de ceux de l'agent de session DecoupleEx. Vous pouez ajouter l'agent de session ia l'éditeur de pipeline et ajuster la taille de la file d'attente en mémoire (Taille maximale de la file d attente). 274 IBM Tealeaf CX - Guide de configuration

285 Voir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Agents de session Tealeaf «Ajout d'un agent de session», à la page 237 «Agent de session Archiage», à la page 238 "Agent de session Indexation des attributs" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session Canister», à la page 249 «Agent de session Analyseur de cookie», à la page 252 «Agent de session Dépose de données», à la page 254 «Agent de session Analyseur de données», à la page 260 «Agent de session Decouple», à la page 264 Agent de session DecoupleEx «Agent de session Confidentialité étendue» «Agent de session Health-Based Routing (HBR)», à la page 278 «Agent de session Déploiement», à la page 285 «Agent de session Analyseur mobile JSON», à la page 289 «Agent de session Code géré», à la page 303 «Agent de session Null», à la page 306 «Agent de session Confidentialité», à la page 307 «Agent de session RTA (Real-Time Monitoring and Alert)», à la page 341 «Agent de session Balises de réponse pour la demande», à la page 346 «Agent de session Fractionnement RTA», à la page 348 «Agent de session de mise en sessions», à la page 353 «Agent de session Routeur de session», à la page 350 «Agent de session Socket», à la page 356 «Agent de session Consignateur de statistiques», à la page 358 "Agent de session de référence Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session de référence Tealeaf - Mode existant», à la page 380 «Agent de session Mise en sessions Tealeaf», à la page 384 «Agent de session TimeGrades», à la page 390 «Agent de session TLI», à la page 392 «Agent de session de décodage d'url», à la page 408 Agent de session Confidentialité étendue L'agent de session PriacyEx permet de chiffrer, bloquer et remplacer du texte dans les mémoires tampon des demandes et des réponses. Comme son prédécesseur, Confidentialité, cet agent de session utilise un ensemble de règles flexible et des options de configuration pour s'assurer que les données sensibles sont traitées de manière appropriée. Pour plus d'informations sur la manière de configurer les règles, les actions et les tests utilisés, oir «Agent de session Confidentialité», à la page 307. Chapitre 4. Agents de session de pipeline CX 275

286 L'agent de session PriacyEx étend l'agent de session Confidentialité plus ancien aec les fonctions suiantes : Recherche plus rapide dans les mémoires tampon : PriacyEx peut rechercher en une seule fois tous les termes à filtrer dans une demande ou une réponse. Prise en charge de l'internationalisation : PriacyEx peut être utilisé pour filtrer les données dans diers schémas de codage internationaux. MD5 : si nécessaire, ous pouez appliquer le hachage MD5 à la sortie d'une règle de confidentialité. Remarque : Chaque fois que possible, utilisez l'agent de session PriacyEx au lieu de Confidentialité, qui risque de deenir obsolète dans les ersions futures. Ajout de l'agent de session Des agents de session peuent être ajoutés ia l'éditeur de pipeline dans TMS. Voir «Ajout d'un agent de session», à la page 237. Pour plus d'informations sur l'éditeur de pipeline et TMS, oir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Le reste de cette page décrit les options de configuration et la manière de les modifier ia le fichier TealeafCaptureSocket.cfg stocké sur le sereur. Ces paramètres sont également disponibles ia l'éditeur de pipeline, cette méthode étant recommandée pour configurer les agents de session. Options Les paramètres de configuration suiants sont disponibles pour l'agent de session : Les aleurs Nom d affichage sont affichées dans TMS, cette méthode étant recommandée pour configurer les agents de session. Voir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Les aleurs Nom sont affichées dans TealeafCaptureSocket.cfg. Tableau 17. Agent de session de confidentialité étendue Nom d'affichage Nom Description Fichier de configuration Affichage des règles dans le journal des éénements ConfigFile LogRules Nom du fichier contenant les règles et les actions utilisées par l'agent de session PriacyEx. La aleur par défaut est Priacy.cfg, qui est également utilisée par l'agent de session Confidentialité. Si ce paramètre a la aleur true, l'agent de session PriacyEx répertorie les règles et les actions utilisées dans le journal des éénements d'application Tealeaf. 276 IBM Tealeaf CX - Guide de configuration

287 Tableau 17. Agent de session de confidentialité étendue (suite) Nom d'affichage Nom Description Nieau de journal LogLeel Si le paramètre Nieau de journal est actié et défini, il définit le nieau de consignation des messages insérés dans la demande dans la section [priacylog]. Les nieaux de consignation suiants sont acceptés : Erreur : ne signale que les erreurs Aertissement : signale les erreurs et les aertissements Info : signale les erreurs, les aertissements et les messages d'information Trace : signale les messages ci-dessus, plus des informations supplémentaires pour le traçage Débogage : signale la quantité maximale d'informations Remarque : Le nieau de consignation Débogage ne doit être actié que si ous déboguez des problèmes liés à des règles et des actions. Les données supplémentaires insérées dans la demande peuent augmenter considérablement le olume de données et aoir un impact négatif sur les performances. En outre, les aleurs des données d'origine non chiffrées peuent être consignées au nieau Débogage. Une fois que ous aez terminé le débogage, n'oubliez pas de réinitialiser le nieau de consignation. Agents de session Tealeaf «Ajout d'un agent de session», à la page 237 «Agent de session Archiage», à la page 238 "Agent de session Indexation des attributs" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session Canister», à la page 249 «Agent de session Analyseur de cookie», à la page 252 «Agent de session Dépose de données», à la page 254 «Agent de session Analyseur de données», à la page 260 «Agent de session Decouple», à la page 264 «Agent de session DecoupleEx», à la page 266 Agent de session Confidentialité étendue «Agent de session Health-Based Routing (HBR)», à la page 278 «Agent de session Déploiement», à la page 285 Chapitre 4. Agents de session de pipeline CX 277

288 «Agent de session Analyseur mobile JSON», à la page 289 «Agent de session Code géré», à la page 303 «Agent de session Null», à la page 306 «Agent de session Confidentialité», à la page 307 «Agent de session RTA (Real-Time Monitoring and Alert)», à la page 341 «Agent de session Balises de réponse pour la demande», à la page 346 «Agent de session Fractionnement RTA», à la page 348 «Agent de session de mise en sessions», à la page 353 «Agent de session Routeur de session», à la page 350 «Agent de session Socket», à la page 356 «Agent de session Consignateur de statistiques», à la page 358 "Agent de session de référence Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session de référence Tealeaf - Mode existant», à la page 380 «Agent de session Mise en sessions Tealeaf», à la page 384 «Agent de session TimeGrades», à la page 390 «Agent de session TLI», à la page 392 «Agent de session de décodage d'url», à la page 408 Agent de session Health-Based Routing (HBR) HBR (Health-Based Routing) est un agent de pipeline qui sureille la santé des Canisters en aal et peut acheminer dynamiquement les sessions aux Canisters en fonction de leur santé. HBR requiert au moins deux sereurs de traitement (HBR ne présente aucun intérêt pour un sereur de traitement) et peut sureiller jusqu'à 20 sereurs de traitement. Remarque : Pour certains déploiements du sereur de traitement, cet agent de session est inclus dans le pipeline par défaut et est requis. Voir «Configuration du pipeline CX», à la page 224. HBR détermine la santé du sereur de traitement en communiquant aec son sereur de recherche et en obtenant le statut du régulateur/canister ( La santé du sereur de traitement est déterminée si le sereur de traitement est en cours de spoulage ; si ce n'est pas le cas, HBR suppose qu'il peut continuer à accepter le trafic des sessions existantes et des nouelles sessions. Si HBR détermine que le sereur de traitement est en cours de spoulage, il continue d'enoyer le trafic des sessions existantes (HBR essaye de gérer la fidélité des sessions par Canister), mais il ne lance aucune nouelle session pour ce sereur de traitement tant qu'il n'a pas résolu sa condition de spoulage. Cette section décrit comment ajouter et configurer l'agent de session HBR. Remarque : Si ous aez chois d'installer HBR par l'intermédiaire du programme d'installation de Tealeaf, HBR est automatiquement configuré. Cette section est utile si ous ajoutez HBR ou que ous modifiez un HBR existant une fois l'installation terminée. 278 IBM Tealeaf CX - Guide de configuration

289 Prérequis Remarque : Une instance locale du sereur de recherche doit être démarrée aant que HBR ne soit initialisé. HBR utilise le sereur de recherche pour éaluer le statut du régulateur sur la machine locale. Les deux serices sont disponibles ia l'utilitaire Serices du Canister (CanScs.exe), qui doit être utilisé pour démarrer et arrêter ces serices. Ajout de l'agent de session Paramètres de configuration Des agents de session peuent être ajoutés ia l'éditeur de pipeline dans TMS. Voir «Ajout d'un agent de session», à la page 237. Pour plus d'informations sur l'éditeur de pipeline et TMS, oir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Le reste de cette page décrit les options de configuration et la manière de les modifier ia le fichier TealeafCaptureSocket.cfg stocké sur le sereur. Ces paramètres sont également disponibles ia l'éditeur de pipeline, cette méthode étant recommandée pour configurer les agents de session. Les paramètres de configuration ci-après sont disponibles pour HBR. Tableau 18. Paramètres de configuration Nom d'affichage Nom Description Nombre maximal de sessions MaxSessions Indique le nombre maximal de sessions simultanées que HBR doit sureiller. HBR tient à jour une table de session pour effectuer le suii du Canister pour cette session. Cela indique la taille que doit aoir la table de session (méthodologie des sessions conserées/supprimées par LRU). Global Default Hits Per Second Per Canister Script TCL de pré-traitement des règles HBR DefaultPerSecMax PreProcScript Nombre global de hits/s par Canister (pour 5 Canisters, aec la aleur par défaut de 200, HBR régule le trafic à 1000 hits/s). Cette aleur globale peut être remplacée par Canister à l'aide de la directie CanisterPerSecMaxX. Chemin d'accès au script TCL de pré-traitement des règles HBR. Health Routing Method RoutingMethod Indique comment HBR doit acheminer le trafic. HBR peut acheminer le trafic de deux manières : 1) le mode "equal" indique qu'il doit équilibrer le trafic entre les machines de traitement cible. 2) le mode "biased" indique qu'il doit acheminer autant que possible le trafic ers le premier Canister puis passer au deuxième si la santé du premier le requiert, et ainsi de suite. Chapitre 4. Agents de session de pipeline CX 279

290 Tableau 18. Paramètres de configuration (suite) Nom d'affichage Nom Description StartUpRouting StartUpRouting Méthode de routage de secours au cas où HBR ne pourrait pas déterminer le routage. Il est très peu probable que cela se produise, mais cela pourrait être le cas si le fichier TeaLeafCaptureSocket.cfg de la section [DecoupleEx] n'était pas configuré aec "SpoolAtStartUp=True" ; au démarrage du serice le trafic pariendrait alors à l'agent de session HBR aant que ce dernier n'ait une chance de déterminer la santé des Canisters cible. Trace du script ScriptTrace Le traçage des scripts permet d'effectuer le suii des actiités des agents de session, ce qui est utile pour le débogage. Par sereur de traitement Pour chaque sereur de traitement : Tableau 19. Paramètres de configuration Nom d'affichage Nom Description Nom du Canister CanisterName Nom de machine (ou adresse IP) du sereur de traitement à sureiller. SearchSerer Port CanisterSSPort Numéro de port du sereur de recherche sur la machine du Canister cible (la aleur par défaut est 19000). Canister Pipeline ID CanisterPipeID Les pipelines enfant sont associés à HBR (paramètre PipelineConfig*), ce qui lie le Canister au pipeline enfant (ce nombre correspond à * dans le paramètre PipelineConfig*). CanisterAppName CanisterAppName Spécifie le paramètre AppName du fichier HBR_Pipeline*.cfg associé (chaque AppName doit être unique). HBR utilise cette aleur lorsqu'il analyse le GoernorStsEx pour rechercher l'entrée correcte. Durées d immobilisation du Canister CanisterOffline Durées d'immobilisation planifiées du Canister. "Daily at 2300 for 10 minutes winddown 20 minutes" indique qu'à 22h40, il n'y a aucune nouelle session (uniquement les sessions existantes), à 23h00, il n'y a aucun trafic, à 23h10, le trafic doit reprendre". Le format facultatif "Tuesday at 2300 for 10 minutes winddown 20 minutes" indique que le Canister est hors ligne tous les mardis à cette heure. 280 IBM Tealeaf CX - Guide de configuration

291 Tableau 19. Paramètres de configuration (suite) Nom d'affichage Nom Description HBR Initialization Time Out alue InitTimeOut Indique la durée (en secondes) requise par HBR lors de l'initialisation. L'initialisation peut prendre un certain temps si le nombre de fichiers spoule est éleé. Détermination de l'état de HBR Comment configurer HBR HBR fonctionne par l'intermédiaire du sereur de recherche, qui fournit le statut DecoupleEx des machines locales et éloignées. L'état du Canister est déterminé principalement suiant que le Canister est actif/inactif selon la commande GoernorStatus exécutée à partir du sereur de recherche. Si la aleur du délai moyen en file d'attente est supérieure à 30 minutes, Le Canister est considéré comme étant dans un état incorrect. Voir "Etat du système" dans le document IBM Tealeaf cximpact - Guide d'administration. Cette section décrit une approche généralisée de la configuration de HBR pour qu'il fonctionne aec plusieurs canisters dans otre enironnement Tealeaf. Pour chaque canister cible, il existe une corrélation un à un entre les entrées CanisterN de la section [HBR] du fichier TeaLeafCaptureSocket.cfg et le pipeline HBR enfant. Par conséquent, la configuration de HBR requiert les opérations suiantes : Edition de la section [HBR] du fichier TeaLeafCaptureSocket.cfg Edition des configurations de pipeline HBR enfant (HBR_PipelineN.cfg) Personnalisation supplémentaire de TeaLeafCaptureSocket.cfg et HBR_PipelineN.cfg, par exemple, pour ajuster les paramètres [DecoupleEx]. Configuration des paramètres globaux de HBR Dans la section [HBR] de TeaLeafCaptureSocket.cfg, érifiez les paramètres ci-après. Voir «Paramètres de configuration», à la page 279. Paramètre Description MaxSessions Cette aleur définit le nombre de lignes dans la table des sessions de HBR, qui correspond au nombre maximal de sessions gérées par HBR. Lorsqu'une nouelle session arrie dans HBR, la plus ancienne est supprimée. La aleur par défaut est Remarque : HBR requiert des données mises en session. DefaultPerSecMax Nombre maximal de hits/s par Canister cible. La aleur par défaut est 300. RoutingMethod Définit la méthode de routage des sessions ers chaque canister : Equal : chaque Canister reçoit le même nombre de sessions. La aleur par défaut est Equal. Chapitre 4. Agents de session de pipeline CX 281

292 Biased : l'ensemble du trafic est distribué au premier Canister jusqu'à ce qu'il ne puisse plus le traiter ; le trafic est alors acheminé ers le deuxième Canister et ainsi de suite. StartUpRouting Informations de routage en l'absence du statut du Canister. LocalSSPort Numéro de port du sereur de recherche local. La aleur par défaut est celle stockée dans le registre local. InitTimeOut Délai en secondes pendant lequel HBR attend l'initialisation, qui est complète une fois que DecoupleEx a été initialisé. La aleur par défaut est de 1800 secondes (30 minutes). HBRAppName Nom d'application dans le fichier.cfg dans lequel réside la section [HBR], qui permet à HBR de se trouer dans un pipeline enfant. La aleur par défaut est TeaLeafCSS_1966. Configuration des paramètres HBR pour des Canisters indiiduels Dans les paramètres ci-après, X indique le numéro d'index du Canister. Voir «Par sereur de traitement», à la page 280. Paramètre Description CanisterNameX Nom ou adresse IP du Canister cible. CanisterPipeIDX ID du fichier HBR_PipelineX.cfg associé de sorte que HBR connaisse le pipeline enfant associé au Canister. CanisterAppNameX Valeur AppName du fichier HBR_PipelineX.cfg, afin que HBR connaisse l'entrée Statut de régulateur de la commande GoernorStatusEx. CanisterSSPortX Numéro de port du sereur de recherche pour le Canister cible. La aleur par défaut est CanisterPerSecMaxX Nombre maximal de hits/s du Canister cible, qui remplace le paramètre global par défaut et permet le déploiement de Canisters dotés de fonctionnalités différentes. La aleur par défaut est la aleur par défaut globale. CanisterSSLogX Indique si les demandes HBR doient être consignées dans le journal du sereur de recherche. La aleur par défaut est False. Durées d'immobilisation du Canister HBR doit être informé des durées d'immobilisation planifiées du Canister. Pour chaque Canister, ous pouez spécifiez les horaires quotidiens ou hebdomadaires auxquels HBR doit réduire son actiité aant d'arrêter le flux de hits ers le Canister, pour que les tâches de maintenance puissent y être effectuées. 282 IBM Tealeaf CX - Guide de configuration

293 Les configurations ci-après décrient plusieurs durées d'immobilisation planifiées pour le même Canister. Les durées d'immobilisation indiiduelles commencent par le même identificateur (CanisterOffline=1) et peuent receoir une extension unique (a, b) en suffixe pour spécifier plusieurs durées d'immobilisation. Exemples de configuration : CanisterOffline1=Daily at 2300 for 10 minutes winddown 20 minutes Tous les jours à 22h40, arrête le flux des noueaux hits ers ce Canister. A 23h00, arrête le Canister pour 10 minutes. CanisterOffline1a=Tuesday at 0200 for 10 minutes winddown 20 minutes Tous les mardis à 1h40, arrête le flux des noueaux hits ers ce Canister. A 2h00, arrête le Canister pour 10 minutes. CanisterOffline1b=Friday at 0500 for 10 minutes winddown 20 minutes Tous les endredis à 4h40, arrête le flux des noueaux hits ers ce Canister. A 5h00, arrête le Canister pour 10 minutes. Désactiation des connexions entre HBR et le Canister Vous pouez désactier les connexions de HBR ers des Canisters indiiduels par l'intermédiaire des fichiers de configuration de HBR. Toutefois pour les durées d'immobilisation non planifiées, il peut être délicat d'effectuer ces modifications sans interrompre la capture et le traitement des données. Au lieu de cela, ous pouez utiliser la méthode ci-après. Remarque : Si ous deez arrêter le routage des hits ers un Canister géré par HBR, ous pouez arrêter le serice Sereur de recherche sur la machine cible. Lorsque HBR tente d'enoyer des hits à un sereur, il commence par interroger le sereur de recherche. Si ce dernier est inactif, il n'enoie pas les hits et commence à les réacheminer ers un autre Canister. Attendez 60 secondes pour érifier que HBR n'achemine plus le trafic ers le Canister. Vous pouez sureiller le flux du trafic ia le rapport HBR. Voir "Etat du système" dans le document IBM Tealeaf cximpact - Guide d'administration. Configuration des paramètres d'un pipeline HBR enfant Pour chaque canister de destination, ous deez configurer un pipeline enfant distinct. Remarque : Il doit exister une correspondance un à un entre un pipeline enfant et un Canister de destination. PipelineConfig1=HBR_Pipeline1.cfg PipelineConfig2=HBR_Pipeline2.cfg PipelineConfig3=HBR_Pipeline3.cfg PipelineConfig4=HBR_Pipeline4.cfg... PipelineConfigN=HBR_PipelineN.cfg Exemple de configuration [HBR]... MaxSessions= DefaultPerSecMax=220 StartUpRouting=1:1-20; 2:21-40; 3:41-60; 4:61-80; 5: RoutingMethod=Equal HBRAppName=TeaLeafCSS_1966 CanisterName1=utltea01 CanisterPipeID1=1 Chapitre 4. Agents de session de pipeline CX 283

294 CanisterAppName1=TeaLeafHBR1 CanisterSSLog1=OFF #CanisterOffline1=Daily at 0100 for 30 minutes winddown 15 minutes CanisterName2=utltea02 CanisterPipeID2=2 CanisterAppName2=TeaLeafHBR2 CanisterSSLog2=OFF #CanisterOffline2=Daily at 0100 for 30 minutes winddown 15 minutes CanisterName3=utltea03 CanisterPipeID3=3... PipelineConfig1=HBR_Pipeline1.cfg PipelineConfig2=HBR_Pipeline2.cfg PipelineConfig3=HBR_Pipeline3.cfg PipelineConfig4=HBR_Pipeline4.cfg PipelineConfig5=HBR_Pipeline5.cfg PipelineConfig6=HBR_Pipeline6.cfg PipelineConfig7=HBR_Pipeline7.cfg Personnalisation des configurations DecoupleEx principales et enfant Les paramètres ci-après doient être examinés dans la section [DecoupleEx] du fichier TealeafCaptureSocket.cfg. Remarque : Vérifiez que chaque dossier spoule DecoupleEx est unique. N'autorisez pas plusieurs instances DecoupleEx partageant le même dossier spoule. Voir «Agent de session DecoupleEx», à la page 266. Paramètre Description SpoolAtStartup=True HBR requiert eniron 15 secondes pour déterminer la santé des Canisters cible. Si elle est correcte, HBR arrête les éentuelles mises en file d'attente et commence à enoyer des hits. Remarque : Cette aleur doit être true. MaxOutMode=HITS Cette aleur définit la mesure par l'intermédiaire de laquelle HBR détermine le débit des Canisters indiiduels. Spécifiez la aleur HITS. MaxOutHitsPerSec=10000 Cette aleur définit le nombre maximal de hits de débit des Canisters indiiduels. La aleur entrée doit prendre en compte tous les pipelines enfant, chacun alimentant un Canister. Commencez par spécifier une aleur éleée pour éiter que la régulation de la distribution des hits ne soient plus sous contrôle de HBR. Agents de session Tealeaf «Ajout d'un agent de session», à la page 237 «Agent de session Archiage», à la page 238 "Agent de session Indexation des attributs" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session Canister», à la page 249 «Agent de session Analyseur de cookie», à la page 252 «Agent de session Dépose de données», à la page IBM Tealeaf CX - Guide de configuration

295 «Agent de session Analyseur de données», à la page 260 «Agent de session Decouple», à la page 264 «Agent de session DecoupleEx», à la page 266 «Agent de session Confidentialité étendue», à la page 275 Agent de session Health-Based Routing (HBR) «Agent de session Déploiement» «Agent de session Analyseur mobile JSON», à la page 289 «Agent de session Code géré», à la page 303 «Agent de session Null», à la page 306 «Agent de session Confidentialité», à la page 307 «Agent de session RTA (Real-Time Monitoring and Alert)», à la page 341 «Agent de session Balises de réponse pour la demande», à la page 346 «Agent de session Fractionnement RTA», à la page 348 «Agent de session de mise en sessions», à la page 353 «Agent de session Routeur de session», à la page 350 «Agent de session Socket», à la page 356 «Agent de session Consignateur de statistiques», à la page 358 "Agent de session de référence Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session de référence Tealeaf - Mode existant», à la page 380 «Agent de session Mise en sessions Tealeaf», à la page 384 «Agent de session TimeGrades», à la page 390 «Agent de session TLI», à la page 392 «Agent de session de décodage d'url», à la page 408 Agent de session Déploiement L'agent de session Déploiement effectue plusieurs fonctions de pipeline et notamment le déploiement des données compressées par un sereur Web pour le transfert HTTP. Par défaut, cet agent de session est toujours configuré comme partie intégrante de chaque pipeline. Remarque : Pour certains déploiements du sereur de traitement, cet agent de session est inclus dans le pipeline par défaut et est requis. Voir «Configuration du pipeline CX», à la page 224. Remarque : Si ous capturez des adresses IP au format IP6, pour permettre l'indexation et la recherche de ces adresses, ous deez effectuer l'une des opérations suiantes : Mise à nieau ers la PCA Build 3501 ou ultérieur Déploiement de l'agent de session Déploiement dans chaque pipeline de traitement Windows. Remarque : Cet agent de session doit apparaître aant tout agent de session qui peut examiner les données dans la réponse HTTP, et notamment Confidentialité, Analyseur de données et RTA. Chapitre 4. Agents de session de pipeline CX 285

296 Présentation Cet agent de session étant généralement présent et placé aant les agents de session de traitement, l'agent de session Déploiement a été étendu par des fonctionnalités supplémentaires pour améliorer les performances et simplifier le pipeline. Il peut également effectuer les fonctions suiantes : Unreqcancelled : cette fonctionnalité peut être utilisée pour identifier les faux positifs dans lesquels une demande semble aoir été annulée par le isiteur. Généralement, cette fonctionnalité peut être gérée par le périphérique Passie Capture, mais elle peut représenter une charge pour l'uc. Si elle est actiée ia l'agent de session Déploiement, cette option permet de décharger cette fonctionnalité car l'agent de session Déploiement utilise déjà la mémoire tampon des réponses. Internationalisation : pour gérer les problèmes de localisation, le périphérique de capture passie peut insérer des ariables de mémoire tampon dans la demande liée à l'internationalisation. Si ces ariables ne sont pas présentes, l'agent de session Déploiement les ajoute. Cette fonction ne requiert aucune configuration. Voir "Prise en charge de l'internationalisation" dans le document IBM Tealeaf CX - Guide d'installation. Compression : l'agent de session Déploiement peut éentuellement être configuré pour compresser les données de réponse HTTP, ce qui est utile dans les pipelines configurés pour transmettre les hits capturés aux autres sereurs du réseau. L'agent de session Déploiement remplace l'agent de session Compression, qui est obsolète. Données de demande IP6 : pour prendre en charge l'indexation et la recherche d'adresses IP6, l'agent de session Déploiement insère des ariables de demande pour les adresses IP dans un format compatible IP6. Voir «Données de demande IP6», à la page 288. Remarque : Cet agent de session doit être utilisé si les données compressées sont traitées par des agents de session autres que les agents de session finaux (Archiage, Socket ou Null) ou par le programme d'indexation des sessions Tealeaf. Ajout de l'agent de session Des agents de session peuent être ajoutés ia l'éditeur de pipeline dans TMS. Voir «Ajout d'un agent de session», à la page 237. Pour plus d'informations sur l'éditeur de pipeline et TMS, oir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Le reste de cette page décrit les options de configuration et la manière de les modifier ia le fichier TealeafCaptureSocket.cfg stocké sur le sereur. Ces paramètres sont également disponibles ia l'éditeur de pipeline, cette méthode étant recommandée pour configurer les agents de session. Paramètres de configuration Les paramètres ci-après sont disponibles pour l'agent de session Déploiement. Les aleurs Nom d affichage sont affichées dans TMS, cette méthode étant recommandée pour configurer les agents de session. Voir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. 286 IBM Tealeaf CX - Guide de configuration

297 Les aleurs Nom sont affichées dans TealeafCaptureSocket.cfg. Tableau 20. Agent de session de déploiement Nom d'affichage Nom Description Replace Response On Error ReplaceResponseOnError Si ce paramètre est défini sur True, une erreur rencontrée lors de la décompression d'une réponse dont le codage de contenu est gzip ou deflate entraîne le remplacement du corps de réponse par du HTML alide contenant un message d'erreur descriptif. La aleur par défaut est True. Si la aleur est False, la réponse d'origine est conserée lorsqu'une erreur se produit au cours de la décompression. Remarque : Si cette aleur est False et que l'opération de décompression échoue, le message suiant est inséré dans la demande : InflateFailed=True. UnReqCancelled UnReqCancelled Les hits Demande annulée ont lieu si le sereur IBM Tealeaf CX Passie Capture Application ne peut pas effectuer la capture. Généralement, un hit est un hit Demande annulée si le sereur PCA n'a pas reçu de réponse du sereur Web à la demande du naigateur ou que la taille de la réponse du sereur Web ne correspond pas à la taille spécifiée dans l'en-tête de réponse. Dans certains cas, une non concordance dans la taille de la réponse ne signifie pas que la réponse est incomplète. Par exemple, une réponse HTML contenant une balise </html> de fin ou une balise de fermeture XML correcte peut tout de même constituer une réponse complète. Si ce paramètre est défini sur True (aleur par défaut), les hits ReqCancelled recherchent une balise de clôture appropriée dans la réponse. s'ils en trouent une, l'agent de session modifie la aleur ReqCancelled en False. Chapitre 4. Agents de session de pipeline CX 287

298 Tableau 20. Agent de session de déploiement (suite) Nom d'affichage Nom Description Max Inflate Size MaxInflateSize Ce paramètre indique la taille de réponse maximale à laquelle cet agent de session déploie une réponse réduite ou compressée. Ce paramètre représente une limite de sécurité du pipeline pour empêcher que les réponses olumineuses ne le deiennent encore daantage. La aleur par défaut est de 1536 ko. Codage par défaut DefaultEncoding Si le Mode est défini sur décompression, cette aleur indique le schéma de codage par défaut à appliquer au texte décompressé. La aleur par défaut est iso Nieau de compression CompressionLeel Si le Mode est défini sur décompression, cette aleur indique le nieau de compression à utiliser lors de la compression. Les nieaux de compression s'échelonnent entre 1 (le plus faible) et 9 (le plus éleé). La aleur par défaut est 5. Mode Mode Ce paramètre définit le mode de fonctionnement de l'agent de session. Déploiement : l'agent de session Déploiement décompresse les données de réponse HTTP. Compression : l'agent de session Compression compresse les données de réponse HTTP. Si aucune aleur n'est explicitement spécifiée, l'agent de session fonctionne en mode Compression. Données de demande IP6 Depuis la build 3501, IBM Tealeaf CX Passie Capture Application prend en charge la capture des adresses IP au format IP4 et IP6. En fonction du format détecté, les adresses IP sont écrites dans un format compatible IP6 dans les ariables de demande suiantes : IPV6_REMOTE_ADDR IPV6_LOCAL_ADDR Si ces ariables ne sont pas présentes dans la demande, l'agent de session Déploiement les insère. Ces ariables de demande sont ensuite indexées à des fins de recherche, ce qui permet la recherche d'adresses IP4 ou IP6 par l'intermédiaire d'une zone de recherche unique. Pour plus d'informations sur ces ariables de demande, oir "Prise en charge d'ip6" dans le document IBM Tealeaf CX - Guide d'installation. 288 IBM Tealeaf CX - Guide de configuration

299 Pour plus d'informations sur la prise en charge de bout en bout d'ip6 dans Tealeaf, oir "Prise en charge d'ip6" dans le document IBM Tealeaf CX - Guide d'installation. Agents de session Tealeaf «Ajout d'un agent de session», à la page 237 «Agent de session Archiage», à la page 238 "Agent de session Indexation des attributs" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session Canister», à la page 249 «Agent de session Analyseur de cookie», à la page 252 «Agent de session Dépose de données», à la page 254 «Agent de session Analyseur de données», à la page 260 «Agent de session Decouple», à la page 264 «Agent de session DecoupleEx», à la page 266 «Agent de session Confidentialité étendue», à la page 275 «Agent de session Health-Based Routing (HBR)», à la page 278 Agent de session de déploiement «Agent de session Analyseur mobile JSON» «Agent de session Code géré», à la page 303 «Agent de session Null», à la page 306 «Agent de session Confidentialité», à la page 307 «Agent de session RTA (Real-Time Monitoring and Alert)», à la page 341 «Agent de session Balises de réponse pour la demande», à la page 346 «Agent de session Fractionnement RTA», à la page 348 «Agent de session de mise en sessions», à la page 353 «Agent de session Routeur de session», à la page 350 «Agent de session Socket», à la page 356 «Agent de session Consignateur de statistiques», à la page 358 "Agent de session de référence Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session de référence Tealeaf - Mode existant», à la page 380 «Agent de session Mise en sessions Tealeaf», à la page 384 «Agent de session TimeGrades», à la page 390 «Agent de session TLI», à la page 392 «Agent de session de décodage d'url», à la page 408 Agent de session Analyseur mobile JSON Remarque : Dans la ersion 8.5, Tealeaf introduit la mise en éénements par étapes, dans laquelle toutes les structures client soumettent des informations d'éénement dans un format JSON cohérent. Par conséquent, cet agent de session n'est plus utilisé aec la dernière ersion des structures de capture côté client. Pour la ersion 8.7, une mise à nieau d'une structure client Tealeaf utilisée peut être requise. Pour plus d'informations sur la nouelle implémentation de capture à partir des structures de consignation, oir "Eénements basés sur des étapes" dans le document IBM Tealeaf Eent Manager - Guide. Chapitre 4. Agents de session de pipeline CX 289

300 L'agent de session Analyseur mobile JSON analyse les messages JSON en texte normal, qui sont générés par les structures de consignation Tealeaf ios ou Android Mobile. Lorsque les données sont décodées, l'agent de session les analyse pour les données d'enironnement et d'éénement, qui sont ajoutées comme paires nom/aleur sur les hits résultants. L'analyseur n'éalue pas les hits Web mobiles, qui peuent être capturés par l'une des structures client prises en charge. Remarque : Les structures de consignation Tealeaf ios et Android Mobile sont un composant de la licence IBM Tealeaf CX Mobile pour application mobile. Contactez otre interlocuteur IBM Tealeaf. Remarque : Cet agent de session ne prend en charge que les données des périphériques ios et Android. Utilisations Cet agent de session est utilisé par les structures client pour générer des données de hit dans les sessions en fonction des messages JSON soumis (méthode existante). Ces ersions ont été introduites dans la ersion 8.4 et remplacées par la messagerie basée sur des étapes. Remarque : Cet agent de session ne s'applique qu'à la méthode existante de gestion des messages JSON des structures client par fractionnement des hits. Si ous aez implémenté la gestion des éénements basée sur des étapes, introduite dans la ersion 8.5, cette session n'est pas requise dans otre implémentation. Présentation Les structures de consignation mobiles ios/android de Tealeaf capturent les données d'enironnement et d'éénement des applications mobiles ios ou Android et les soumettent aux sereurs Tealeaf pour capture et traitement. Si la PCA a été correctement configurée pour traiter ces hits, ils sont acheminés au pipeline Windows pour décodage et analyse, ces opérations étant effectuées en grande partie par cet agent de session. A mesure que chaque hit est reçu par l'agent de session, il est analysé afin d'y rechercher les paires nom/aleur qui l'identifient comme hit contenant des données de l'une des structures de consignation prises en charge. Les hits qui ne contiennent pas les aleurs appropriées sont transmis au prochain agent de session sans modification. Lorsque l'agent de session rencontre une erreur au cours du traitement d'un hit (par exemple, en raison de données de consignation non alides), il génère un fichier de idage et le pipeline Windows redémarre. Pour plus d'informations sur les paires nom/aleur requises, oir «Identificateurs de demande», à la page 291. Les hits qui contiennent des données soumises à partir d'une structure sont analysés conformément à la procédure ci-après. Les messages JSON sont fractionnés en plusieurs hits Tealeaf afin de rendre les données de l'application natie mobile accessible pour la mise en éénement. La majorité des données de demande est clonée à partir du hit d'origine. Chaque hit ne peut contenir que des types de message JSON uniques. Un noueau hit est créé si un type de message est répété. 290 IBM Tealeaf CX - Guide de configuration

301 Remarque : Les hits peuent également être fractionnés par session. Les structures de consignation Tealeaf peuent enoyer les données de plusieurs sessions dans un même message. Les données sont analysées dans un objet C++ représentant le message JSON. Si cette étape échoue, une erreur est consignée. L'agent de session génère un fichier de idage et le pipeline Windows redémarre. Ces sections supplémentaires sont ajoutées à la demande : AppEn et MobileEents, qui contiennent respectiement les données d'enironnement et d'éénement. Une fois que chaque hit Tealeaf a été créé, il est transmis au prochain agent de session du pipeline pour un traitement en aal. Ces étapes sont répétées pour les hits suiants qui passent par l'agent de session. Chaque paquet soumis à partir des structures de consignation peut être diisé dans le système Tealeaf en plusieurs hits composés de ues et d'écrans différents de ceux de l'application natie mobile. Tealeaf recommande d'utiliser l'agent de session DecoupleEx après celui-là pour réguler la distribution des hits aux agents de session et pipelines suiants. Voir «Pipeline de traitement de l'analyseur mobile», à la page 292. Remarque : Il peut s'aérer difficile de préoir la quantité de données générées en fonction de la capture d'une application mobile à l'aide des structures de consignation mobiles. Tealeaf recommande un test de charge exhaustif dans un enironnement de déeloppement aant tout déploiement en production. Prérequis Installation d'une page cible Tealeaf L'application mobile sureillée doit être configurée de sorte à soumettre des demandes à une page cible Tealeaf, qui accuse réception de la soumission pour permettre la capture et la transmission des éénements côté client à Tealeaf. Voir "Installation et implémentation d'ui Capture for AJAX" dans le document IBM Tealeaf UI Capture for AJAX - Guide. Remarque : IBM Tealeaf CX UI Capture for AJAX n'est disponible que pour les utilisateurs existants. Les noueaux utilisateurs doient utiliser IBM Tealeaf CX UI Capture j2. Identificateurs de demande Les hits générés et soumis par les structures de consignation mobiles doient comporter les paires nom/aleur suiantes dans la demande : HTTP_CONTENT_TYPE=<AnyContentTypeEndingwith>/json HTTP_X_TEALEAF =DEVICE X-Tealeaf-JSON-Version=N.N.N.N où : DEVICE est défini sur Android ou ios NNNN représente la ersion du schéma JSON A mesure que chaque hit est reçu pour être traité, l'agent de session recherche la aleur HTTP_CONTENT_TYPE. Chapitre 4. Agents de session de pipeline CX 291

302 Si le type ne se termine pas par json, le hit est transmis en aal sans être modifié. La chaîne d'unité de HTTP_X_TEALEAF=DEVICE est analysée et érifiée si DEVICE possède la aleur Android ou ios. Si ce n'est pas le cas, le hit est transmis en aal sans être modifié. Configuration de la PCA La PCA doit être configurée pour capturer le type de données soumis par les structures de consignation mobiles. Dans l'onglet Pipeline de la console Web de la PCA, ous deez spécifier ce qui suit : Les pages mobiles soumises pour capture ne doient pas apparaître dans la liste des extensions de fichier exclues. La page TealeafTarget doit être actiée pour la capture. Les extensions spéciales liées à otre application mobile doient être incluses dans la liste des extensions de fichier incluses. Les types POST JSON ci-après doient être actiés pour la capture. Ces types de contenu doient être érifiés ou insérés dans la configuration Capture de la totalité des types de POST. text/json text/x-json application/json application/x-json Voir "Console Web de la PCA - Onglet Pipeline" dans le document IBM Tealeaf Passie Capture Application - Guide. Pipeline de traitement de l'analyseur mobile L'agent de session Analyseur mobile JSON peut être déployé dans tout pipeline Tealeaf, y compris les pipelines enfant. Prenez en compte les points suiants : Remarque : Cet agent de session doit être déployé aant l'agent de session Confidentialité dans le pipeline. Voir «Agent de session Confidentialité», à la page 307. Voir «Agent de session Confidentialité étendue», à la page 275. Remarque : Pour mettre en sessions les hits de l'application mobile, ous deez insérer l'agent de session Mise en sessions après celui-ci pour qu'il puisse utiliser l'identificateur SessionID extrait de la section MobileEn comme clé de mise en sessions. Voir «Agent de session de mise en sessions», à la page 353. Les pipelines sont configurés dans l'éditeur de pipeline, dans Tealeaf Management System. Voir "Editeur de pipeline TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. Voir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Agents de session liés aux périphériques mobiles Les agents de session ci-après s'appliquent à la capture effectie des données d'application soumises à partir des structures de consignation déployées sur les périphériques mobiles. 292 IBM Tealeaf CX - Guide de configuration

303 Tableau 21. Pipeline de traitement de l'analyseur mobile Ordre Agent de session Requis pour la structure Description recommandé 1 Analyseur mobile JSON O Capture les éénements JSON soumis par la structure de consignation Tealeaf déployée. Pour plus d'informations, oir l'agent de session Analyseur mobile JSON. 2 Analyseur mobile de données structurées N Capture les données client soumises dans les posts JSON par l'application mobile. Cet agent de session n'est requis dans otre pipeline de données mobiles que si ous capturez des données client de l'application natie mobile. 3 Découpleur N L'agent de session Analyseur mobile JSON peut générer plusieurs hits pour chaque hit qui passe par le pipeline. Pour gérer la soudaine hausse de trafic en aal, ous deez enisager d'insérer l'agent de session Découpleur en aal de l'analyseur mobile. Pour plus d'informations, oir «Agent de session Decouple», à la page Confidentialité N Après les agents de session JSON, ous deez déployer l'agent de session Confidentialité pour pouoir supprimer les données sensibles exposées sous forme de messages JSON en texte en clair par l'analyseur. Pour plus d'informations, oir «Agent de session Confidentialité», à la page Mise en sessions N Génère la clé de mise en sessions des sessions proenant de l'application mobile à l'aide de la structure de consignation. Pour plus d'informations, oir «Agent de session de mise en sessions», à la page 353. Cet agent de session doit être placé après l'agent de session Analyseur mobile JSON dans le pipeline, car il utilise l'id session de la clé AppEn pour la mise en sessions. Chapitre 4. Agents de session de pipeline CX 293

304 Ajout de l'agent de session Paramètres de configuration Remarque : Si l'agent de session Analyseur mobile est présent, supprimez-le car il est obsolète et a été remplacé par la ersion JSON. Des agents de session peuent être ajoutés ia l'éditeur de pipeline dans TMS. Voir «Ajout d'un agent de session», à la page 237. Pour plus d'informations sur l'éditeur de pipeline et TMS, oir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Le reste de cette page décrit les options de configuration et la manière de les modifier ia le fichier TealeafCaptureSocket.cfg stocké sur le sereur. Ces paramètres sont également disponibles ia l'éditeur de pipeline, cette méthode étant recommandée pour configurer les agents de session. [MobileJsonParser] TypeName=MobileJsonParser DLL=SessionAgentMobileJsonParser.dll DownStreamConfigSection=TLTRef LogLeel=Debug EnableLogFile=true LogKeepDays=30 OutputStats=true StatsReportingInteral=60 Tableau 22. Paramètres de configuration Nom d'affichage Nom Description Nieau de journal LogLeel Le nieau de consignation de l'agent de session peut prendre l'une des aleurs numériques ci-après. 0 - Erreurs uniquement 1 - Aertissements 2 - Info 3 - Performances 4 - Débogage de l'analyse 5 - Traçage des fonctions La mise en commentaire de ce paramètre désactie la consignation. Voir «Journalisation», à la page 295. Enable Log File EnableLogFile Si la aleur est true, un fichier journal est enregistré pour l'agent de session dans le répertoire Logs. Voir «Journalisation», à la page 295. Log Keep Days LogKeepDays Spécifiez le nombre de jours pendant lequel les fichiers de consignation doient être conserés. La aleur par défaut est 30. Output Stats OutputStats Si la aleur est true, les statistiques sont générées à partir de l'agent de session suiant l'interalle défini ci-après. 294 IBM Tealeaf CX - Guide de configuration

305 Tableau 22. Paramètres de configuration (suite) Nom d'affichage Nom Description Stats Reporting Interal StatsReportingInteral Interalle en minutes auquel les statistiques sont générées et communiquées par l'agent de session. La aleur par défaut est de 60 (une heure). Journalisation Un journal de cet agent de session est conseré dans le répertoire Logs à l'intérieur du répertoire d'installation de Tealeaf. Exceptions non traitées Si une exception n'est pas traitée, un message similaire au message ci-après est enregistré dans le journal des éénements d'application Windows. Process dump file written to: C:\Tealeaf\Logs\TeaLeafCaptureSocket.exe-(X.X.X.XXXX)-YYYYMMDD-NNNNNN-NNNNN- NNNNN.dmp Please send this file along with the information below to Tealeaf customer support, and delete the dump file when finished. Exception <exception name and number> at address 0xADDR! <source file name and line number> Module: c:\tealeaf\sessionagentmobilejsonparser.dll BaseAddr: 0xADDR Le fichier de idage référencé ci-dessus est enregistré dans le répertoire Logs. Remarque : Si une exception n'est pas traitée, le pipeline s'arrête et redémarre et les hits en cours de traitement sont perdus. Références aux paires nom/aleur mobiles Remarque : Les informations de référence ci-après s'appliquent aux solutions Tealeaf qui utilisent l'agent de session Analyseur mobile JSON et non la mise en éénements par étape. Cet analyseur n'est pas disponible pour la ersion 8.3. et les ersions antérieures. A partir de la ersion 8.5, Tealeaf introduit un format de messagerie JSON générique dans la structure client, qui ne requiert pas cet agent de session. Voir "Référence de schéma d'objet JSON Tealeaf" dans le document IBM Tealeaf Client Framework - Guide d'intégration des données. A l'aide du format de message JSON, ous pouez créer des éénements dans Tealeaf. Voir "Mise en éénement par étape" dans le document IBM Tealeaf Eent Manager - Guide. Exemples de données de demande Exemple de section AppEn Cette section n'est générée que si les données correspondantes sont présentes dans le message JSON soumis. Cette section peut apparaître dans chaque demande de la session. Chapitre 4. Agents de session de pipeline CX 295

306 [AppEn] SessionID=9fb657a4a241d140d1e8c5c551c13752 SessionStartTime= Pour plus d'informations sur ces zones, oir «Section AppEn». Exemple de section MobileEents Cette section n'est générée que si les données correspondantes sont présentes dans le message JSON soumis. [MobileEents] CustomEent_TimeOffset= CustomEent_ScreenViewOffset= CustomEent_CustomEentName=AlertDialog is Pressed CustomEent_CustomEentData=AlertDialog Button Pressed: OK Control_TimeOffset= Control_ScreenViewOffset= Control_Id=-1 Control_Target.Type=LinearLayout Control_Target.SubType=ViewGroup Control_Location.x=0 Control_Location.y=118 Control_Location.width=480 Control_Location.height=117 Control_Eent.Type=Click Control_Eent.SubType= Pour plus d'informations sur ces zones, oir «Section MobileEents», à la page 298. RequestBody A des fins de relecture, le premier hit de chaque session contient la section [RequestBody], qui correspond aux données JSON. Section AppEn La section [AppEn] de la demande contient des informations sur l'application mobile et le périphérique sur lequel elle est exécutée. Paire Nom/Valeur Description SessionID=x x représente le modèle du périphérique utilisé (par exemple, iphone) SessionStartTime=n n représente l'heure de lancement de la session en microsecondes depuis le 1er janier 1970 (GMT) Message ClientEnironment Description : contient des informations spécifiques au périphérique. Apparaît à des interalles spécifiques dans une session. ClientEnironment Si elles sont disponibles, les paires nom/aleur de l'enironnement sont ajoutées à la section [AppEn]. Ces données sont répétées dans les hits fractionnés et générés par l'agent de session. 296 IBM Tealeaf CX - Guide de configuration

307 Description : contient des données d'enironnement client de base cohérentes entre tous les périphériques. Préfixe du nom : ClientEnironment Paire Nom/Valeur Description ClientEnironment_OSVersion=x x représente la ersion du système d'exploitation du périphérique. ClientEnironment_Width=n n représente la largeur de l'écran. ClientEnironment_Height=n n représente la hauteur de l'écran. MobileEnironment Préfixe du nom : ClientEnironment.MobileEnironment Description : contient des informations sur l'enironnement spécifique au périphérique mobile. Paire Nom/Valeur Description ClientEnironment_MobileEnironment_TotalStorage=n n représente la capacité de stockage (en octets) sur le périphérique. ClientEnironment_MobileEnironment_TotalMemory=n n représente la quantité de mémoire (en octets) sur le périphérique. ClientEnironment_MobileEnironment_Locale=x x représente l'identificateur de l'enironnement local actuel (par exemple, en_us). ClientEnironment_MobileEnironment_Language=x x représente l'identificateur de la langue actuelle (par exemple, en). ClientEnironment_MobileEnironment_Manufacturer=x x représente le fabricant du périphérique. ClientEnironment_MobileEnironment_DeiceModel=x x représente le modèle du périphérique utilisé (par exemple, iphone). ClientEnironment_MobileEnironment_AppName=x x représente le nom de l'application consignée. ClientEnironment_MobileEnironment_AppVersion=n.n Version de l'application mobile ClientEnironment_MobileEnironment_UserID=x x représente un ID utilisateur haché pour l'utilisateur du périphérique. ClientEnironment_MobileEnironment_OrientationType=x x représente le type d'orientation par défaut du périphérique. Enironnement Android Préfixe du nom : ClientEnironment.MobileEnironment.Android Description : contient des informations sur l'enironnement spécifique à Android. Paire Nom/Valeur Description ClientEnironment_MobileEnironment_Android_KeyBoardType=x Valeurs des chaînes : Chapitre 4. Agents de session de pipeline CX 297

308 QWERTY NO_KEYS ClientEnironment_MobileEnironment_Android_Brand=x x représente la marque du périphérique ClientEnironment_MobileEnironment_Android_FingerPrint=x x représente l'empreinte du périphérique Exemple ClientEnironment_OSVersion=2.3.4 ClientEnironment_Width=0 ClientEnironment_Height=0 ClientEnironment_MobileEnironment_TotalStorage= ClientEnironment_MobileEnironment_TotalMemory= ClientEnironment_MobileEnironment_Locale=English (United States) ClientEnironment_MobileEnironment_Language=English ClientEnironment_MobileEnironment_Manufacturer=motorola ClientEnironment_MobileEnironment_DeiceModel=MB860 ClientEnironment_MobileEnironment_AppName= ClientEnironment_MobileEnironment_AppVersion=1.0 ClientEnironment_MobileEnironment_UserID=fpgh48 ClientEnironment_MobileEnironment_OrientationType=PORTRAIT ClientEnironment_MobileEnironment_Android_Brand=MOTO ClientEnironment_MobileEnironment_Android_FingerPrint= MOTO/olyatt/olympus:2.3.4/4.5.91/110625:user/release-keys ClientEnironment_MobileEnironment_Android_KeyBoardType=1 Section MobileEents Conentions de dénomination des paires Nom/Valeur des éénements mobiles Les entrées de la section [MobileEents] de la demande sont nommées en fonction du type de message qu'elles utilisent pour les rapports. Chaque paire nom/aleur représentant un membre de données d'un objet JSON, le nom est élaboré pour représenter la hiérarchie, mais sous une forme utilisable pour le traitement Tealeaf. Tout éénement possède au moins une entrée : Paire Nom/Valeur Description <messagetype>.timeoffset=n n est le décalage de l'éénement par rapport à l'horodatage <messagetype>.screenviewoffset=n n est le décalage de l'éénement par rapport à l'horodatage depuis que le contexte a été chargé La liste ci-après répertorie les paires de nom/aleur attendues pour chaque type de message. Si une aleur n'est pas entrée par le message client, elle n'est pas affichée. Message de commande Description : contient les informations spécifiques à l'interaction aec l'utilisateur. Préfixe du nom : Control_Target Description : contient des informations sur l'élément d'interface graphique cible spécifique à l'action utilisateur. 298 IBM Tealeaf CX - Guide de configuration

309 Paire Nom/Valeur Description Control_TimeOffset=n n est le décalage de l'éénement par rapport à l'horodatage Control_ScreenViewOffset=n n est le décalage de l'éénement par rapport à l'horodatage depuis que le contexte a été chargé Control_Target_Type=x x est le type de commande d'interface graphique Control_Target_SubType=x x est le sous-type éentuel de commande d'interface graphique Control_Target_Id=x x est l'id unique de la commande Control_Target_DwellTime=n n est le temps passé par l'utilisateur sur cette commande d'interface graphique Control_Target_CurrentState=x x est l'état actuel éentuel de la commande d'interface graphique (Exemple : texte actuel dans une zone de texte) Control_Target_PreiousState=x x est l'état précédent éentuel de la commande d'interface graphique (Exemple : texte initial dans une zone de texte, aant l'éénement) Préfixe du nom : Control_Target_Position Description : contient des informations sur la position de l'élément d'interface graphique cible par rapport à l'écran. Paire Nom/Valeur Description Control_Target_Position_x=n n est l'abscisse de la commande d'interface graphique Control_Target_Position_y=n n est l'ordonnée éentuelle de la commande d'interface graphique Control_Target_Position_width=n n est la largeur de la commande d'interface graphique Control_Target_Position_height=n n est la hauteur éentuelle de la commande d'interface graphique Exemple Control_TimeOffset= Control_TimeOffset= Control_Target_Type=LinearLayout Control_Target_SubType=ViewGroup Control_Target_Id=0 Control_Target_DwellTime=3245 Control_Target_CurrentState= Control_Target_PreiousState= Control_Target_Position.x=0 Control_Target_Position.y=118 Chapitre 4. Agents de session de pipeline CX 299

310 Control_Target_Position.width=100 Control_Target_Position.height=75 Control_Eent_Type=Click Control_Eent_SubType= Message ScreenView Description : contient la ue ScreenView isible par le isiteur. Préfixe du nom : ScreenView Description : contient des informations sur les opérations de chargement ou de déchargement de la ue ScreenView actuelle. Paire Nom/Valeur Description ScreenView_TimeOffset=n n est le décalage de l'éénement par rapport à l'horodatage ScreenView_ScreenViewOffset=n n est le décalage de l'éénement par rapport à l'horodatage depuis que le contexte a été chargé ScreenView_LogicalPageName=x x est le nom du contexte ScreenView_Type=x x est LOAD ou UNLOAD. ScreenView_RenderTime=n n représente le temps nécessaire, en millisecondes, pour présenter le contexte lors d'une action LOAD. ScreenView_Referrer=x x est la référence au contexte précédent qui a lancé le contexte actuel. Exemple ScreenView_TimeOffset=225 ScreenView_ScreenViewOffset=0 ScreenView_LogicalPageName=Tab2 ScreenView_Type=LOAD ScreenView_RenderTime=22 ScreenView_Referrer=Tab1 Message d'éénement personnalisé Préfixe du nom : CustomEent Description : contient le nom de l'éénement personnalisé et les données d'éénement. Paire Nom/Valeur Description CustomEent_CustomEentName=x x est le nom de l'éénement personnalisé CustomEent_CustomEentData=x x représente les données personnalisées de l'éénement Exemple 300 IBM Tealeaf CX - Guide de configuration CustomEent_TimeOffset= CustomEent_ScreenViewOffset=0 CustomEent_CustomEentName=AlertDialog CustomEent_CustomEentData= AlertDialog Button Pressed: OK

311 Message d'état du client Préfixe du nom : ClientState.MobileState Description : contient les données d'état du périphérique mobile qui changent au cours du temps. Paire Nom/Valeur Description ClientState_MobileState_IPAddress=x x est le nom de l'éénement personnalisé Cette aleur est égale à si le périphérique est connecté à un réseau étendu sans fil. ClientState_MobileState_Battery=n n est le nieau de batterie du périphérique ClientState_MobileState_FreeMemory=n n est la mémoire libre disponible en octets ClientState_MobileState_FreeStorage=n n est l'espace de stockage libre disponible en octets ClientState_MobileState_Orientation=n n = 0, 90, 180,-180,-90 ClientState_MobileState_Carrier=x x est le nom de la porteuse à laquelle le périphérique est connecté ClientState_MobileState_NetworkReachability=x x est le type de réseau auquel le périphérique est connecté. Exemples : ReachableViaWIFI, 3G, Edge ClientState_MobileState_KeyboardState=x x est l'état du claier : HIDDEN_TRUE ou HIDDEN_FALSE Exemple ClientState_TimeOffset=0 ClientState_ScreenViewOffset=0 ClientState_MobileState_IPAddress= ClientState_MobileState_freeMemory= ClientState_MobileState_FreeStorage= ClientState_MobileState_Orientation=0 ClientState_MobileState_Carrier=Verizon ClientState_MobileState_NetworkReachability=ReachableViaWiFi Message de l'exception Préfixe du nom : ClientException Description : les journaux d'exception sont indiqués ci-après. Paire Nom/Valeur Description ClientException_Name=x x est le nom de l'exception ClientException_Description=x x est la description de l'exception ClientException_Description_Exists=True La description peut comporter un retour chariot. Elle peut être utilisée comme sentinelle Balise de fin lors de la création d'un attribut de hit. Chapitre 4. Agents de session de pipeline CX 301

312 ClientException_StackTrace=x x est la trace de pile laissée par le gestionnaire d'exceptions. ClientException_StackTrace_Exists=True La trace de pile peut comporter un retour chariot. Elle peut être utilisée comme sentinelle Balise de fin lors de la création d'un attribut de hit. Exemple ClientException_Name=CrashTest ClientException_Description=-[TProtoMonitoringLeelViewController crashme]: unrecognized selector sent to instance 0x ClientException_Description_Exists=True ClientException_StackTrace=-[TProtoMonitoringLeelViewController crashme]: ClientException_StackTrace_Exists=True Agents de session Tealeaf «Ajout d'un agent de session», à la page 237 «Agent de session Archiage», à la page 238 "Agent de session Indexation des attributs" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session Canister», à la page 249 «Agent de session Analyseur de cookie», à la page 252 «Agent de session Dépose de données», à la page 254 «Agent de session Analyseur de données», à la page 260 «Agent de session Decouple», à la page 264 «Agent de session DecoupleEx», à la page 266 «Agent de session Confidentialité étendue», à la page 275 «Agent de session Health-Based Routing (HBR)», à la page 278 «Agent de session Déploiement», à la page 285 Agent de session de l'analyseur mobile JSON «Agent de session Code géré», à la page 303 «Agent de session Null», à la page 306 «Agent de session Confidentialité», à la page 307 «Agent de session RTA (Real-Time Monitoring and Alert)», à la page 341 «Agent de session Balises de réponse pour la demande», à la page 346 «Agent de session Fractionnement RTA», à la page 348 «Agent de session de mise en sessions», à la page 353 «Agent de session Routeur de session», à la page 350 «Agent de session Socket», à la page 356 «Agent de session Consignateur de statistiques», à la page 358 "Agent de session de référence Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session de référence Tealeaf - Mode existant», à la page 380 «Agent de session Mise en sessions Tealeaf», à la page 384 «Agent de session TimeGrades», à la page 390 «Agent de session TLI», à la page 392 «Agent de session de décodage d'url», à la page IBM Tealeaf CX - Guide de configuration

313 Agent de session Code géré L'agent de session Code géré (SessionAgentCLR) est une structure de déeloppement qui permet de générer une fonctionnalité personnalisée par dessus le pipeline à l'aide d'un langage de déeloppement orienté objet, tel que C# ou VB.NET. Par exemple, l'agent de session Code géré permet d'effectuer des recherches de données externes, de déelopper des filtres et transformations de données personnalisés ou d'appeler des actions externes. Le code géré permet d'accéder aux ressources externes suiantes : Bibliothèque de classes Microsoft.NET Objets COM Fichiers DLL externes Remarque : SessionAgentCLR requiert la ersion 1.1 ou une ersion ultérieure de Microsoft.NET Framework. MS Visual Studio.NET 2003 ou une ersion ultérieure est recommandé pour l'écriture et le débogage. SessionAgentCLR utilise la procédure suiante : Il charge une instance de la routine d'exécution du langage commun. Il compare les fichiers source au fichier.dll de l'assemblage. Il peut être compilé si le fichier.dll est manquant ou que la source est plus récente. Il charge l'assemblage utilisateur. La méthode Init est appelée. Le code utilisateur peut effectuer toute initialisation globale requise ici. Il appelle la méthode ProcessHit pour chaque hit. Le code utilisateur peut modifier ou supprimer un hit ou en ajouter de noueaux. Il appelle la méthode Heartbeat sur chaque analyse de maintenance. Ce code temporel peut être exécuté à ce stade. Il appelle la méthode de nettoyage au désassemblage du pipeline. Le code utilisateur peut effectuer un nettoyage global à ce stade. Ajout de l'agent de session Des agents de session peuent être ajoutés ia l'éditeur de pipeline dans TMS. Voir «Ajout d'un agent de session», à la page 237. Pour plus d'informations sur l'éditeur de pipeline et TMS, oir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Le reste de cette page décrit les options de configuration et la manière de les modifier ia le fichier TealeafCaptureSocket.cfg stocké sur le sereur. Ces paramètres sont également disponibles ia l'éditeur de pipeline, cette méthode étant recommandée pour configurer les agents de session. Paramètres de configuration Les options de configuration suiantes sont disponibles : Les aleurs Nom d affichage sont affichées dans TMS, cette méthode étant recommandée pour configurer les agents de session. Voir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Les aleurs Nom sont affichées dans TealeafCaptureSocket.cfg. Chapitre 4. Agents de session de pipeline CX 303

314 Tableau 23. Agent de session Code géré Nom Nom d'affichage Assembly AssemblyDLL DLL Assembly Name AssemblyName Description Nom du fichier.dll contenant l'assemblage de l'agent de session (agent de session compilé). Ce paramètre est également utilisé pour spécifier le nom.dll de la sortie si CompileIfNeeded est défini sur True. Indique le nom de l'assemblage. Il s'agit généralement de la même aleur qu'assemblydll, sans.dll. Class Name ClassName Nom de la classe qui implémente l'interface IHitHandler de l'agent de session. Compile If Needed CompileIfNeeded Si la aleur est True, les horodatages de tous les fichiers source spécifiés sont comparés à l'horodatage du fichier.dll de l'assemblage. Si des fichiers source ont été modifiés ou que le fichier.dll de l'assemblage n'existe pas encore, l'assemblage de l'agent de session est compilé. Cette option doit être définie sur False si le fichier source n'est pas disponible sur le sereur qui exécute cet agent de session. Débogage Debug Indique si l'assemblage de l'agent de session doit être généré en mode débogage, si CompileIfNeeded=True. Assembly Base Path Fichier journal Nieau de journal AssemblyBase LogFile LogLeel Ce paramètre permet de spécifier le répertoire, par rapport au répertoire d'installation de Tealeaf, à utiliser comme répertoire de base pour la recherche des DLL d'assemblage qui ne se trouent pas dans le cache à accès global (GAC). Spécifie le nom et le chemin d'accès facultatif, par rapport au répertoire d'installation de Tealeaf, d'un fichier journal pour l'agent de session du code géré. Les méthodes de trace appelées dans le code de l'agent de session sont enregistrées dans le fichier journal spécifié, si le nieau de journal spécifié le permet. Nieau de prolixité utilisé lors de l'enregistrement dans le fichier journal. Les aleurs possibles sont error, warn, info, debug et off. La aleur par défaut est warn. 304 IBM Tealeaf CX - Guide de configuration

315 Tableau 23. Agent de session Code géré (suite) Nom d'affichage Include Response Nom IncludeResponse Description Indique si la réponse doit être transmise au gestionnaire de hits dans l'agent de session. Si la réponse n'est pas examinée ou modifiée par l'agent de session, cette aleur doit être définie sur False pour améliorer les performances. Exemple de configuration [Managed] TypeName=Managed DLL=SessionAgentCLR.dll SourceFile=managed\source\testhandler.cs AssemblyDLL=TestHandler.dll AssemblyName=TestHandler ClassName=TestHandler.TestClass References=System.Data.dll, System.XML.dll CompileIfNeeded=True Debug=True AssemblyBase=managed HitObjectDLL=Tealeaf.Pipeline.dll LogFile=managed\saclr.log LogLeel=warn DownStreamConfigSection=Null # Add any additional config options here. They will be aailable to your code # ia the Tealeaf object. Agents de session Tealeaf «Ajout d'un agent de session», à la page 237 «Agent de session Archiage», à la page 238 "Agent de session Indexation des attributs" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session Canister», à la page 249 «Agent de session Analyseur de cookie», à la page 252 «Agent de session Dépose de données», à la page 254 «Agent de session Analyseur de données», à la page 260 «Agent de session Decouple», à la page 264 «Agent de session DecoupleEx», à la page 266 «Agent de session Confidentialité étendue», à la page 275 «Agent de session Health-Based Routing (HBR)», à la page 278 «Agent de session Déploiement», à la page 285 «Agent de session Analyseur mobile JSON», à la page 289 Agent de session Code géré «Agent de session Null», à la page 306 «Agent de session Confidentialité», à la page 307 «Agent de session RTA (Real-Time Monitoring and Alert)», à la page 341 «Agent de session Balises de réponse pour la demande», à la page 346 «Agent de session Fractionnement RTA», à la page 348 «Agent de session de mise en sessions», à la page 353 Chapitre 4. Agents de session de pipeline CX 305

316 «Agent de session Routeur de session», à la page 350 «Agent de session Socket», à la page 356 «Agent de session Consignateur de statistiques», à la page 358 "Agent de session de référence Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session de référence Tealeaf - Mode existant», à la page 380 «Agent de session Mise en sessions Tealeaf», à la page 384 «Agent de session TimeGrades», à la page 390 «Agent de session TLI», à la page 392 «Agent de session de décodage d'url», à la page 408 Agent de session Null L'agent de session Null termine le pipeline de capture si aucune action n'est requise sur les données. Cet agent de session est utile si les données ne sont plus requises. 306 IBM Tealeaf CX - Guide de configuration Remarque : L'agent de session Null étant un agent de session final, l'option -DownStreamConfigSection n'est pas requise. Ajout de l'agent de session Des agents de session peuent être ajoutés ia l'éditeur de pipeline dans TMS. Voir «Ajout d'un agent de session», à la page 237. Pour plus d'informations sur l'éditeur de pipeline et TMS, oir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Le reste de cette page décrit les options de configuration et la manière de les modifier ia le fichier TealeafCaptureSocket.cfg stocké sur le sereur. Ces paramètres sont également disponibles ia l'éditeur de pipeline, cette méthode étant recommandée pour configurer les agents de session. Agents de session Tealeaf «Ajout d'un agent de session», à la page 237 «Agent de session Archiage», à la page 238 "Agent de session Indexation des attributs" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session Canister», à la page 249 «Agent de session Analyseur de cookie», à la page 252 «Agent de session Dépose de données», à la page 254 «Agent de session Analyseur de données», à la page 260 «Agent de session Decouple», à la page 264 «Agent de session DecoupleEx», à la page 266 «Agent de session Confidentialité étendue», à la page 275 «Agent de session Health-Based Routing (HBR)», à la page 278 «Agent de session Déploiement», à la page 285 «Agent de session Analyseur mobile JSON», à la page 289 «Agent de session Code géré», à la page 303 Agent de session Null

317 «Agent de session Confidentialité» «Agent de session RTA (Real-Time Monitoring and Alert)», à la page 341 «Agent de session Balises de réponse pour la demande», à la page 346 «Agent de session Fractionnement RTA», à la page 348 «Agent de session de mise en sessions», à la page 353 «Agent de session Routeur de session», à la page 350 «Agent de session Socket», à la page 356 «Agent de session Consignateur de statistiques», à la page 358 "Agent de session de référence Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session de référence Tealeaf - Mode existant», à la page 380 «Agent de session Mise en sessions Tealeaf», à la page 384 «Agent de session TimeGrades», à la page 390 «Agent de session TLI», à la page 392 «Agent de session de décodage d'url», à la page 408 Agent de session Confidentialité L'agent de session Confidentialité fournit un mécanisme de blocage, de chiffrement ou de remplacement des données sensibles basé sur des règles dans les demandes et les réponses Web capturées. L'agent de session Confidentialité peut être déployé sur le sereur IBM Tealeaf CX, un sereur IBM Tealeaf CX Passie Capture Application ou des sereurs Web indiiduels. Remarque : Pour certains déploiements du sereur de traitement, cet agent de session est inclus dans le pipeline par défaut et est requis. Voir «Configuration du pipeline CX», à la page 224. L'agent de session Confidentialité peut bloquer, chiffrer ou remplacer des données sensibles, supprimer des hits (ou uniquement les données de réponse des hits), mais aussi ajouter, modifier ou supprimer des paires nom/aleur dans la demande. Données bloquées : les données bloquées sont définitiement remplacées par un caractère biffé spécifié, qui est répété sur toute la longueur des données bloquées. Le caractère biffé par défaut est X. Remarque : Ce remplacement est irréersible. Tealeaf recommande de ne bloquer que les données sensibles qui n'ont jamais besoin d'être extraites par la suite. Chiffrement : le chiffrement est effectué à l'aide d'une clé de confidentialité, qui est affectée à un groupe NT spécifique. Chaque action de confidentialité peut spécifier une clé ou un groupe pour le chiffrement. Une fois que les données ont été chiffrées, les données d'origine sont bloquées à l'aide d'un autre caractère biffé pour indiquer qu'elles ont été chiffrées. Les données chiffrées sont sauegardées dans la section [Priacy] de la demande. Le caractère biffé par défaut du chiffrement Vous pouez affecter des clés de confidentialité à l'aide de TMS. Lorsqu'une session contenant des données chiffrées par l'agent de session Confidentialité est relue, IBM Tealeaf CX RealiTea Viewer ou la relecture sur Chapitre 4. Agents de session de pipeline CX 307

318 naigateur extrait les clés de confidentialité des groupes auxquels l'utilisateur actuel appartient et ne déchiffre que les éléments de données chiffrés à l'aide des clés autorisées. Remarque : Les zones chiffrées à l'aide de règles de confidentialité dans les pipelines IBM Tealeaf CX Passie Capture Application ou Windows ne peuent pas être déchiffrées dans le portail. - Ces zones chiffrées ne peuent être déchiffrées que lors d'une nouelle exécution. - Vous pouez également laisser les zones configurées à l'état non chiffré dans les données de session, puis définir spécifiquement des règles de confidentialité à appliquer lors de la relecture des sessions, afin de permettre l'affichage des données non chiffrées dans le portail, si nécessaire. Voir «Confidentialité à la demande», à la page 136. Remplacement de données : Lorsque des données sont remplacées, une chaîne de remplacement préconfigurée est insérée ou les données sont supprimées si aucune chaîne de remplacement n'a été spécifiée. Cette opération est irréersible. Edition de paires nom/aleur : ous pouez également utiliser l'agent de session Confidentialité pour ajouter, modifier ou supprimer des paires nom/aleur (un nom de zone et sa aleur) dans la demande. Cette fonction offre de puissantes options permettant de manipuler les métadonnées utilisées pour traiter les hits. Versions de l'agent de session Confidentialité Tealeaf prend actuellement en charge deux agents de session Confidentialité : [Priacy] et [PriacyEx]. Le second étend la fonctionnalité du premier. Remarque : [Priacy] est une ersion antérieure aec un jeu de fonctions réduit. Si ous actiez l'agent de session Confidentialité dans otre pipeline, ous deez utiliser [PriacyEx]. Le reste de cette section coure l'agent de session [Priacy] et notamment l'éditeur de confidentialité, l'utilitaire TMS par l'intermédiaire duquel ous configurez os règles de confidentialité. Voir «Accès à l'éditeur de confidentialité», à la page 310. Prise en charge des applications mobiles Remarque : L'utilisation de l'agent de session Confidentialité ou Confidentialité étendue pour bloquer ou masquer les données JSON par étape soumises pour capture à partir d'une structure client Tealeaf n'est pas prise en charge dans cette ersion. Pour actier la confidentialité, ous deez utiliser la solution de confidentialité fournie par la structure du client. Voir "Confidentialité des données dans les enironnements de capture côté client Tealeaf" dans le document IBM Tealeaf Client Framework - Guide d'intégration des données. 308 IBM Tealeaf CX - Guide de configuration

319 Ajout et configuration de l'agent de session Etapes de base Test de la confidentialité Aant d'appliquer os règles de confidentialité dans le pipeline, ous pouez les tester à l'aide de l'utilitaire Testeur de confidentialité de Tealeaf. Cet utilitaire doit faire partie de otre flux de traaux de confidentialité. Voir «Utilitaire Testeur de confidentialité», à la page 416. Test de la confidentialité dans RTV IBM Tealeaf CX RealiTea Viewer inclut un testeur de confidentialité intégré. Remarque : Si ous utilisez des données de RTV pour tester os règles de confidentialité, une configuration supplémentaire dans RTV peut être requise. Voir "RealiTea Viewer - Testeur de confidentialité" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Aant de commencer Aant d'actier l'agent de session Confidentialité, ous deez définir ses tests, ses règles et ses actions ia le noeud Serice de transport\configuration de l agent de session Confidentialité dans TMS. Voir «Accès à l'éditeur de confidentialité», à la page 310. Ajout de l'agent de session Des agents de session peuent être ajoutés ia l'éditeur de pipeline. Voir «Ajout d'un agent de session», à la page 237. Actiation de l'agent de session Confidentialité Une fois que ous aez déeloppé et testé les règles, les tests et les actions dans otre agent de session Confidentialité, ous pouez actier ce dernier ia le noeud Serice de transport\configuration du serice de transport. Voir «Accès à l'éditeur de confidentialité», à la page 310. Une fois que ous aez configuré otre agent de session Confidentialité, il apparaît dans l'onglet Statut du pipeline de TMS. Voir "Onglet Statut du pipeline TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. Il se peut que ous deiez planifier et exécuter une mise à jour pour insérer la configuration de l'agent de session Confidentialité sur les sereurs TMS esclae. Voir "Onglet Traaux TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. Pour plus d'informations sur l'éditeur de pipeline, oir "Editeur de pipeline TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. Le reste de cette page décrit les options de configuration et la manière de les modifier ia le fichier TealeafCaptureSocket.cfg stocké sur le sereur. Ces paramètres sont également disponibles ia l'éditeur de pipeline, cette méthode étant recommandée pour configurer les agents de session. Les étapes ci-après offrent un aperçu de la manière d'actier l'agent de session Confidentialité dans otre configuration de pipeline. Chacune des étapes ci-après fait référence à une section pour des détails supplémentaires. Chapitre 4. Agents de session de pipeline CX 309

320 1. Pour actier le chiffrement, éditez Sereur de recherche\configuration du sereur de recherche à l'aide de TMS pour définir les clés de confidentialité des groupes qui ont accès aux données chiffrées. Voir «Chapitre sur la configuration du sereur de recherche», à la page Créez des règles et des actions dans Serice de transport\configuration de l agent de session Confidentialité, dans TMS, pour effectuer les actions de blocage et de chiffrement de otre choix. Voir «Accès à l'éditeur de confidentialité». 3. Ajoutez la section de configuration de l'agent de session Confidentialité ([Priacy]) à la configuration du pipeline. Voir «Actiation de la confidentialité ia TMS», à la page Spécifiez cet agent de session sous DownStreamConfigSection pour l'un des agents de session qui se troue actuellement dans le pipeline. 5. Modifiez la aleur DownStreamConfigSection de la section [Priacy] pour faire référence à l'agent de session ers lequel l'agent de session précédent pointait à l'origine. 6. Vérifiez que le fichier de configuration de l'agent de session Confidentialité (Priacy.cfg) est correctement configuré aant de redémarrer le pipeline. 7. Redémarrez le pipeline. Généralement, cela requiert un redémarrage du serice approprié, tel que le serice de transport Tealeaf. Voir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. 8. Une fois le redémarrage terminé, recherchez les éentuelles erreurs dans le journal des éénements d'application. Accès à l'éditeur de confidentialité Les erreurs dans la configuration de l'agent de session Confidentialité sont consignées comme des erreurs dans le journal des éénements d'application. Dans la plupart des cas où des erreurs se sont produites, le pipeline parient toujours à charger et traiter les hits, mais les règles ou les actions dont la configuration n'est pas alide sont ignorées. A l'aide de l'éditeur de confidentialité de TMS, ous pouez configurer le filtre de confidentialité, qui applique un ensemble de règles, de tests et d'actions définies par l'utilisateur au trafic du pipeline ia l'agent de session Confidentialité ou Confidentialité étendue. Pour plus d'informations sur TMS, oir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Pour accéder à l'éditeur de confidentialité : 1. Connectez-ous au portail en tant qu'administrateur Tealeaf. 2. Dans le menu Portail, sélectionnez Tealeaf > TMS. 3. Accédez au noeud Serice de transport du sereur que ous souhaitez configurer. 4. Cliquez sur Priacy Filter configuration. 5. Dans le panneau Actions de configuration, cliquez sur Afficher/Modifier. 6. L'éditeur de confidentialité s'oure et affiche l'ensemble actuel de règles de confidentialité. L'éditeur de confidentialité est diisé en quatre sections : Les «Règles», à la page 311 permettent de déterminer les hits à sélectionner pour le blocage des données, le chiffrement ou toute autre action de confidentialité. 310 IBM Tealeaf CX - Guide de configuration

321 Les «Tests», à la page 315 sont des comparaisons utilisées pour déterminer si une action associée doit être exécutée suite à l'éaluation. Les «Actions», à la page 317 indiquent les données figurant dans le hit à traiter et comment traiter le hit. Les «Keys», à la page 326 déterminent les clés de confidentialité à utiliser pour les processus de chiffrement. Les données de l'éditeur de confidentialité sont disponibles dans le fichier Priacy.cfg. Règles Les règles de confidentialité représentent le mécanisme par l'intermédiaire duquel les hits sont sélectionnés pour le blocage ou le chiffrement des données. L'agent de session Confidentialité interprète chaque règle par rapport aux données de hit et filtre le contenu en fonction de la spécification de règle. Les règles sont des mécanismes permettant de regrouper des actions à déclencher en fonction de la même condition. Voir «Actions», à la page 317. Remarque : Lors de la création de règles de confidentialité qui modifient le contenu sur des pages UpdatePanel, le décompte d'octets pour la page non modifiée doit être maintenu dans la page modifiée après l'application de la modification. Sinon, ces pages ne sont pas relues correctement. Cette limitation est également applicable aux règles de relecture. Voir "RealiTea Viewer - Règles de relecture" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Conentions de désignation des règles Dans le panneau de configuration des règles, chaque règle est définie dans sa propre section. Les noms des sections de règle commencent par [Rule1]. La règle suiante est [Rule2], suiie de [Rule3] et ainsi de suite. Les règles doient être nommées au format Règle + Nombre illustré ci-dessus, faute de quoi l'agent de session Confidentialité ne les reconnaîtra pas. Les règles sont éaluées suiant leur ordre numérique et non suiant l'ordre dans lequel elles apparaissent dans le fichier. Par exemple, si [Rule2] est répertorié aant [Rule1], [Rule1] est tout de même éalué en premier. L'agent de session Confidentialité peut prendre en charge jusqu'à 256 règles. Tests de règle Chaque règle peut comporter un ou plusieurs tests, qui sont éalués pour déterminer si les actions qui lui sont associées doient être traitées. Pour une condition à éaluer, ous pouez définir un test imbriqué dans la section [Tests], à l'aide des options de configuration ReqField, ReqOp et ReqVal. Voir «Tests», à la page 315. Pour créer plusieurs tests ou partager un test entre plusieurs règles, ous pouez créer des tests nommés et les spécifier suiant l'ordre dans lequel ils doient être éalués, à l'aide de l'option de configuration Tests. Pour des exemples de formats de règle, ainsi que des tests et des actions, consultez le fichier Priacy.cfg dans le répertoire d'installation de Tealeaf. Remarque : Pour tout blocage ou chiffrement, au moins une règle doit être définie. Vous pouez créer une règle permettant de traiter tous les hits en omettant l'option de configuration Tests et les éentuelles options de configuration de test imbriquées. Voir «Tests», à la page 315. Chapitre 4. Agents de session de pipeline CX 311

322 Manipulation des règles Pour ajouter une règle, cliquez sur Ajouter une règle. Voir «Configuration des règles», à la page 313. Pour éditer une règle, cliquez sur Modifier en regard de la règle répertoriée. Voir «Configuration des règles», à la page 313. Pour modifier l'ordre des règles répertoriées dans la configuration de l'agent de session Confidentialité, cliquez sur les flèches de déplacement ertical. Pour supprimer une règle, cliquez sur Supprimer en regard de la règle répertoriée. 312 IBM Tealeaf CX - Guide de configuration

323 Configuration des règles Figure 25. Configuration des règles Les options de configuration des règles sont les suiantes : Commande Description Nom Entrez le nom de la règle. Les noms de règle doient se présenter sous la forme Règle + Numéro séquentiel. Voir «Conentions de désignation des règles», à la page 311. ReqField Cette option définit le nom d'une zone, la partie nom d'une paire Chapitre 4. Agents de session de pipeline CX 313

324 ReqOp ReqVal TestOp nom/aleur dans le fichier de demande. La aleur de cette zone est utilisée à titre comparatif. Vous pouez également appliquer un des noms de zone spéciaux suiants : TL_URLEXT : représente la partie de l'extension de fichier de l'url TL_URLTAIL : représente l'extrémité de l'url, y compris le dernier signe / de l'url et tout ce qui ient après TL_VIRTUALDIR : représente la partie du répertoire irtuel de l'url ReqOp définit l'opération de comparaison effectuée par cette règle entre ReqField et ReqVal. Les aleurs alides de cette option sont les suiantes : = - True si la aleur de zone est égale à ReqVal. La comparaison des chaînes est insensible à la casse.!= - True si la aleur de zone n'est pas égale à ReqVal. La comparaison des chaînes est insensible à la casse. > - True si la aleur de zone est supérieure à ReqVal < - True si la aleur de zone est inférieure à ReqVal contains - True si ReqVal est contenu dans la aleur de zone partof - True si la aleur de zone fait partie de (est contenue dans) ReqVal partoflist - True si la aleur de zone correspond à l'une des aleurs de ReqVal. Vous pouez utiliser des points-irgules, ou tout autre délimiteur spécifié par la propriété ListDelimiter, pour délimiter la liste des aleurs dans ReqVal. exists - True si la zone de demande existe. La portion ReqVal de la règle n'est pas requise. Pour un exemple de règle utilisant l'opérateur exists, oir «Exemple : l'existence d'une zone de demande signifie d'une section de demande doit être supprimée.», à la page 335. null - True si la zone de demande existe, mais qu'elle ne possède pas de aleur. La portion ReqVal de la règle n'est pas requise. notnull - True si la zone de demande existe, mais qu'elle possède une aleur. Aucune alidation n'est effectuée sur la aleur. La portion ReqVal de la règle n'est pas requise. ReqVal spécifie la aleur aec laquelle la aleur de la zone spécifiée par ReqField doit être comparée. Il peut s'agit d'une aleur littérale ou d'un nom de zone. Si un nom de zone est spécifié, la aleur de la zone est utilisée pour la comparaison. Pour utiliser un nom de zone, ous deez spécifier ReqVal est une zone=true pour la règle. Il s'agit de l'opérateur logique à utiliser lorsque plusieurs tests sont spécifiés. Vous pouez choisir entre AND et OR. Lorsque TestOp=AND, tous les tests doient renoyer true afin de pouoir effectuer les actions. Lorsque TestOp=OR, les actions sont effectuées si un des tests renoie true. Si aucune aleur n'est spécifiée, AND est appliqué comme aleur par défaut. 314 IBM Tealeaf CX - Guide de configuration

325 Remarque : Vous ne pouez appliquer qu'un opérateur de test à une même règle. Si ous deez utiliser des combinaisons d'opérateurs AND et OR, elles doient être diisées en plusieurs règles. Délimiteur de liste Indique le caractère de séparation des éléments de liste dans ReqVal si ReqOp possède la aleur PARTOFLIST. Par défaut, il s'agit d'un point-irgule (;). Sensible à la casse Valeur true ou false indiquant si les recherches des noms de zone doient être sensibles à la casse. La aleur par défaut est false. Si la aleur est true, les recherches sont accélérées. ReqVal est une zone Valeur true ou false indiquant si ReqVal contient un nom de zone. Not Valeur true ou false : si la aleur est true, le résultat de l'éaluation test est inersé (opérateur logique NOT). Voir «Remarques sur l'opérateur NOT». Arrêter le traitement Valeur true ou false indiquant s'il est nécessaire d'interrompre le traitement de règles supplémentaires si la règle est définie sur true. Actié Valeur true ou false indiquant si la règle est actie. Actions Cette zone contient un ou plusieurs noms d'action correspondant aux noms des sections d'action à effectuer si la règle renoie true. Tests Pour ajouter une action, sélectionnez-la dans la liste déroulante. Cliquez ensuite sur Ajouter. Pour supprimer une action de la liste, sélectionnez-la et cliquez sur Supprimer sélection. Voir «Actions», à la page 317. Cette zone contient un ou plusieurs noms de test correspondant aux noms des sections de test. Les tests spécifiés sont éalués afin de déterminer si les actions sont exécutées pour la règle. Si aucun test n'est spécifié, les actions sont exécutées pour tous les hits. Pour ajouter un test, sélectionnez-le dans la liste déroulante. Cliquez ensuite sur Ajouter. Pour supprimer un test de la liste, sélectionnez-la et cliquez sur Supprimer sélection. Voir «Tests». Remarques sur l'opérateur NOT Les tests qui utilisent l'opérateur Not renoient la aleur true si la zone est introuable pour tous les opérateurs, excepté l'opérateur exists. Remarque : Si ous utilisez un opérateur not sur un test de comparaison, ous deez d'abord érifier si la zone existe aant d'effectuer la comparaison. Tests Les tests de confidentialité sont des conditions de comparaison éaluées pour déterminer si les actions qui y sont associées doient être exécutées. Chapitre 4. Agents de session de pipeline CX 315

326 Le nom d'un test doit être unique parmi tous les noms de section. Chaque test peut être utilisé par un nombre quelconque de règles. Manipulation des tests Pour ajouter un test, cliquez sur Ajouter un test. Voir «Configuration des tests». Pour éditer un test, cliquez sur Modifier en regard du test répertorié. Voir «Configuration des tests». Pour supprimer un test, cliquez sur Supprimer en regard du test répertorié. Certains tests ne peuent pas être supprimés. Configuration des tests Figure 26. Configuration des tests Les options de configuration des tests sont les suiantes : Commande Description Nom Entrez le nom du test. Ce nom doit être unique parmi tous les tests. ReqField Cette option définit le nom d'une zone, la partie nom d'une paire nom/aleur dans le fichier de demande. La aleur de cette zone est utilisée à titre comparatif. Vous pouez également appliquer un des noms de zone spéciaux suiants : TL_URLEXT : représente la partie de l'extension de fichier de l'url TL_URLTAIL : représente l'extrémité de l'url, y compris le dernier signe / de l'url et tout ce qui ient après TL_VIRTUALDIR : représente la partie du répertoire irtuel de l'url 316 IBM Tealeaf CX - Guide de configuration

327 Pour entrer un autre nom de zone, sélectionnez...(entrer dans la zone de droite). Entrez le nom de la zone dans la zone de texte fournie. Remarque : Les conditions des tests de confidentialité ne peuent pas faire référence à des zones de demande qui commencent par TL_. Les zones qui utilisent ces noms sont considérées comme étant spécifiques à Tealeaf. ReqOp ReqOp définit l'opération de comparaison effectuée par cette règle entre ReqField et ReqVal. Les aleurs alides de cette option sont les suiantes : = - True si la aleur de zone est égale à ReqVal. La comparaison des chaînes est insensible à la casse.!= - True si la aleur de zone n'est pas égale à ReqVal. La comparaison des chaînes est insensible à la casse. > - True si la aleur de zone est supérieure à ReqVal < - True si la aleur de zone est inférieure à ReqVal contains - True si ReqVal est contenu dans la aleur de zone partof - True si la aleur de zone fait partie de (est contenue dans) ReqVal partoflist - True si la aleur de zone correspond à l'une des aleurs de ReqVal. Vous pouez utiliser des points-irgules, ou tout autre délimiteur spécifié par la propriété ListDelimiter, pour délimiter la liste des aleurs dans ReqVal. exists - True si la zone de demande existe. ReqVal Remarque : Pour l'opérateur exists, ous deez entrer une aleur ReqVal, bien que cette dernière soit ignorée. ReqVal spécifie la aleur aec laquelle la aleur de la zone spécifiée par ReqField doit être comparée. Il peut s'agit d'une aleur littérale ou d'un nom de zone. Si un nom de zone est spécifié, la aleur de la zone est utilisée pour la comparaison. Pour utiliser un nom de zone, ous deez spécifier ReqVal est une zone=true pour la règle. ReqVal est une zone Si cette option est définie sur true, la aleur spécifiée par ReqVal est interprétée comme un nom de zone. La aleur par défaut est false. Délimiteur de liste Indique le caractère de séparation des éléments de liste dans ReqVal si ReqOp possède la aleur partoflist. La aleur par défaut est un point-irgule ( ; ). Sensible à la casse Valeur booléenne indiquant si les recherches des noms de zone doient être sensibles à la casse. La aleur par défaut est false. Si la aleur est true, les recherches sont accélérées pour ces données. Actions Les actions de confidentialité identifient les données à traiter et définissent le type de traitement à effectuer dessus. Chapitre 4. Agents de session de pipeline CX 317

328 Chaque action est définie dans sa propre section. Le nom d'une action doit être unique parmi tous les noms de section. Chaque action peut être utilisée par un nombre quelconque de règles. Actions en mémoire tampon Lorsque les actions de confidentialité sont exécutées, les modifications résultantes sont mises en mémoire tampon. La règle [Rule1] est testée en premier et, si elle renoie la aleur true, son action est mise en tampon pour être exécutée ultérieurement. [Rule2], [Rule3] et toutes les règles suiantes sont testées et leurs actions sont mises en mémoire tampon suiant l'ordre d'éaluation, si nécessaire. Chaque action qui suit est effectuée sur les données aant que ces dernières n'aient été modifiées ; elle n'applique pas les modifications de données effectuées par les actions précédentes. Il existe une exception : Remarque : Pour les actions ReqSet, ReqAppend et ReqDelete, qui modifient les données de demande, l'agent de session Confidentialité examine les modifications en mémoire tampon effectuées par les précédentes actions ReqSet, ReqAppend et ReqDelete, ainsi que les données existantes. Par exemple, si deux actions consécuties définissent une aleur pour la ariable de demande Foo dans la section [appdata] de la demande, la deuxième action remplace la première. Toutefois, ces actions ne peuent pas oir les modifications apportées par les précédentes actions de blocage ou de chiffrement. Manipulation des actions Pour ajouter une action, cliquez sur Ajouter une action. Voir «Configuration des actions», à la page 319. Pour éditer une action, cliquez sur Modifier en regard de l'action répertoriée. Voir «Configuration des actions», à la page 319. Pour supprimer une action, cliquez sur Supprimer en regard de l'action répertoriée. Certaines actions ne peuent pas être supprimées. 318 IBM Tealeaf CX - Guide de configuration

329 Configuration des actions Figure 27. Configuration des actions Les options de configuration des actions sont présentées ci-après. Section Nom/Action Commande Description Nom Action Entrez le nom de l'action. Ce nom doit être unique parmi toutes les actions. Identifie l'action à effectuer. Les actions disponibles sont les suiantes : Block : permet de errouiller les données correspondantes à l'aide du caractère de substitution spécifié. Encrypt : permet de chiffrer et de masquer les données correspondantes à l'aide du caractère de substitution spécifié. Chapitre 4. Agents de session de pipeline CX 319

330 Replace : permet de remplacer les données correspondantes par une chaîne de texte spécifiée. DropHit : permet de supprimer le hit. Aucune autre action n'est effectuée. DropResponse : permet de supprimer la réponse du hit en cours. ReqSet : permet de définir ou de remplacer la aleur de la paire nom-aleur dans la demande. Si elle n'existe pas, la paire nom-aleur est créée ; il en est de même pour la section spécifiée. Les actions de ce type sont mises en mémoire tampon. Voir «Actions en mémoire tampon», à la page 318. ReqAppend :s'ajoute à la aleur de la paire nom-aleur spécifiée dans la demande. Si elle n'existe pas, la paire nom-aleur est créée ; il en est de même pour la section spécifiée. Les actions de ce type sont mises en mémoire tampon. Voir «Actions en mémoire tampon», à la page 318. ReqDelete : permet de supprimer de la demande la totalité de la paire nom-aleur spécifiée. Cette action ne supprime pas la section, même lorsqu'elle est ide. Les actions de ce type sont mises en mémoire tampon. Voir «Actions en mémoire tampon», à la page 318. Clé de chiffrement Si Action est défini sur Encrypt, l'option Clé de chiffrement permet de spécifier l'id clé de la définir à utiliser pour le chiffrement. Cet ID doit correspondre à l'id clé du groupe dont les membres doient pouoir déchiffrer les données lors de la relecture de la session. Groupe Remarque : Pour spécifier la clé de chiffrement, ous pouez utiliser Key ou Group mais pas les deux. Voir «Chapitre sur la configuration du sereur de recherche», à la page 107. Si Action est défini sur Encrypt, l'option Group permet de spécifier le nom de groupe dont la clé de confidentialité est utilisée pour le chiffrement et dont les membres doient pouoir déchiffrer les données lors de la relecture de la session. Le groupe spécifié doit déjà posséder une clé de confidentialité qui utilise TMS et doit être spécifié au format domaine\nomgroupe. Par exemple, un groupe nommé admin dans le domaine Windows operations est spécifié comme suit : Group=operations\admin Remarque : Pour spécifier la clé de chiffrement, ous pouez utiliser Key ou Group mais pas les deux. Section Destination Commande Description Section L'option Section permet d'identifier le nom de la section qui contient les données à traiter. Il peut s'agir de l'un des noms de section du fichier de demande (par exemple, [en]) ou l'un des noms réserés suiants : 320 IBM Tealeaf CX - Guide de configuration

331 response : indique que les données spécifiées doient être recherchées dans la réponse. urlfield : permet d'effectuer l'action pour les noms de aleur spécifiés (ou tout si la zone Nom de aleur n'est pas définie) pour les aleurs de la section urlfield, c'est-à-dire QUERY_STRING, de la chaîne de requête de RawRequest (le cas échéant), de la chaîne de requête de HTTP_REFERER, ainsi que de l'en-tête de demande du référenceur et du corps de demande de RawRequest (le cas échéant). Le nom des zones urlfield à traiter doit être spécifié à l'aide de Nom de aleur. cookie : permet d'effectuer l'action pour les noms de aleur spécifiés (ou tout si la zone Nom de aleur n'est pas définie) pour les aleurs de la section cookie, c'est-à-dire les paires nom/aleur HTTP_COOKIE et HTTP_SET_COOKIE, les en-têtes de paramétrage des cookies dans la section ResponseHeader (le cas échéant), les en-têtes de paramétrage des cookies dans la réponse et l'en-tête Cookie dans la section RawRequest (le cas échéant). Le nom des cookies à traiter doit être spécifié à l'aide de Nom de aleur. Remarque : Lorsqu'une section n'est pas spécifiée dans une action, la totalité de la mémoire tampon des demandes est utilisée. Remarque : Lorsque ous éditez une aleur Section en mode brut ia TMS, n'utilisez pas de guillemets (") dans le nom Section. Ignorer spécial Cette aleur booléenne indique si le traitement spécial doit être ignoré lorsqu'urlfield ou cookie est spécifié pour Section (oir ci-dessus). Zone Si la aleur est true, Masque de début peut être utilisé dans les sections [urlfield] et [cookie]. La aleur par défaut est false. L'option Zone permet de spécifier éentuellement un ou plusieurs noms de zone séparés par des irgules. Si Zone et Nom de aleur sont tous deux omis, la section (spécifiée par le paramètre Section) est intégralement bloquée ou chiffrée. Remarque : Lorsque ous bloquez ou chiffrez une section [xmln] de la demande, ous ne pouez pas utiliser de combinaisons Zone et Nom de aleur pour spécifier les données, en raison du formatage différent dans ces sections. Vous deez utiliser Masque de début et Masque de début RE pour spécifier le contenu à bloquer ou chiffrer. La aleur de Zone peut être un nom de zone (portion nom d'une paire nom/aleur) ou l'un des noms réserés suiants : body : Si Section=response, le corps de la réponse est traité, sans les en-têtes de réponse. Si Section=RawRequest et que la section RawRequest est présente, le corps de la demande est traité, s'il est présent. Pour inclure un en-tête spécifique dans la réponse, entrez le nom de l'en-tête pour la aleur Zone. Remarque : Pour appliquer la confidentialité aux zones d'en-tête de réponse, omettez les deux-points dans le nom de zone. Par exemple, utilisez x-mydatafield, au lieu de x-mydatafield:. Chapitre 4. Agents de session de pipeline CX 321

332 322 IBM Tealeaf CX - Guide de configuration Laissez la aleur de Zone ide pour inclure l'intégralité de la section d'en-tête. Nom de aleur L'option Nom de aleur permet de spécifier éentuellement un ou plusieurs noms de aleur. Si Section=urlfield, cette option spécifie les noms urlfield à traiter. Si Section=cookie, cette option permet de spécifier les cookies à traiter. Remarque : Lorsque ous bloquez ou chiffrez une section [xmln] de la demande, ous ne pouez pas utiliser de combinaisons Zone et Nom de aleur pour spécifier les données, en raison du formatage différent dans ces sections. Vous deez utiliser Masque de début et Masque de début RE pour spécifier le contenu à bloquer ou chiffrer. Sinon, Nom de aleur spécifie la portion nom d'une paire nom/aleur dans la aleur d'une zone de demande ou d'un en-tête de réponse (si Section=response). Inerser l action Valeur true ou false indiquant si l'action doit être inersée. Si cette option est actiée, elle effectue l'action sur toutes les zones ou tous les noms de aleur excepté ceux spécifiés. Si la zone Nom de aleur est spécifiée, tous les noms sauf ceux indiqués dans cette zone sont traités. Si la zone Nom de aleur n'est pas spécifiée, les noms indiqués pour Zone sont exclus de l'action. Remarque : Cette action peut être uniquement utilisée aec les actions Block, Encrypt et Replace. L'option Masque de début ne peut pas être utilisée aec une action d'inersion. Section Expression de masque Commande Description Masque de début Masque de début est utilisé pour la correspondance de texte dans les régions de données, telles que le corps de la réponse, un bloc XML dans la demande ou une aleur longue pour une paire nom/aleur. La chaîne spécifiée par Masque de début est recherchée dans les données (spécifiées par Section, Zone et Nom de aleur). Si Masque de début est utilisé, ous deez également spécifier Masque de fin ou Longueur, à moins que l'option Inclusie ait la aleur true. SiInclusie=true, le masque de début et le masque de fin facultatif sont également bloqués/chiffrés. Cette option est utile lorsque ous souhaitez errouiller ou chiffrer une chaîne de données constantes. Si Inclusie=false, le masque de début n'est pas traité. Masque de fin L'option Masque de fin spécifie le masque de chaîne qui signale la fin des données identifiées par un masque de début. Toutes les données du masque de début au masque de fin sont traitées, si Inclusie=true. Si Inclusie=false, les chaînes des masques ne sont pas incluses. Expression régulière? Si la aleurmasque de début ou Masque de fin représente une expression régulière, spécifiez la aleur true.

333 Inclusie L'option Inclusie indique si le masque de début et le masque de fin (si utilisé) doient être bloqués ou chiffrés, aec les données traitées dans le cadre d'une recherche aec masque de début. La aleur par défaut est false. Nombre de répétitions Pour les actions aec un masque de début, cette option indique le nombre d'instances de données correspondant au masque à traiter. Section Remplacement Commande Description Caractère biffé Caractère biffé permet de remplacer les données d'origine qui sont bloquées ou chiffrées par un caractère alphanumérique. Les aleurs suiantes ne peuent pas être utilisées comme caractère biffé :. - (point), - (irgule) / - (barre oblique) (barre oblique inersée) [ - (crochet gauche) ] - (crochet droit) - (barre erticale) - (apostrophe) " - (guillemet) Longueur du biffage La longueur du biffage permet de spécifier la longueur en octets des données correspondantes à biffer. Il s'agit du nombre de caractères indiqués dans la zone Caractère biffé utilisés pour remplacer les données d'origine (lorsque Action=Block ou Action=Encrypt). Si la longueur du biffage est plus grande que les données d'origine, des caractères de substitution supplémentaires sont ajoutés. Si la aleur de Longueur du biffage est plus petite que la taille des données d'origine, les caractères de la zone Longueur du biffage sont remplacés par le contenu de la zone Caractère biffé et les données restantes sont supprimées. Si la aleur de Longueur du biffage est un nombre négatif, le nombre de caractères représentés par la aleur absolue de la zone Longueur du biffage est conseré. Par exemple, pour conserer les quatre derniers caractères d'une aleur, définissez Strike Length=-4. Masque de blocage Représente une expression régulière spécifiant les caractères des données trouées à remplacer par le caractère de substitution. Tous les caractères d'un groupe, défini par les parenthèses, de l'expression régulière sont remplacés par le caractère de substitution. Les caractères correspondant à une partie du modèle situés en dehors d'un groupe ne sont pas remplacés. Cette option ne s'applique pas aux actions de remplacement. Par exemple, le masque suiant errouille les chiffres d'un numéro de sécurité social, en laissant apparaître les tirets : BlockingMask=([0-9] {3} Chapitre 4. Agents de session de pipeline CX 323

334 )-(--[0-9]- {2} -)-([0-9] {4}) 324 IBM Tealeaf CX - Guide de configuration Dans l'exemple suiant, seuls les quatre premiers chiffres d'une carte de crédit sont isibles : BlockingMask=[0-9]{4} ([0-9]\*) Masque de blocage est utilisé à la place de Longueur du biffage. Vous pouez utiliser l'une ou l'autre, mais pas les deux. Remarque : Soyez prudent lorsque ous utilisez Masque de blocage. Si les données ne correspondent pas à l'expression régulière spécifiée pour Masque de blocage, elles ne seront ni errouillées ni chiffrées. Chaîne de remplacement Chaîne utilisée pour remplacer les données d'origine si Action=Replace. Section Options correspondantes Commande Description Sensible à la casse Valeur true ou false indiquant si les recherches doient être sensibles à la casse. La aleur par défaut est false. Si la aleur est true, les recherches sont accélérées. Longueur (octets) Utilisée à la place d'un masque de fin, l'option Longueur indique la longueur des données (en octets) à traiter suite à un masque de début identifié. Si Inclusie=true, la longueur du masque de début n'est pas prise en compte, bien qu'elle soit également traitée. Section Opérations de demande Commande Description Section ReqSet Cette option permet de spécifier la section de la paire Nom/aleur d'une action ReqSet, ReqAppend ou ReqDelete. La section ReqSet est requise pour ces trois actions. Zone ReqSet La zone ReqSet spécifie le nom d'une paire nom/aleur pour une action ReqSet, ReqAppend ou ReqDelete. La zone ReqSet est requise pour ces trois actions. Résultat de ReqSet Si le masque de début est une expression régulière, cette option permet de générer une aleur formatée pour une action ReqSet ou ReqAppend. L'expression Masque de début doit contenir un ou plusieurs "groupes" définis entre parenthèses dans l'expression régulière. Le résultat de ReqSet est une chaîne contenant un texte littéral et des paramètres de substitution pour les données capturées par le masque de début. Par exemple: Start Pattern=name="(.*?)" alue="(.*?)" ReqSet Result=Field {g1} alue: {g2}

335 Génère une aleur similaire à la suiante : Field-Foo-alue: Bob e premier paramètre de substitution (g1) est remplacé par la aleur du premier groupe dans l'expression régulière. g2 représente la deuxième aleur, et ainsi de suite. La chaîne de résultat est ensuite utilisée comme aleur pour l'action ReqSet ou ReqAppend. MD5 Le paramètre MD5 true/false indique si les données résultantes capturées par la règle doient être codées par MD5. Remarque : L'option MD5 ne peut être appliquée que si l'agent de session Confidentialité étendue est utilisé. Pour plus d'informations, oir «Agent de session Confidentialité étendue», à la page 275. La aleur par défaut est false. Total de contrôle Le paramètre Total de contrôle true/false indique si un total de contrôle Adler32 doit être appliqué aux données résultantes capturées par la règle. Ce total de contrôle gère plusieurs cas qui ne sont généralement pas traités par les totaux de contrôle, tels que plusieurs erreurs dont la somme est égale à0oularéorganisation des caractères dans la séquence. La aleur Totale de contrôle est utile pour comparer des données sensibles lorsque l'utilisateur souhaite limiter les possibilités de recherche inersée pour obtenir la aleur d'origine. Par exemple, la aleur Total de contrôle peut être utilisée pour comparer plusieurs tentaties de saisie de mot de passe. Si l'utilisateur saisit le mauais mot de passe d'un hit à un autre, le total de contrôle permet d'enregistrer ce cas sans que le mot de passe ne soit réélé. Si ous bloquiez simplement les données de mot de passe, ous ne pourriez pas comparer les hits suiants pour rééler les multiples tentaties de saisie du mot de passe. La aleur par défaut est false. Remarque : Pour ReqSet et ReqAppend, il est possible de spécifier la aleur à définir ou à ajouter de deux manières : 1. Vous pouez utiliser une chaîne littérale en spécifiant le texte de otre choix pour la chaîne de remplacement. 2. Vous pouez extraire les données de la demande ou la réponse à l'aide des options Section, Zone, Nom de aleur, Masque de début et/ou Masque de fin. Si ous utilisez Masque de début aec l'une de ces actions, le nombre de répétitions est toujours égal à 1, ce qui signifie que la première correspondance est toujours utilisée. Ignorer spécial est toujours défini sur true pour ces actions si Section est spécifié. Aec ces actions, aucune manipulation spéciale n'est nécessaire pour les sections urlfield ou cookie. Pour effacer la aleur d'une zone (paire nom/aleur) sans supprimer l'intégralité de la zone, spécifiez une aleur ide pour la chaîne de remplacement : Replace String= Tous les retours chariot et les sauts de ligne de la chaîne de aleur sont remplacés par \r et \n, respectiement. Les modifications des paramètres de confidentialité sont placées en file d'attente et appliquées après la fin de toutes les opérations, ce qui signifie que les actions Chapitre 4. Agents de session de pipeline CX 325

336 oient normalement les données d'origine. ReqSet, ReqAppend et ReqDelete assurent le suii des ajouts, des modifications et des suppressions de zones. Par conséquent, il est possible d'effectuer plusieurs modifications sur une même zone en toute sécurité. Par exemple, ous pouez ajouter une zone, puis concaténer des données supplémentaires à la aleur. Il est recommandé d'utiliser ReqSet et ReqAppend pour effectuer les modifications apportées aux aleurs de zone. L'action Remplacer peut affecter n'importe quel bloc de données de la demande ou de la réponse, c'est pourquoi elle n'est pas incluse dans le suii des modifications. Si ous utilisez Zone ou Nom de aleur aec ReqSet ou ReqAppend, ous ne deez spécifier qu'une seule zone ou un seul nom de aleur. S'il existe plusieurs noms, la aleur du dernier élément troué est utilisée. Pour ReqSet ou ReqAppend, ous deez éiter de ne spécifier qu'une section pour extraire la aleur ; la aleur de la dernière zone (paire nom/aleur) de la section serait utilisée pour ReqSet ou ReqAppend. Keys La section facultatie [Keys] permet de définir explicitement des clés de confidentialité et leur aleur chiffrée. Filtres préconfigurés Remarque : Cette option n'est généralement utilisée que si l'agent de session Confidentialité est exécuté sur une machine autre que le sereur IBM Tealeaf CX où les clés de confidentialité définies ne sont pas directement accessibles. Dans ce cas, les ID clé et les aleurs de clé chiffrées doient être copiés de TMS dans le fichier de configuration de l'agent de l'agent de session Confidentialité, qui est ensuite copié sur la machine cible. Vous pouez ajouter des clés à la section [Keys] en cliquant sur le bouton Ajouter une clé dans l'éditeur de configuration de filtre de confidentialité. Remarque : Ne renommez pas une clé de confidentialité une fois que ous l'aez créée. La aleur chiffrée contient une référence au nom et ne peut pas être modifiée une fois qu'elle a été créée. Le nom et la aleur de la clé doient proenir des clés générées par l'éditeur de configuration du sereur de recherche dans Tealeaf Management System. Voir «Clés de confidentialité», à la page 117. Voir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Tealeaf fournit un certain nombre de filtres de confidentialité des données préconfigurés dans la configuration de confidentialité par défaut. Par l'intermédiaire de TMS, ous pouez actier, éditer et tester les règles, les actions et les tests de ces filtres. Les sections ci-après décrient deux filtres préconfigurés. 326 IBM Tealeaf CX - Guide de configuration

337 Filtre de blocage des données Par défaut, Tealeaf inclut des règles et des actions pour reconnaître des commentaires HTML spécifiques dans les données de réponse et bloquer les données entre elles. Les données peuent être placées entre signes inférieur et supérieur, de la manière suiante : Your Social Security No. is <!--TLTIHB--> <!--TLTIHE--> Si ce filtre de données est actié, les données sont présentées dans Tealeaf comme suit : Your Social Security No. is <!--TLTIHB-->XXXXXXXXXXX<!--TLTIHE--> Remarque : Tealeaf fournit un testeur permettant de tester les filtres de confidentialité. Vous pouez utiliser cet utilitaire pour déelopper et tester ce filtre aant de le déployer ia TMS. Voir «Utilitaire Testeur de confidentialité», à la page Ourez le filtre de confidentialité ia TMS. Voir «Accès à l'éditeur de confidentialité», à la page Dans l'éditeur de confidentialité, ous deez actier l'action TextBlockTags. Recherchez l'entrée et cliquez sur Modifier. a. Dans l'action, les aleurs Masque de début et Masque de fin doient correspondre aux balises HTML ci-dessus. b. S'il existe des espaces entre les balises à factoriser, ous deez appliquer une expression régulière : Remarque : L'utilisation d'une expression régulière dans une règle de confidentialité est une opération coûteuse. Elle doit être éitée chaque fois que possible. Au lieu de cela, essayez de supprimer l'espace entre les balises. 1) Entrez l'expression suiante dans la zone de texte Masque de début et cochez la case Expression régulière? : <!--[ \t\r\n]*tltihb[ \t\r\n]*--> 2) Entrez l'expression suiante dans la zone de texte Masque de fin et cochez la case Expression régulière? : <!--[ \t\r\n]*tltihe[ \t\r\n]*--> c. Par défaut, le caractère de remplacement de chaque caractère entre les balises est X. pour utiliser un autre caractère, entrez une aleur dans la zone de texte Caractère biffé. d. Vérifiez les autres aleurs répertoriées. e. Cliquez sur OK. 3. Maintenant, ous deez configurer la règle 1 pour exécuter cette action. a. Sous la section Règles, recherchez Règle 1. Cliquez sur Modifier. b. Vérifiez que la case Actié est cochée. c. Dans le menu déroulant Actions, sélectionnez TextBlockTags. Cliquez ensuite sur Ajouter. d. L'action TextBlockTags a été ajoutée à la règle. e. Vérifiez les autres aleurs répertoriées. f. Cliquez sur OK. 4. Pour ce filtre, il n'y a pas de tests à configurer. 5. Cliquez sur Sauegarder. L'action TextBlockTags a été actiée pour la règle 1. Chapitre 4. Agents de session de pipeline CX 327

338 6. Créez une tâche TMS pour affecter immédiatement cette configuration à tous les sereurs. Voir "Onglet Traaux TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. Pour plus d'informations sur la manière de générer des applications Web pour utiliser ce filtre et plusieurs nieaux de sécurité des données, oir "Génération d'applications Web en prenant en compte Tealeaf" dans le document IBM Tealeaf CX - Guide d'installation. Filtre de chiffrement des données Comme pour la section précédente, Tealeaf peut être configuré pour reconnaître des commentaires HTML spécifiques dans les données de réponse et chiffrer les données entre eux. Les données peuent être placées entre signes inférieur et supérieur, de la manière suiante : Your Social Security No. is <!--TLTENB--> <!--TLTENE--> Si ce filtre de données est actié, les données sont présentées dans Tealeaf comme suit, pour les utilisateurs Tealeaf qui ne disposent pas des droits appropriés : Your Social Security No. is <!--TLTENB-->@@@@@@@@@@<!--TLTENE--> Les utilisateurs Tealeaf qui possèdent les droits de groupe d'utilisateurs appropriés peuent afficher les données. Remarque : Tealeaf fournit un testeur permettant de tester les filtres de confidentialité. Vous pouez utiliser cet utilitaire pour déelopper et tester ce filtre aant de le déployer ia TMS. Voir «Utilitaire Testeur de confidentialité», à la page 416. Pour créer un filtre de chiffrement pour un ensemble d'utilisateurs spécifique, effectuez les étapes détaillées répertoriées ci-après. Aant de commencer Si ous ne l'aez pas déjà fait, créez le groupe d'utilisateurs qui contient les utilisateurs pouant isualiser les données. 1. Ajoutez les utilisateurs Tealeaf au groupe. 2. Générez une clé de confidentialité et affectez-la à ce groupe. Voir «Génération de clés de confidentialité», à la page Copiez cette aleur dans le claier pour l'utiliser ultérieurement. Dans TMS Remarque : Aant d'effectuer ces étapes, ous deez érifier si cette action a déjà été incluse dans otre système Tealeaf. En fonction de otre build actuelle et de sa mise à nieau ou non à partir d'une ersion précédente, ous aez peut-être déjà accès à cette action. Il se peut que ous deiez affecter la clé de confidentialité de l'action. Voir «Fichier Priacy.cfg», à la page Ourez le filtre de confidentialité ia TMS. Voir «Accès à l'éditeur de confidentialité», à la page Dans l'éditeur de confidentialité, ous deez créer l'action. Dans la section Actions, cliquez sur Ajouter une action. a. Entrez le nom de l'action. Par exemple, TextEncryptTags. b. Dans le menu déroulant Action, sélectionnez Chiffrer. Des options supplémentaires peuent apparaître. 328 IBM Tealeaf CX - Guide de configuration

339 c. Pour la aleur Clé, collez la aleur que ous aez créée pour la clé de confidentialité ci-dessus. d. Dans la zone de texte Groupe, entrez le nom du groupe qui peut afficher les données. e. Dans le menu déroulant Section, sélectionnez réponse. f. Les aleurs Masque de début et Masque de fin doient correspondre aux balises HTML ci-dessous. Définissez le masque de début : <!--TLTENB-->. Définissez le masque de fin : <!--TLTENE-->. g. S'il existe des espaces entre les balises à factoriser, ous deez appliquer une expression régulière : Remarque : L'utilisation d'une expression régulière dans une règle de confidentialité est une opération coûteuse. Elle doit être éitée chaque fois que possible. Au lieu de cela, essayez de supprimer l'espace entre les balises. 1) Entrez l'expression suiante dans la zone de texte Masque de début et cochez la case Expression régulière? : <!--[ \t\r\n]*tltenb[ \t\r\n]*--> 2) Entrez l'expression suiante dans la zone de texte Masque de fin et cochez la case Expression régulière? : <!--[ \t\r\n]*tltene[ \t\r\n]*--> h. Par défaut, le caractère de remplacement de chaque caractère entre les balises est X. Généralement, ce caractère est réseré aux actions de blocage. Définissez cette aleur dans la zone de texte Caractère biffé. i. Vérifiez les autres aleurs répertoriées. j. Cliquez sur OK. 3. Maintenant, ous deez configurer la règle 1 pour exécuter cette action. a. Sous la section Règles, recherchez Règle 1. Cliquez sur Modifier. b. Vérifiez que la case Actié est cochée. c. Dans le menu déroulant Actions, sélectionnez TextEncryptTags. Cliquez ensuite sur Ajouter. d. L'action TextEncryptTags a été ajoutée à la règle. e. Vérifiez les autres aleurs répertoriées. f. Cliquez sur OK. 4. Pour ce filtre, il n'y a pas de tests à configurer. 5. Cliquez sur Sauegarder. L'action TextEncryptTags a été actiée pour la règle Créez une tâche TMS pour affecter immédiatement cette configuration à tous les sereurs. Voir "Onglet Traaux TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. Fichier Priacy.cfg Dans le fichier de configuration Priacy.cfg, l'action se présente comme suit : [TextEncryptTags] Action=Encrypt Key=DemoKey01 Section=response Field=body StartPattern=<!--TLTEHB--> EndPattern=<!--TLTEHE--> Chapitre 4. Agents de session de pipeline CX 329

340 Dans la configuration ci-dessus, la aleur DemoKey01 doit être remplacée par la clé de confidentialité utilisée pour déchiffrer les données masquées. Voir «Génération de clés de confidentialité», à la page 118. Pour plus d'informations sur la manière de générer des applications Web pour utiliser ce filtre et plusieurs nieaux de sécurité des données, oir "Génération d'applications Web en prenant en compte Tealeaf" dans le document IBM Tealeaf CX - Guide d'installation. Filtres préconfigurés supplémentaires Des filtres supplémentaires ont été fournis dans le fichier de configuration Priacy.cfg de Tealeaf. Exemples de filtre Voir «Accès à l'éditeur de confidentialité», à la page 310. La section ci-après fournit des exemples illustrant l'utilisation de l'agent de session Confidentialité pour bloquer ou supprimer du texte. Exemple - Filtrage des données de session des employés Si os employés utilisent régulièrement le site Web de otre entreprise, il peut s'aérer utile d'extraire leurs données de session des rapports tout en capturant les informations. Dans la solution ci-après, les isiteurs correspondant à des employés internes se connectent au site Web de la société à partir de la même adresse IP (aaa.bbb.ccc.ddd). A l'aide de la configuration Priacy.cfg, peut identifier de manière unierselle les employés dans l'application demandeur (TLT_APPLICATION_NAME) aec la aleur Employee. Remarque : Cette solution doit être déployée dans le pipeline Tealeaf aant que l'agent de session de référence Tealeaf ne soit appliqué. Dans Priacy.cfg, effectuez les modifications suiantes : [Rule1] ReqField=REMOTE_ADDR ReqOp=EQ ReqVal=aaa.bbb.ccc.ddd Actions=Employee [Employee] Action=ReqSet ReqSet Section=appdata ReqSet Field=TLT_APPLICATION_NAME Replace String=Employee 330 IBM Tealeaf CX - Guide de configuration Une fois que ous aez effectué la configuration ci-dessus, actiez bien la aleur Employee : System\Reference_Application.txt A xx employee Pour filtrer les sessions des employés : Les sessions des employés peuent alors être facilement filtrées par les utilisateurs Tealeaf si nécessaire, à l'aide de la chaîne TLT_APPLICATION_NAME=Employee. Pour rechercher les sessions des employés, utilisez le générateur de recherche de Tealeaf. Dans la aleur TLT_APPLICATION_NAME, entrez Employee.

341 Tous les rapports existants peuent être filtrés pour extraire les données de session des employés à l'aide du filtre d'application dans des graphiques. Remarque : Le fichier Windows Priacy.cfg contient de nombreux exemples d'opération de filtrage. Exemple - Blocage de texte Le blocage de texte peut être utilisé pour assainir les données sensibles, telles que les numéros de carte de crédit ou les mots de passe, des données capturées utilisées dans les ersions précédentes d'ibm Tealeaf CX. En plus de la fonctionnalité étendue, l'agent de session Confidentialité fournit des règles et des actions par défaut qui émulent le comportement de l'ancien agent de session Blocage de texte. Remarque : Par défaut, la PCA est configurée pour assainir toutes les données utilisateur en entrée des zones de formulaire, à des fins de sécurité. Si nécessaire, ous pouez désactier ce paramètre ia la console Web de la PCA et gérer la confidentialité des données des zones, zone par zone. Cet assainissement est géré à l'aide de l'action TextBlockURLFields configurée par défaut dans la règle 1. Voir "Console Web PCA - Onglet Règles" dans le document IBM Tealeaf Passie Capture Application - Guide. Remarque : Les clients Tealeaf sont chargés de déterminer les informations à assainir, d'identifier les zones et les emplacements de ces informations, d'implémenter les règles et les actions de l'agent de session Confidentialité (et les balises de métadonnées facultaties) et de gérer ces paramètres dans le temps. Les sections ci-après expliquent comment bloquer des zones de données spécifiques dans la demande et la réponse. Par défaut, Tealeaf fournit des règles et des actions permettant de bloquer du texte dans la réponse, qui peuent être modifiées et actiées en fonction des exigences de otre application Web. Voir «Filtre de blocage des données», à la page 327. Méthode 1 : modifications du fichier de demande Pour assainir les données sensibles dans les zones d'url, ous pouez utiliser l'action TextBlockURLFields_WhiteList dans le fichier de configuration de l'agent de session Confidentialité fourni (Priacy.cfg). Par défaut, cette action est exécutée dans Rule1. Pour identifier les zones à bloquer, spécifiez les noms de zone dans l'option Nom de aleur de l'action TextBlockURLFields_WhiteList. Méthode 2 : modifications du fichier de réponse Tous les noms de zone sensible (par exemple, primaryapplicant_socialsecuritynumber) doient être ajoutés à l'action TextBlockURLFields_WhiteList (ou à une action similaire de l'agent de session Confidentialité) pour empêcher les utilisateurs de oir ces informations dans la ue Demande/Réponse d'ibm Tealeaf CX RealiTea Viewer. Méthode 3 : blocage de texte sur plusieurs lignes dans la réponse Supposons que ous souhaitiez bloquer le code HTML suiant dans la réponse : Chapitre 4. Agents de session de pipeline CX 331

342 <b>account Number: </b> </td> Vous pouez créer la section d'action de confidentialité suiante pour bloquer ce texte : [BlockAccountNumber] Action=Replace Section=response Field=body StartPattern=<b>Account Number: EndPattern=</td> Inclusie=True ReplaceString=<b>Account Number: XXXXXXXX </b> </td> Exemple - Actiation de la recherche de zones chiffrées ou bloquées Dans certains cas, ous pouez permettre à un ensemble restreint d'utilisateurs d'effectuer des recherches dans des données sensibles chiffrées ou bloquées. Vous pouez créer des filtres de confidentialité pour copier les données sensibles dans une zone hachée par MD5, puis chiffrer ou bloquer la zone d'origine. Vous pouez ensuite configurer un modèle de recherche pour inclure la nouelle ersion de la zone et appliquer le hachage MD5 au terme de recherche pour renoyer la aleur d'origine. Remarque : L'option MD5 ne peut être appliquée que si l'agent de session Confidentialité étendue est utilisé. Pour plus d'informations, oir «Agent de session Confidentialité étendue», à la page 275. Limitations Remarque : Les étapes ci-après offrent un moyen d'accéder aux données bloquées ou sensibles qui doient être par ailleurs protégées. Si ous êtes inquiet au sujet de l'accès à cette zone nouellement créée, procédez comme suit : Examinez les utilisateurs et les groupes ayant accès à la configuration de modèles de recherches ia leurs profils de menu. Voir "Administration des utilisateurs CX" dans le document IBM Tealeaf cximpact - Guide d'administration. Il se peut que ous puissiez créer un ou plusieurs éénements pour segmenter l'accès à la zone de recherche par groupes d'utilisateurs. Voir «Segmentation des données», à la page 131. Les zones de recherche auxquelles un hachage MD5 a été appliqué doient être des correspondances exactes. Les caractères génériques ne sont pas disponibles. Les tirets et autres signes de ponctuation peuent être supprimés de la zone de recherche. Par exemple, les données d'origine : deiennent la aleur de zone hachée par MD5 suiante : Les utilisateurs qui effectuent des recherches dans une zone hachée par MD5 doient être informés de ces limitations. 332 IBM Tealeaf CX - Guide de configuration

343 Configuration Supposons qu'une zone de numéro de téléphone à contacter doie être actiée ia une recherche MD5 et bloquée de tout accès courant. Cette aleur est stockée dans la demande sous CONTACT_PHONE. Les aleurs sont stockées au format XXX-XXX-XXXX. 1. Ourez le filtre de confidentialité ia TMS. a. Dans l'onglet WorldView, cliquez sur le noeud Serice de transport. b. Cliquez sur Priacy Filter configuration. c. Cliquez sur Afficher/Modifier dans le panneau Actions de configuration. Voir "Onglet TMS WorldView" dans le document IBM Tealeaf cximpact - Guide d'administration. 2. La configuration du filtre de confidentialité s'oure. 3. Créez une action pour copier la zone CONTACT_PHONE dans CON_PHONE_HASH, dans la section [appdata], où elle est automatiquement indexée. a. Cliquez sur Ajouter une action. b. Les zones suiantes doient être spécifiées. Les autres sont facultaties : Commande Description Nom Entrez le nom de l'action. Ce nom doit être unique parmi toutes les actions. Pour notre exemple, appelez-la CopyContactPhoneToHash. Action Spécifiez la aleur ReqSet, qui permet de définir ou de remplacer la aleur de la paire nom-aleur dans la demande. Si elle n'existe pas, la paire nom-aleur est créée ; Section L'option Section permet d'identifier le nom de la section qui contient les données à traiter. Vous pouez la laisser ide, auquel cas, la mémoire tampon des demandes est analysée dans son intégralité. Zone Pour notre exemple, entrez CONTACT_PHONE. Nom de aleur Ne renseignez pas cette zone. Inerser l action Spécifiez la aleur false. Masque de début Ne renseignez pas cette zone. Masque de fin Ne renseignez pas cette zone. Section ReqSet Spécifiez la aleur appdata pour placer la paire nom/aleur dans la section [appdata]. Zone ReqSet Définissez cette aleur sur CON_PHONE_HASH. Résultat de ReqSet Ne renseignez pas cette zone. MD5 Spécifiez la aleur true pour appliquer un hachage MD5 à la zone. Par la suite, la zone de recherche applique le hachage MD5 à la chaîne entrée pour extraire les aleurs de la nouelle zone. Chapitre 4. Agents de session de pipeline CX 333

344 Total de contrôle Spécifiez la aleur false. c. Sauegardez la nouelle action CopyContactPhoneToHash. 4. Créez une action pour bloquer les données dans CONTACT_PHONE. a. Cliquez sur Ajouter une action. b. Les zones suiantes doient être spécifiées. Les autres sont facultaties : Commande Description Nom Entrez le nom de l'action. Ce nom doit être unique parmi toutes les actions. Pour notre exemple, appelez-la BlockContactPhone. Action Cet exemple utilise Bloquer, qui bloque les données. Vous pouez également choisir Chiffrer. Section L'option Section permet d'identifier le nom de la section qui contient les données à traiter. Vous pouez la laisser ide, auquel cas, la mémoire tampon des demandes est analysée dans son intégralité. Zone Pour notre exemple, entrez CONTACT_PHONE. Nom de aleur Ne renseignez pas cette zone. Inerser l action Spécifiez la aleur false. Masque de début Ne renseignez pas cette zone. Masque de fin Ne renseignez pas cette zone. Caractère biffé Caractère biffé permet de remplacer les données d'origine qui sont bloquées ou chiffrées par un caractère alphanumérique. Pour cet exemple de blocage, utilisez X. Longueur du biffage Ne renseignez pas cette zone. Masque de blocage La aleur Masque de blocage est une expression régulière spécifiant les caractères des données trouées à remplacer par le caractère de substitution. Remarque : Soyez prudent lorsque ous utilisez Masque de blocage. Si les données ne correspondent pas à l'expression régulière spécifiée pour Masque de blocage, elles ne seront ni errouillées ni chiffrées. Remplacer la chaîne Ne renseignez pas cette zone. c. Sauegardez la nouelle action BlockContactPhone. 5. Créez une règle permettant de rechercher la zone CONTACT_PHONE. Cette règle éalue chaque hit pour déterminer s'il contient la zone. a. Cliquez sur Ajouter une règle. 334 IBM Tealeaf CX - Guide de configuration

345 b. Les zones suiantes doient être spécifiées. Les autres sont facultaties : Commande Description Nom Entrez le nom de la règle. Les noms de règle doient se présenter sous la forme Règle + Numéro séquentiel. Voir «Conentions de désignation des règles», à la page 311. ReqField Entrez le nom de la zone à rechercher. Dans notre exemple, il s'agit de la zone CONTACT_PHONE. ReqOp Pour cette règle, sélectionnez exists, qui renoie la aleur true si la zone existe dans les données. Arrêter le traitement Spécifiez la aleur false pour continuer à traiter d'autres règles si cette règle renoie la aleur true. Actié Spécifiez la aleur true. Actions Sélectionnez les actions que ous aez créées précédemment. Vous deez les sélectionner de sorte qu'elles apparaissent dans l'ordre suiant : 1) CopyContactPhoneToHash, 2) BlockContactPhone Remarque : L'action de copie doit être exécutée aant l'action de blocage ou de chiffrement. Tests Pour cet exemple, aucun test n'est requis. c. Pour sauegarder la règle, cliquez sur OK. 6. Cliquez sur Sauegarder pour sauegarder os modifications. 7. Configurez une tâche pour enoyer les modifications à tous les sereurs. 8. Vous pouez configurer un modèle de recherche pour inclure la zone CON_PHONE_HASH. La zone doit être incluse dans un modèle de recherche terminé. La zone doit être configurée de sorte que le actié MD5 soit actié. Les utilisateurs du modèle de recherche doient être informés qu'ils ne doient pas insérer de tirets (-) dans leurs chaînes de recherche, dans cette zone. Voici un exemple possible de aleur : Voir "Configuration des modèles de recherche" dans le document IBM Tealeaf cximpact - Guide d'administration. 9. Vous pouez éentuellement créer un modèle de liste de session pour inclure cette nouelle aleur de zone dans la sortie affichée. Voir "Modèles de liste des sessions" dans le document IBM Tealeaf cximpact - Guide d'administration. Remarque : Les aleurs ne peuent pas faire l'objet d'une recherche à l'aide d'un modèle de recherche terminé tant qu'une session terminée contenant CON_PHONE_HASH n'a pas été capturée et indexée. Exemple : l'existence d'une zone de demande signifie d'une section de demande doit être supprimée. Supposons que les données de demande de otre application Web contienne une zone de carte de crédit (CREDIT_CARD_NO), dont ous souhaitez bloquer la aleur. En outre, ous souhaitez bloquer le nom de zone lui-même afin d'accroître la sécurité Chapitre 4. Agents de session de pipeline CX 335

346 et les demandes qui incluent la zone incluent également une section appelée [CustInfo] que ous souhaitez supprimer. Vous pouez gérer ces tâches à l'aide de la configuration de règles ci-après. 1. Créez une action pour supprimer la ariable de demande : Nom : Del_CREDIT_CARD_NO Action : ReqDelete Section : ne pas renseigner Zone : CREDIT_CARD_NO 2. Créez une action pour supprimer la section [CustInfo] : Nom : Del_CustInfo Action : ReqDelete Section : CustInfo Zone : ne pas renseigner 3. Créez une règle aec les aleurs suiantes : ReqField : CREDIT_CARD_NO ReqOp : exists Actié : true Actions : Del_CREDIT_CARD_NO Del_CustInfo Exemple - Ajout de données de demande pour indexation Pour améliorer les performances de recherche, Tealeaf recherche dans les sessions terminées un ensemble de données prédéfini qui permet généralement de localiser les sessions. Le portail et RTV utilisent ensuite ces index pour localiser rapidement les sessions en fonction des critères de recherche que ous entrez. Pour de nombreux clients, cet ensemble de données est suffisant pour une recherche efficace des sessions qui les intéressent. Les index ne sont pas utilisés pour les recherches dans les sessions acties. Dans certains cas, ous pouez décider que certaines données de session non disponibles par défaut pour la recherche doient être accessibles. Par exemple : Vous aez créé des règles de pipeline qui insèrent des données spécifiques aux applications dans la demande. Vous aez déployé IBM Tealeaf CX UI Capture for AJAX, qui permet la capture des éénements de l'interface utilisateur à partir du naigateur du isiteur. Dans les cas ci-dessus, il se peut que les données ne soient pas automatiquement indexées pour la recherche. A l'aide de l'une des méthodes fournies, ous pouez rendre ces données disponibles pour une recherche ia des aleurs d'éénement ou des données indexées. A l'aide de règles de confidentialité, ous pouez déplacer des données de la réponse ou la demande dans la section [appdata] de la demande, où elles sont automatiquement indexées pour la recherche. Remarque : L'ajout de données d'index est considérée comme étant une tâche d'administrateur Tealeaf. L'ajout de données à indexer pour la recherche augmente la taille des index stockés sur le sereur de traitement. Suiant le olume des données augmentées marquées pour indexation, les index peuent oir leur taille augmenter considérablement et aoir un impact sur l'espace 336 IBM Tealeaf CX - Guide de configuration

347 disque disponible et les performances du sereur de traitement. Aant de commencer à ajouter des données, ous deez érifier os objectifs aec le serice informatique. Voir «Ajout d'autres zones pour indexation et recherche», à la page 55. Actiation de la confidentialité ia TMS Vous pouez actier l'agent de session Confidentialité ia TMS. Pour actier l'agent de session Confidentialité : 1. Accédez à TMS ia le portail. Voir «Ajout et configuration de l'agent de session», à la page Accédez au noeud Serice de transport du sereur que ous souhaitez configurer. 3. Cliquez sur Configuration du serice de transport. 4. Cliquez sur Afficher. 5. Pour éditer la ersion affichée, cliquez sur Modifier. 6. La fenêtre affiche tous les pipelines et leurs agents de session actuellement disponibles dans otre système Tealeaf. 7. Les pipelines sont définis par nom et port dans la section [Globals]. Pour plus d'informations sur la création de pipelines, oir «Génération d'un pipeline dans le fichier de configuration», à la page 228. Remarque : L'agent de session Confidentialité doit se trouer après l'agent de session Decouple (et l'agent de session de déploiement si les réponses sont compressées) dans le pipeline, mais aant la plupart des autres agents de session. Actiation de la confidentialité ia TealeafCaptureSocket.cfg Un agent de session, tel que l'agent de session Confidentialité, est actié en créant un pointeur dans ce fichier ers sa configuration dans la section de configuration de l'agent de session directement en amont. 1. Pour intégrer l'agent de session Confidentialité, ous deez éditer la propriété DownStreamConfigSection de la configuration de l'agent de session juste aant lui dans le pipeline. 2. Par exemple, si l'agent de session en amont est [DecoupleEx], dans la configuration de cet agent de session, ous deez définir la propriété suiante : DownStreamConfigSection=PriacyEx. Chapitre 4. Agents de session de pipeline CX 337

348 Figure 28. Actiation de la confidentialité ia TMS 3. Dans la section [Priacy], ous pouez modifier les propriétés pour refléter l'agent de session. Les éléments précédés d'un signe dièse (#) sont désactiés. 338 IBM Tealeaf CX - Guide de configuration

349 Figure 29. Actiation de la confidentialité 4. Définissez les paramètres de configuration globaux. Le tableau suiant répertorie les paramètres de configuration de l'agent de session : Remarque : Les aleurs Nom d affichage sont affichées dans TMS, cette méthode étant recommandée pour configurer les agents de session. Voir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Les aleurs Nom sont affichées dans TealeafCaptureSocket.cfg. Tableau 24. Actiation de la confidentialité ia TealeafCaptureSocket.cfg Affichage Nom Description DLL DLL Fichier.DLL utilisé par l'agent de session. Ne modifiez pas cette aleur. Chapitre 4. Agents de session de pipeline CX 339

350 Tableau 24. Actiation de la confidentialité ia TealeafCaptureSocket.cfg (suite) Affichage Nom Description Fichier de configuration Affichage des règles dans le journal des éénements Nieau de journal ConfigFile LogRules LogLeel Fichier contenant les règles, les actions et les tests de confidentialité. La aleur par défaut du fichier de configuration est Priacy.cfg, qui correspond au fichier modèle par défaut installé dans le répertoire d'installation de Tealeaf.\ Ce fichier contient plusieurs exemple de règle et une documentation détaillée sur l'implémentation. Pour plus d'informations, examinez ce fichier ia TMS. Remarque : Aant d'actier l'agent de session Confidentialité, ous deez configurer et tester les règles et actions de otre agent de session. Voir «Accès à l'éditeur de confidentialité», à la page 310. Lorsqu'elle est définie sur true, cette option actie l'enregistrement des règles et de leurs actions dans le hit. Voir «Consignation de l'agent de session Confidentialité». Si LogRules est actié, cette aleur définit le nieau de consignation. Voir «Consignation de l'agent de session Confidentialité». 5. Dans la zone Description de ersion, entrez une description des modifications apportées dans cette ersion. Par exemple, Agent de session Confidentialité actié. Remarque : Si le serice de transport se troue sur un sereur autre que le sereur maître TMS, ous deez enoyer les modifications de configuration au sereur du serice de transport. Voir "Onglet Traaux TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. 6. Cliquez sur Sauegarder pour sauegarder os modifications. L'agent de session Confidentialité a été actié dans le pipeline configuré. Consignation de l'agent de session Confidentialité Si la consignation est actiée, les messages de journal sont enregistrés dans la section [priacylog] de la demande. Via une relecture par naigateur ou RTV, ous pouez examiner les données de hit pour éaluer la manière dont les règles de l'agent de session Confidentialité sont traitées. Remarque : La consignation de l'agent de session Confidentialité est utilisée principalement à des fins de débogage. Pour actier le débogage dans l'agent de session Confidentialité, définissez les aleurs de propriété suiantes dans la section [PriacyEx] : LogRules : true LogLeel : DEBUG 340 IBM Tealeaf CX - Guide de configuration

351 Une documentation supplémentaire est disponible dans les remarques de la section [PriacyEx]. Voir la capture d'écran précédente. Application de la confidentialité Des règles de confidentialité peuent être appliquées dans plusieurs zones du système Tealeaf. Voir "Gestion de la confidentialité des données dans Tealeaf CX" dans le document IBM Tealeaf CX - Guide d'installation. Test de la confidentialité Des règles de confidentialité peuent être déeloppées dans les zones suiantes : TMS : oir «Accès à l'éditeur de confidentialité», à la page 310. RTV : les règles de confidentialité peuent être testées par rapport à des sessions sélectionnées. Voir "RealiTea Viewer - Testeur de confidentialité" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Agent de session RTA (Real-Time Monitoring and Alert) RTA (Real-Time Alerts) fournit un éritable traitement en temps réel sur tous les hits capturés par Tealeaf. RTA peut être utilisé aux fins suiantes : Suppression de hits : supprime les hits contenant des données non souhaitées, telles que les hits de ping ou de signal de présence et les images. Echantillonnage de session : spécifie un pourcentage de sessions à supprimer de la capture. Détection d'éénements : détecte des éénements spécifiés et enoie des alertes : il peut s'agir d'erreurs HTTP et de durées de génération des pages importantes aant que les hits n'atteignent le Canister. Présentation Vous pouez configurer RTA pour exécuter trois types de test sur les données : REQTest : teste une zone quelconque de la demande. Ce test recherche une aleur spécifiée dans la chaîne de l'url. Il peut s'agir d'un code de statut, d'une chaîne de requête ou de quelque chose de similaire. RSPSrch : effectue une recherche textuelle de la réponse. Ce test effectue une recherche dans le texte renoyé par le sereur en fonction de la demande. Par exemple, ous pouez rechercher une transaction partielle. SessPCT : sélectionne aléatoirement un pourcentage de sessions spécifié. Ce test permet de supprimer un pourcentage spécifié des sessions. SessPCT détermine le nombre total de sessions en conertissant les octets 4à7 de l'id session en entier, dont le modulo par 101 est ensuite calculé. Le nombre résultant est compris entre 0 et 100. Une session complète contient un nombre paire d'entiers compris entre 0 et 100. Lorsqu'un modulo alide est reçu, il est comparé au paramètre de règle. Une fois que le test a été effectué et que toutes les règles de test ont été satisfaites, RTA peut effectuer l'une des actions suiantes : APPEent : génère un éénement d'application Tealeaf dans la demande Delete : supprime le hit EentLOG : crée une entrée dans le journal des éénements NT enoie un courrier électronique SetVar : définit une ariable Chapitre 4. Agents de session de pipeline CX 341

352 Actiation de RTA Ajout de l'agent de session Des agents de session peuent être ajoutés ia l'éditeur de pipeline dans TMS. Voir «Ajout d'un agent de session», à la page 237. Pour plus d'informations sur l'éditeur de pipeline et TMS, oir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Le reste de cette page décrit les options de configuration et la manière de les modifier ia le fichier TealeafCaptureSocket.cfg stocké sur le sereur. Ces paramètres sont également disponibles ia l'éditeur de pipeline, cette méthode étant recommandée pour configurer les agents de session. Vous pouez actier l'agent de session Temps réel en l'ajoutant à otre pipeline Windows ia TMS. Pour actier RTA : 1. Connectez-ous au portail Tealeaf en tant qu'administrateur. 2. Dans le menu Portail, sélectionnez Tealeaf > TMS. 3. Dans la ue Sereurs, cliquez sur le noeud Serice de transport. 4. Cliquez sur Configuration du serice de transport. 5. Cliquez sur Afficher/Modifier. 6. L'éditeur de pipeline s'affiche. Voir "Editeur de pipeline TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. 7. Dans le panneau Agents de session disponibles, faites glisser RTA dans otre pipeline. 8. La boîte de dialogue d'édition d'agent de session apparaît. Voir «Paramètres de configuration». 9. Editez les propriétés. Cliquez sur OK. 10. Pour sauegarder os modifications dans l'éditeur de pipeline, cliquez sur Sauegarder. Paramètres de configuration Les paramètres de configuration suiants sont disponibles pour cet agent de session : Les aleurs Nom d affichage sont affichées dans TMS, cette méthode étant recommandée pour configurer les agents de session. Voir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Les aleurs Nom sont affichées dans TealeafCaptureSocket.cfg. Tableau 25. Paramètres de configuration Afficher nom Nom Description Trace du script ScriptTrace Indique si la fonctionnalité de débogage des scripts doit être actiée ou non. Définissez cette option comme suit : ScriptTrace=OFF ou ScriptTrace=ON 342 IBM Tealeaf CX - Guide de configuration

353 Configuration de tests RTA dans TMS Les tests et règles de l'agent de session RTA (Real-Time Alerting) peuent être configurés ia Tealeaf Management System dans le portail Tealeaf. Pour configurer RTA : 1. Connectez-ous au portail Tealeaf en tant qu'administrateur. 2. Dans le menu Portail, sélectionnez Tealeaf > TMS. 3. Dans la ue Sereurs, cliquez sur le noeud Serice de transport. 4. Cliquez sur Configuration de RTA. 5. Cliquez sur Afficher/Modifier. 6. Le fichier de configuration.ini de RTA est affiché. Pour plus d'informations sur TMS, oir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Edition du fichier RTA.ini Le fichier RTA.ini est l'emplacement de configuration des règles de RTA. Vous trouerez des instructions complètes sur la manière de configurer RTA dans le fichier RTA.ini, accessible ia TMS. Le fichier RTA.ini contient sept exemples de règle qui peuent être utilisés comme modèles. Les règles sont implémentées dans un format XML laxiste aec des balises de début et de fin. Il n'existe pas de limites quant au nombre de tests qu'une règle peut comporter. Les règles sont traitées suiant l'ordre spécifié par le paramètre NUM= et non l'ordre dans lequel elles apparaissent dans le fichier. Les règles peuent utiliser des opérateurs tels que Supérieur à, Egal à ou Non égal à. Le paramètre STOPRULES arrête le traitement des règles. Limites des règles Une instance indiiduelle de l'agent de session RTA ne peut pas contenir plus de 150 règles. Le fichier RTA.ini ne peut pas contenir plus de 150 règles. En outre, le paramètre NUM= ne peut pas utiliser une aleur supérieure à 150. La solution palliatie consiste à déployer une deuxième instance de RTA dans le même pipeline à l'aide d'un autre fichier.ini. Exemples de règle RTA Règle de réduction du nombre de sessions Cette règle réduit le nombre de sessions d'eniron 10 %. Remarque : La directie STOPRULES empêche tout traitement supplémentaire des règles si cette règle possède la aleur true. <RULE NUM="1" STATUS="DISABLED" DESCRIPTION="Delete 10% of Sessions" STOPRULES="YES"> <GROUP TYPE="SessPCT" PERCENT="10" > </GROUP> <GROUP TYPE="DELETE" > </GROUP> </RULE> Chapitre 4. Agents de session de pipeline CX 343

354 Règle des erreurs HTTP 400 et supérieures Cette règle recherche les erreurs HTTP 400 ou supérieures, à l'exception des erreurs 404, qui peuent se produire fréquemment en raison des erreurs typographiques des utilisateurs. L'action consiste à créer une entrée dans le journal des éénements NT : <RULE NUM="5" STATUS="DISABLED" DESCRIPTION="HTTP Errors"> <GROUP TYPE="REQTest" REQF="StatusCode" REQOP="GT" REQVAL="399" > </GROUP> <GROUP TYPE="REQTest" REQF="StatusCode" REQOP="NE" REQVAL="404" > </GROUP> <GROUP TYPE="EentLog" TYPE="WARNING" PRIORITY="Normal" CATEGORY="3xx - 4xx HTTP Errors"> </GROUP> </RULE> Règle de durée de génération des pages importante Cette règle recherche les durées de génération des pages supérieures à 60 secondes : <RULE NUM="6" STATUS="DISABLED" DESCRIPTION="Page Response Time &gt 300 Secs"> <GROUP TYPE="REQTest" REQF="TL_ResponseTime" REQOP="GT" REQVAL="300" > </GROUP> <GROUP TYPE="EentLog" TYPE="ERROR" PRIORITY="Seere" CATEGORY="Page Generation Error"> </GROUP> </RULE> Règle des erreurs HTTP 500 et supérieures Cette règle recherche les erreurs HTTP 500 ou supérieures, qui correspondent aux erreurs de sereur internes. En plus de créer une entrée de journal des éénements de type ERREUR, elle crée un éénement APPEent. L'opérateur NOT est utilisé dans cette règle. <RULE NUM="8" STATUS="DISABLED" DESCRIPTION="HTTP 500 Errors"> <GROUP TYPE="REQTest" NOT="YES" REQF="StatusCode" REQOP="LT" REQVAL="500" > </GROUP> <GROUP TYPE="APPEent" TYPE="ERROR" PRIORITY="High" CATEGORY="HTTP 500 Errors"> </GROUP> </RULE> Règle de recherche dans la mémoire tampon des réponses Cet exemple ne recherche la chaîne Partial Transaction dans la mémoire tampon des réponses, que pour les pages hors cache du sereur (code d'état HTTP 302). <RULE NUM="9" STATUS="DISABLED" DESCRIPTION="Partial Transaction" > <GROUP TYPE="REQTest" REQF="StatusCode" REQOP="NE" REQVAL="302" > </GROUP> <GROUP TYPE="RSPSrch" SRCHSTR="Partial Transaction" SRCHCASE="YES" REGEXPR="NO" > </GROUP> <GROUP TYPE=" " To="John@doe.com,Mary@doe.com" From="From@doe.com" Subject="Partial Serer Transaction" Hostname="Mailhost" Port="25"> </GROUP> <GROUP TYPE="EentLog" TYPE="WARNING" PRIORITY="Low" CATEGORY="Partial Transaction"> </GROUP> </RULE> 344 IBM Tealeaf CX - Guide de configuration

355 Exemple de sortie Règle de recherche dans la mémoire tampon des demandes Cet exemple recherche la chaîne APPEVENT TYPE=&qout dans la mémoire tampon des demandes, telle qu'elle existe dans un éénement APPEent. ReqTest n'effectue que des opérations nom/aleur. <RULE NUM="10" STATUS="DISABLED" DESCRIPTION="Partial Transaction" > <GROUP TYPE="RSPSrch" SRCHSTR="APPEVENT TYPE=&qout" SRCHCASE="YES" REGEXPR="NO" SRCHREQ="YES" > </GROUP> <GROUP TYPE="EentLog" TYPE="WARNING" PRIORITY="Low" CATEGORY="APPEent Found"> </GROUP> </RULE> Voici un exemple d'entrée du journal des éénements générée par l'option Journal des éénements RTA : Tealeaf Real Time Alert Page/URL - /postinfo.html Type - APP HTTP Sts Code Sesn ID - B77674C64D1B68945A0A058A28EE5021 Hit ID _168A Error Summary - Priority: Ultra-High - Category: HTTP - Description: ASP error Rsp Time - 0 seconds RequestTime: T15:56:28.168Z ResponseTime: T15:56:28.268Z Miscellaneous Serer: localhost - Page Size: 2542 Bytes - Referring URL: Voici un exemple de sortie XML générée par l'option AppEent de RTA : [xml1] <APPEVENT TYPE="SessionAgent" EVENT="ERROR" SESSIONID="5A7CB3DF4CABFF43E5478DB111466B50" HITID=" _561A"> <GROUP TYPE="ERROR"> <VAR NAME="CATEGORY" VALUE="Test of Ctype1"/> <VAR NAME="STATUS_CODE" VALUE="200"/> <VAR NAME="DESCRIPTION" VALUE="Any Page Response Time >10 Secs"/> </GROUP> </APPEVENT> Agents de session Tealeaf «Ajout d'un agent de session», à la page 237 «Agent de session Archiage», à la page 238 "Agent de session Indexation des attributs" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session Canister», à la page 249 «Agent de session Analyseur de cookie», à la page 252 «Agent de session Dépose de données», à la page 254 «Agent de session Analyseur de données», à la page 260 «Agent de session Decouple», à la page 264 «Agent de session DecoupleEx», à la page 266 «Agent de session Confidentialité étendue», à la page 275 «Agent de session Health-Based Routing (HBR)», à la page 278 «Agent de session Déploiement», à la page 285 «Agent de session Analyseur mobile JSON», à la page 289 «Agent de session Code géré», à la page 303 Chapitre 4. Agents de session de pipeline CX 345

356 «Agent de session Null», à la page 306 «Agent de session Confidentialité», à la page 307 Agent de session RTA (Real-Time Monitoring and Alert) «Agent de session Balises de réponse pour la demande» «Agent de session Fractionnement RTA», à la page 348 «Agent de session de mise en sessions», à la page 353 «Agent de session Routeur de session», à la page 350 «Agent de session Socket», à la page 356 «Agent de session Consignateur de statistiques», à la page 358 "Agent de session de référence Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session de référence Tealeaf - Mode existant», à la page 380 «Agent de session Mise en sessions Tealeaf», à la page 384 «Agent de session TimeGrades», à la page 390 «Agent de session TLI», à la page 392 «Agent de session de décodage d'url», à la page 408 Agent de session Balises de réponse pour la demande RSPTags2REQ recherche les paires nom/aleur dans la mémoire tampon RSP et les place dans la section [appdata] de REQ pour qu'elles puissent être indexées et recherchées. Cet agent de session est principalement destiné aux sites et produits qui utilisent déjà le marquage des pages et utilisent ces balises. Pour plus d'informations, oir Ajout de l'agent de session Des agents de session peuent être ajoutés ia l'éditeur de pipeline dans TMS. Voir «Ajout d'un agent de session», à la page 237. Pour plus d'informations sur l'éditeur de pipeline et TMS, oir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Le reste de cette page décrit les options de configuration et la manière de les modifier ia le fichier TealeafCaptureSocket.cfg stocké sur le sereur. Ces paramètres sont également disponibles ia l'éditeur de pipeline, cette méthode étant recommandée pour configurer les agents de session. Paramètres de configuration Les paramètres de configuration suiants sont disponibles pour RSPTags2REQ : Les aleurs Nom d affichage sont affichées dans TMS, cette méthode étant recommandée pour configurer les agents de session. Voir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Les aleurs Nom sont affichées dans TealeafCaptureSocket.cfg. 346 IBM Tealeaf CX - Guide de configuration

357 Tableau 26. Agent de session Balises de réponse pour la demande Nom d'affichage Nom Description Response Buffer Start Pattern Response Buffer End Pattern Response Name/Value Pair Delimiter RSP Var Delimiter RSP Tags To Search For Trace du script RSPStartPatt RSPEndPatt RSPNameValueDelimiter RSPVarDelimiter RSPTags ScriptTrace Début de la recherche dans la mémoire tampon RSP, qui permet de limiter les recherches dans la mémoire tampon RSP. Fin de la recherche dans la mémoire tampon RSP. Définit le délimiteur entre les paires nom/aleur. Délimiteur nom/aleur. La aleur par défaut est =. Liste délimitée par des points-irgules des ariables à rechercher. Si le symbole pipe ( ) est présent, la partie gauche correspond au nom de ariable de la mémoire tampon RSP et la partie droite, au nom de la section [appdata] de REQ. Si aucun symbole pipe n'est présent, le même nom est utilisé. Si la aleur de ce paramètre est ON, le traçage des scripts est actié, ce qui est utile pour le débogage. La aleur par défaut est OFF. Exemple de configuration Dans l'exemple qui suit, nous supposons que le marquage des pages est appliqué dans la mémoire tampon RSP de la manière suiante :... <!-- PageTagging Start --> <!-- Page Tagging Comments--> <script language="jaascript" type="text/jaascript"> <!-- ar TL_Name="Tea Pots"; ar TL_Category="Clay"; ar TL_Type="Dual"; ar TL_ar1=""; ar TL_ar2="Teal"; ar TL_ar3="6 cup set"; ar TL_ar4=""; ar TL_ar5="Burn Pad"; */--> </script>... L'exemple de configuration qui suit repose sur ce qui précède, Name, ar2, ar3 et ar4 deant être extraits : RSPStartPatt=<!-- PageTaggingStart RSPEndPatt=*/--> RSPVarDelimiter== RSPTags=TL_Name Item;TL_ar2 Color;TL_ar3 Version;TL_ar5 Accessory Chapitre 4. Agents de session de pipeline CX 347

358 Aec cette configuration, la section [appdata] de REQ se présente comme suit : [appdata] Item=Tea Pots Color=Teal Version=6 cup set Accessory=Burn Pad Agents de session Tealeaf «Ajout d'un agent de session», à la page 237 «Agent de session Archiage», à la page 238 "Agent de session Indexation des attributs" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session Canister», à la page 249 «Agent de session Analyseur de cookie», à la page 252 «Agent de session Dépose de données», à la page 254 «Agent de session Analyseur de données», à la page 260 «Agent de session Decouple», à la page 264 «Agent de session DecoupleEx», à la page 266 «Agent de session Confidentialité étendue», à la page 275 «Agent de session Health-Based Routing (HBR)», à la page 278 «Agent de session Déploiement», à la page 285 «Agent de session Analyseur mobile JSON», à la page 289 «Agent de session Code géré», à la page 303 «Agent de session Null», à la page 306 «Agent de session Confidentialité», à la page 307 «Agent de session RTA (Real-Time Monitoring and Alert)», à la page 341 Agent de session Balises de réponse pour la demande «Agent de session Fractionnement RTA» «Agent de session de mise en sessions», à la page 353 «Agent de session Routeur de session», à la page 350 «Agent de session Socket», à la page 356 «Agent de session Consignateur de statistiques», à la page 358 "Agent de session de référence Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session de référence Tealeaf - Mode existant», à la page 380 «Agent de session Mise en sessions Tealeaf», à la page 384 «Agent de session TimeGrades», à la page 390 «Agent de session TLI», à la page 392 «Agent de session de décodage d'url», à la page 408 Agent de session Fractionnement RTA Aec le routeur de session, RTASplit permet d'acheminer le trafic aux pipelines enfant. RTASplit peut utiliser des conditions RTA enrichies pour déterminer le routage. Ce dernier peut être basé sur le contenu d'une ou de plusieurs aleurs REQ. Par exemple, ous pouez effectuer le routage en fonction de l'url. Si l'url inclut tealeaf, elle est acheminée ers childpipe1. Sinon, elle est acheminée ers childpipe IBM Tealeaf CX - Guide de configuration

359 L'agent de session Routeur de session est utilisé dans les cas de routage des sessions par pourcentages. Voir «Agent de session Routeur de session», à la page 350. Ajout de l'agent de session Des agents de session peuent être ajoutés ia l'éditeur de pipeline dans TMS. Voir «Ajout d'un agent de session», à la page 237. Pour plus d'informations sur l'éditeur de pipeline et TMS, oir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Le reste de cette page décrit les options de configuration et la manière de les modifier ia le fichier TealeafCaptureSocket.cfg stocké sur le sereur. Ces paramètres sont également disponibles ia l'éditeur de pipeline, cette méthode étant recommandée pour configurer les agents de session. Paramètres de configuration Les paramètres de configuration suiants sont disponibles pour cet agent de session : Les aleurs Nom d affichage sont affichées dans TMS, cette méthode étant recommandée pour configurer les agents de session. Voir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Les aleurs Nom sont affichées dans TealeafCaptureSocket.cfg. Tableau 27. Agent de session Fractionnement RTA Afficher nom Nom Description Trace du script ScriptTrace Si la aleur de ce paramètre est ON, le traçage des scripts est actié, ce qui est utile pour le débogage. La aleur par défaut est OFF. Fichier de configuration RTAIni Nom du fichier de configuration de l'agent de session. Par défaut, ce nom de fichier est RTASplit.ini. Une documentation de configuration supplémentaire est fournie dans le fichier.ini. Exemple de configuration L'agent de session Fractionnement RTA permet de détourner le contenu statique d'un pipeline de traitement Windows ers le sereur TLI et le pipeline pour l'insérer dans une archie statique. Une archie statique est une bibliothèque de contenus statiques capturés quotidiennement à des fins de stockage à long terme pour relecture et audit. Pour plus d'informations sur la configuration de l'agent de session Fractionnement RTA afin qu'il puisse être utilisé aec des archies statiques, oir «Agent de session TLI», à la page 392. Pour plus d'informations sur les archies statiques, oir "Gestion des archies statiques" dans le document IBM Tealeaf cximpact - Guide d'administration. Chapitre 4. Agents de session de pipeline CX 349

360 Agents de session Tealeaf «Ajout d'un agent de session», à la page 237 «Agent de session Archiage», à la page 238 "Agent de session Indexation des attributs" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session Canister», à la page 249 «Agent de session Analyseur de cookie», à la page 252 «Agent de session Dépose de données», à la page 254 «Agent de session Analyseur de données», à la page 260 «Agent de session Decouple», à la page 264 «Agent de session DecoupleEx», à la page 266 «Agent de session Confidentialité étendue», à la page 275 «Agent de session Health-Based Routing (HBR)», à la page 278 «Agent de session Déploiement», à la page 285 «Agent de session Analyseur mobile JSON», à la page 289 «Agent de session Code géré», à la page 303 «Agent de session Null», à la page 306 «Agent de session Confidentialité», à la page 307 «Agent de session RTA (Real-Time Monitoring and Alert)», à la page 341 «Agent de session Balises de réponse pour la demande», à la page 346 Agent de session Fractionnement RTA «Agent de session de mise en sessions», à la page 353 «Agent de session Routeur de session» «Agent de session Socket», à la page 356 «Agent de session Consignateur de statistiques», à la page 358 "Agent de session de référence Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session de référence Tealeaf - Mode existant», à la page 380 «Agent de session Mise en sessions Tealeaf», à la page 384 «Agent de session TimeGrades», à la page 390 «Agent de session TLI», à la page 392 «Agent de session de décodage d'url», à la page 408 Agent de session Routeur de session L'agent de session Routeur de session permet d'acheminer le trafic, ce qui est nécessaire dans un enironnement à plusieurs processeurs ou Canisters, où le serice de transport doit acheminer le trafic à un ou plusieurs sereurs de traitement. Le routage est toujours effectué sur la base d'un pourcentage de sessions. Par exemple, dans un système aec un composant Transport et trois composants Processeur pour receoir les données, l'agent Routeur de session peut être configuré pour enoyer un tiers du trafic à chaque composant de traitement. Remarque : Pour certains déploiements du sereur de traitement, cet agent de session est inclus dans le pipeline par défaut et est requis. Voir «Configuration du pipeline CX», à la page IBM Tealeaf CX - Guide de configuration

361 Remarque : Cet agent acheminant le trafic au nieau session, les données doient être correctement mises en sessions au préalable. Remarque : Si le trafic est réparti à l'aide d'une méthode autre que les pourcentages, l'agent de session RTASplit est requis. Ajout de l'agent de session Des agents de session peuent être ajoutés ia l'éditeur de pipeline dans TMS. Voir «Ajout d'un agent de session», à la page 237. Pour plus d'informations sur l'éditeur de pipeline et TMS, oir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Le reste de cette page décrit les options de configuration et la manière de les modifier ia le fichier TealeafCaptureSocket.cfg stocké sur le sereur. Ces paramètres sont également disponibles ia l'éditeur de pipeline, cette méthode étant recommandée pour configurer les agents de session. Paramètres de configuration Les paramètres de configuration suiants sont disponibles pour cet agent de session : Les aleurs Nom d affichage sont affichées dans TMS, cette méthode étant recommandée pour configurer les agents de session. Voir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Les aleurs Nom sont affichées dans TealeafCaptureSocket.cfg. Tableau 28. Agent de session du routeur de session Nom d'affichage Nom Description Script d initialisation InitScript Script TCL qui initialise cet agent de session. La aleur par défaut est PipelineSplitterCFG.tcl. Keep TEMP Config KeepTEMPConfig Si la aleur de ce paramètre est true, les fichiers de configuration de pipeline temporaires sont conserés, ce qui est utile pour le débogage. La aleur par défaut est false. Pipeline (0) PipelineEx0 Ce paramètre contient la configuration de pipeline par défaut, qui enoie les hits au prochain agent de session dans le pipeline en cours. Cette configuration par défaut est la suiante : Traffic SessPct=0-100 Pipeline (1) PipelineEx1 Ce paramètre peut être utilisé pour acheminer les hits des statistiques au pipeline approprié. Le paramètre par défaut est le suiant : Traffic Stats Decouple Null Chapitre 4. Agents de session de pipeline CX 351

362 Exemple de configuration 352 IBM Tealeaf CX - Guide de configuration Exemple de section SessionRouter du fichier TealeafCaptureSocket.cfg : [SessionRouter] TypeName=SessionRouter DLL=SessionAgentPipelineSplitter.dll DownStreamConfigSection=Null InitScript=PipelineSplitterCFG.tcl KeepTEMPConfig=False PipelineEx0=Traffic SessPct=0-100 PipelineEx1=Traffic Stats Decouple Socket TeaBag0:1966 PipelineEx2=Traffic SessPct=0-50 Decouple Socket TeaBag1:1966 PipelineEx3=Traffic SessPct= Decouple Socket TeaBag2:1966 UseSSL=true L'exemple ci-dessus possède un pipeline principal (PipelineEx0) et trois pipelines enfant, l'un d'eux étant le pipeline Statut du trafic et les deux autres receant 50 % du trafic. Pipe 0 (PipelineEx0) est le pipeline principal, comme spécifié dans TealeafCaptureSocket.cfg. Normalement, Routeur de session arrie à la fin du pipeline principal, comme dans l'exemple ci-dessus, où DownStreamConfigSection pointe ers Null. Tous les autres pipelines sont considérés comme des pipelines enfant de SessionAgentSessionRouter. Le pipeline des statistiques est destiné aux hits des statistiques, qui sont acheminés ers le sereur de génération de rapports. Les deux pipelines du trafic des sessions acheminent les deux moitiés du trafic aux deux sereurs de traitement. L'agent de session Routeur de session permet de créer jusqu'à 64 pipelines enfant. Agents de session Tealeaf «Ajout d'un agent de session», à la page 237 «Agent de session Archiage», à la page 238 "Agent de session Indexation des attributs" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session Canister», à la page 249 «Agent de session Analyseur de cookie», à la page 252 «Agent de session Dépose de données», à la page 254 «Agent de session Analyseur de données», à la page 260 «Agent de session Decouple», à la page 264 «Agent de session DecoupleEx», à la page 266 «Agent de session Confidentialité étendue», à la page 275 «Agent de session Health-Based Routing (HBR)», à la page 278 «Agent de session Déploiement», à la page 285 «Agent de session Analyseur mobile JSON», à la page 289 «Agent de session Code géré», à la page 303 «Agent de session Null», à la page 306 «Agent de session Confidentialité», à la page 307 «Agent de session RTA (Real-Time Monitoring and Alert)», à la page 341

363 «Agent de session Balises de réponse pour la demande», à la page 346 «Agent de session Fractionnement RTA», à la page 348 «Agent de session de mise en sessions» Agent de session Routeur de session «Agent de session Socket», à la page 356 «Agent de session Consignateur de statistiques», à la page 358 "Agent de session de référence Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session de référence Tealeaf - Mode existant», à la page 380 «Agent de session Mise en sessions Tealeaf», à la page 384 «Agent de session TimeGrades», à la page 390 «Agent de session TLI», à la page 392 «Agent de session de décodage d'url», à la page 408 Agent de session de mise en sessions L'agent de session Mise en session utilise une zone de mémoire tampon REQ unique et applique l'algorithme de hachage MD5. A partir d'une seule zone de taille arbitraire, MD5 crée une chaîne ASCII hexadécimale de 32 octets similaire à la aleur TLTSID de la mémoire tampon REQ de 32 octets. Ajout de l'agent de session Des agents de session peuent être ajoutés ia l'éditeur de pipeline dans TMS. Voir «Ajout d'un agent de session», à la page 237. Pour plus d'informations sur l'éditeur de pipeline et TMS, oir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Le reste de cette page décrit les options de configuration et la manière de les modifier ia le fichier TealeafCaptureSocket.cfg stocké sur le sereur. Ces paramètres sont également disponibles ia l'éditeur de pipeline, cette méthode étant recommandée pour configurer les agents de session. Méthode de hachage MD5 Paramètres de configuration La configuration de MD5 comprend les paramètres suiants : Remarque : Le hachage MD5 est limité à un seul paramètre de mise en session. PrimarySessMD5=True (facultatif) PrimarySessField=JSESSIOND (requis) PrimarySessFieldMaskOFF=0 35 (facultatif) PrimaryCaseInsensitie=true (facultatif) Les paramètres de configuration suiants sont disponibles pour cet agent de session : Les aleurs Nom d affichage sont affichées dans TMS, cette méthode étant recommandée pour configurer les agents de session. Voir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Chapitre 4. Agents de session de pipeline CX 353

364 Les aleurs Nom sont affichées dans TealeafCaptureSocket.cfg. Tableau 29. Paramètres de configuration Nom d'affichage Nom Description Zone de mise en session PrimarySessField Indique la zone REQ principale à mettre en session. Cette aleur peut correspondre à n'importe quelle zone de la mémoire tampon REQ, paire nom/aleur [urlfield] ou REMOTE_ADDR dans la section [en]. Vous pouez spécifier plusieurs zones de session principales. Voir «Autres zones de mise en sessions», à la page 355. Remarque : Si cette zone est un paramètre de cookie HTTP, érifiez que ce script est configuré après CookieParser. Décalages des zones PrimarySessFieldMaskOff Permet de spécifier la aleur SessField comme une "sous-chaîne" de la zone REQ. Il s'agit d'une simple spécification des décalages de début et de fin des caractères. Ces aleurs sont généralement des entiers, mais l'utilisation du méta-paramètre end est également autorisée. Les décalages sont des aleurs basées sur des 0. Voici quelques exemples : PrimarySessFieldMaskOff=0 end (chaîne entière) PrimarySessFieldMaskOff=0 19 (20 premiers caractères) PrimarySessFieldMaskOff=14 end-4 (15e caractère jusqu'au 4e à partir de la fin) PrimarySessFieldMaskOff=end-9 end-2 (9e à partir de la fin jusqu'au 2e à partir de la fin) Section PrimarySessFieldSection Zone facultatie identifiant la section de la mémoire tampon REQ dans laquelle se troue PrimarySessField. Par défaut, la zone spécifiée par PrimarySessField est recherchée dans l'intégralité de la demande. Non sensible à la casse PrimaryCaseInsensitie S'il est défini sur true, le paramètre de mise en session peut comporter des aleurs de casse mixte. Si possible, cette option doit être éitée, dans la mesure où la correspondance insensible à la casse utilise daantage de ressources système que la correspondance sensible à la casse. Ce paramètre s'applique uniquement au nom de paramètre et non à la aleur de paramètre. 354 IBM Tealeaf CX - Guide de configuration

365 Autres zones de mise en sessions Cette fonctionnalité permet de spécifier plusieurs noms de zone pour PrimarySessField sous forme de liste délimitée par des irgules. Chaque nom de zone peut éentuellement être préfixé d'un nom de section (par exemple, cookies:sessionid). Voici un exemple : PrimarySessField=SESSIONID,SESSIONID2,cookies:OTHER_SESSIONID Remarque : Si PrimarySessFieldSection est spécifié, il s'applique à toutes les zones qui ne possèdent pas de nom de section explicite. Les aleurs PrimarySessFieldMaskOff et PrimaryCaseInsensitie s'appliquent à toutes les zones de mise en session. SASessioning recherche les zones de mise en session suiant l'ordre indiqué. Agents de session liés aux périphériques mobiles Cet agent de session peut être utilisé dans le cadre de la capture et du traitement des messages JSON soumis à partir de l'une des structures client de Tealeaf et du fractionnement de ces messages en hits distincts dans le pipeline Windows. Il s'agit de la méthode existante. Ces ersions de structure client ont été introduites dans la ersion 8.4 et remplacées par la messagerie basée sur des étapes, à partir de la ersion 8.5. Agents de session Tealeaf «Ajout d'un agent de session», à la page 237 «Agent de session Archiage», à la page 238 "Agent de session Indexation des attributs" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session Canister», à la page 249 «Agent de session Analyseur de cookie», à la page 252 «Agent de session Dépose de données», à la page 254 «Agent de session Analyseur de données», à la page 260 «Agent de session Decouple», à la page 264 «Agent de session DecoupleEx», à la page 266 «Agent de session Confidentialité étendue», à la page 275 «Agent de session Health-Based Routing (HBR)», à la page 278 «Agent de session Déploiement», à la page 285 «Agent de session Analyseur mobile JSON», à la page 289 «Agent de session Code géré», à la page 303 «Agent de session Null», à la page 306 «Agent de session Confidentialité», à la page 307 «Agent de session RTA (Real-Time Monitoring and Alert)», à la page 341 «Agent de session Balises de réponse pour la demande», à la page 346 «Agent de session Fractionnement RTA», à la page 348 Agent de session de mise en sessions «Agent de session Routeur de session», à la page 350 Chapitre 4. Agents de session de pipeline CX 355

366 «Agent de session Socket» «Agent de session Consignateur de statistiques», à la page 358 "Agent de session de référence Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session de référence Tealeaf - Mode existant», à la page 380 «Agent de session Mise en sessions Tealeaf», à la page 384 «Agent de session TimeGrades», à la page 390 «Agent de session TLI», à la page 392 «Agent de session de décodage d'url», à la page 408 Agent de session Socket L'agent de session Socket transfère les données capturées ers un autre ordinateur ia un réseau TCP/IP, tel qu'un sereur à l'intérieur d'un pare-feu. Remarque : S'il est actié, l'agent de session Socket représente la fin du pipeline ; l'option -DownStreamConfigSection n'est donc pas requise. Ajout de l'agent de session Des agents de session peuent être ajoutés ia l'éditeur de pipeline dans TMS. Voir «Ajout d'un agent de session», à la page 237. Pour plus d'informations sur l'éditeur de pipeline et TMS, oir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Le reste de cette page décrit les options de configuration et la manière de les modifier ia le fichier TealeafCaptureSocket.cfg stocké sur le sereur. Ces paramètres sont également disponibles ia l'éditeur de pipeline, cette méthode étant recommandée pour configurer les agents de session. Paramètres de configuration Les paramètres de configuration suiants sont disponibles pour cet agent de session : Les aleurs Nom d affichage sont affichées dans TMS, cette méthode étant recommandée pour configurer les agents de session. Voir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Les aleurs Nom sont affichées dans TealeafCaptureSocket.cfg. Tableau 30. Agent de session Socket Nom d'affichage Nom Description Sereur Serer Indique le nom ou l'adresse IP numérique de la machine éloignée à laquelle les données capturées sont enoyées. Port Port Indique le numéro de port IP du réseau à utiliser pour le transfert des données. 356 IBM Tealeaf CX - Guide de configuration

367 Tableau 30. Agent de session Socket (suite) Nom d'affichage Utiliser SSL Nom UseSSL Description Indique si une connexion SSL doit être utilisée pour transférer les données capturées ers le sereur. Remarque : Le port spécifié sur le sereur doit être configuré pour SSL pour que cette option puisse être utilisée. Agents de session Tealeaf «Ajout d'un agent de session», à la page 237 «Agent de session Archiage», à la page 238 "Agent de session Indexation des attributs" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session Canister», à la page 249 «Agent de session Analyseur de cookie», à la page 252 «Agent de session Dépose de données», à la page 254 «Agent de session Analyseur de données», à la page 260 «Agent de session Decouple», à la page 264 «Agent de session DecoupleEx», à la page 266 «Agent de session Confidentialité étendue», à la page 275 «Agent de session Health-Based Routing (HBR)», à la page 278 «Agent de session Déploiement», à la page 285 «Agent de session Analyseur mobile JSON», à la page 289 «Agent de session Code géré», à la page 303 «Agent de session Null», à la page 306 «Agent de session Confidentialité», à la page 307 «Agent de session RTA (Real-Time Monitoring and Alert)», à la page 341 «Agent de session Balises de réponse pour la demande», à la page 346 «Agent de session Fractionnement RTA», à la page 348 «Agent de session de mise en sessions», à la page 353 «Agent de session Routeur de session», à la page 350 Agent de session Socket «Agent de session Consignateur de statistiques», à la page 358 "Agent de session de référence Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session de référence Tealeaf - Mode existant», à la page 380 «Agent de session Mise en sessions Tealeaf», à la page 384 «Agent de session TimeGrades», à la page 390 «Agent de session TLI», à la page 392 «Agent de session de décodage d'url», à la page 408 Chapitre 4. Agents de session de pipeline CX 357

368 Agent de session Consignateur de statistiques L'agent de session Consignateur de statistiques est un agent de session de pipeline final qui permet de transmettre des statistiques sur les composants Tealeaf pour les consigner dans la base de données STATISTICS. Les composants Tealeaf tels qu'ibm Tealeaf CX Passie Capture Application et l'agent de session DecoupleEx peuent insérer des hits dans le pipeline, qui contiennent des statistiques sur les opérations du composant. Si l'agent de session Consignateur de statistiques est actié, ces hits de statistiques sont assemblés pour être insérés dans la base de données STATISTICS. Remarque : L'agent de session Consignateur de statistiques utilise le compte TLUSER pour se connecter à la base de données TL_STATISTICS. Ce compte utilisateur de base de données doit disposer de droits de lecture/d'écriture sur la base de données. Voir "Administration du sereur SQL" dans le Guide des bases de données IBM Tealeaf. Les résultats de ces journaux de statistiques assemblées peuent être examinés dans des graphiques et rapports par l'intermédiaire du portail Tealeaf. Pour afficher les statistiques des composants, sélectionnez Tealeaf > Statistiques système dans le portail Tealeaf. Sélectionnez les composants Tealeaf. Sélectionnez la date, l'heure, les composants et le rapport à générer. Voir "Statistiques système" dans le document IBM Tealeaf cximpact - Guide d'administration. Ajout de l'agent de session Des agents de session peuent être ajoutés ia l'éditeur de pipeline dans TMS. Voir «Ajout d'un agent de session», à la page 237. Pour plus d'informations sur l'éditeur de pipeline et TMS, oir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Le reste de cette page décrit les options de configuration et la manière de les modifier ia le fichier TealeafCaptureSocket.cfg stocké sur le sereur. Ces paramètres sont également disponibles ia l'éditeur de pipeline, cette méthode étant recommandée pour configurer les agents de session. Paramètres de configuration Remarque : Lors de l'installation, le programme d'installation de Tealeaf ous inite à entrer les informations sur le sereur et à préciser si le consignateur de statistiques doit être actié. Si ous l'aez actié lors de l'installation, ous n'aez pas besoin de modifier de paramètres. Il est recommandé d'accepter les aleurs par défaut. Les paramètres de configuration suiants sont disponibles pour l'agent de session : Les aleurs Nom d affichage sont affichées dans TMS, cette méthode étant recommandée pour configurer les agents de session. Voir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Les aleurs Nom sont affichées dans TealeafCaptureSocket.cfg. 358 IBM Tealeaf CX - Guide de configuration

369 Tableau 31. Agent de session Consignateur de statistiques Afficher nom Fichier journal Nieau de journal Pass Through SQL Retry Interal Nom LogFile LogLeel PassThrough SQLRetryTimeMins Description Fichier journal de l'agent de session, par rapport au répertoire d'installation de Tealeaf. La aleur par défaut est managed\ StatsDebug.log. Nieau de consignation des messages de journal. Les aleurs acceptées sont les suiantes : Erreur : ne signale que les erreurs Aertissement : signale les erreurs et les aertissements Info : signale les erreurs, les aertissements et les messages d'information (aleur par défaut) Trace : signale les messages ci-dessus, plus des informations supplémentaires pour le traçage Débogage : signale la quantité maximale d'informations Remarque : Le nieau de consignation Débogage ne doit être actié que si ous déboguez des problèmes. Une fois que ous aez terminé le débogage, n'oubliez pas de réinitialiser le nieau de consignation. Si la aleur est YES, l'application de consignation des statistiques ne représente pas la destination final des hits dans le pipeline. Au lieu de supprimer les hits des statistiques, DownStreamConfigSection peut être utilisé pour définir des agents de session supplémentaires, y compris l'agent de session Canister ou d'autres destinations, où sont stockées les données des hits non liés aux isiteurs. La aleur par défaut est NO. Délai des tentaties de restauration d'une connexion SQL perdue. Le délai minimal accepté est de 1 minute ; il n'existe pas de limite supérieure. La aleur par défaut est 5. Agents de session Tealeaf «Ajout d'un agent de session», à la page 237 «Agent de session Archiage», à la page 238 "Agent de session Indexation des attributs" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session Canister», à la page 249 «Agent de session Analyseur de cookie», à la page 252 Chapitre 4. Agents de session de pipeline CX 359

370 «Agent de session Dépose de données», à la page 254 «Agent de session Analyseur de données», à la page 260 «Agent de session Decouple», à la page 264 «Agent de session DecoupleEx», à la page 266 «Agent de session Confidentialité étendue», à la page 275 «Agent de session Health-Based Routing (HBR)», à la page 278 «Agent de session Déploiement», à la page 285 «Agent de session Analyseur mobile JSON», à la page 289 «Agent de session Code géré», à la page 303 «Agent de session Null», à la page 306 «Agent de session Confidentialité», à la page 307 «Agent de session RTA (Real-Time Monitoring and Alert)», à la page 341 «Agent de session Balises de réponse pour la demande», à la page 346 «Agent de session Fractionnement RTA», à la page 348 «Agent de session de mise en sessions», à la page 353 «Agent de session Routeur de session», à la page 350 «Agent de session Socket», à la page 356 Agent de session Consignateur de statistiques "Agent de session de référence Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session de référence Tealeaf - Mode existant», à la page 380 «Agent de session Mise en sessions Tealeaf», à la page 384 «Agent de session TimeGrades», à la page 390 «Agent de session TLI», à la page 392 «Agent de session de décodage d'url», à la page 408 Agent de session de référence Tealeaf L'agent de session de référence Tealeaf est déployé dans le pipeline Windows pour détecter des données dimensionnelles spécifiques et les capturer pour que Tealeaf puisse les utiliser. Cet agent de session peut être utilisé pour les actiités suiantes : Détection des agents utilisateur : l'agent de session de référence Tealeaf peut détecter le type d'agent utilisateur, le naigateur et le système d'exploitation utilisés par os isiteurs. Pour plus d'informations, oir «Analyse étendue des agents utilisateur», à la page 364. Analyse et préfixage des référents : l'agent de session de référence Tealeaf peut être configuré afin de normaliser les aleurs des référents en paires nom/aleur pour une analyse plus simple et peut préfixer ces aleurs aec une chaîne configurée pour éliminer les conflits potentiels aec les autres aleurs d'url. Voir «Analyse de référent», à la page 364. Références de capture : la fonctionnalité UI Capture de Tealeaf peut être déployée pour capturer les éénements côté client et autres données, y compris les aleurs de référence. Ces aleurs sont détectées par l'agent de session de référence Tealeaf. Voir «Références Client-Side Capture», à la page 361. Remarque : Pour certains déploiements du sereur de traitement, cet agent de session est inclus dans le pipeline par défaut et est requis. Voir "Configuration du pipeline CX" dans le document IBM Tealeaf CX - Guide de configuration. 360 IBM Tealeaf CX - Guide de configuration

371 Tutoriel Pour plus d'informations sur la manière dont les informations sur les agents utilisateur sont utilisées dans Tealeaf et notamment sur les étapes permettant de configurer les objets d'éénement pour rechercher les informations sur les agents utilisateur, oir "Scénario E2E - Suii des informations d'agent d'utilisateur dans Tealeaf" dans le document IBM Tealeaf cximpact - Guide d'utilisation. Ajout de l'agent de session Remarque : Cet agent de session est ajouté au pipeline par défaut sur chaque Canister. Il doit être présent dans tout pipeline qui traite les hits de session. Des agents de session peuent être ajoutés ia l'éditeur de pipeline dans TMS. Voir "Ajout d'un agent de session" dans le document IBM Tealeaf CX - Guide de configuration. Pour plus d'informations sur l'éditeur de pipeline et TMS, oir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Le reste de cette page décrit les options de configuration et la manière de les modifier ia le fichier TealeafCaptureSocket.cfg stocké sur le sereur. Ces paramètres sont également disponibles ia l'éditeur de pipeline, cette méthode étant recommandée pour configurer les agents de session. Références Client-Side Capture : L'agent de session de référence Tealeaf ajoute les aleurs TLT_CUI_URL et TLT_CUI_APPLICATION_NAME à la mémoire tampon des demandes pour rechercher les URL et noms d'application à partir desquels les éénements capturés de l'interface graphique du client sont en fait générés. Ces aleurs sont générées si IBM Tealeaf CX UI Capture for AJAX a été acheté sous licence et déployé dans otre enironnement pour capturer les éénements de l'interface graphique qui se produisent dans le naigateur du isiteur. Pour plus d'informations, Contactez otre interlocuteur IBM Tealeaf. Pour plus d'informations sur IBM Tealeaf CX UI Capture for AJAX, oir "Foire aux questions UI Capture" dans la Foire aux questions d'ibm Tealeaf UI Capture for AJAX. Ces aleurs sont générées comme des aleurs de référence normales, mais elles risquent de ne pas correspondre à celles des membres normaux. Les membres normaux représentent la page parent à partir de laquelle les éénements AJAX côté client ont été lancés. L'éénement enfant pouant être enoyé à toute page, sa aleur risque de ne pas correspondre à la page parent. TLT_CUI_URL est présenté comme une aleur normalisée pour l'url côté client. Si l'agent de session est configuré de sorte à surcharger la zone d'application, TLT_CUI_APPLICATION_NAME peut être utilisé de manière différente. Voir «Surcharge et UI Capture», à la page 374. L'agent de session de référence Tealeaf ajoute également les aleurs TLT_CUI_URL_ID et TLT_CUI_APPLICATION_NAME_ID à la mémoire tampon des demandes, ce qui permet le couplage des données des demandes AJAX et des pages parent à partir desquelles elles sont lancées. Elles suient le même schéma que les ID TLT standard. Toutes leurs informations proiennent des mêmes fichiers de référence et peuent être manipulées et étendues de la même manière. Chapitre 4. Agents de session de pipeline CX 361

372 Valeurs de référence des chemins Détermination des aleurs des chemins : La dimension la plus difficile à rendre significatie est la dimension Chemin, qui contient des informations d'url. Les technologies de génération de contenu dynamique peuent serir des contenus de page différents en réponse aux demandes d'un chemin donné. Par conséquent, les URL ne peuent différer que dans leur chaîne de requête, données POST ou autre contenu de demande HTTP. Le chemin correspond à tous les caractères de l'url, du premier / après l'identificateur de l'hôte au caractère qui précède le premier?, si ce caractère est présent. Les éléments suiants ne font pas partie du chemin : Identificateur du protocole : Hôte : (par exemple, Port : (par exemple, :80) La aleur de la dimension de référence Chemin peut être définie par l'agent de session de référence Tealeaf ou par tout autre agent de pipeline qui le précède. L'agent de session fournit les trois méthodes suiantes pour définir cette ariable : Simple, Mappage et Programmation. Simple Dans le cas Simple, les érifications de l'extension de nom de fichier et du code de statut HTTP effectuées par l'agent de session de référence Tealeaf suffisent à limiter ou déterminer les aleurs de chemin irtuel. Ce cas implique les conditions suiantes : L'URL ne contient pas d'identificateurs de session ou de hit distincts. Elle ne contient pas d'informations d'état. Les chemins se terminent par des extensions de nom de fichier Le logiciel du site Web est homogène sur tous les sereurs. Les noms de page par défaut (par exemple, index.html ou default.asp) des URL qui se terminent par / sont identiques pour tous les sereurs Web. Mappage La technique de mappage peut être utilisée pour les cas suiants : Le chemin de plusieurs pages peut souent être le même (par exemple, /page.cgi ou /ISAPI.dll), mais une ou deux chaînes de requête ou autres ariables de demande peuent distinguer les pages les unes des autres. Par exemple, un code peut être imbriqué dans la chaîne de requête pour distinguer les pages serant à l'application Web (par exemple, la aleur catid 700 dans /page.asp?catid=700 correspond à la page Vue Produit). L'algorithme de "page par défaut" de l'agent de session pour les répertoires irtuels (par exemple, URL=/ ou URL=/somedir/) utilise le fichier de configuration de mappage pour définir la aleur TLT_URL. Le fichier de mappage contient une entrée initiale créée lors de la procédure d'installation. Par exemple : # TLT_URL URL ReqVar1 ReqVar2 /default.asp / Cet exemple de configuration affecte TLT_URL=/default.asp dans la section [appdata] si / est la aleur de la ariable d'url dans la demande Tealeaf. 362 IBM Tealeaf CX - Guide de configuration

373 Les masques de début de répertoire irtuel déterminent la alidité des chemins. Tous les chemins qui respectent un masque de début spécifié sont inclus (par exemple, tous les chemins commençant par /serer/ ou /support/customers/). Cette méthode est plus ouerte que la première méthode de mappage et permet d'accepter daantage de aleurs de chemin indésirables. Programmation La programmation sous forme de règles RTA ou d'un agent de pipeline personnalisé, à l'aide d'agents de session TCL ou Code géré, est requise pour les cas qui ne peuent pas être traités par les techniques Simple ou Mappage. Par exemple, si la aleur d'url contient un type d'état d'application ou d'informations de suii qui doit être exclu afin de générer une aleur correcte pour TLT_URL, la aleur TLT_URL doit être définie ia un agent de pipeline personnalisé en amont de l'agent de session de référence Tealeaf. Remarque : Tel qu'il est effectué par DoubleClick ou Coremetrics par exemple, le marquage de page ne peut pas être géré natiement comme source par l'agent de session pour la aleur de TLT_URL. Vous deez créer un agent de pipeline personnalisé et l'appliquer aant l'agent de session. Ordre de priorité des méthodes de traitement des chemins La priorité de traitement des URL est la suiante : URLReferenceRules URLReferenceVirtualDir NormalizeURLExt et NormalizeURLStatusCode Si URLReferenceRulesMode est défini sur STOP, la méthode 3 n'est pas utilisée pour alider l'url et l'agent de session de référence Tealeaf procède à une interprétation stricte de l'url. Si le mode est CONT, une combinaison de règles et de tests de code de statut et d'extension de nom de fichier peut être utilisée. Par exemple, les méthodes 1 et 3 pourraient être combinées pour un site contenant plusieurs noms de répertoires irtuels possibles, sans doute car les sereurs Web sont un mélange hétérogène de sereurs IIS et J2EE. Utilisez l'étape 1 pour déterminer le nom de fichier par défaut des répertoires irtuels. Pour tous les autres types d'url, utilisez les règles d'extension/de code de statut normales. Exemple : #TLT_URL URL ReqVar1 ReqVar2 /default.asp / IISSESSIONID /page.jhtml / JSESSIONID Dimensions olumineuses : Les aleurs de chemin sont utilisées pour alimenter la dimension d'url fournie par Tealeaf. Suiant la manière dont cette dimension est configurée, otre base de données peut croître sans limite. La gestion des données des dimensions est particulièrement importante pour les dimensions qui capturent un grand olume de aleurs, telles que les URL. L'implémentation d'instructions spécifiques permettant de gérer les URL et autres dimensions olumineuses peut permettre d'empêcher une croissance effrénée de la base de données. Chapitre 4. Agents de session de pipeline CX 363

374 Voir "Gestion des URL et autres dimensions olumineuses" dans le document IBM Tealeaf Eent Manager - Guide. Options d'analyse syntaxique de référence supplémentaires Analyse de référent : L'agent de session de référence Tealeaf peut analyser la aleur HTTP_REFERER dans la mémoire tampon REQ en un ensemble de paires nom/aleur plus accessible. Etudiez l'exemple de paire nom/aleur suiant : HTTP_REFERER=[ page.html?id=1234&req=25&page_id=2] La section [referrer] de la mémoire tampon REQ doit se présenter comme suit : [referrer] REFERRER_DOMAIN=yourdomain.com REFERRER_FILEPATH=/parent/first_child/second_child/page.html req=25 page_id=2 id=1234 Cette configuration permet à Tealeaf de générer des éénements sur des aleurs dans certaines URL de référent de otre choix et de collecter des données sur ces aleurs. Premier hit : le référent analysé à partir du premier hit d'une session est utilisé comme entrée pour l'attribut de session qui recherche les aleurs de référent. Cette aleur correspond au référent de la session. Chaque hit : l'agent de session de référence Tealeaf détecte également la aleur du référent pour chaque hit de la session. Pour actier l'analyse du référent dans l'agent de session de référence Tealeaf, spécifiez ReferrerParsing=True dans la configuration de l'agent de session ia TMS. Remarque : Si ReferrerParsing n'est pas actié, le masque Domaine référent fourni par Tealeaf ne capture pas de données. Préfixation du référent : Pour éliminer les conflits potentiels entre les référents et les zones d'url, ous pouez préfixer les aleurs de la section Referrer en ajoutant la propriété de configuration suiante à la configuration de l'agent de session de référence Tealeaf : ReferrerPrepend=MY_PREPEND_ Remarque : Pour pouoir préfixer les référents, l'analyse des référents doit être actiée (ReferrerParsing=True). Lorsque la préfixation des référents est actiée, un exemple de sortie dans la section [Referrer] de la demande peut se présenter comme suit : [Referrer] MY_PREPEND_REFERRER_DOMAIN=somewhere.somplace.com MY_PREPEND_REFERRER_FILEPATH=/testytime/testytime2/file.dll Analyse étendue des agents utilisateur : L'agent de session de référence Tealeaf gère la détection et l'alimentation des informations sur les agents utilisateur extraites de la mémoire tampon des demandes. Lorsqu'un utilisateur soumet une demande à l'application Web, les informations sur le naigateur, le système d'exploitation et le type d'application du isiteur (mobile, bureau, BOT) sont incluses dans la demande. 364 IBM Tealeaf CX - Guide de configuration

375 Ces informations sont comparées à un ensemble de normes gérées de manière publique et remplacent celles que ous définissez pour déterminer si les informations sur les agents utilisateur soumises correspondent à des agents utilisateur connus. Au départ, l'agent de session de référence Tealeaf examine un cache à élagage automatique qu'il consere en mémoire pour accélérer l'accès aux aleurs courantes les plus souent détectées. Voir «Optimisation du cache à élagage automatique», à la page 368. Si aucune correspondance n'est trouée, l'agent de session examine les autres ressources de fichier pour y rechercher des correspondances. Voir «Ordre d'éaluation de l'analyse étendue des agents utilisateur», à la page 366. Remarque : Par défaut, l'analyse des agents utilisateur est actiée pour les nouelles installations et les mises à nieau. Le mode existant doit être actié séparément. Voir «Mode existant pour l'analyse des agents utilisateur», à la page 373. Exemple de sortie : Supposons que la paire nom/aleur d'agent utilisateur suiante soit détectée dans la demande : HTTP_USER_AGENT=Mozilla/5.0 (Windows; U; Windows NT 5.1; en-us; r: ) Gecko/ Firefox/ (.NET CLR ) Si l'agent utilisateur ci-dessus est détecté, l'agent de session effectue des recherches pour renoyer les aleurs associées à cet agent utilisateur à partir des normes publiques. Ces aleurs sont insérées comme paires nom/aleur dans la demande : [ExtendedUserAgent] TLT_BROWSER=Firefox TLT_BROWSER_VERSION=Firefox3.6 TLT_BROWSER_PLATFORM=Win XP TLT_TRAFFIC_TYPE=BROWSER TLT_BROWSER_JAVASCRIPT=true TLT_BROWSER_COOKIES=true Si TLT_TRAFFIC_TYPE=MOBILE, les zones suiantes peuent être insérées et renseignées pour l'agent utilisateur mobile : TLT_SCREEN_HEIGHT TLT_SCREEN_WIDTH TLT_COLOR_DEPTH TLT_PICTURE_SUPPORT TLT_VIDEO_SUPPORT TLT_STREAMING_SUPPORT En outre, si la consignation de l'agent utilisateur est actiée, les entrées suiantes peuent apparaître dans la section [UALog] insérée dans la demande : [UALog] Retriee From Cache took 9.029e-005 seconds Checking TLT_USER_CAP Selected class User Agent Parsing::Firefox User Agent Matcher User Agent Parsing::Wurfl Data Manager::Apply Exact Match m_user Agent Map.find took seconds User Agent Parsing::Wurfl Data Manager::Apply Exact Match took seconds User Agent Parsing::Browscap Data Manager::Apply Exact Match m_exact Search Map.find took seconds Regex match: Mozilla/5\.0\s+\(Windows;\s+.*;\s+Windows\s+NT\ s+5\.1;\s+.*;\s+r:1\.9\.2.*\) \s+gecko/.*\s+firefox/3\.6.* m_regex Search Map lookup took seconds User Agent Parsing::Browscap Data Manager::Apply Exact Match Chapitre 4. Agents de session de pipeline CX 365

376 took seconds User Agent Parsing::Filter::Get Data Node took seconds GJK_Browscap_Version GJK_Browscap_Version 4566 Thu, 28 Oct :52: Ordre d'éaluation de l'analyse étendue des agents utilisateur : Lorsque l'agent de session de référence Tealeaf détecte une aleur dans la ariable de demande HTTP_USER_AGENT, cette aleur est éaluée à l'aide des étapes ci-après, dans l'ordre indiqué. Tableau 32. Ordre d'éaluation de l'analyse étendue des agents utilisateur Ordre Nom du fichier Description d'éaluation 1 aleurs spéciales non alides Si HTTP_USER_AGENT contient des aleurs ides ou des espaces, des aleurs spéciales sont insérées dans les attributs appropriés. Voir «Valeurs d'agent d'utilisateur ides», à la page cache en mémoire La érification de la aleur est effectuée dans le cache en mémoire géré par l'agent de session. Voir «Optimisation du cache à élagage automatique», à la page UserCap.cs Les aleurs définies par l'utilisateur qui remplacent les aleurs des normes publiques (WURFL.cs et BrowsCap.cs) sont spécifiées dans ce fichier, qui est érifié aant les normes publiques. UserCap.cs peut être utilisé pour insérer des aleurs non présentes dans les normes publiques. Ces correspondances sont identifiées à l'aide des DLL UAMatchers. Voir «Plug-ins UAMatchers», à la page WURFL.cs Norme publique des périphériques mobiles. Ce fichier doit être téléchargé et conerti à partir de son XML natif pour être utilisé par l'agent de session. Lors de la conersion, ous pouez éentuellement inclure l'utilisation de aleurs génériques dans otre fichier WURFL conerti. Voir «Utilisation de génériques», à la page 369. Ces correspondances sont identifiées à l'aide des DLL UAMatchers. Voir «Plug-ins UAMatchers», à la page 371. Voir "Outils de l'agent d'utilisateur" dans le document IBM Tealeaf cximpact - Guide d'administration. 366 IBM Tealeaf CX - Guide de configuration

377 Tableau 32. Ordre d'éaluation de l'analyse étendue des agents utilisateur (suite) Ordre Nom du fichier Description d'éaluation 5 application natie mobile Pour les applications naties mobiles sureillées par Tealeaf, les informations sur les agents utilisateur sont automatiquement soumises par la structure client Tealeaf qui sureille l'application. Ces informations sont utilisées pour alimenter les propriétés standard de l'analyse étendue des agents utilisateur. Voir «Analyse étendue des agents utilisateur pour les applications naties mobiles», à la page BrowsCap.cs Norme publique des agents utilisateur fixes et bot. Ce fichier doit être conerti à partir de son format natif pour être utilisé par l'agent de session. Des génériques sont automatiquement inclus dans la ersion conertie de BrowsCap.cs. Voir «Utilisation de génériques», à la page 369. Voir "Outils de l'agent d'utilisateur" dans le document IBM Tealeaf cximpact - Guide d'administration. 7 UserSupplement.cs Si aucune correspondance n'est trouée dans l'un des fichiers ci-dessus, l'agent de session érifie le fichier UserSupplement.cs, qui peut être utilisé pour ajouter les agents utilisateur qui ne sont pas actuellement répertoriés dans la norme publique et qui apparaissent dans otre flux de capture. Valeurs d'agent d'utilisateur ides Si la aleur de HTTP_USER_AGENT est une aleur indétectable, les aleurs suiantes sont insérées dans les attributs appropriés : Tableau 33. Attribut de hit BrowserType : Valeur détectée Attribut Valeur insérée "" BrowserType UserAgentBlank whitespace BrowserType UserAgentBlank HTTP_USER_AGENT introuable dans la demande BrowserType UserAgentNotFound Chapitre 4. Agents de session de pipeline CX 367

378 Tableau 34. Attribut de hit TrafficType : Valeur détectée Attribut Valeur insérée "" TrafficType UserAgentHeaderIsBlank whitespace TrafficType UserAgentBlank HTTP_USER_AGENT introuable dans la demande TrafficType NoUserAgentHeaderFound Pour rechercher les aleurs TrafficType : Sessions acties : recherchez TLT_TRAFFIC_TYPE=<Inserted Value> dans le texte de la demande. Sessions terminées : Créez un éénement pour enregistrer la aleur de l'attribut de hit Type de trafic. Voir "Onglet Eénements TEM" dans le document IBM Tealeaf Eent Manager - Guide. Créez une règle de confidentialité pour déplacer la ariable et aleur de demande TLT_TRAFFIC_TYPE dans la section [appdata]. Voir "Agent de session Confidentialité" dans le document IBM Tealeaf CX - Guide de configuration. Pour plus d'informations sur la recherche, oir "Recherche dans les données de session" dans IBM Tealeaf cximpact - Guide d'utilisation. Optimisation du cache à élagage automatique : Suiant le olume de trafic et la diersité du trafic ers otre site Web, il se peut que ous deiez adapter les paramètres du cache à élagage automatique. La recherche d'une aleur appropriée pour ces deux paramètres est primordiale pour des performances optimales de otre pipeline si l'analyse étendue des agents utilisateur est utilisée. Interalle d'élagage Vous pouez définir l'interalle auquel le cache à élagage automatique est mis à jour pour refléter les tous derniers agents utilisateur détectés. Le paramètre PruningInteral représente le nombre de secondes entre les mises à jour. Ajustez ce paramètre après l'analyse étendue des agents utilisateur. En modifiant la aleur PruningInteral du cache, ous affectez la probabilité de suppression d'un agent utilisateur du cache pour inactiité. Si cette aleur est éleée, un agent utilisateur peut rester un long moment dans le cache aant d'être supprimé. Si elle est faible, l'agent utilisateur doit être u fréquemment, faute de quoi, il risque d'être supprimé. taille maximale du cache Le paramètre MaxCacheSize représente le nombre maximal d'entrées dans le cache. Ajustez ce paramètre après l'analyse étendue des agents utilisateur. Pour les sites Web possédant un ensemble principal d'agents utilisateur, le cache doit fonctionner correctement aec un paramètre MaxCacheSize de taille relatiement faible. Spécifiez la aleur Cela signifie en fait que le nombre d'agents utilisateur différents stockés pour une recherche rapide peut atteindre IBM Tealeaf CX - Guide de configuration

379 Si ous constater un spoulage dû au cache des agents utilisateur, l'augmentation de la aleur MaxCacheSize diminue la probabilité qu'une chaîne d'agent utilisateur entrante ne se troue pas déjà en cache. L'augmentation de cette aleur consomme également daantage de mémoire car une quantité de données plus importante doit être stockée. Utilisation de génériques : Les normes publiques utilisées pour l'analyse étendue des agents utilisateur peut contenir des aleurs génériques pour les agents utilisateur. Par exemple, si la chaîne d'agent utilisateur iphone 10 est détectée dans le flux de capture et qu'il n'existe pas de correspondance exacte dans la norme publique, une chaîne d'agent utilisateur générique (iphone) peut être insérée, si la norme publique contient une entrée générique. BrowsCap.cs : pour les agents utilisateur fixes, l'utilisation de génériques est automatiquement actiée et ne peut pas être configurée. WURFL.cs : pour les agents utilisateur mobiles, l'utilisation de génériques est actiée par défaut lorsque la norme publique est conertie pour être utilisée dans Tealeaf. Voir "Outils de l'agent d'utilisateur" dans le document IBM Tealeaf cximpact - Guide d'administration. L'actiation des génériques est utile pour capturer dans certains formulaires les nouelles ersions des agents utilisateur qui n'ont pas encore été insérées dans les normes publiques. Lorsque les normes publiques sont mises à jour, les entrées de ces agents utilisateur doient correspondre sur la norme publique sans modifications de la configuration. Voir «Ordre d'éaluation de l'analyse étendue des agents utilisateur», à la page 366. Chemins à ignorer : Vous pouez éentuellement configurer l'analyse étendue des agents utilisateur pour qu'elle traite les URL spécifiées déclenchées par des agents utilisateur spécifiques afin qu'elles soient marquées comme type de trafic différent. Supposons par exemple que pour l'agent utilisateur Jakarta, la isite d'une page autre que /MyXMLSerice.aspx indique que l'agent utilisateur est un moteur de recherche, tandis que les isites de la page /MyXMLSerice.aspx indiquent que l'agent utilisateur n'est pas un robot. En indiquant que ce chemin doit être ignoré lors d'une analyse normale des agents utilisateur, ous pouez spécifier la aleur de type de trafic appropriée pour l'exception "non robot" (TrafficType=XMLSericeConsumer). Pour spécifier les chemins à ignorer, effectuez les étapes ci-après. 1. Connectez-ous au portail Tealeaf en tant qu'administrateur. 2. Dans le menu Portail, sélectionnez Tealeaf > TMS. Tealeaf Management System s'affiche. Voir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. 3. Cliquez sur l'onglet WorldView. 4. Dans la liste déroulante Sereurs, sélectionnez le sereur qui héberge le pipeline de capture où l'agent de session de référence Tealeaf est déployé. 5. Cliquez sur le noeud Serice de transport. 6. Sélectionnez Configuration du serice de transport. 7. Dans le panneau Actions de configuration, cliquez sur Afficher/Modifier (Brut). 8. La ersion brute du fichier TealeafCaptureSocket.cfg est affichée. Vous pouez choisir de copier et coller ce contenu dans l'éditeur de texte de otre choix pour l'éditer. Chapitre 4. Agents de session de pipeline CX 369

380 9. Dans ce fichier, recherchez la section [TLTRef]. 10. Recherchez les paramètres de configuration ci-après dans la section [TLTRef]. S'ils ne s'y trouent pas, insérez-les. PathsToSkip=^MyPath*$;^YourPath*$ TrafficTypeForSkippedPaths=XMLSerice BrowserForSkippedPaths=XMLSericeConsumer où Paramètre Description PathsToSkip Entrez une liste de chemins d'accès, délimités par des points-irgules (;). Vous pouez entrer des expressions régulières. Par exemple, ous pouez entrer la aleur ^MyPath*$ pour rechercher tous les chemins contenant la sous-chaîne MyPath. Pour plus d'informations sur les expressions régulières, oir «Expressions régulières dans l'analyse étendue des agents utilisateur». TrafficTypeForSkippedPaths Pour les chemins correspondant à une aleur spécifiée dans PathsToSkip, ce interne identifie la aleur à insérer dans l'objet Type de trafic. Voir "Configuration des éénements d'agents d'utilisateur" dans le document IBM Tealeaf cximpact - Guide d'administration. BrowserForSkippedPaths Pour les chemins correspondant à une aleur spécifiée dans PathsToSkip, ce interne identifie la aleur à insérer dans l'objet Type de naigateur. Voir "Configuration des éénements d'agents d'utilisateur" dans le document IBM Tealeaf cximpact - Guide d'administration. 11. Pour sauegarder os modifications, cliquez sur Sauegarder. 12. Pour enoyer la modification aux autres Canisters de otre enironnement, cliquez sur Ajouter des tâches et les soumettre. Expressions régulières dans l'analyse étendue des agents utilisateur : Vous pouez utiliser des expressions régulières dans les aleurs que ous définissez dans la configuration de l'analyse des agents utilisateur. Vous trouerez ci-dessous des exceptions à l'implémentation standard des expressions standard : Caractère Utilisation * Caractère générique? Caractère générique. Littéral de chaîne. Apparaît fréquemment dans les définitions d'agent utilisateur. ( Littéral de chaîne. Apparaît fréquemment dans les définitions d'agent utilisateur. ) Littéral de chaîne. Apparaît fréquemment dans les définitions d'agent utilisateur. Caractère d'espacement Traité comme un espace 370 IBM Tealeaf CX - Guide de configuration

381 Remarque : En raison des exceptions ci-dessus et de certaines autres différences, les implémentations des expressions régulières pour cet agent de session et IBM Tealeaf CX RealiTea Viewer diffèrent. Voir "Expressions régulières dans RealiTea Viewer" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Vous trouerez ci-dessous des exemples et la manière dont ils correspondent aux aleurs de l'analyse des agents utilisateur. Masque d'expression régulière Correspondances ^IP$ S.P S?P S*P IP SHIP SHIPS SP SIP SIT UP SIP SAP SOP SIP SAP STOP Plug-ins UAMatchers : La correspondance entre les aleurs détectées et l'ensemble des aleurs d'agent utilisateur disponible est gérée par plug-in. Pour chaque type majeur d'agent utilisateur, Tealeaf fournit un fichier.dll distinct qui effectue l'analyse correspondante. Remarque : Les plug-ins UAMatchers sont fournis par Tealeaf. Les clients ne peuent pas créer leurs propres plug-ins à ce stade. Remarque : Si les données des agents utilisateur ne sont pas disponibles dans les fichiers de définition standard publics, un plug-in UAMatcher peut étendre les informations d'agent utilisateur enregistrées dans la session aec des informations supplémentaires, telles que la ersion ou la plateforme du naigateur, lues directement dans la chaîne d'agent utilisateur fournie dans la demande d'origine. Actuellement, la norme Browscap ne fait pas de différence entre la plateforme WinXP 64 bits et la plateforme Windows Serer bits, car les chaînes d'agent utilisateur de ces deux plateformes s'auto-identifient comme plateforme Windows NT 5.2. Par défaut, Browscap identifie cette chaîne d'agent utilisateur comme une machine Windows XP 64 bits. Les plug-ins UAMatchers sont stockés dans le répertoire ci-après. Remarque : Ne déplacez pas, ne renommez pas et ne modifiez pas ces fichiers. <répertoire_installation_tealeaf>\system\uamatchers Analyse étendue des agents utilisateur pour les applications naties mobiles : Les applications mobiles indiiduelles enoient généralement une chaîne d'agent utilisateur unique non connue des référentiels publics, mais elles peuent également ne pas enoyer d'agent utilisateur du tout. Par conséquent, la détection Chapitre 4. Agents de session de pipeline CX 371

382 des agents utilisateur pour les applications naties mobiles ne peut pas s'appuyer sur WURFL, Browscap ou d'autres normes publiques. Pour actier le suii des informations liées aux agents utilisateur, les structures de client Tealeaf pour les applications naties mobiles soumettent les informations d'en-tête suiantes : Structure de consignation Exemple d'en-tête soumis Android Logging Framework HTTP_X_TEALEAF=deice (Android) Lib/ ios Logging Framework HTTP_X_TEALEAF=deice (ios) Lib/ Remarque : L'en-tête ci-dessus est également utilisé par la solution IBM Tealeaf CX UI Capture for AJAX. Toutefois, la détection des agents utilisateur d'ibm Tealeaf CX UI Capture for AJAX proient du client utilisé dans la session. Voir «Références Client-Side Capture», à la page 361. Lorsque l'agent de session de référence Tealeaf détecte l'en-tête HTTP_X_TEALEAF et la aleur (android) ou (ios), il effectue les tâches suiantes : L'agent de session de référence Tealeaf remplace la ariable de demande du type de trafic : TLT_TRAFFIC_TYPE=MOBILE_APP Cette aleur est affichée comme aleur MOBILE_APP dans la dimension Type de trafic. Voir "Onglet Dimensions TEM" dans le document IBM Tealeaf Eent Manager - Guide. L'agent de session de référence Tealeaf remplace la ariable de demande de la plateforme du naigateur : Android : TLT_BROWSER_PLATFORM=Android ios : TLT_BROWSER_PLATFORM=iOS L'agent de session de référence Tealeaf recherche l'en-tête HTTP_X_TEALEAF_PROPERTY, qui est soumis à partir des structures client aec des informations étendues sur les agents utilisateur. Par exemple : HTTP_X_TEALEAF_PROPERTY=TLT_BROWSER=StraussAndPlesser Natie; TLT_BROWSER_VERSION=8.5; TLT_BROWSER_PLATFORM=Android; TLT_BRAND=Asus; TLT_MODEL=Asus Eee Pad Transformer TF101; TLT_SCREEN_HEIGHT=800; TLT_SCREEN_WIDTH=1280; TLT_COLOR_DEPTH=65536 Ces aleurs sont utilisées pour alimenter la section [ExtendedUserAgent]. Par exemple : [ExtendedUserAgent] TLT_BROWSER=StraussAndPlesser Natie TLT_BROWSER_VERSION=8.5 TLT_BROWSER_PLATFORM=Android TLT_BRAND=Asus TLT_MODEL=Asus Eee Pad Transformer TF101 TLT_SCREEN_HEIGHT=800 TLT_SCREEN_WIDTH=1280 TLT_COLOR_DEPTH= IBM Tealeaf CX - Guide de configuration

383 Les zones [ExtendedUserAgent] suiantes ne sont pas alimentées aec les données des applications naties mobiles car les zones ne sont applicables qu'aux naigateurs : TLT_BROWSER_JAVASCRIPT TLT_BROWSER_COOKIES TLT_PICTURE_SUPPORT TLT_VIDEO_SUPPORT TLT_STREAMING_SUPPORT Remarque : Certaines ariables ci-dessus peuent être insérées aec des aleurs false si la demande elle-même inclut un agent utilisateur. Une fois que ces zones ont été insérées dans la section [ExtendedUserAgent], les zones et les propriétés de HTTP_X_TEALEAF_PROPERTY sont appliquées. Mode existant pour l'analyse des agents utilisateur : Dans la ersion x, Tealeaf a introduit une nouelle implémentation de l'analyse des agents utilisateur qui permet une correspondance bien plus précise des agents utilisateur détectés dans le flux de capture. Si ous le souhaitez, ous pouez actier l'implémentation précédente de l'analyse des agents utilisateur comme mode existant. Remarque : Tealeaf recommande fortement d'utiliser la dernière implémentation de l'analyse des agents utilisateur. L'analyse des agents utilisateur dans le mode Existant est fournie pour les clients qui ont effectué une mise à nieau à partir de ersions qui prenaient en charge la précédente implémentation de l'analyse des agents utilisateur, mais qui ne peuent toujours pas passer à la nouelle implémentation à ce stade. Il est probable que l'analyse des agents utilisateur dans le mode Existant deienne obsolète dans une prochaine ersion. Pour plus d'informations sur le mode existant, oir "Agent de session de référence Tealeaf - Mode existant" dans le document IBM Tealeaf CX - Guide de configuration. Surcharge de la zone de référence d'application : Remarque : A partir de la ersion 8.0, la possibilité de capturer le type d'agent utilisateur est mieux prise en charge en créant une dimension alimentée par un masque qui détecte la aleur directement à partir de la demande. Vous deez désactier cette fonction si elle a été actiée et conceoir une dimension pour capturer le contenu. Il est probable que cette fonctionnalité deienne obsolète dans une prochaine ersion. Voir "Onglet Dimensions TEM" dans le document IBM Tealeaf Eent Manager - Guide. Vous pouez éentuellement configurer l'agent de session de référence Tealeaf pour remplacer le contenu par défaut inséré dans la zone TLT_APPLICATION_NAME de la section [appdata] de la demande. Pour cela, effectuez l'une des opérations suiantes : TealeafCaptureSocket.cfg : Dans la section [TLTRef] de TealeafCaptureSocket.cfg, définissez le paramètre suiant : OerloadAppRef=true TMS : 1. Si ous effectuez la configuration ia TMS, ajoutez l'agent de session à otre pipeline ia l'éditeur de pipeline. Voir "Editeur de pipeline TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. Chapitre 4. Agents de session de pipeline CX 373

384 2. Cliquez sur l'icône de l'agent de session TLTRef dans l'éditeur de pipeline, puis cliquez sur Modifier. 3. Cliquez sur Ajouter des éléments de configuration. 4. Cochez la case Oerload Application Reference Field. 5. Cliquez deux fois sur OK. 6. Cliquez sur Sauegarder. 7. Configurez une tâche pour mettre à jour tous les sereurs immédiatement. Si l'option OerloadAppRef est définie sur True, la aleur de TLT_APPLICATION_NAME est remplacée par celle du type de trafic extrait du cache des agents utilisateur. Les aleurs possibles sont les suiantes : BOT MOBILE BROWSER MOBILE_BOT UNKNOWN Remarque : Lorsque la zone de référence d'application est surchargée, les seuls identificateurs isibles par le Canister sont ceux associés aux aleurs de type de trafic ci-dessus. Surcharge et UI Capture : Si UI Capture est déployé lorsque la zone Application reference est surchargée, la aleur de TLT_APPLICATION_NAME extraite des informations d'agent utilisateur est également enregistrée dans la aleur TLT_CUI_APPLICATION_NAME, qui est insérée par l'agent de session si HTTP_X_TEALEAF_PAGE_URL est détecté dans la demande. Remarque : HTTP_X_TEALEAF_PAGE_URL est inséré par UI Capture. Voir "Foire aux questions UI Capture" dans la foire aux questions d'ibm Tealeaf UI Capture for Ajax. Par défaut, cette aleur contient le chemin de l'url de la page parent. Pour plus d'informations sur la configuration de cet en-tête, oir "Référence UI Capture for Ajax" dans le document IBM Tealeaf UI Capture for Ajax - Guide. Dans le tableau ci-dessous, ous pouez examiner le mappage des ariables de demande de destination et la manière dont elles sont alimentées par les données si la surcharge est désactiée et actiée. Tableau 35. Surcharge et UI Capture Variable de Source de demande standard demande de destination TLT_CUI_ APPLICATION_ NAME TLT_ APPLICATION_ NAME En-tête HTTP_X_TEALEAF_PAGE_URL [en]/url Source de demande surchargée Si surchargé : TLT_TRAFFIC_TYPE Si surchargé : TLT_TRAFFIC_TYPE Les deux ariables d'application de la demande contiennent les informations sur le type de trafic extraites de l'agent utilisateur détecté. 374 IBM Tealeaf CX - Guide de configuration

385 La aleur de TLT_CUI_URL est définie par l'agent de session et n'est pas affectée par la surcharge de la zone d'application. Voir «Références Client-Side Capture», à la page 361. Paramètres de configuration Les paramètres de configuration suiants sont disponibles pour l'agent de session de référence Tealeaf : Les aleurs Nom d affichage sont affichées dans TMS, cette méthode étant recommandée pour configurer les agents de session. Voir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Les aleurs Nom sont affichées dans TealeafCaptureSocket.cfg. Tableau 36. Paramètres de configuration Nom d'affichage Nom Description Adanced User Agent Parsing AdancedUAParsing Si la aleur de ce paramètre est True, l'agent de session de référence Tealeaf utilise le cache à élagage automatique pour accélérer les recherches d'informations sur les agents utilisateur. Ce cache contient les derniers agents utilisateur consultés. La aleur par défaut est True. Voir "Configuration de la détection des agents utilisateur" dans le document IBM Tealeaf cximpact - Guide d'administration. Allow Empty Extensions AllowEmptyExtension Si la aleur de ce paramètre est True, les URL qui ne contiennent pas d'extension peuent être normalisées. La aleur par défaut est True. Days to Keep Stats StatsKeepDays Nombre de jours pendant lequel les statistiques sur l'agent de session de référence Tealeaf doient être conserées dans les fichiers journaux mobiles. La aleur par défaut est 30. Log Reference Statistics OutputReferenceStats Si la aleur de ce paramètre est True, les statistiques sur les opérations de l'agent de session de référence Tealeaf sont générées toutes les heures pour les rapports, par l'intermédiaire de l'agent de session Consignateur de statistiques. La aleur par défaut est True. Maximum Cache Size MaxCacheSize Nombre maximal d'entrées dans le cache. La aleur par défaut est Remarque : Si Adanced User Agent Parsing est actié, cette aleur doit être spécifiée. Normalize App Name NormalizeAppName Si la aleur de ce paramètre est True, la aleur de TLT_APPLICATION_NAME correspond au répertoire irtuel défini comme aleur entre les deux premières barres obliques de l'url. La aleur par défaut est True. Chapitre 4. Agents de session de pipeline CX 375

386 Tableau 36. Paramètres de configuration (suite) Nom d'affichage Nom Description Normalize Host NormalizeHost Si la aleur de ce paramètre est True, une manipulation des données supplémentaire est effectuée pour normaliser les aleurs hôte aant qu'elles ne soient sauegardées comme ID référence. La aleur par défaut est True. Normalize Serer NormalizeSerer Si la aleur de ce paramètre est True, la aleur de TLT_SERVER correspond à celle de LOCAL_ADDR. La aleur par défaut est True. Normalize URL NormalizeURL Seules les URL dont l'extension et les codes de statut sont répertoriés sous NormalizeURLExt sont prises en compte. Si l'url se termine par une barre oblique, la racine par défaut est ajoutée et l'url est décodée. Si l'url contient l'un des caractères (/, :, ;,?), elle est tronquée au nieau de ce caractère. La aleur par défaut est True. Pruning Interal PruningInteral Interalle en minutes auquel le cache des agents utilisateur est mis à jour aec les derniers agents utilisateur consultés. La aleur par défaut est 10. Remarque : Si Adanced User Agent Parsing est actié, cette aleur doit être spécifiée. Reference Statistics Min Hits OutputReferenceStatsMin Nombre minimal de hits au cours de l'interalle de consignation des statistiques pour que les statistiques de référence soient consignées. La aleur par défaut est 1. Reference Update Interal UpdateInteral Interalle en secondes auquel les fichiers de référence sont mis à jour ou lus. La aleur par défaut est 60. Analyse de référent ReferrerParsing Si la aleur de ce paramètre est True, les aleurs des référents sont analysées et normalisées. La aleur par défaut est True. Voir «Analyse de référent», à la page 364. Statistics Reporting Interal StatsReportingInteral Interalle en minutes auquel l'agent de session enoie les statistiques. Les aleurs suiantes sont acceptées : 5, 10, 15, 30 et 60. Remarque : Cet interalle est relatif au début de l'heure. Par exemple, la aleur 30 génère les statistiques à 12h00, 12h30, etc. 376 IBM Tealeaf CX - Guide de configuration

387 Tableau 36. Paramètres de configuration (suite) Nom d'affichage Nom Description Codes de statut NormalizeURLStatusCode Liste des codes de statut d'url admis pouant être normalisés. La aleur par défaut est 0;200;302;304;400;402;403;404; 410;500;501;502;503;504;505. URL Default Document NormalizeURLRootDefault Si l'url indique que la ressource est un répertoire, cette aleur est insérée comme nom de fichier par défaut. La aleur par défaut est DEFAULTPAGE. URL Extensions NormalizeURLExt Liste délimitée par des points-irgules des URL à normaliser. La aleur par défaut est ACTION;ASMX;ASP;ASPX;CSS;DO; HTM;HTML;GIF;ICO;JPG;JS;JSP;JHTML; PDF;PHP;SWF. URL Reference Rules URLReferenceRules Indique si les règles de référence d'url sont actiées. La aleur par défaut est true. URL Reference Rules File URLReferenceRulesFile Chemin d'accès et nom de fichier des règles de référence d'url. La aleur par défaut est.\system\ Reference_Path_Rules.txt. Les chemins relatifs sont spécifiés par rapport au répertoire qui contient la DLL utilisée. URL Reference Rules Mode URLReferenceRulesMode Mode des règles de référence d'url. La aleur par défaut est cont. stop : le traitement des URL se termine une fois que l'ensemble de règles ou le répertoire irtuel ne troue plus d'occurrence. Le traitement s'arrête toujours après un ensemble de règles ou un répertoire irtuel détecté. cont : le traitement des URL se poursuit même en cas d'échec. Use Full Virtual Dir UseFullVirtualDir Si la aleur est True, les correspondances sont établies pour l'intégralité de la chaîne du répertoire irtuel, même si elle inclut une barre oblique (par exemple, myapp\subdir). Si la aleur est False, les correspondances sont déterminées par le paramètre URLReferenceVirtualDir utilisé. La aleur par défaut est False. Voir «Référencement de répertoires irtuels», à la page 378. Chapitre 4. Agents de session de pipeline CX 377

388 Tableau 36. Paramètres de configuration (suite) Nom d'affichage Nom Description URL Virtual Dirs URLReferenceVirtualDir Liste de répertoires irtuels d'url, séparés par des irgules, sans espaces. La aleur par défaut est serlets. Exemple : serlets;cgi-bin D'autres options sont disponibles. Voir «Référencement de répertoires irtuels». User Agent Files Directory UAFilesDir Ce répertoire doit contenir tous les fichiers requis pour l'analyse des agents utilisateur : BrowsCap.cs pour la détection des agents utilisateur du bureau WURFL.cs pour les agents utilisateur mobiles UserCap.cs pour les chaînes de détection des agents utilisateur définies par l'utilisateur Remarque : Si Adanced User Agent Parsing est actié, cette aleur doit être spécifiée. Cette aleur doit correspondre à un chemin d'accès complet au répertoire. N'utilisez pas de chemin relatif. Vous pouez spécifier ce chemin comme chemin UNC. Voir "Configuration de la détection des agents utilisateur" dans le document IBM Tealeaf cximpact - Guide d'administration. Tableau 37. Eléments de configuration supplémentaires : Afficher nom Nom Description Log URL Statistics Oerload Application Reference Field OutputURLStats OerloadAppRef Cet outil de débogage peut être utilisé pour générer les statistiques sur les URL. La aleur par défaut est False. Si la aleur est True, la aleur de TLT_APPLICATION_NAME dans la mémoire tampon des demandes est remplacée par la aleur du type de naigateur extraite du cache des agents utilisateur. Voir «Surcharge de la zone de référence d'application», à la page 373. Référencement de répertoires irtuels : Vous pouez spécifiez l'url à utiliser comme répertoire irtuel partiellement ou intégralement. 378 IBM Tealeaf CX - Guide de configuration

389 Pour utilisez l'url dans son intégralité, affectez à UseFullVirtualDir la aleur True. Pour utilisez une partie de l'url, affectez à UseFullVirtualDir la aleur True. Vous pouez déterminer la partie de l'url à utiliser comme répertoire irtuel en affectant à l'un des paramètres ci-après la aleur True. Soit l'url suiante : /dir/sub-dir/sub-sub-dir/page.html Si URLReferenceVirtualDir=true, le répertoire irtuel est : dir Si URLReferenceVirtualDir2=true, le répertoire irtuel est : sub-dir Si URLReferenceVirtualDir3=true, le répertoire irtuel est : sub-sub-dir Tout paramètre pour URLReferenceVirtualDir4 et au dessus est ignoré. Agent de session de référence Tealeaf dans des enironnements à plusieurs Canisters L'agent de session doit être déployé dans un emplacement cohérent dans chaque pipeline Windows de chaque Canister qui traite des hits. Dans un enironnement à plusieurs Canisters, tous les Canisters peuent communiquer de manière indépendante aec la base de données pour extraire les aleurs de référence. Agents de session Tealeaf "Ajout d'un agent de session" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session Archiage" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session Indexation des attributs" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session Canister" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session Analyseur de cookie" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session Dépose de données" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session Analyseur de données" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session Decouple" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session DecoupleEx" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session Confidentialité étendue" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session Health-Based Routing (HBR)" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session Déploiement" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session Analyseur mobile JSON" dans le document IBM Tealeaf CX - Guide de configuration Chapitre 4. Agents de session de pipeline CX 379

390 "Agent de session Code géré" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session Null" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session Confidentialité" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session RTA (Real-Time Monitoring and Alert)" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session Balises de réponse pour la demande" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session Fractionnement RTA" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session Mise en sessions" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session Routeur de session" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session Socket" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session Consignateur de statistiques" dans le document IBM Tealeaf CX - Guide de configuration Agent de session de référence Tealeaf "Agent de session Mise en sessions Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session TimeGrades" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session TLI" dans le document IBM Tealeaf CX - Guide de configuration "Agent de session Décodage d'url" dans le document IBM Tealeaf CX - Guide de configuration Agent de session de référence Tealeaf - Mode existant Remarque : Cette section décrit un mode existant d'analyse des agents utilisateur. Pour la ersion 8.1, Tealeaf utilise une implémentation supérieure permettant d'effectuer le suii des agents utilisateur fixes, mobiles et bot. Tealeaf recommande fortement d'utiliser la nouelle méthode d'analyse des agents utilisateur. Voir "Agent de session de référence Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration. L'agent de session de référence Tealeaf gère la détection et l'alimentation des informations sur les agents utilisateur extraites de la mémoire tampon des demandes. Lorsqu'un utilisateur soumet une demande à l'application Web, les informations sur le naigateur, le système d'exploitation et le type d'application du isiteur (mobile, bureau, BOT) sont incluses dans la demande. Remarque : Par défaut, l'analyse des agents utilisateur est actiée pour les nouelles installations et les mises à nieau. Le mode existant doit être actié séparément. Voir «Actiation du mode existant», à la page 381. Présentation Le mode Existant actie les fonctionnalités de l'implémentation initiale de l'analyse étendue des agents utilisateur. 380 IBM Tealeaf CX - Guide de configuration

391 Remarque : Pour les utilisateurs Tealeaf, la différence entre les deux méthodes d'implémentation est transparente. Toutefois, la méthode plus récente offre des fonctionnalité de correspondance supérieures, des améliorations de la consignation et une meilleure prise en charge des anomalies des données. Les fonctions du mode Existant incluent : L'utilisation d'un cache à élagage automatique pour un accès rapide aux agents utilisateur les plus fréquemment détectés. Ce cache est également utilisé dans la nouelle implémentation. Voir "Agent de session de référence Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration. Fichiers de configuration utilisés : BrowsCap.cs : norme publique des agents utilisateur fixes et bot. UserCap.cs : fichier de configuration défini par l'utilisateur des agents utilisateur non disponibles dans UserCap.cs. WURFL.cs : si le module IBM Tealeaf CX Mobile est sous licence, la norme WURFL doit être téléchargée et conertie au format CSV, qui contient la norme WURFL publique à utiliser par Tealeaf lors de l'identification des agents utilisateur mobiles. - Voir "Maintenance du système CX" dans le document IBM Tealeaf CX - Guide d'installation. Messages de journal enoyés au journal des éénements Windows. Actiation du mode existant Pour actier le mode existant pour l'analyse des agents utilisateur, effectuez les étapes ci-après. Remarque : Si ous aez utilisé la ersion standard de l'analyse des agents utilisateur et que ous aez ajouté des aleurs dans le fichier UserSupplement.cs, ces aleurs doient être insérées dans le fichier UserCap.cs. Le fichier UserSupplement.cs n'est pas utilisé dans le mode existant. 1. Connectez-ous au portail Tealeaf en tant qu'administrateur. 2. Dans le menu Portail, sélectionnez Tealeaf > TMS. Tealeaf Management System s'affiche. Voir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. 3. Cliquez sur l'onglet WorldView. 4. Dans la liste déroulante Sereurs, sélectionnez le sereur qui héberge le pipeline de capture où l'agent de session de référence Tealeaf est déployé. 5. Cliquez sur le noeud Serice de transport. 6. Sélectionnez Configuration du serice de transport. 7. Dans le panneau Actions de configuration, cliquez sur Afficher/Modifier (Brut). 8. La ersion brute du fichier TealeafCaptureSocket.cfg est affichée. Vous pouez choisir de copier et coller ce contenu dans l'éditeur de texte de otre choix pour l'éditer. 9. Dans ce fichier, recherchez la section [TLTRef]. 10. Vérifiez que la aleur d'adanceduaparsing est True. Ce paramètre actie l'analyse de base des agents utilisateur. Il doit aoir la aleur True pour toutes les nouelles installations ou les mises à nieaux ers la ersion 8.1 ou une ersion ultérieure. Si ce n'est pas le cas, spécifiez la aleur True. 11. Dans la section [TLTRef], recherchez UAParsing=. Chapitre 4. Agents de session de pipeline CX 381

392 Si ous ne trouez pas cette chaîne, insérez la ligne suiante dans cette section : UAParsing=old Si ous la trouez, érifiez qu'elle possède la aleur ci-dessus (old). Ce paramètre actie le mode existant. Remarque : Ce paramètre n'est pas disponible par défaut et doit être inséré manuellement dans la configuration. 12. Configurez les autres paramètres de l'agent utilisateur. Voir "Agent de session de référence Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration. 13. Pour sauegarder os modifications, cliquez sur Sauegarder. 14. Pour enoyer la modification aux autres Canisters de otre enironnement, cliquez sur Ajouter des tâches et les soumettre. 15. Le mode existant est actié pour l'analyse des agents utilisateur. Pour le désactier, affectez à UAParsing une autre aleur, mettez la ligne en commentaire ou supprimez-la de la configuration. Désactiation de l'utilisation des génériques Si Mode existant est actié, l'utilisation de génériques d'agent utilisateur n'est pas prise en charge. Voir "Agent de session de référence Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration. Les génériques sont un mécanisme de substitution utilisé lorsque les mises à jour de BrowsCap.cs et WURFL.cs sont conerties pour être utilisées dans Tealeaf. Lors de ce processus de conersion, l'utilisation de génériques est désactiée à l'aide d'une case à cocher. Voir "Outils de l'agent d'utilisateur" dans le document IBM Tealeaf cximpact - Guide d'administration. Optimisation du cache à élagage automatique Suiant le olume de trafic et la diersité du trafic ers otre site Web, il se peut que ous deiez adapter les paramètres du cache à élagage automatique. La recherche d'une aleur appropriée pour ces deux paramètres est primordiale pour des performances optimales de otre pipeline si l'analyse étendue des agents utilisateur est utilisée. Le mode existant utilise le même cache que l'implémentation en cours. Voir "Agent de session de référence Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration. Messages du journal des éénements au démarrage Plusieurs erreurs peuent se produire au démarrage du module d'agent utilisateur étendu. La plupart de ces erreurs sont dues à des fichiers manquants ou de format incorrect. Les erreurs sont normalement explicites, mais ous pouez éiter d'éentuels problèmes aec les fichiers cache des agents utilisateur en respectant les règles ci-après. Règles d'édition des fichiers de configuration 1. N'éditez pas manuellement les fichiers BrowsCap.cs et WURFL.cs dans un éditeur. Ces fichiers doient être dans le format créé par leur propriétaire et ne doient pas être modifiés. Le cache de l'agent utilisateur érifie le format des fichiers et les en-têtes aant de charger les fichiers et ne charge pas les fichiers qui ont été modifiés. 382 IBM Tealeaf CX - Guide de configuration

393 Remarque : Ces fichiers doient être mis à jour de manière régulière à partir des ersions publiées de la norme disponible publiquement. Voir "Maintenance du système CX" dans le document IBM Tealeaf CX - Guide d'installation. 2. Lorsque ous éditez le fichier UserCap.cs, obserez son format. La configuration de ce fichier est une fonction d'utilisateur expérimenté et ne doit être effectuée que par des utilisateurs aisés. Le format est défini dans la première ligne du fichier et consiste en une liste de colonnes. Le nombre de colonnes et leur aleur par défaut sont également disponibles dans le fichier. Ils doient correspondre faute de quoi le chargement du fichier échouera. Pour plus d'informations sur l'édition, oir "Outils de l'agent d'utilisateur" dans le document IBM Tealeaf cximpact - Guide d'administration. 3. L'édition du fichier UserCap.cs dans Excel peut entraîner la suppression des guillemets de chaque aleur sur une ligne particulière. Dans ce cas, le fichier ne peut pas être chargé. Effectuez toujours une copie de sauegarde du fichier aant de le modifier pour pouoir toujours récupérer le fichier d'origine en cas d'erreur de formatage. Détection du type de système d'exploitation et de naigateur à partir des informations d'agent utilisateur (ersion la plus ancienne) Remarque : Les informations ci-dessous ne sont utilisées que si l'analyse aancée des agents utilisateur est désactiée. Les informations ci-dessous appartiennent à une ersion antérieure du suii des agents utilisateur et ont été remplacées par le paramètre AdancedUAParsing. Il peut s'aérer utile de détecter et signaler les types de naigateur et de système d'exploitation utilisés par os isiteurs. Pour collecter ces données, l'agent de session de référence Tealeaf autorise l'utilisation des paires nom/aleur choisies par l'utilisateur qui dénotent une expression régulière, sur le membre de mémoire tampon HTTP_USER_AGENT REQ. Par exemple, dans le fichier de configuration, ous pouez entrer la section suiante : #User Agent Parsing (add new members as desired) UA_Replace=True IE_All=MSIE\s\d\.\d Opera_MajMin=Opera/\d\.\d\d #Operating System Parsing (add new members as desired) OS_Replace=True Windows_XP=Windows\sNT\s5\.1 Si UA_Replace possède la aleur True, l'expression régulière sur chaque paire nom/aleur est appliquée à la chaîne de l'agent utilisateur. Si une correspondance est trouée, la aleur du nom dans la partie gauche est insérée dans la section [appdata], comme illustré ci-dessous : [appdata] TLT_BROWSER=Opera_MajMin TLT_OS=Windows_XP De cette façon, ous pouez regrouper les types de système d'exploitation et de naigateur de n'importe quelle manière. Par exemple, ous pouez représenter toutes les correspondances d'expression régulière possibles pour Microsoft Internet Explorer sous IE_ALL ou les fractionner par numéros de ersion majeurs et mineurs, pour obtenir une granularité plus fine, comme dans l'exemple suiant : Chapitre 4. Agents de session de pipeline CX 383

394 UA_Replace=True IE_6=MSIE\s6\.\d IE_7=MSIE\s7\.\d A titre de référence, le fichier TealeafCaptureSocket-base.cfg contient plusieurs expressions régulières courantes. Agent de session Mise en sessions Tealeaf La mise en sessions peut être appliquée dans le pipeline Tealeaf ia l'agent de session TLSessioning. La mise en sessions Tealeaf s'appuie sur les données utilisateur de la mémoire tampon REQ pour fonctionner. L'identificateur de session Tealeaf peut être spécifié autrement que comme un cookie HTTP, par exemple, comme un paramètre QUERY_STRING. L'agent de session TLSessioning prend en charge la mise en sessions impliquant des tables et des recherches de table. Remarque : Lorsque ous configurez la section TLSessioning dans le fichier CSS.cfg, placez la section après la section [CookieParser]. Sinon, l'agent de session ne perçoit pas le cookie comme une paire nom/aleur REQ. Ajout de l'agent de session Des agents de session peuent être ajoutés ia l'éditeur de pipeline dans TMS. Voir «Ajout d'un agent de session», à la page 237. Pour plus d'informations sur l'éditeur de pipeline et TMS, oir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Le reste de cette page décrit les options de configuration et la manière de les modifier ia le fichier TealeafCaptureSocket.cfg stocké sur le sereur. Ces paramètres sont également disponibles ia l'éditeur de pipeline, cette méthode étant recommandée pour configurer les agents de session. Mode de fonctionnement de la mise en sessions Tealeaf La puissance et la ulnérabilité de la mise en sessions Tealeaf reposent sur les tables de hachage associées aux tables de session. Les ID session sont stockés dans des compartiments, le hachage des ID session déterminant le compartiment dans lequel se troue l'id session. L'objectif des clés de hachage est de répartir équitablement les ID session entre les compartiments de hachage. Par conséquent, il est important que la fonction de hachage fonctionne correctement aec les ID session spécifiés pour que l'utilisation des compartiments résultante soit relatiement uniforme. Une fonction de hachage qui ne fonctionne pas correctement peut se transformer en liste séquentielle. Remarque : Les hachages arient suiant les enironnements Tealeaf. Ce qui fonctionnait correctement sur un site Web risque de ne pas fonctionner aussi bien ailleurs. La détermination du hachage approprié implique généralement la capture de données pour déterminer la meilleure aleur de hachage. Le stockage sous-jacent fournit compartiments pour stocker les ID session. Pour un site qui crée une session toutes les secondes, ID session sont stockés par jour. Aec un hachage bien distribué, il yaenmoyenne un à deux ID session par compartiment. Pour rechercher un ID session de manière aléatoire, un 384 IBM Tealeaf CX - Guide de configuration

395 utilisateur extrait le hachage de l'id session, examine le compartiment associé et n'effectue pas plus de deux recherches aant de trouer l'id session. Si la aleur de hachage n'est pas répartie équitablement, les délais de recherche sont rallongés et, dans le pipeline de capture, la itesse est primordiale. En général, la mise en sessions nécessite de stocker au moins ID session dans des tables. La itesse à laquelle ces opérations de stockage et de recherche se produisent a un impact direct sur la itesse de mise en sessions. Les recherches en série dans le pool des ID session est très lente. A l'aide des clés de hachage, le hachage de base de données détermine le compartiment dans lequel se troue un ID session particulier. Par exemple, le TLTSID standard est une aleur ASCII hexadécimale de 32 octets. Les octets 5 à 8 de cette chaîne correspondent à un nombre assez aléatoire, ce qui en font une bonne clé de hachage pour les identificateurs globaux uniques car les ID session sont équitablement répartis entre les compartiments spécifiés par cette sous-chaîne. L'opérateur RTA SessPCT utilise ces quatre octets pour effectuer cette opération. Aucun hachage ne fonctionne aussi bien sur tous les jeux de données possibles. La fonction de hachage par défaut peut s'aérer médiocre aec un ensemble de clés particulier. La ariable de configuration TLSessioning permet de spécifier des clés de hachage ariées. Exemple de configuration de section TLSessioning Vous trouerez ci-dessous un exemple de section TLSessioning dans le fichier CSS.cfg : [TLSessioning] TypeName=TLSessioning DLL=SessionAgentRulesEngine.dll DownStreamConfigSection=<NEXT CONFIG SECTION> ScriptTrace=OFF ResponseType=All EnironmentScript=EngineEnironment.tcl PreProcScript=TLSessioning.PreProc.tcl ActionScript=TLSessioning.Action.tcl MaxSessions=5000 PrimarySessField=SITESERVER=ID PrimaryLooseStrict=Strict PrimaryMaxFieldLen=36 The following settings are optional: REQFilterTCL=true PrimarySessFieldMaskOff / PrimarySessFieldMaskTCL PrimaryHashKeyOff/PrimaryHashKeyTCL PrimaryAssociateSetCookie=true PrimaryCaseInsensitie=true SecondarySessField =JSESSIONID SecondaryLooseStrict=Strict SecondaryMaxFieldLen=156 TertiarySessField=USER_ID TertiaryLooseStrict=Strict TertiaryMaxFieldLen=36 Chapitre 4. Agents de session de pipeline CX 385

396 Paramètres de configuration Les paramètres de configuration suiants sont disponibles pour cet agent de session : Les aleurs Nom d affichage sont affichées dans TMS, cette méthode étant recommandée pour configurer les agents de session. Voir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Les aleurs Nom sont affichées dans TealeafCaptureSocket.cfg. Tableau 38. Paramètres de configuration Nom d'affichage Nom Description Maximum de sessions MaxSessions Indique le nombre maximal de sessions simultanées. La aleur par défaut est PrimarySessField PrimarySessField Zone de mise en sessions principale. La aleur par défaut est JSESSIONID. PrimaryMaxFieldLen PrimaryMaxFieldLen Taille maximale de PrimarySessioningField en caractères. PrimaryCaseInsensite PrimaryCaseInsensite Si la aleur est true, PrimarySessioningField est insensible à la casse. La aleur par défaut est false. PrimarySessFieldMaskOFF PrimarySessFieldMaskOFF Cette zone peut être utilisée pour spécifier des décalages de zone pour PrimarySessField. Les décalages sont basés sur des 0. PrimaryAssociateSetCookie PrimaryAssociateSetCookie Dans les cas où le paramètre de mise en sessions est une aleur de cookie et que cette dernière peut être mise à jour, cette option demande au script de rechercher la prochaine occurrence du paramètre de mise en sessions. Si une occurrence est détectée, cette aleur est associée à TLTSID. SecondarySessField SecondarySessField Zone de mise en sessions secondaire. La aleur par défaut est JSESSIONID. SecondaryMaxFieldLen SecondaryMaxFieldLen Taille maximale de SecondarySessioningField en caractères. SecondarySessFieldMaskOFF SecondarySessFieldMaskOFF Cette zone peut être utilisée pour spécifier des décalages de zone pour SecondarySessField. Les décalages sont basés sur des 0. SecondaryAssociateSetCookie SecondaryAssociateSetCookie A utiliser si SecondarySessioningField est un cookie et qu'il change dans la session, ia une directie set-cookie. SecondaryCaseInsensite SecondaryCaseInsensite Si la aleur est true, SecondarySessioningField est insensible à la casse. La aleur par défaut est false. TertiarySessField TertiarySessField Zone de mise en sessions tertiaire. La aleur par défaut est JSESSIONID. 386 IBM Tealeaf CX - Guide de configuration

397 Tableau 38. Paramètres de configuration (suite) Nom d'affichage Nom Description TertiaryMaxFieldLen TertiaryMaxFieldLen Taille maximale de TertiarySessioningField en caractères. TertiarySessFieldMaskOFF TertiarySessFieldMaskOFF Cette zone peut être utilisée pour spécifier des décalages de zone pour TertiarySessField. Les décalages sont basés sur des 0. TertiaryAssociateSetCookie TertiaryAssociateSetCookie A utiliser si TertiarySessioningField est un cookie et qu'il change dans la session, ia une directie set-cookie. TertiaryCaseInsensite TertiaryCaseInsensite Si la aleur est true, TertiarySessioningField est insensible à la casse. La aleur par défaut est false. ScriptTrace ScriptTrace Si cette option est actiée, le traçage des scripts est appliqué aux actions de l'agent de session, ce qui est utile pour le débogage. Remarque : ScriptTrace ne doit pas être actié dans les enironnements de production. Exemples Le code suiant érifie le paramètre CaptureSource et ne prend en compte que les chaînes capturée ia la PCA2 : REQFilterTCL=string equal "TealeafPassieCapture2" [REQBufVal "CaptureSource"] Le code suiant est identique au code ci-dessus, mais la comparaison des chaînes ne respecte pas la casse : REQFilterTCL=string equal -nocase "TealeafPassieCapture2" [REQBufVal "CaptureSource"] Le code suiant teste si la chaîne "test" est contenue dans la aleur HTTP_HOST : REQFilterTCL=string first "test" [REQBufVal "HTTP_HOST"] Notez que l'opération string first respectant toujours la casse, il n'existe pas de paramètre -nocase. Le code suiant est identique au code ci-dessus, mais le test ne respecte pas la casse : REQFilterTCL=regexp -nocase -- "test" [REQBufVal "HTTP_HOST"] Le code suiant teste si le paramètre LOCAL_ADDR contient l'une des adresses IP suiantes : , ou " REQFilterTCL=regexp -- " ( )" [REQBufVal "LOCAL_ADDR"] Chapitre 4. Agents de session de pipeline CX 387

398 Remarques Ne modifiez pas le fichier ctc-conf.xml pour supprimer TLTSID comme cookie de la session, même s'il ne l'est pas. Lors d'une mise en session sur une aleur non TLTSID, la capture passie crée un identificateur global unique de 32 octets comme aleur TLTSID, qui transforme tous les hits en sessions à un hit. TLSessioning supposant que le contenu TLTSID correspond à un identificateur global unique de 32 octets (les nouelles sessions utilisent le TLTSID du premier hit), conserez cette aleur comme un identificateur global unique de 32 octets. Si le cookie TLTSID est alide car l'injecteur de cookie Tealeaf est utilisé, TLSessioning n'est pas nécessaire, mais ous pouez l'utiliser à partir du moment où TLTSID est spécifié pour PrimarySessField. Tout échantillonnage de session tel que celui effectué par l'agent de session RTA doit se trouer après le script TLSessioning pour éiter toute infidélité des sessions en aal. Jointure de sessions TLSessioning peut être utilisé pour les jointures de sessions de base. La jointure de sessions est définie comme la jointure de fragments dans un même fragment. Par exemple, les hits ci-après représentent deux sessions physiques différentes, comme déterminé par TLTSID : Hit 1: TLTSID = C70C0F4F451ED57190F8D5A059A1D071 Hit 2: TLTSID = C70C0F4F451ED57190F8D5A059A1D071 Hit 3: TLTSID = C70C0F4F451ED57190F8D5A059A1D071 User-Key = 20E8AB8F-531D Hit 4: TLTSID = C70C0F4F451ED57190F8D5A059A1D071 User-Key = 20E8AB8F-531D Hit 5: TLTSID = 649B0BDA4BC15E0B141AD A13 User-Key = 20E8AB8F-531D Hit 6: TLTSID = 649B0BDA4BC15E0B141AD A13 User-Key = 20E8AB8F-531D Hit 7: TLTSID = 649B0BDA4BC15E0B141AD A13 Pour combiner ces fragments dans une même session, les hits 5 à 7 doient posséder le même TLTSID que les hits 1 à 4.La configuration est la suiante : PrimarySessField=TLTSID PrimaryLooseStrict=Strict PrimaryMaxFieldLen=36 SecondarySessField=User-Key SecondaryLooseStrict=Strict SecondaryMaxFieldLen=20 Si Hit 3 est traité, TLSessioning constate la présence d'user-key et lui associe l'id session (dans le cas présent, C70C0F4F451ED57190F8D5A059A1D071). Si Hit 5 arrie, le TLTSID est modifié, ce qui indique le démarrage d'une nouelle session. Ce TLTSID apparaît pour la première fois, mais TLSessioning associe déjà la aleur User-Key à un TLTSID existant et le premier identificateur (C70C0F4F451ED57190F8D5A059A1D071) remplace donc le noueau TLTSID. Cette aleur User-Key est également associée au noueau TLTSID. Si Hit 7 est traité sans aleur User-Key, TLSessioning peut continuer à associer le TLTSID correct à ce hit. Exemples réels de configuration de TLSessioning Exemple 1 Cet exemple simple illustre la mise en session sur une zone de mémoire tampon REQ, USERID, qui peut contenir jusqu'à 32 octets. 388 IBM Tealeaf CX - Guide de configuration

399 Comme il n'y a pas de paramètre REQFilterTCL, tous les hits sont sujets à la mise en session. A partir d'une analyse de la zone USERID, le système ayant déterminé qu'userid était au format GUID, la clé de hachage par défaut (octets 5à8) d'userid est utilisée. [TLSessioning] TypeName=TLSessioning DLL=SessionAgentRulesEngine.dll DownStreamConfigSection=Null ScriptTrace=OFF ResponseType=All EnironmentScript=EngineEnironment.tcl ActionScript=TLSessioning.Action.tcl PreProcScript=TLSessioning.PreProc.tcl MaxSessions=10000 PrimarySessField=USERID PrimaryLooseStrict=Strict PrimaryMaxFieldLen=32 Exemple 2 L'exemple 2 représente une légère éolution de l'exemple 1 et utilise des JSESSIONID. Seuls les hits où TealeafPassieCapture2 est CaptureSource sont utilisés. L'examen de certains exemples JSESSIONID réèle ce qui suit : JSESSIONID=0000NMkrBPJZ_CDI6uwIGn2mc5:-1 JSESSIONID=0000Fn6ZSGhoYwYYGnhO0o9uP:-1 JSESSIONID=0000RxQR-FOyXbf_HqSo8sgE9t:-1 JSESSIONID=0000h9fQp-aVTadt7TAw4IksSXP:-1 JSESSIONID=0000BLWMKVi8qNs8G6OC12tF8V:-1 JSESSIONID=0000b3N00Y8Af0Mi54CkeijtTL:-1 Les octets 5 à 27 représentent la zone de mise en session, et les octets 5 à 9, la clé de hachage. La configuration appropriée est la suiante : [TLSessioning] TypeName=TLSessioning DLL=SessionAgentRulesEngine.dll DownStreamConfigSection=Null ScriptTrace=OFF ResponseType=All EnironmentScript=EngineEnironment.tcl ActionScript=TLSessioning.Action.tcl PreProcScript=TLSessioning.PreProc.tcl MaxSessions=10000 REQFilterTCL=string equal "TealeafPassieCapture2" \ [REQBufVal "CaptureSource"] PrimarySessField=JSESSIONID PrimaryLooseStrict=Strict PrimaryMaxFieldLen=32 PrimarySessFieldMaskOFF=4 26 PrimaryHashKeyOFF=4 8 Agents de session Tealeaf «Ajout d'un agent de session», à la page 237 «Agent de session Archiage», à la page 238 "Agent de session Indexation des attributs" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session Canister», à la page 249 Chapitre 4. Agents de session de pipeline CX 389

400 «Agent de session Analyseur de cookie», à la page 252 «Agent de session Dépose de données», à la page 254 «Agent de session Analyseur de données», à la page 260 «Agent de session Decouple», à la page 264 «Agent de session DecoupleEx», à la page 266 «Agent de session Confidentialité étendue», à la page 275 «Agent de session Health-Based Routing (HBR)», à la page 278 «Agent de session Déploiement», à la page 285 «Agent de session Analyseur mobile JSON», à la page 289 «Agent de session Code géré», à la page 303 «Agent de session Null», à la page 306 «Agent de session Confidentialité», à la page 307 «Agent de session RTA (Real-Time Monitoring and Alert)», à la page 341 «Agent de session Balises de réponse pour la demande», à la page 346 «Agent de session Fractionnement RTA», à la page 348 «Agent de session de mise en sessions», à la page 353 «Agent de session Routeur de session», à la page 350 «Agent de session Socket», à la page 356 «Agent de session Consignateur de statistiques», à la page 358 "Agent de session de référence Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session de référence Tealeaf - Mode existant», à la page 380 Agent de session Mise en sessions Tealeaf «Agent de session TimeGrades» «Agent de session TLI», à la page 392 «Agent de session de décodage d'url», à la page 408 Agent de session TimeGrades L'agent de session TimeGrades affecte un nieau à un hit dans les trois zones suiantes : Temps de génération du sereur Web : correspond au temps que met le sereur Web pour charger la page. Temps réseau : mesure la itesse du réseau en fonction du temps qu'a passé un paquet sur le réseau. Ces informations ne sont disponibles qu'à partir d'une machine hôte de capture passie. Temps aller-retour : correspond au temps de déplacement d'un paquet du client ers le sereur Web. Ces informations ne sont disponibles qu'à partir d'une machine hôte de capture passie. En fonction de ces trois critères, TimeGrades affecte au hit le nieau Excellent, Normal, NormalEleé ou Eleé. Ces aleurs sont associées à des nombres qui leur sont affectés dans le script TCL de TimeGrades. Ajout de l'agent de session Des agents de session peuent être ajoutés ia l'éditeur de pipeline dans TMS. Voir «Ajout d'un agent de session», à la page IBM Tealeaf CX - Guide de configuration

401 Paramètres de configuration Pour plus d'informations sur l'éditeur de pipeline et TMS, oir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Le reste de cette page décrit les options de configuration et la manière de les modifier ia le fichier TealeafCaptureSocket.cfg stocké sur le sereur. Ces paramètres sont également disponibles ia l'éditeur de pipeline, cette méthode étant recommandée pour configurer les agents de session. Les paramètres ci-après sont disponibles pour cet agent de session. Les aleurs Nom d affichage sont affichées dans TMS, cette méthode étant recommandée pour configurer les agents de session. Voir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Les aleurs Nom sont affichées dans TealeafCaptureSocket.cfg. Dans chaque cas, l'entrée est un ensemble de aleurs spécifié. Voir «Affectation de nieaux». Tableau 39. Paramètres de configuration Afficher nom Nom Description Web Serer Time Breaks WSGenBreaks Liste des nieaux de durée de génération des pages de sereur Web (<alue>:<description>) séparés par des irgules. Network Transit Breaks NetworkTransitBreaks Liste des nieaux de durée de transit réseau (<alue>:<description>) séparés par des irgules. RoundTrip Breaks RoundTripBreaks Liste des nieaux de durée aller-retour (<alue>:<description>) séparés par des irgules. Affectation de nieaux Voici un exemple de chaîne en entrée pour WSGenBreaks :.20:ExcellentWS,1.0:NormalWS,2.0:HighNormalWS,4:HighWS Voici un exemple de chaîne en entrée pour NetworkTransitBreaks :.5:ExcellentNT,1:NormalNT,2.1:HighNormalNT,5:HighNT Voici un exemple de chaîne en entrée pour RoundTripBreaks :.5:ExcellentRT,1.0:NormalRT,2.25:HighNormalRT,3.5:HighRT Mode d'application des nieaux TimeGrades ajoute ces scores au hits, en fonction des aleurs brutes qu'il reçoit. Tout nombre supérieur à la aleur la plus éleée définie (par exemple, 5) reçoit automatiquement le nieau NormalEleé. Ce nieau peut être configuré pour aoir un libellé différent en ajoutant la description souhaitée dans les sections set LastNTDesc, set LastRTDesc et set LastWSDesc du script TCL. Si un noueau nom est ajouté, il apparaît sous la forme suiante : High <Noueau nom>. Chapitre 4. Agents de session de pipeline CX 391

402 Par exemple : set LastWSDesc [GetValue $ConfigSection "LastWSDescription=Extra"] génère le libellé suiant comme nieau le plus éleé : High Extra Agents de session Tealeaf «Ajout d'un agent de session», à la page 237 «Agent de session Archiage», à la page 238 "Agent de session Indexation des attributs" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session Canister», à la page 249 «Agent de session Analyseur de cookie», à la page 252 «Agent de session Dépose de données», à la page 254 «Agent de session Analyseur de données», à la page 260 «Agent de session Decouple», à la page 264 «Agent de session DecoupleEx», à la page 266 «Agent de session Confidentialité étendue», à la page 275 «Agent de session Health-Based Routing (HBR)», à la page 278 «Agent de session Déploiement», à la page 285 «Agent de session Analyseur mobile JSON», à la page 289 «Agent de session Code géré», à la page 303 «Agent de session Null», à la page 306 «Agent de session Confidentialité», à la page 307 «Agent de session RTA (Real-Time Monitoring and Alert)», à la page 341 «Agent de session Balises de réponse pour la demande», à la page 346 «Agent de session Fractionnement RTA», à la page 348 «Agent de session de mise en sessions», à la page 353 «Agent de session Routeur de session», à la page 350 «Agent de session Socket», à la page 356 «Agent de session Consignateur de statistiques», à la page 358 "Agent de session de référence Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session de référence Tealeaf - Mode existant», à la page 380 «Agent de session Mise en sessions Tealeaf», à la page 384 Agent de session TimeGrades «Agent de session TLI» «Agent de session de décodage d'url», à la page 408 Agent de session TLI L'agent de session TLI peut être déployé pour générer des fichiers TLI en temps réel en fonction des données de session transmises ia un pipeline Windows et capturées afin d'être stockées. Un fichier TLI est une base de données de contenu statique, tel que des images, des scripts Jaa et des feuilles de style, qui peut être référencée lors de la relecture, au lieu d'accéder au sereur d'origine. Cette archie de contenu statique améliore les performances de relecture sans les problèmes potentiels de connectiité ou les distorsions de statistiques de performances sur l'application Web de production. 392 IBM Tealeaf CX - Guide de configuration

403 Remarque : L'agent de session TLI permet d'ajouter du contenu aux archies statiques (fichiers TLI). Pour plus d'informations sur les archies statiques de Tealeaf, oir "Gestion des archies statiques" dans le document IBM Tealeaf cximpact - Guide d'administration. La relecture à l'aide de fichiers TLI est prise en charge ia IBM Tealeaf CX RealiTea Viewer et la relecture sur naigateur. Voir "Utilisation d'archies statiques dans RTV" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Pour les utilisateurs BBR, la relecture du contenu statique est transparente. Cette section fournit les étapes de configuration relaties au déploiement de l'agent de session TLI, à la configuration du pipeline TLI et à l'extraction du contenu statique du pipeline de traitement principal du sereur TLI. Pour plus d'informations sur les autres étapes de configuration requises pour configurer les sereurs TLI, oir "Gestion des archies statiques" dans le document IBM Tealeaf cximpact - Guide d'administration. Prérequis Remarque : En fonction du olume de contenu statique dans otre application Web et du trafic quotidien, permettre la capture du contenu statique peut augmenter considérablement le olume de données capturées, traitées et stockées par Tealeaf. Pour plus d'informations, contactez les serices professionnels de Tealeaf. Configuration de la gestion de TLI Le déploiement de cet agent de session et la capture du contenu statique requièrent une configuration de bout en bout de Tealeaf. Aant de commencer, ous deez ous familiariser aec les exigences et configurer l'agent de session et son pipeline dans le contexte des étapes globales. Voir "Gestion des archies statiques" dans le document IBM Tealeaf cximpact - Guide d'administration. Configuration de pipelines pour les archies statiques L'architecture de base des pipelines de traitement TLI consiste à extraire le contenu de l'un de os pipelines Windows existants et à l'enoyer à un pipeline Windows dédié à l'insertion de contenu statique dans des fichiers.tli. Voir «Hypothèses de déploiement», à la page 394. L'archiage statique nécessite de modifier les pipelines suiants : «Principal pipeline de traitement», à la page 395 : dans otre pipeline de traitement Windows principal, ous deez insérer l'agent de session RTA pour transmettre le contenu statique au sereur TLI. Voir «Principal pipeline de traitement», à la page 395. «Pipeline de traitement TLI», à la page 395 : sur le sereur TLI, ous deez configurer un pipeline pour capturer le contenu statique et le stocker dans le fichier TLI approprié. Voir «Principal pipeline de traitement», à la page 395. Chapitre 4. Agents de session de pipeline CX 393

404 Hypothèses de déploiement Les instructions de configuration répertoriées ci-dessous reposent sur plusieurs hypothèses : Le pipeline TLI est installé sur une machine distincte dédiée à la capture du contenu statique et à son stockage dans des fichiers TLI. Ce sereur TLI ne contient aucun autre pipeline. Dans un pipeline Canister, le contenu statique est extrait du pipeline et transmis au sereur TLI. Remarque : L'agent de session TLI ne doit pas être déployé dans un pipeline Windows où un autre traitement est effectué. Cet agent de session requiert un pipeline Windows dédié et, si possible, une machine dédiée distincte. D'autres déploiements sont possibles. Pour plus d'informations, euillez contacter les serices professionnels de Tealeaf. Flux de traaux de configuration Le contenu statique doit être séparé des autres données de session dès que possible lors du traitement sur les sereurs Windows. Les olumes de contenu statique pouant être considérables, ous deez en minimiser le traitement aec les autres agents de session, qui ne pourront pas effectuer d'actions sur ces données principalement binaires. Il est recommandé de déployer l'agent de session RTA immédiatement après un agent de session Decouple au début de chaque pipeline Windows. Des informations supplémentaires sont fournies dans le flux de traaux de configuration. 394 IBM Tealeaf CX - Guide de configuration 1. Aant de commencer, le logiciel Tealeaf doit être installé sur le sereur TLI. Voir "Gestion des archies statiques" dans le document IBM Tealeaf cximpact - Guide d'administration. 2. A l'aide de TMS, accédez à l'éditeur de pipeline sur le sereur TLI. 3. Créez un pipeline. Voir "Editeur de pipeline TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. 4. Spécifiez les agents de session du pipeline de traitement TLI. Voir «Pipeline de traitement TLI», à la page Insérez l'agent de session TLI. Voir «Ajout de l'agent de session», à la page Configurez les paramètres de l'agent de session TLI. Voir «Configuration de l'agent de session TLI», à la page Le sereur TLI est maintenant configuré et prêt à receoir des données du pipeline Windows principal. 8. A l'aide de TMS, insérez l'agent de session RTA dans le pipeline sur le Canister ou la machine HBR qui transmettra le contenu statique au sereur TLI. Cet agent de session doit être configuré pour transmettre le contenu des réponses des types MIME appropriés au pipeline de traitement TLI. Voir «Principal pipeline de traitement», à la page Une fois que ous aez terminé la configuration, ous deez actier la capture d'un seul type de contenu ia la PCA pour le tester. Vous pouez utiliser ce test pour déterminer la capture et le stockage du contenu statique et les impacts potentiels sur la bande passante et l'espace de stockage requis. Voir "Console Web de la PCA - Onglet Pipeline" dans le document IBM Tealeaf Passie Capture Application - Guide. 10. Vous pouez continuer d'actier des types de contenu en fonction de os besoins.

405 Pipeline de traitement TLI Le pipeline utilisé pour insérer un contenu statique dans le fichier.tli actuel requiert la configuration minimale suiante : Decouple > Inflate > TLI > Null Remarque : Pour le pipeline de traitement TLI, Tealeaf recommande d'utiliser l'agent de session Decouple au lieu de l'agent de session DecoupleEx. L'agent de session DecoupleEx inclut des fonctionnalités de spoulage, qui peuent retarder l'insertion dans la base de données TLI et perturber les horodatages sur les objets. En dehors de l'enironnement TLI, TLI recommande l'agent de session DecoupleEx pour les pipelines qui traitent les hits de session. Remarque : L'agent de session TLI doit être configuré de sorte que son agent de session en aal soit l'agent de session Null. Voir «Ajout de l'agent de session», à la page 400. Remarque : Dans presque tous les enironnements, l'agent de session Confidentialité n'est pas nécessaire pour le pipeline TLI. La plupart du contenu statique correspondant à des fichiers binaires ou statiques, il est peu probable qu'un contenu statique requiert des mesures de sécurité. En règle générale, si un objet requiert que la confidentialité lui soit appliquée, il n'appartient sans doute pas à une archie statique. Principal pipeline de traitement Déploiement de RTASplit Ci-dessous, ous pouez examiner le pipeline de traitement de contenu principal minimal sous forme de liste d'agents de session. Plus spécifiquement, l'agent de session RTASplit doit être inséré et configuré pour acheminer le contenu statique ers le pipeline de traitement TLI. Decouple > RTASplit > (autres agents de session, y compris Confidentialité) > Null Remarque : L'agent de session RTASplit doit être déployé dès que possible dans le pipeline, de sorte que les agents de session en aal n'aient pas à traiter inutilement du contenu statique. Tealeaf recommande de le déployer immédiatement après l'agent de session Decouple. Ce déploiement peut aoir un impact sur la taille des fichiers spoule. RTASplit peut être déployé ia l'éditeur de pipeline dans TMS. Si l'agent de session est ajouté ia TMS : L'agent de session RTASplit dans le pipeline doit être configuré. Voir «Configuration de RTASplit». Une référence de fichier de configuration RTASplit est ajoutée sous le noeud Serice de transport, sur le sereur sur lequel il a été déployé. Ce fichier ini est utilisé pour définir les règles appliquées à RTASplit. Voir «Règles RTASplit», à la page 396 Voir "Editeur de pipeline TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. Configuration de RTASplit Une fois que l'agent de session RTASplit a été déployé dans le pipeline de traitement principal, ous pouez utiliser l'exemple de configuration ci-après comme base de modification du comportement de l'agent de session. Les éléments clés de la configuration sont décrits sous l'exemple. Chapitre 4. Agents de session de pipeline CX 395

406 [RTASplit] TypeName=RTASplit DLL=SessionAgentPipelineSplitter.dll DownStreamConfigSection=<NEXT CONFIG SECTION> ScriptTrace=OFF RTAIni=RTASplit.ini ResponseType=All EnironmentScript=EngineEnironment.tcl PreProcScript=RTA.PreProc.tcl ActionScript=RTA.Action.tcl # TLI pipeline PipelineConfig1=HitRouter_Pipeline1.cfg # Null pipeline PipelineConfig2=HitRouter_Pipeline2.cfg Vous trouerez ci-après les éléments clés de la configuration que ous souhaitez modifier. Remarque : Tealeaf recommande de ne pas modifier les autres configurations, à moins que Tealeaf ne ous le demande explicitement. zone Description PipelineConfig1 Nom de fichier du pipeline qui reçoit le contenu de la règle 2, comme défini ci-dessous. Remarque : Ne modifiez pas ce nom de fichier. PipelineConfig2 Nom de fichier du pipeline qui reçoit le contenu de la règle 1, comme défini ci-dessous. Remarque : Ne modifiez pas ce nom de fichier. Ajout de pipelines Pour la configuration TLI, aucun autre pipeline n'est requis. Si otre enironnement requiert des configurations RTA supplémentaires : Ajoutez une référence similaire à la suiante : # Null pipeline PipelineConfig3=HitRouter_Pipeline3.cfg Copiez l'un des autres fichiers de configuration de pipeline et éditez-le pour y inclure la configuration d'agent de session requise pour otre noueau pipeline. Editez les règles RTA pour enoyer les données requises au noueau pipeline. Remarque : Si ous deez mettre une règle en commentaire, insérez un dièse (#) en début de ligne, pour désactier la ligne. Règles RTASplit L'agent de session RTASplit doit être configuré pour détecter les types MIME des réponses à transmettre au pipeline de traitement TLI. Vous trouerez ci-dessous des exemples de règle permettant d'acheminer le contenu au système de destination. 396 IBM Tealeaf CX - Guide de configuration

407 Pour configurer les règles RTASplit : 1. Dans le portail Tealeaf, sélectionnez Tealeaf > TMS. Tealeaf Management System s'affiche. Voir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. 2. Dans le menu déroulant Afficher, sélectionnez Sereurs. 3. Sélectionnez le sereur sur lequel se troue le pipeline de traitement principal. 4. Cliquez sur le noeud Serice de transport. 5. Cliquez sur le noeud du fichier de configuration RTASplit. Remarque : Si ce fichier n'est pas présent, l'agent de session RTA n'a pas été déployé dans otre pipeline. Voir "Editeur de pipeline TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. 6. Cliquez sur Afficher/Modifier. 7. Le fichier de configuration des règles RTA est affiché. Vous trouerez ci-dessous un ensemble de règles RTAsplit permettant de dérouter le contenu statique du pipeline dans lequel l'agent de session RTA est déployé ers le sereur TLI afin qu'il puisse être capturé par l'agent de session TLI. # # The below rules searches the ResponseType for a match and routes the current # hit to Pipe0 or Pipe1. # This is an example is intended to be used with a TLI session agent # configured in Pipe1. # <RULE NUM="1" STATUS="ENABLED" DESCRIPTION="ResponseType to Pipe 2" Stoprules="YES" > <GROUP TYPE="REQTest" REQF="ResponseType" REQOP="EQ" REQVAL="unknown"> </GROUP> <GROUP TYPE="REQTest" REQF="StatusCode" REQOP="EQ" REQVAL="304"> </GROUP> <GROUP TYPE="REQTest" REQF="URL" REQOP="REGEXPR" REQVAL="(\.js \.gif \.jpg)"> </GROUP> <GROUP TYPE="SetPipeID" PipeID="2" Type="SET"> </GROUP> </Rule> <RULE NUM="2" STATUS="ENABLED" DESCRIPTION="ResponseType to Pipe 1" Stoprules="YES" > <GROUP TYPE="REQTest" REQF="ResponseType" REQOP="REGEXPR" REQVAL="(image x-jaascript css)"> </GROUP> <GROUP TYPE="SetPipeID" PipeID="1" Type="SET"> </GROUP> </Rule> # Règle Description REGLE 1 Cet ensemble de règles enoie un contenu non statique au pipeline 2 (oir HitRouter_PipeLine2_TLI_sample.cfg ci-dessous), en fonction des regroupements suiants : Tout contenu aec un type de réponse inconnu Tout contenu incluant un message de code de statut 304. Ce code indique que le contenu n'a pas été modifié depuis la dernière fois qu'il a été demandé, ce qui signifie qu'il a été mis en cache dans le naigateur et a déjà été traité pour être capturé en tant que nouel élément de contenu. Chapitre 4. Agents de session de pipeline CX 397

408 Tout contenu n'ayant pas une extension.js,.gif ou.jpg Voir «Pipeline 2», à la page 399. REGLE 2 Cet ensemble de règles enoie le contenu statique au pipeline 1 (oir HitRouter_PipeLine1_TLI_sample.cfg ci-dessous), en fonction de l'expression régulière qui associe le type de réponse aux types image, x-jaascript ou css. Remarque : En fonction des types de contenu de otre application Web, il peut être nécessaire de déelopper cette liste. Les types de contenu supplémentaires doient être actiés pour capture ia l'onglet Pipeline de la console Web de la PCA. Voir "Console Web de la PCA - Onglet Pipeline" dans le document IBM Tealeaf Passie Capture Application - Guide. Voir «Pipeline 1». Configuration du pipeline RTASplit Vous trouerez ci-après des exemples de configuration pour les pipelines spécifiques à l'agent de session RTASplit. Lorsque les données sont transmises ia l'agent de session RTASplit, les règles ci-dessus indiquent les pipelines auxquels les données sont transmises. En fonction des configurations ci-après, les données sont traitées et, lors de la configuration de RTA pour la gestion du contenu statique, elles sont transmises au sereur TLI ia le Pipeline 1. Remarque : Lorsqu'il est utilisé dans le pipeline TLI, l'agent de session RTA est un agent de session aancé et ne doit être déployé qu'après consultation des serices professionnels de Tealeaf. Pipeline 1 Ce pipeline reçoit le contenu statique de l'agent de session RTA, comme défini dans la règle 2 ci-dessus. [StatusMaster] DLL=StatusMaster.dll AppName=TeaLeafHR1 [Globals] DownStreamConfigSection=Decouple # Child pipelines should hae a Decouple session agent, the Decoupler # allows for sending hits down multiple pipelines to be a parallel operation. # Otherwise data sent down multiple pipelines would become a serial # operation, and any delay (eg, socket haing to reconnect) will impact the # speed/performance of possible other child pipelines. # [Decouple] TypeName=Decouple DLL=SessionAgentDecouple.dll MaxQueueSize=2500 DownStreamConfigSection=Inflate [Inflate] TypeName=Inflate DLL=SessionAgentInflate.dll UnReqCancelled=True MaxInflateSize=512KB DownStreamConfigSection=RTA #DownStreamConfigSection=TLI # Inflate or Deflate Stuff #Mode=Deflate 398 IBM Tealeaf CX - Guide de configuration

409 Mode=Inflate # use only when querystring needs to be modified. [RTA] TypeName=RTA DLL=SessionAgentRulesEngine.dll DownStreamConfigSection=TLI RTAIni=TLI_RTA.ini ScriptTrace=ON ResponseType=All EnironmentScript=EngineEnironment.tcl PreProcScript=RTA.PreProc.tcl ActionScript=RTA.Action.tcl [TLI] TypeName=TLI DLL=SessionAgentTLI.dll MaxImageSize=1MB DownStreamConfigSection=Null MimeTypes=image/jpeg,image/gif,application/x-jaascript #-- Leae it commented out for <installbasedir>\system\tli #TliDirectory=C:\Tealeaf\System\TLI Log=OFF LogLeel=INFO #-- Leae it commented out for <installbasedir>\logs #LogDir=C:\TeaLeaf\Logs # Disk Quota Controls (identical to SessionAgentArchie) # DiskQuotaDLL=DiskQuota.dll DiskQuotaPctFree=10 DiskQuotaScanTimeSeconds=20 [Null] TypeName=Null DLL=SessionAgentNull.dll Pipeline 2 D'après les règles ci-dessus, ce pipeline enfant gère le contenu non statique. En tant que tel, le contenu passe par l'agent de session Decouple, qui gère la régulation du contenu dans les pipelines pour que le traitement puisse être effectué en parallèle. Le pipeline est immédiatement arrêté aec l'agent de session Null, après quoi il est retransmis au pipeline parent et entre dans l'agent de session défini pour receoir le contenu après l'agent de session RTA. [StatusMaster] DLL=StatusMaster.dll AppName=TeaLeafHR2 [Globals] DownStreamConfigSection=Decouple # Child pipelines should hae a Decouple session agent, the Decoupler # allows for sending hits down multiple pipelines to be a parallel operation. # Otherwise data sent down multiple pipelines would become a serial # operation, and any delay (eg, socket haing to reconnect) will impact # the speed/performance of possible other child pipelines. # [Decouple] TypeName=Decouple Chapitre 4. Agents de session de pipeline CX 399

410 DLL=SessionAgentDecouple.dll MaxQueueSize=2500 DownStreamConfigSection=Null [Null] TypeName=Null DLL=SessionAgentNull.dll Désactiation de DelImages Si ous aez déployé l'agent de session Dépose de données dans otre pipeline TLI ou tout pipeline qui alimente le pipeline TLI, érifiez que la fonction DelImages a été désactiée. Actiée par défaut, cette fonction supprime le contenu statique et notamment les images, les feuilles de style et les scripts Jaa des hits qui passent par le pipeline. Pour que l'archie statique capture correctement ce contenu, elle doit rester dans le hit jusqu'à ce que l'agent de session TLI la oit. Ajout de l'agent de session Remarque : A partir de la PCA Build 3502, cette fonctionnalité peut être actiée dans le pipeline PCA. Si ous aez installé la PCA Build 3502 ou ultérieur, érifiez que cette fonction est désactiée dans l'onglet Pipeline. Voir "Suppression des images dans la PCA" dans le document IBM Tealeaf Passie Capture Application - Guide. Voir «Agent de session Dépose de données», à la page 254. Remarque : N'actiez pas la capture du contenu statique sur l'application PCA tant que ous n'aez pas terminé la configuration de l'agent de session TLI. Pour ajouter l'agent de session, ous pouez utiliser l'éditeur de pipeline TMS pour créer le pipeline et spécifier la plupart de son agent de session : Decouple > Inflate > TLI > Null Tous les agents de session ci-dessus peuent être ajoutés ia l'éditeur de pipeline dans le système de gestion Tealeaf. Effectuez les étapes ci-après pour insérer l'agent de session TLI dans otre pipeline de capture sur le sereur TLI. Remarque : Ces étapes supposent que ous aez déjà créé le pipeline aec tous les agents de session, à l'exception de l'agent de session TLI, et que ous aez sauegardé la configuration sur le sereur. Pour plus d'informations sur la création du pipeline, oir "Ajout de pipelines" dans le document IBM Tealeaf cximpact - Guide d'administration. Pour plus d'informations sur l'ajout d'un agent de session, oir "Ajout d'agents de session" dans le document IBM Tealeaf cximpact - Guide d'administration. Pour plus d'informations sur l'emplacement du portail dans lequel ous effectuez ces modifications de configuration, oir "Editeur de pipeline TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. 1. Insérez l'agent de session TLI dans otre pipeline. 2. Placez l'agent de session immédiatement après l'agent de session Déploiement. 3. Editez l'agent de session. 4. Configurez les paramètres si nécessaire. Voir «Configuration de l'agent de session TLI», à la page IBM Tealeaf CX - Guide de configuration

411 5. Dans les paramètres de configuration TLI, érifiez que le paramètre suiant est spécifié : DownStreamConfigSection=Null 6. Le paramètre ci-dessus détermine que le prochain agent de session après l'agent de session TLI est l'agent de session Null, ce qui correspond à la configuration correcte. 7. Sauegardez la configuration. Vous aez spécifié le pipeline. 8. L'étape suiante consiste à configurer les autres paramètres de l'agent de session. Vous pouez laisser le fichier ouert pour passer à la section suiante. Voir «Configuration de l'agent de session TLI». Configuration de l'agent de session TLI Une fois que ous aez configuré le pipeline TLI pour capturer le contenu statique, ous deez configurer l'agent de session TLI dans le pipeline. Cet agent de session analyse le contenu en fonction d'une liste de types MIME configurée. Si des types MIME correspondants sont détectés, l'agent de session génère un identificateur unique pour l'objet à l'aide d'un total de contrôle calculé du contenu et de l'url d'où il proient. Cet identificateur est comparé aux identificateurs des objets déjà stockés dans le fichier.tli actif. En l'absence de correspondance aec un identificateur existant, l'objet statique est inséré dans l'archie statique. Remarque : Le contenu statique seri par un réseau de distribution de contenu tel qu'akamai est téléchargé dans le naigateur du isiteur et peut donc être capturer par l'agent de session TLI. Par défaut, l'agent de session TLI est configuré pour capturer les types mime suiants : image/jpeg image/gif application/x-jaascript Remarque : Si la PCA n'a pas encore été configurée pour capturer les types MIME souhaités, ces derniers n'apparaissent jamais dans le pipeline Windows et ne sont pas capturés à ce stade. L'actiation de la capture de ces types MIME ia la PCA est la dernière étape de la configuration, après quoi, le contenu statique passe par le système et le olume de données peut augmenter considérablement. Vous trouerez ci-après un exemple de configuration de l'agent de session TLI tel qu'il apparaît dans le fichier TealeafCaptureSocket.cfg. Remarque : Si possible, ous deez utiliser Tealeaf Management System pour effectuer os modifications de configuration. Les informations ci-dessous sont fournies car elles contiennent de la documentation supplémentaire. # # Tealeaf Image Content File # # MimeTypes - Mimetype(s) to add to TLI file. # MaxImageSize - Max size of indiidual content added to TLI file. # TLIDirectory - Directory where TLI files are written. # # Logging Controls # Log -- either ON/OFF # LogLeel -- either ERROR/WARNING/INFO/DEBUG Chapitre 4. Agents de session de pipeline CX 401

412 # LogDir -- log directory. Default "<Tealeaf Install Directory>\Logs" [TLI] TypeName=TLI DLL=SessionAgentTLI.dll MaxImageSize=1MB DownStreamConfigSection=Null MimeTypes=image/jpeg,image/gif,application/x-jaascript #-- Leae it commented out for <installbasedir>\system\tli #TliDirectory=C:\Tealeaf\System\TLI Log=ON LogLeel=INFO #-- Leae it commented out for <installbasedir>\logs #LogDir=C:\TeaLeaf\Logs # Disk Quota Controls (identical to SessionAgentArchie) # DiskQuotaDLL=DiskQuota.dll DiskQuotaPctFree=20 DiskQuotaScanTimeSeconds=20 Paramètre Description DLL Définissez cette aleur sur SessionAgentTLI.dll. MaxImageSize Taille maximale autorisée pour les fichiers image. Par défaut, cette aleur est de 1Mo. DownStreamConfigSection Ce paramètre spécifie l'agent de session suiant dans le pipeline auquel la sortie de celui-ci est transmise. Remarque : Pour l'agent de session TLI, cette aleur doit être Null. Ne transmettez pas de contenu statique aux autres agents de session une fois qu'il a été inséré ou rejeté par l'agent de session TLI. MimeTypes Définit les types MIME capturés dans l'archie statique. Par défaut, les types MIME suiants sont capturés dans les archies statiques : image/jpeg,image/gif,application/x-jaascript Remarque : Ces types MIME doient être configurés pour être capturés par IBM Tealeaf CX Passie Capture Application, qui supprime le contenu statique par défaut. Voir "Console Web de la PCA - Onglet Pipeline" dans le document IBM Tealeaf Passie Capture Application - Guide. Remarque : Si le sereur TLI détecte un type de contenu qui ne se troue pas dans cette liste, le type de contenu est automatiquement supprimé de tout autre traitement. Log Pour actier la consignation, spécifiez la aleur ON. Voir «Journalisation», à la page 406. LogLeel Définissez le nieau de consignation de l'agent de session TLI. Remarque : Les seuls nieaux de consignation actuellement pris en charge sont INFO/DEBUG. Voir «Journalisation», à la page IBM Tealeaf CX - Guide de configuration

413 DiskQuotaDLL Indique le fichier.dll qui gère la sureillance de gestion des disques du répertoire TLI. Cette aleur doit être égale à DiskQuota.dll. Voir «Gestion de l'espace disque», à la page 406. DiskQuotaPctFree Configure le pourcentage le plus faible autorisé pour l'espace disque disponible. Voir «Gestion de l'espace disque», à la page 406. DiskQuotaScanTimeSeconds Interalle en secondes entre les recherches d'espace disponible par le gestionnaire de disques dans le répertoire TLI. Voir «Gestion de l'espace disque», à la page 406. Heure d'enregistrement L'agent de session TLI est automatiquement configuré pour enregistrer l'archie statique du jour à 0h01. Lorsque l'archie est enregistrée, l'archie statique actuelle est fermée, un fichier.tli est créé et le contenu statique y est ajouté. A l'aide du Serice de planification, ous pouez configurer des traaux de fusion de sorte qu'ils fusionnent le contenu quotidien de TLI dans l'archie mensuelle. Voir "Configuration des traaux TLI" dans le document IBM Tealeaf CX - Guide de configuration. L'agent de session TLI peut être déployé par l'intermédiaire de l'éditeur de pipeline TMS. Une configuration supplémentaire est nécessaire. Voir "Editeur de pipeline TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. Noms de fichier TLI Les fichiers.tli sont stockés dans les répertoires TLI à l'aide des masques de désignation ci-après. Fichier TLI Nom de fichier Quotidien StaticFiles_YYYYMMDD.tli Mensuel MergeStaticFiles_YYYYMMDD.tli Voir "Fichiers TLI" dans le document IBM Tealeaf cximpact - Guide d'administration. Chapitre 4. Agents de session de pipeline CX 403

414 Spécification des répertoires TLI L'agent de session TLI requiert trois répertoires à configurer pour le stockage des données générées par TLI : Tableau 40. Spécification des répertoires TLI Répertoire Paramètre Description Répertoire TLI Sauegarde TLI TLIDirectory TLIBackupPath Répertoire dans lequel les fichiers TLI quotidiens sont créés et stockés aant d'être fusionnés dans les fichiers TLI mensuels, qui sont stockés dans le même répertoire. Remarque : Si ous spécifiez un répertoire autre que le répertoire par défaut, ous deez appliquer la modification au paramètre TLIPath dans la configuration du sereur de recherche, à l'aide de TMS. Voir «Modification des répertoires TLI sur le sereur de recherche». Répertoire dans lequel les fichiers TLI quotidiens fusionnés sont stockés une fois qu'ils ont été supprimés du répertoire TLI principal. Ce paramètre est configuré ia le sereur de recherche. Voir «Modification des répertoires TLI sur le sereur de recherche». Remarque : Ce répertoire ne peut pas se trouer dans le répertoire principal de TLI. Si ous spécifiez un répertoire autre que le répertoire par défaut, ous deez appliquer la modification au sereur de recherche ia TMS. Voir «Modification des répertoires TLI sur le sereur de recherche». Pour plus d'informations sur la fusion des fichiers TLI, oir "Configuration des traaux de fusion TLI" dans le document IBM Tealeaf CX - Guide de configuration Journaux LogDir Répertoire dans lequel les fichiers journaux TLI sont stockés si la consignation est actiée. Par défaut, la consignation est désactiée et ce répertoire est le répertoire principal des journaux Tealeaf. Voir «Journalisation», à la page 406. Modification des répertoires TLI sur le sereur de recherche Lorsque ous modifiez le paramètre du répertoire principal de TLI ou du répertoire de sauegarde de TLI, ous deez appliquer la modification à la configuration du sereur de recherche ia TMS. Effectuez les étapes ci-après pour effectuer la modification. 404 IBM Tealeaf CX - Guide de configuration

415 1. Une fois que ous aez appliqué la modification à l'agent de session TLI, sauegardez la configuration. Voir "Editeur de pipeline TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. 2. Si ous ne ous trouez pas actuellement dans Tealeaf Management System, dans le menu du portail, sélectionnez Tealeaf > TMS. Voir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. 3. Cliquez sur l'onglet WorldView. 4. Dans le menu déroulant Afficher, sélectionnez Sereurs. 5. Sélectionnez le sereur sur lequel se troue le pipeline de traitement TLI. Remarque : Ces mises à jour ne doient être appliquées qu'au sereur de recherche hébergé par le sereur TLI. 6. Ourez le noeud Sereur de recherche. 7. Cliquez sur Configuration du sereur de recherche. 8. Dans la sous-fenêtre Actions de configuration, cliquez sur Afficher/Modifier (Brut). 9. La configuration brute du sereur de recherche est affichée. Cliquez sur le noeud Par défaut. 10. Spécifiez le chemin d'accès au fichier local pour l'un des paramètres suiants ou les deux, en fonction des aleurs que ous aez spécifiées pour l'agent de session TLI : Paramètre du sereur de recherche Description TLIPath Paramètre du répertoire principal de TLI. Doit correspondre à la aleur de TliDirectory dans l'agent de session TLI TLIBackupPath Paramètre du répertoire de sauegarde de TLI sur le sereur TLI. Doit correspondre à la aleur spécifiée pour TliBackupDir dans l'agent de session TLI. Remarque : Ce répertoire ne peut pas se trouer dans le répertoire principal de TLI. Il peut s'agir d'un répertoire distinct sur le même périphérique de stockage, ce qui est recommandé. Si ous créez ce répertoire sur le même olume de stockage que le répertoire principal et que ous actiez la sureillance de l'espace disque, l'espace disponible de ce répertoire de sauegarde est sureillé. Le répertoire n'est pas sureillé s'il se troue sur un autre périphérique de stockage. Voir «Gestion de l'espace disque», à la page Sauegardez les modifications apportées à la configuration. Modification des répertoires TLI sur le sereur de relecture Chaque instance du sereur de relecture dans otre enironnement doit connaître l'emplacement du sereur TLI et les aleurs de chemin appropriées. Cette configuration doit être appliquée à chaque instance du sereur de relecture ia TMS. Voir «Configuration du sereur de relecture», à la page 74. Chapitre 4. Agents de session de pipeline CX 405

416 Journalisation L'agent de session TLI peut être configuré pour générer des informations de consignation. Remarque : Le nieau de consignation Débogage génère des messages d'information, d'aertissement et d'erreur, qui peuent engendrer des fichiers de taille considérable. Pour cette raison, la consignation est définie sur INFO par défaut. Pour actier la consignation : Dans l'agent de session TLI, ous deez configurer les paramètres suiants : 1. Pour LogDir, configurez le répertoire local dans lequel les journaux de l'agent de session TLI doient être stockés. Si cette aleur n'est pas spécifiée, le répertoire principal des journaux Tealeaf est utilisé : <répertoire_installation_tealeaf>\logs 2. Augmentez la aleur de LogLeel du nieau INFO au nieau DEBUG, si nécessaire. 3. Définissez le paramètre Log sur ON. Sauegardez les modifications. La messagerie au nieau de consignation Débogage est actiée pour l'agent de session TLI. Déboguez les problèmes si nécessaire. Une fois que ous aez résolu le problème, remplacez DEBUG par la aleur d'origine du journal. Si la consignation est actiée, l'agent de session enregistre un fichier journal détaillé dans lequel les erreurs peuent être recherchées. Recherchez la chaîne ERROR dans ce fichier. Gestion de l'espace disque L'agent de session TLI peut être configuré pour sureiller l'espace disponible sur le périphérique de stockage sur lequel se troue le répertoire principal de TLI et générer une alerte du journal des éénements Windows lorsque le pourcentage d'espace disque libre deient inférieur à un seuil spécifié. Remarque : La sureillance de la gestion des disques TLI ne s'applique qu'au répertoire principal de TLI. Si le répertoire de sauegarde de TLI se troue sur un autre périphérique de stockage, ces outils ne sureillent pas l'espace disque libre dans ce répertoire et ne génèrent pas d'alertes à ce sujet. Pour actier la sureillance de l'espace disque sur le périphérique de stockage sur lequel les fichiers TLI sont enregistrés, effectuez les étapes de configuration ci-après. Remarque : Aant de commencer à utiliser l'agent de session TLI, ous deez déterminer la quantité d'espace disque sur le périphérique de stockage désigné et éaluer l'impact potentiel de la capture du contenu statique. Voir "Ealuation de l'impact sur le stockage et le débit des données" dans le document IBM Tealeaf cximpact - Guide d'administration. 406 IBM Tealeaf CX - Guide de configuration

417 1. Dans l'éditeur de pipeline TMS, éditez la configuration de l'agent de session TLI. Voir "Editeur de pipeline TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. 2. Configurez les paramètres de configuration suiants : a. Pour la aleur DiskQuotaDLL, spécifiez DiskQuota.dll. Aucune autre alue n'est actuellement prise en charge. b. Définissez le pourcentage minimale d'espace disque disponible autorisé sur le périphérique de stockage. Si l'espace disque disponible descend en dessous de ce pourcentage, les hits sont supprimés par le pipeline de capture et un message est généré dans le journal des éénements Windows. Le message est le suiant : Session Agent TLI: Disk quota check failed. Disk quota too low. Start dropping hits. c. Affectez au paramètre DiskQuotaScanTimeSeconds l'interalle en secondes auquel le gestionnaire de disque recherche l'espace disponible dans le répertoire TLI. Par défaut, cette aleur est de 20 secondes. Aucune modification n'est normalement requise. 3. Sauegardez les modifications apportées à la configuration. Si le seuil du pourcentage minimal est dépassé, un message d'erreur est généré dans le journal des éénements Windows du sereur TLI désigné. Vous pouez sureiller le journal des éénements du sereur TLI ia le portail. Voir "Journal des éénements Windows" dans le document IBM Tealeaf cximpact - Guide d'administration. Ces contrôles de gestion de disque sont identiques à ceux utilisés par l'agent de session Archiage. Voir «Agent de session Archiage», à la page 238. Agents de session Tealeaf «Ajout d'un agent de session», à la page 237 «Agent de session Archiage», à la page 238 "Agent de session Indexation des attributs" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session Canister», à la page 249 «Agent de session Analyseur de cookie», à la page 252 «Agent de session Dépose de données», à la page 254 «Agent de session Analyseur de données», à la page 260 «Agent de session Decouple», à la page 264 «Agent de session DecoupleEx», à la page 266 «Agent de session Confidentialité étendue», à la page 275 «Agent de session Health-Based Routing (HBR)», à la page 278 «Agent de session Déploiement», à la page 285 «Agent de session Analyseur mobile JSON», à la page 289 «Agent de session Code géré», à la page 303 «Agent de session Null», à la page 306 «Agent de session Confidentialité», à la page 307 «Agent de session RTA (Real-Time Monitoring and Alert)», à la page 341 «Agent de session Balises de réponse pour la demande», à la page 346 «Agent de session Fractionnement RTA», à la page 348 «Agent de session de mise en sessions», à la page 353 Chapitre 4. Agents de session de pipeline CX 407

418 «Agent de session Routeur de session», à la page 350 «Agent de session Socket», à la page 356 «Agent de session Consignateur de statistiques», à la page 358 "Agent de session de référence Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session de référence Tealeaf - Mode existant», à la page 380 «Agent de session Mise en sessions Tealeaf», à la page 384 «Agent de session TimeGrades», à la page 390 Agent de session TLI «Agent de session de décodage d'url» Agent de session de décodage d'url L'agent de session Décodage d'url permet de normaliser les caractères de la section [urlfield] de la mémoire tampon des demandes. Le protocole HTTP n'autorise pas la représentation natie de certains caractères, tels que les deux-points, les points-irgules, les espaces et les perluètes. Les caractères étendus (ceux dont le bit supérieur est défini) et les caractères sur plusieurs octets sont codés par URL. Les caractères codés par Url sont représentés comme la aleur hexadécimale du caractère précédée du signe pourcentage (%). L'espace est une exception de la méthode ci-dessus. Il est représenté par le signe plus (+). Par exemple, la chaîne Now s the time est codées par l'url sous la forme Now%27s+the+time. Ajout de l'agent de session Des agents de session peuent être ajoutés ia l'éditeur de pipeline dans TMS. Voir «Ajout d'un agent de session», à la page 237. Pour plus d'informations sur l'éditeur de pipeline et TMS, oir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Paramètres de configuration Les paramètres de configuration suiants sont disponibles pour cet agent de session : Les aleurs Nom d affichage sont affichées dans TMS, cette méthode étant recommandée pour configurer les agents de session. Voir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Les aleurs Nom sont affichées dans TealeafCaptureSocket.cfg. Tableau 41. Agent de session de décodage d'url Nom d'affichage Nom Description ExcludeType1 ExcludeType1 S'ils sont spécifiés, les types/sources de capture sont exclus de l'opération de décodage d'url. ExcludeType2 ExcludeType2 S'ils sont spécifiés, les types/sources de capture sont exclus de l'opération de décodage d'url. 408 IBM Tealeaf CX - Guide de configuration

419 Tableau 41. Agent de session de décodage d'url (suite) Nom d'affichage Nom Description Exclude Vars ExcludeVars Si elles sont spécifiées, les ariables répertoriées dans la section [urlfield] sont exclues de l'opération de décodage d'url. Utilitaires du pipeline CX Agents de session Tealeaf «Ajout d'un agent de session», à la page 237 «Agent de session Archiage», à la page 238 "Agent de session Indexation des attributs" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session Canister», à la page 249 «Agent de session Analyseur de cookie», à la page 252 «Agent de session Dépose de données», à la page 254 «Agent de session Analyseur de données», à la page 260 «Agent de session Decouple», à la page 264 «Agent de session DecoupleEx», à la page 266 «Agent de session Confidentialité étendue», à la page 275 «Agent de session Health-Based Routing (HBR)», à la page 278 «Agent de session Déploiement», à la page 285 «Agent de session Analyseur mobile JSON», à la page 289 «Agent de session Code géré», à la page 303 «Agent de session Null», à la page 306 «Agent de session Confidentialité», à la page 307 «Agent de session RTA (Real-Time Monitoring and Alert)», à la page 341 «Agent de session Balises de réponse pour la demande», à la page 346 «Agent de session Fractionnement RTA», à la page 348 «Agent de session de mise en sessions», à la page 353 «Agent de session Routeur de session», à la page 350 «Agent de session Socket», à la page 356 «Agent de session Consignateur de statistiques», à la page 358 "Agent de session de référence Tealeaf" dans le document IBM Tealeaf CX - Guide de configuration «Agent de session de référence Tealeaf - Mode existant», à la page 380 «Agent de session Mise en sessions Tealeaf», à la page 384 «Agent de session TimeGrades», à la page 390 «Agent de session TLI», à la page 392 Agent de session de décodage d'url Pour faciliter le déeloppement, la sureillance et la maintenance de os pipelines Tealeaf, plusieurs outils sont inclus dans otre solution Tealeaf. Utilisez les liens ci-après pour accéder à la documentation sur ces utilitaires. Utilitaire du pipeline Description Chapitre 4. Agents de session de pipeline CX 409

420 "Editeur de pipeline TMS" dans le document IBM Tealeaf cximpact - Guide d'administration Vous définissez et configurez os pipelines de traitement Tealeaf ia l'éditeur de pipeline dans TMS. Voir "Editeur de pipeline TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. «Lecteur d'archie TeaLeaf - Exécuter les sessions archiées» Lit les fichiers d'archie Tealeaf et les enoie ia des pipelines configurés pour un noueau traitement. «Statut de capture TeaLeaf - Utilitaire de sureillance des pipelines», à la page 412 Sureille le statut des pipelines de capture de Tealeaf. Remarque : Cet utilitaire est maintenant également disponible ia le portail. Voir "Onglet Statut du pipeline TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. «Utilitaire Testeur de confidentialité», à la page 416 Teste les règles, les actions et les tests de confidentialité aant de les déployer dans le flux de capture en direct. Voir «Utilitaire Testeur de confidentialité», à la page 416. Lecteur d'archie TeaLeaf - Exécuter les sessions archiées Le lecteur d'archie lit les fichiers d'archie Tealeaf (.TLA) et enoie les données ia les agents de session de pipeline, en ue d'un traitement supplémentaire. Les opérations effectuées sont généralement celles qui le sont lors de la capture de données en temps réel, à des fins pratiques ou de performances (par exemple, pour appliquer un script de moteur de règles sophistiqué aux données qui peuent aoir un impact négatif sur les performances de capture). Aant de commencer, ous deez lancer le pipeline par l'intermédiaire duquel ous enoyez le fichier.tla. Voir «Démarrage et sureillance du pipeline de capture sur plusieurs sereurs.», à la page 411. Un fichier de configuration est associé au lecteur d'archie Tealeaf. Ce fichier de configuration est similaire aux fichiers de configuration de capture. Pour utiliser le lecteur d'archie Tealeaf : 1. Lancez l'exécutable suiant : <répertoire_installation_tealeaf>\tealeafarchierreader.exe 2. Le lecteur d'archie Tealeaf est affiché : 410 IBM Tealeaf CX - Guide de configuration

421 3. Dans la zone de texte Fichier de configuration, le chemin d'accès au fichier TeaLeafArchieReader.cfg est affiché. Pour sélectionner un autre fichier, cliquez sur Parcourir... et accédez à l'emplacement du fichier. 4. Pour sélectionner un fichier.tla, cliquez sur Ajouter... Pour examiner les en-têtes, demandes et réponses du fichier sélectionné, cliquez sur Examine. Pour générer un récapitulatif du fichier sélectionné, cliquez sur Summarize. Pour supprimer un fichier.tla du sereur, sélectionnez-le et cliquez sur Supprimer. 5. Options : L'option Open for Eery File peut être utilisée si le pipeline Capture est configuré de sorte à se terminer par l'agent de session Archiage et que des fichiers.tla sont créés au cours de ce processus. Si cette option est sélectionnée, chaque fichier.tla de la liste est traité de manière indiiduelle. Si cette option n'est pas sélectionnée, les multiples fichiers sont traités comme un fichier.tla. L'option Sequence Hits permet de traiter les hits de session suiant l'ordre chronologique. 6. Pour commencer le traitement du fichier, cliquez sur Démarrer. Démarrage et sureillance du pipeline de capture sur plusieurs sereurs. Démarrez le sereur de réception aant de démarrer le pipeline de capture. Le sereur de réception est contrôlé par un serice Windows NT dans le panneau de configuration. Une fois que le sereur de réception a été démarré, les sereurs émetteurs peuent l'être à leur tour. Les procédures ci-après fournissent des instructions permettant d'installer le serice dans le panneau de configuration et de démarrer le sereur. Chapitre 4. Agents de session de pipeline CX 411

422 Démarrage du pipeline de capture Démarrez le pipeline de capture à l'aide du serice de transport Tealeaf dans l'applet des serices du panneau de configuration de Windows. Examinez le pipeline démarré à l'aide de l'obserateur d'éénements pour rechercher les erreurs de l'application Tealeaf. Pour démarrer le pipeline de capture sur plusieurs sereurs : 1. Dans le menu Démarrer, cliquez sur Paramètres > Panneau de configuration. 2. Dans le Panneau de configuration, cliquez deux fois sur Serices. 3. Sélectionnez le Serice de transport TeaLeaf. 4. Cliquez sur Démarrer. 5. Cliquez sur Fermer pour fermer la fenêtre Serices. Pour érifier l'obserateur d'éénements : 6. Accédez à Démarrer > Programmes > Outils d'administration > Obserateur d'éénements. 7. Dans l'arborescence Obserateur d'éénements, sélectionnez Journal d'application. 8. Examinez la colonne Source. 9. Vérifiez qu'aucun message d'erreur n'a été généré par le serice de transport Tealeaf. Sureillance du pipeline de capture sur plusieurs sereurs. Vous pouez sureiller l'actiité du sereur Tealeaf ia l'utilitaire du statut de capture de Tealeaf ou Tealeaf Management System. Voir «Statut de capture TeaLeaf - Utilitaire de sureillance des pipelines». Pour plus d'informations sur TMS, oir "Tealeaf Management System" dans le document IBM Tealeaf cximpact - Guide d'administration. Statut de capture TeaLeaf - Utilitaire de sureillance des pipelines A l'aide de l'utilitaire du statut de transport Tealeaf, ous pouez sureiller l'ensemble des pipelines de capture et de traitement de Tealeaf, y compris le traitement par chaque agent dans le pipeline, pour tous les sereurs Tealeaf de otre enironnement. Remarque : Le pipeline Tealeaf peut également être sureillé ia TMS. Dans les ersions futures, l'utilitaire distinct risque de deenir obsolète. Pour plus d'informations sur TMS, oir "Onglet Statut du pipeline TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. L'utilitaire du statut de transport Tealeaf est accessible à partir de l'emplacement suiant dans le menu Démarrer de Windows : 412 IBM Tealeaf CX - Guide de configuration

423 Filtres La zone de liste des filtres contient les différents agents de session (dans l'ordre du pipeline) pour chaque filtre actuellement exécuté sur le système. Après le nom de l'agent de session, il existe des statistiques sur toutes les données, du débit du flux à l'indication comme quoi un agent de session met ou non les données en file d'attente. Lorsque ous cliquez sur chaque filtre, la liste actie des agents et de leurs données reflète le filtre que ous examinez. Cela modifie également les statistiques de filtrage (en regard de la liste des filtres) pour refléter la date et l'heure de début et le nom du filtre. La zone de liste des filtres est le contrôle maître de nieau supérieur permettant de sureiller le pipeline aec l'utilitaire. Assurez-ous d'aoir bien sélectionné le filtre approprié lorsque ous sureillez les statistiques d'un pipeline particulier. Figure 30. Zone de liste Filtres Chapitre 4. Agents de session de pipeline CX 413

424 Connexions La liste des connexions répertorie les connexions acties, leur débit, leur protocole et le nom de la machine sur laquelle elles se trouent. Toutes les connexions en cours sont affichées en permanence et ne peuent pas être ajoutées, supprimées ou sélectionnées. Le numéro d'emplacement correspond à l'adresse mémoire occupée par la connexion dans la mémoire partagée de Tealeaf. Figure 31. Zone de liste Connexions Sous la zone de liste des connexions, des statistiques reflètent l'état général de toutes les connexions de la liste. Actif : nombre de connexions acties à un moment donné. Max : nombre maximal de connexions autorisé. Total : nombre total de connexions depuis que l'application a été lancée. Figure 32. Statistiques de connexion En regard de la zone des statistiques de connexion se troue une zone intitulée "Octets". Cette zone indique le débit total de toutes les connexions. Total : nombre total d'octets transmis par l'ensemble des connexions. Par seconde : nombre d'octets par seconde qui passent par toutes les connexions. Figure 33. Statistiques sur les octets 414 IBM Tealeaf CX - Guide de configuration

425 Sous la zone des statistiques de connexion se troue un ensemble de statistiques sur les pages transférées. Total : nombre total de pages depuis le lancement de l'utilitaire. Par seconde : nombre de pages affichées au cours de la dernière seconde. Taille moyenne : débit au cours de la dernière seconde diisé par le nombre de pages affichées au cours de la dernière seconde. Figure 34. Statistiques de page Graphique de transfert Le graphique de transfert se troue dans le coin inférieur gauche de l'utilitaire. Il indique le transfert total en octets par seconde de toutes les connexions. Il existe également plusieurs boutons d'option permettant à l'utilisateur de modifier l'échelle du graphique pour diers nieaux de transfert. Le graphique ne se recalibre pas automatiquement en fonction de l'échelle car certains sites peuent connaître d'importants écarts de trafic. Le graphique changerait alors en permanence d'échelle à chaque fois que le trafic passe de kilooctets de données à des mégaoctets de données et ice ersa. Cela permet à l'utilisateur de ne sureiller que les moments où l'amplitude est la plus faible ou la plus éleée lors du transfert. Figure 35. Graphique de transfert Le graphique possède également une commande à granularité fine qui permet de diiser les aleurs représentées par ordre de grandeur. Cela est utile si le trafic sature le paramètre ko, mais qu'il n'enregistre pas d'écarts assez précis pour être u sous le paramètre Mo. Chapitre 4. Agents de session de pipeline CX 415

426 Console Serice de transport L'utilitaire Statut de capture ous permet également d'arrêter et de démarrer le serice de transport pour modifier facilement le pipeline. Cela peut s'aérer utile lorsque ous deez apporter des modifications à la configuration d'agent de session et redémarrer le serice pour que ces modifications soient prises en compte. Figure 36. serice de transport Pour arrêter le serice de transport, cliquez sur Arrêter. Pour démarrer ou redémarrer le serice de transport, cliquez sur Démarrer. Minimisation Figure 37. Utilitaire minimisé Enfin, lorsqu'il est minimisé, l'utilitaire est placé dans la barre des tâches système. Il peut ainsi être utilisé tout comme le gestionnaire de tâches et être rappelé lorsque ous le souhaitez. Figure 38. Barre des tâches système de Tealeaf Pour rétablir l'utilitaire, cliquez deux fois dessus ou, à l'aide du bouton droit de la souris, cliquez sur l'icône Tealeaf dans la barre des tâches système et sélectionnez Restaurer. Vous pouez également fermer l'utilitaire à partir de ce menu. Utilitaire Testeur de confidentialité L'utilitaire Testeur de confidentialité permet aux déeloppeurs Tealeaf de créer des règles de confidentialité et d'en tester le comportement dans le pipeline Tealeaf sans aoir a lui soumettre de données de hit. Dans le testeur de confidentialité, ous pouez définir et éditer des règles de confidentialité, puis les tester sur les données que ous collez dans l'utilitaire. Remarque : L'utilitaire Testeur de confidentialité est accessible ia les configurations des agents de session Confidentialité, Confidentialité étendue et RTA (Real-Time Monitoring Alert). Ces agents de session doient être inclus dans otre pipeline Windows pour permettre l'édition de la configuration des règles. 416 IBM Tealeaf CX - Guide de configuration

427 Pour plus d'informations sur l'ajout de ces agents de session, oir "Editeur de pipeline TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. Versions Le testeur de confidentialité permet de tester les règles utilisées par les agents de session Tealeaf suiants, qui sont définies dans les fichiers de configuration ci-dessous : Tableau 42. Versions Agent de session Fichier de configuration Documentation de l'agent de session Confidentialité Priacy.cfg «Agent de session Confidentialité», à la page 307 PriacyEx Priacy.cfg «Agent de session Confidentialité étendue», à la page 275 RTA RTA.ini «Agent de session RTA (Real-Time Monitoring and Alert)», à la page 341 Remarque : Aant de commencer à modifier le fichier, ous deriez sauegarder une ersion de secours de ce fichier. Voir «Sauegarde», à la page 430. Démarrage du testeur de confidentialité Pour les agents de session Confidentialité Pour les agents de session Confidentialité et Confidentialité étendue, effectuez les étapes suiantes pour exécuter le testeur de confidentialité : 1. Connectez-ous au portail Tealeaf en tant qu'administrateur. 2. Pour ourir Tealeaf Management System, sélectionnez Tealeaf > TMS dans le menu du portail. 3. Si ous ne l'aez pas déjà fait, ous deez ajouter l'agent de session Confidentialité ou Confidentialité étendue ia l'éditeur de pipeline dans TMS. Voir "Editeur de pipeline TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. 4. Dans TMS, sélectionnez Sereurs dans le menu déroulant Afficher. 5. Ourez le noeud suiant : Serice de transport > Filtre de confidentialité 6. Cliquez sur Afficher/Modifier. 7. La configuration du filtre de confidentialité s'affiche. Voir «Agent de session Confidentialité», à la page A l'aide de la configuration Filtre de confidentialité, ous pouez tester les définitions de règle de confidentialité de l'une ou l'autre des ersions des règles de confidentialité prises en charge par Tealeaf : a. Pour tester les règles de l'agent de session Confidentialité, cliquez sur Test (Priacy). L'agent de session Confidentialité fournit un ensemble de base de règles de confidentialité. Il a été remplacé par l'agent de session Confidentialité étendue. Voir «Agent de session Confidentialité», à la page 307. Chapitre 4. Agents de session de pipeline CX 417

428 b. Pour tester les règles de l'agent de session Confidentialité étendue, cliquez sur Test (PriacyEx). L'agent de session Confidentialité étendue fournit toutes les règles de confidentialité de l'agent de session Confidentialité, ainsi qu'une prise en charge plus rapide des recherches et de l'internationalisation. Voir «Agent de session Confidentialité étendue», à la page 275. Remarque : L'agent de session Confidentialité a été remplacé par l'agent de session Confidentialité étendue. Chaque fois que possible, utilisez PriacyEx. Voir «Agent de session Confidentialité étendue», à la page Le testeur de confidentialité s'oure. Remarque : Si une configuration est partagée, ous pouez sélectionner le sereur sur lequel le testeur doit être exécuté. Les configurations non partagées sont testées sur le sereur qui possède la configuration. 10. L'utilitaire possède les mêmes fonctions quelle que soit la ersion du testeur de confidentialité. Pour l'agent de session RTA (Real-Time Monitoring Alert) Pour l'agent de session RTA, effectuez les étapes suiantes pour exécuter le testeur de confidentialité pour RTA : 1. Connectez-ous au portail Tealeaf en tant qu'administrateur. 2. Pour ourir Tealeaf Management System, sélectionnez Tealeaf > TMS dans le menu du portail. 3. Si ous ne l'aez pas déjà fait, ous deez ajouter l'agent de session RTA ia l'éditeur de pipeline dans TMS. Voir "Editeur de pipeline TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. 4. Dans TMS, sélectionnez Sereurs dans le menu Afficher. 5. Ourez le noeud suiant : Serice de transport > Configuration de RTA 6. Cliquez sur Afficher/Modifier. 7. La configuration de RTA s'affiche. Voir «Agent de session RTA (Real-Time Monitoring and Alert)», à la page Pour tester les règles de configuration de RTA, cliquez sur Test(RTA). 9. Le testeur de confidentialité s'oure. Remarque : Si une configuration est partagée, ous pouez sélectionner le sereur sur lequel le testeur doit être exécuté. Les configurations non partagées sont testées sur le sereur qui possède la configuration. 10. L'utilitaire possède les mêmes fonctions quelle que soit la ersion du testeur de confidentialité. 418 IBM Tealeaf CX - Guide de configuration

429 Flux de traaux Figure 39. Testeur de confidentialité Si le testeur de confidentialité est démarré, l'onglet Demande et l'onglet Réponse sont préalimentés aec un exemple de demande et de réponse. Vous pouez copier et coller d'autres données à tester dans l'un ou l'autre de ces onglets. Voir «Acquisition d'exemples de données», à la page 420. Chapitre 4. Agents de session de pipeline CX 419

430 Lorsqu'il est exécuté, le testeur de confidentialité crée un fichier Tealeaf.tla contenant la demande et la réponse initiales. Ce fichier est enoyé à ArchieReader, qui applique alors les règles de confidentialité et génère le fichier.tla modifié qui sera affiché par le testeur de confidentialité. Flux de traaux du testeur de confidentialité : Voici le flux de traaux recommandé : 1. Par défaut, le testeur de confidentialité alimente les onglets Demande et Réponse aec des échantillons de données. Toutefois, pour tester des règles spécifiques, il se peut que ous deiez configurer os propres échantillons de données. Vous pouez copier et coller des échantillons de données dans les onglets Demande et Réponse. Si ous le souhaitez, ous pouez en acquérir. Voir «Acquisition d'exemples de données». 2. Modifiez os règles de confidentialité dans l'éditeur approprié, dans TMS. Voir «Edition de règles», à la page Dans l'éditeur, ourez le testeur de confidentialité. Voir «Démarrage du testeur de confidentialité», à la page Vous pouez utiliser les commande copier/coller standard pour alimenter ces onglets aec des données de hit réelles. Remarque : Le testeur de confidentialité ne sauegarde pas le contenu des onglets Demande et Réponse. Vous pouez sauegarder os échantillons de données dans un fichier texte en dehors de l'utilitaire. 5. Pour inclure les informations de consignation de la confidentialité, cochez la case Inclure le journal de confidentialité. Cette option n'est pas disponible dans le testeur de confidentialité de RTA. Voir «Journaux de confidentialité», à la page Exécutez le testeur de confidentialité. Voir «Exécution du testeur de confidentialité», à la page Examinez les résultats dans les onglets de sortie. Voir «Examen des résultats», à la page Itérez les étapes ci-dessus jusqu'à ce que ous soyez satisfait des résultats. 9. Si les modifications apportées à la règle fonctionnent, ous pouez sauegarder le fichier de configuration édité ia TMS. Voir «Sauegarde», à la page 430. Acquisition d'exemples de données 420 IBM Tealeaf CX - Guide de configuration Le testeur de confidentialité ne préalimente pas les onglets Demande et Réponse aec des données lorsqu'il est lancé, mais ous deez fournir des exemples de données qui testent spécifiquement les règles que ous créez. Si l'exemple de données ne contient pas de données identifiées et éaluées par os règles, les résultats en sortie risquent de n'indiquer aucune modification pour des règles qui modifient les données détectées. Remarque : Il est important de collecter des exemples de données qui seront spécifiquement utilisés par les règles de otre déeloppement. Vous deez examiner les données de demande et de réponse en détails pour érifier qu'elles répondent à os critères de test. Vous pouez ous procurer des exemples de données de demande et de réponse auprès des sessions disponibles ia la relecture sur naigateur ou RTV. Remarque : Si ous collez une mémoire tampon des réponses dans son intégralité à partir de RTV, assurez-ous que la ligne HTTP: est la première ligne de la

431 Edition de règles réponse. RTV insère des lignes supplémentaires pour fonctionner correctement, mais ces lignes peuent être à l'origine de problèmes dans l'utilitaire Testeur de confidentialité. L'application IBM Tealeaf CX RealiTea Viewer autonome actie la fonctionnalité de relecture et fournit des ues pour les données de demande et de réponse à partir du bureau Windows. Voir "RealiTea Viewer - Vue Demande" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. Voir "RealiTea Viewer - Vue Réponse" dans le document IBM Tealeaf RealiTea Viewer - Guide d'utilisation. La relecture sur naigateur (BBR, Browser-Based Replay) permet de relire des sessions Tealeaf ia le portail. A l'aide de BBR, ous pouez relire des sessions et examiner les données de demande et de réponse. Voir "Relecture sur naigateur CX" dans le document IBM Tealeaf cximpact - Guide d'utilisation. Si ous testez une réponse correspondant à un document XML, elle ne contient pas d'en-tête. Le testeur de confidentialité tente d'interpréter ces données comme un document HTML ; sans en-tête correctement défini, ce HTML n'est pas alide et le testeur de confidentialité échoue. Pour tester une réponse XML : 1. Dans RTV, sélectionnez Afficher > Afficher en-tête HTTP. 2. Pour afficher la réponse complète, cliquez sur le bouton RSP. 3. Copiez l'intégralité du texte XML aec les en-têtes. 4. Collez l'intégralité du texte dans l'onglet de la réponse du testeur de confidentialité. 5. Testez les données par rapport à l'ensemble de règles que ous aez défini. Vous éditez des règles et lancez le testeur de confidentialité par l'intermédiaire de la configuration appropriée dans TMS. Remarque : La configuration n'apparaît pas dans TMS tant que ous ne l'aez pas ajoutée à otre pipeline ia l'éditeur de pipeline. Voir "Editeur de pipeline TMS" dans le document IBM Tealeaf cximpact - Guide d'administration. Pour plus d'informations sur l'édition des règles : «Agent de session Confidentialité», à la page 307 «Agent de session Confidentialité étendue», à la page 275 «Agent de session RTA (Real-Time Monitoring and Alert)», à la page 341 Une fois que ous aez édité les règles, ous pouez ourir le testeur de confidentialité et tester les règles immédiatement. Remarque : Vous n'aez pas besoin de sauegarder le fichier pour tester les règles de confidentialité ia l'utilitaire. Voir «Démarrage du testeur de confidentialité», à la page 417. Chapitre 4. Agents de session de pipeline CX 421

432 Exécution du testeur de confidentialité Figure 40. Exécution du testeur de confidentialité 1. Si ous ne l'aez pas déjà fait, ous deez coller les exemples de données de demande et de réponse et éditez os règles. Voir «Acquisition d'exemples de données», à la page 420. Voir «Edition de règles», à la page IBM Tealeaf CX - Guide de configuration

433 Examen des résultats 2. Pour inclure les informations de consignation de la confidentialité, cochez la case Inclure le journal de confidentialité. Cette option n'est pas disponible dans le testeur de confidentialité de RTA. Voir «Journaux de confidentialité», à la page Pour exécuter les règles de confidentialité sélectionnées sur le texte des onglets Demande et Réponse, cliquez sur Exécuter. Lors de l'exécution, les informations de consignation sont affichées dans la sous-fenêtre Statut. 4. Une fois que le test est terminé, ous pouez examiner la sortie. Voir «Examen des résultats» ci-après. Une fois que le test est terminé, cliquez sur l'onglet Demande en sortie ou Réponse en sortie pour afficher les résultats de la sortie. Chapitre 4. Agents de session de pipeline CX 423

434 Figure 41. Onglet Demande en sortie Une fois que ous aez exécuté le testeur de confidentialité, ous pouez comparer les différences dans les exemples de demande et de réponse entre les exemples de données en entrée et les résultats de la sortie. Pour comparer les demandes en entrée et en sortie, cliquez sur Demande Diff. Pour comparer les réponses en entrée et en sortie, cliquez sur Réponse Diff. Une fois que les différences sont affichées, ous pouez examiner les résultats côte à côte ou dans une même portion de texte fusionnée. 424 IBM Tealeaf CX - Guide de configuration

435 Vue unifiée : dans Vue unifiée, ous pouez examiner les modifications entre l'entrée et la sortie de la demande ou la réponse dans une même sous-fenêtre. Voir «Vue unifiée», à la page 426. Vue côte à côte : dans Vue côte à côte, ous pouez examiner les modifications entre l'entrée et la sortie dans des panneaux distincts. Voir «Vue côte à côte». Vue côte à côte Dans une ue côte à côte, le texte d'entrée de la demande ou de la réponse est affiché à gauche et la sortie, à droite, les numéros de ligne étant affichés pour faciliter la correspondance des modifications. Vous pouez copier des données de l'une ou l'autre de ces sous-fenêtres. Sélectionnez les données et appuyez sur CTRL+C. Dans l'image ci-dessous, les éléments supprimés apparaissent en gris, tandis que le texte de remplacement apparaît en bleu, à droite. Figure 42. Vue côte à côte Différences entre les ues côte à côte Modification Identificateur Lignes ajoutées ersion pré-test : arrière-plan en gris ersion post-test : arrière-plan en bleu Chapitre 4. Agents de session de pipeline CX 425

436 Lignes supprimées ersion pré-test : arrière-plan en rouge ersion post-test : arrière-plan en gris Lignes mises à jour ersion pré-test : arrière-plan en rouge ersion post-test : arrière-plan en bleu Vue unifiée Dans Vue unifiée, ous pouez examiner les différences entre la réponse ou la demande en entrée et la sortie dans le même panneau. Pour copier des données, sélectionnez-les et appuyez sur CTRL+C. Dans l'image ci-dessous, les éléments supprimés par les règles apparaissent en rouge, tandis que le texte de remplacement apparaît en bleu. 426 IBM Tealeaf CX - Guide de configuration

437 Figure 43. Vue unifiée Différences entre les ues unifiées Modification Identificateur Lignes ajoutées texte en bleu Lignes supprimées texte en rouge Lignes mises à jour ancienne ligne : texte en rouge nouelle ligne : texte en bleu Chapitre 4. Agents de session de pipeline CX 427

438 Journaux de confidentialité Lors de l'exécution, les informations de consignation générées par l'agent de session sont affichées dans la sous-fenêtre Statut. Vous pouez éentuellement choisir d'inclure les informations de consignation de la confidentialité générées par l'agent de session à la fin de la sortie générée. Pour inclure les informations de consignation de la confidentialité, cochez la case Inclure le journal de confidentialité. Remarque : L'inclusion du journal de confidentialité n'est pas disponible dans la ersion RTA du testeur de confidentialité. Dans la sortie, les informations de consignation sont affichées sous la section [priacylog] de la sortie, comme dans l'image ci-dessous : 428 IBM Tealeaf CX - Guide de configuration

439 Figure 44. Journal de confidentialité dans la sortie des demandes Remarque : Toutes les erreurs de la configuration de la confidentialité sont consignées dans le journal des éénements d'application Windows. Pour érifier que le Testeur de confidentialité n'a pas signalé d'erreurs, reportez-ous au journal des éénements d'application Windows. Chapitre 4. Agents de session de pipeline CX 429