Activation du suivi

Introduction

Le système de gestion d'événements (EMS) de Cisco Intelligent Contact Management (ICM) fournit une interface de programme d'application (API) pour les processus ICM à utiliser afin de rapporter des événements. Ce document explique comment activer le suivi afin d'aider à résoudre les problèmes dans Cisco ICM.

Conditions préalables

Exigences

Cisco vous recommande de prendre connaissance des rubriques suivantes :

• Cisco ICM

• Microsoft Windows NT version 4 et Windows 2000

Composants utilisés

Les informations contenues dans ce document sont basées sur les versions de matériel et de logiciel suivantes :

• Cisco ICM versions 4.6.2 et ultérieures

• Microsoft Windows version 4 et Windows 2000

The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. If your network is live, make sure that you understand the potential impact of any command.

Conventions

Pour plus d'informations sur les conventions utilisées dans ce document, reportez-vous à Conventions relatives aux conseils techniques Cisco.

Augmenter le suivi

Il existe deux façons de documenter les problèmes dans Cisco ICM, avec l'API ou en activant le traçage.

API

Utilisez l'API afin de :

• Consignez un événement dans le fichier journal local du service EMS.

• Consigner un événement dans le journal des événements des applications Microsoft Windows NT/2000.

• Envoyer un événement au serveur de base de données pour le stockage dans la base de données Cisco ICM.

• Envoyer un événement au service de transfert du service client central pour livraison au Centre d'assistance technique Cisco (TAC).

Augmenter le suivi

Pour résoudre les problèmes d'ICM, vous pouvez activer le suivi à l'aide de l'une des procédures suivantes :

• Éditeur du Registre Microsoft Windows NT ou Windows 2000

• Utilitaire Regacc

• OPCTest

• contre-essai

• Procmon

Remarque : veillez à désactiver tous les tracés lorsque vous avez terminé. En outre, et c'est plus important, ne laissez pas les fenêtres de commande de processus ouvertes lorsque vous avez terminé le test. Cela affecte considérablement les ressources système, en particulier l'utilisation du processeur et la mémoire.

Éditeur du Registre Windows NT ou Windows 2000

Complétez ces étapes afin d'exécuter regedit32 :

1. Choisissez Start > Run.

2. Tapez regedt32 afin d'ouvrir l'Éditeur du Registre Windows NT ou Windows 2000.

   Voici un exemple des paramètres de l'Éditeur du Registre et du Gestionnaire d'interface de périphérique EMS (PIM). Pour afficher ces paramètres, accédez à ce chemin :

   • Cisco ICM versions 4.6 et antérieures :

     Software\geotel\icr\cust_inst\ICRcomponenttype\EMS\CurrentVersion\
       Library\Processes

   • Cisco ICM versions 5.0 et ultérieures :

     Software\Cisco Systems,Inc.\icm\cust_inst\ICMcomponenttype\EMS\
       CurrentVersion\Library\Processes

   Idéalement, les clés sont affichées à gauche de la fenêtre de l'Éditeur du Registre et les valeurs à droite.

3. Double-cliquez sur la valeur à modifier et la boîte de dialogue Éditeur DWORD s'affiche.

4. Dans le panneau Radix, cliquez sur Hex.

5. Modifiez la valeur.

6. Click OK.

Ce tableau indique les valeurs que vous pouvez modifier dans l'Éditeur du Registre. Les valeurs les plus courantes à modifier sont AllLogFileMax, LogFileMax et TraceMask. Le nombre de fichiers journaux ne doit jamais être modifié.

Valeur	Chemin
FichierJournalEMSAllMax	Taille maximale totale de tous les fichiers journaux EMS pour le processus. La valeur par défaut est 6000000/6 Mo ou 2000000/2 Mo.
NombreFichiersJournauxEMSA	Nombre de fichiers journaux EMS pour le processus. La valeur par défaut est 20 et n'a généralement pas besoin d'être modifiée.
FichierJournalEMSLmax	Taille maximale de chaque fichier journal EMS. La valeur par défaut est 100000 ou 100K.
MasqueCourseEMST	Bit de suivi permettant au processus d'enregistrer davantage de données dans les fichiers journaux EMS. 0 est établi par défaut.
DonnéesUtilisateurEMSU	Laissez ce champ vide. La définition des bits de trace dans procmon remplit automatiquement ce champ.
AffichageEMSDsurÉcran	La valeur par défaut est 1. Définissez cette valeur sur 0 afin de ne pas afficher les données dans la fenêtre de processus. Cette opération sollicite moins le processeur et facilite l'accès à pcAnywhere.

Si vous devez augmenter le traçage afin de dépanner, déterminez d'abord la quantité d'espace disque libre sur la machine. Si l'espace disque disponible est suffisant, effectuez les modifications suivantes :

• Définissez EMSAllLogFileMax sur 100 Mo.

  Remarque : vérifiez d'abord que vous disposez d'un espace disque suffisant sur le lecteur sur lequel Cisco ICM est installé.

• Définissez EMSLogFileMax sur 10 Mo.

• Définissez EMSDisplayToScreen sur 0.

• Les modifications du Registre doivent être effectuées pour chaque processus à partir duquel vous prévoyez de collecter des journaux.

  Remarque : Mémoriser EMSAllLogfilesMTax est cumulatif. Si vous définissez EMSAllLogfilesMax sur 100 Mo pour OPC, PIM1, PIM2 et CTISVR, vous utilisez 400 Mo d'espace disque disponible.

• Les tailles de fichier suggérées ne sont qu'un point de référence. Les centres de contact importants et très occupés peuvent avoir besoin d'augmenter EMSAllLogfilesMax afin de s'assurer que les journaux ne sont pas écrasés.

Afficher les messages suivis

Une fois les messages capturés, affichez-les avec l'utilitaire dumplog EMS. Dumplog lit un fichier journal EMS, formate les données d'événement et écrit les données formatées dans un fichier de sortie. Si le fichier journal inclut des événements de suivi de message, chaque message suivi apparaît au format décodé dans la sortie dumplog.

Lorsque les données sont capturées, réinitialisez les valeurs que vous avez modifiées.

Utilitaire Regacc

L'utilitaire regacc est piloté par commande et peut être utilisé dans une session Telnet. Tapez regacc à l'invite de commandes. Ce tableau répertorie les commandes regacc les plus courantes :

Commande	Ce qu'il fait
régd	Modifie le répertoire de Registre actuel.
répertoire	Répertorie le répertoire de Registre actuel.
regpwd	Imprime le répertoire de travail en cours.
régresser	Définit une nouvelle valeur de Registre dans le répertoire de Registre actif.
q	Quitte l'utilitaire regacc.
?	Affiche l'aide de regacc.
commande / ?	Affiche la syntaxe d'une commande individuelle.

Cet exemple montre comment accéder au répertoire contenant les processus d'activation du suivi. Émettez la commande regcd afin de changer de répertoire, puis la commande regdir afin d'afficher le contenu du répertoire de travail actuel.

regcd
Cisco ICM version 4.6 and earlier:
regacc:regcd software\geotel\icr\cal\pg1a\ems\currentversion\library\processes

Cisco ICM version 5.0 and later:
regacc:regcd software\Cisco Systems, Inc.\icm\cal\pg1a\ems\currentversion\library\processes
regacc:regdir
		<KEY>       : DCServer
               <KEY>       : et
               <KEY>       : hsl
               <KEY>       : mds
               <KEY>       : mis
               <KEY>       : nm
               <KEY>       : nmm
               <KEY>       : opc
               <KEY>       : pgag
               <KEY>       : pim1
               <KEY>       : tsyp

Remarque : cette valeur est affichée sur plusieurs lignes en raison des limites d'espace.

Dans ce cas, le processus PIM doit être suivi. La commande regcd est utilisée afin de se déplacer dans le répertoire pim1, et la commande regdir afin d'afficher le contenu de ce répertoire.

regacc:  regcd pim1 
regacc:regdir

EMSAllLogFilesMax             : REG_DWORD: 1e8480
EMSBreakOnExit                : REG_DWORD: 0x0
EMSBreakOnInit                : REG_DWORD: 0x0
EMSDebugBreak                 : REG_DWORD: 0x1
EMSDisplayToScreen            : REG_DWORD: 0x1
EMSForwardLevel               : REG_DWORD: 0x1
EMSLogFileCountMax            : REG_DWORD: 0x3e8
EMSLogFileLocation            : REG_SZ: logfiles
EMSLogFileMax                 : REG_DWORD: 0x186a0 
EMSNTEventLogLevel            : REG_DWORD: 0x2
EMSTraceMask                  : REG_DWORD: 0x0
EMSUserData                   : REG_BINARY: FFFF

La commande regset est utilisée afin de changer la valeur. Dans cet exemple, la taille EMSLogFileMax passe de 5 Mo à 1 Mo.

Remarque : vous devez utiliser des formats hexadécimaux lorsque vous modifiez des valeurs.

regacc:regset emsalllogfilesmax 1e8480 
emsalllogfilesmax 1e8480                    :REG_DWORD:  1e8480

OPCTest, Rttest et Procmon

Voici une explication des processus utilisés dans le suivi.

OPCTest

Vous pouvez utiliser OPCTest afin d'activer le suivi pour le processus OPC seulement. Activez chaque indicateur de suivi à l’aide de la commande debug. Dans OPCTest, tapez debug / ? pour plus d'informations sur la commande.

Si le processus est activé ou si les services sont arrêtés, les options spécifiées sont désactivées. Il est toujours nécessaire d'utiliser la commande regacc ou regedt32 afin d'augmenter EMSAllLogFilesMax et EMSLogFilesMax afin que les données ne soient pas renvoyées à la ligne dans la sortie.

Afin de désactiver le suivi à partir d'OPCTest, émettez la commande debug /noall. N'oubliez pas de réduire toutes les fenêtres de processus lorsque vous avez terminé le test.

Référez-vous à Utilisation de l'utilitaire de ligne de commande OPC Test pour plus d'informations sur OPCTest.

Rttest

Vous pouvez émettre la commande rttest afin d'activer le suivi seulement pour le processus RTR. Utilisez la commande debug afin d'activer les compteurs de trace individuels. Dans rttest, tapez debug / ? pour plus d'informations sur la commande.

Si le processus est activé ou si les services sont arrêtés, les options spécifiées sont désactivées. Il est toujours nécessaire d'utiliser la commande regacc ou regedt32 afin d'augmenter EMSAllLogFilesMax et EMSLogFilesMax afin que les données ne soient pas renvoyées à la ligne dans la sortie.

Référez-vous à L'utilitaire rttest de Cisco ICM pour plus d'informations sur rttest.

Procmon

Vous pouvez utiliser procmon pour activer le suivi sur les processus pims, mis et ctiserver. Malheureusement, il n'existe pas d'option standard pour activer le suivi de ces processus. Par exemple, l'option pour le commutateur Definity est debug, alors que pour démarrer une trace PIM VRU, vous devez définir la jauge de trace et utiliser la commande ltrace afin d'afficher les jauges de trace. Afin d'afficher plus d'informations sur l'utilisation de procmon, tapez ceci à une invite DOS :

procmon custname device process

Émettez la commande mhelp afin de répertorier les options pour le processus individuel.

Voici un exemple des options du commutateur Definity :

C:\>procmon cust pg2a pim1
>>>>debug /?
Usage: acd_debug [/noagent] [/agent] [/agent+] [/agent++] [/nobri] [/bri]
                 [/bri+] [/nocall] [/call] [/call+] [/nocms] [/cms] [/cms+]
                 [/noconfig] [/config] [/nocv] [/cv] [/noerror] [/error]
                 [/nohb] [/hb] [/ken] [/ken+] [/noken] [/noopc] [/opc]
                 [/nopost] [/post] [/nosim] [/sim] [/notg] [/tg] [/notimer]
                 [/timer] [/notp] [/tp] [/tp+] [/trace] [/novq] [/vq] [/vq+]
                 [/warning] [/nowarning] [/all] [/noall] [/set UserSetBit]
                 [/help] [/?]

L'utilitaire regacc est intégré à procmon. Dans procmon, vous pouvez émettre la commande mhelp afin d'afficher les commandes regacc.

Si le processus est activé ou si les services sont arrêtés, les options spécifiées sont désactivées. Il est toujours nécessaire d'utiliser les commandes regacc ou regedt32 pour augmenter EMSAllLogFilesMax et EMSLogFilesMax afin que les données ne soient pas renvoyées à la ligne dans la sortie.

Pour désactiver le suivi de procmon, entrez debug /noall. N'oubliez pas de réduire toutes les fenêtres de processus lorsque vous avez terminé le test.

Référez-vous à Utilisation de la console Procmon (Remote Process Monitor Console) pour plus d'informations sur procmon.

Informations connexes

• Utilisation de l'utilitaire de ligne de commande OPC Test
• L'utilitaire rttest de Cisco ICM
• Utilisation de la console du moniteur de traitement à distance (Procmon)
• Comment utiliser l'outil Dumplog
• Support technique - Cisco Systems