Ce document décrit comment définir le suivi dans Cisco Unified Contact Center Enterprise (UCCE) pour les clients, les services de passerelle périphérique (PG), Cisco Customer Voice Portal (CVP), Cisco UCCE Outbound Dialer, Cisco Unified Communications Manager (CallManager) (CUCM) et les passerelles Cisco.
Cisco vous recommande de prendre connaissance des rubriques suivantes :
Connectez-vous au serveur Finesse avec Secure Shell (SSH) et entrez ces commandes afin de collecter les journaux dont vous avez besoin. Vous êtes invité à identifier un serveur FTP SSH (SFTP) sur lequel les journaux seront téléchargés.
Journaux | Commande |
---|---|
Journaux d'installation | fichier get install desktop-install.log |
Journaux de bureau | fichier get activelog desktop recress |
Journaux de service | fichier get activelog platform/log/servm*.\* compacter |
Journaux Tomcat de la plate-forme | fichier get activelog tomcat/logs recress |
Journaux d'installation du système d'exploitation vocal (VOS) | fichier get install install.log |
Cette procédure décrit comment créer et collecter des fichiers de débogage :
[Debug Log]
Path=..\log\agent.dbg
Size=3000000
Threshold=DEBUG
Cette procédure décrit comment créer et collecter des fichiers de débogage :
[Debug Log]
Path=..\log\supervisor.dbg
Size=3000000
THRESHOLD=DEBUG
Sur le PC client sur lequel le client CTIOS est installé, utilisez Regedt32 afin d'activer le suivi. Modifiez ces paramètres :
Libérer | Emplacement du registre | Valeur par défaut | Modifier |
---|---|---|---|
Versions antérieures à 7.x | HKEY_LOCAL_MACHINE\Software\Cisco Systems\Ctios\Logging\TraceMask | 0x07 | Augmentez la valeur à 0xfff. |
Version 7.x et ultérieure | HKEY_LOCAL_MACHINE\SOFTWARE\Cisco Systems, Inc.\Suivi CTIOS | 0x40000307 | Définissez la valeur 0xfff pour le dépannage. |
La sortie par défaut est créée et placée dans un fichier texte nommé CtiosClientLog dans le fichier c:\Program Files\Cisco Systems\CTIOS Client\CTIOS Desktop Phones\ install directory.
Voici les paramètres de débogage du service de synchronisation CAD :
Paramètre | Valeur |
---|---|
Fichier de configuration Emplacement par défaut |
DirAccessSynSvr.cfg C:\Program Files\Cisco\Desktop\config |
Questions générales | Seuil=DEBUG |
Fichiers de sortie | DirAccessSynSvr.log |
Voici les paramètres de débogage du serveur RASCAL CAD 6.0(X) :
Paramètre | Valeur |
---|---|
Fichier de configuration Emplacement par défaut |
FCRasSvr.cfg C:\Program Files\Cisco\Desktop\config |
Questions générales | Plage = 1-4, 50, 3000-8000 |
Problèmes liés à LDAP : | Plage = 4 000-4 999 |
Problèmes liés à LRM : | Plage = 1999-2000 |
Problèmes liés à la base de données | Plage = 50-59 |
Fichiers de sortie Emplacement par défaut |
FCRasSvr.log, FCRasSvr.dbg C:\Program Files\Cisco\Desktop\log |
Voici les paramètres de débogage du serveur de discussion :
Paramètre | Valeur |
---|---|
Fichier de configuration Emplacement par défaut |
FCCServer.cfg C:\Program Files\Cisco\Desktop\config |
Questions générales | Seuil=DEBUG |
Fichiers de sortie Emplacement par défaut |
FCCServer.log, FCCServer.dbg C:\Program Files\Cisco\Desktop\log |
Reportez-vous à Utilisation de l'utilitaire Dumplog pour extraire les journaux pour la collection de journaux.
Utilisez l'utilitaire de surveillance du processus (procmon) afin d'activer et de désactiver les niveaux de suivi. Ces commandes activent le suivi du gestionnaire d'interface périphérique (PIM) CallManager :
C:\procmon <Customer_Name> <PG_Name> <ProcessName>
>>>trace tp* !-- Turns on third party request tracing
>>>trace precall !-- Turns on precall event tracing
>>>trace *event !-- Turns on agent and call event tracing
>>>trace csta* !-- Turns on CSTA call event tracing
>>>ltrace !-- Output of all trace bits
>>>q !-- Quits
Cette commande procmon désactive le suivi PIM de CallManager :
>>>trace * /off
Cette procédure décrit comment activer le suivi CUCM :
Ces commandes procmon activent le suivi JGW :
C:\procmon <Customer_Name> <node> process
>>>trace JT_TPREQUESTS !-- Turns on third-party request traces
>>>trace JT_JTAPI_EVENT_USED !-- Turns on traces for the JTAPI Events the PG uses
>>>trace JT_ROUTE_MESSAGE !-- Turns on routing client traces
>>>trace JT_LOW* !-- Traces based on the underlying JTAPI and CTI layers
Un exemple de commande est procmon ipcc pg1a jgw1.
Cette procédure décrit comment activer le suivi CTISVR du côté actif :
Ces commandes procmon activent le suivi pour VRU PIM :
C:\procmon <Customer_Name> <PG_Name> <ProcessName>
procmon>>>trace *.* /off !-- Turns off
procmon>>>trace !-- Verifies what settings are on/off
procmon>>>trace cti* /onprocmon>>>trace opc* /on
procmon>>>trace *ecc* /onprocmon>>>trace *session* /off
procmon>>>trace *heartbeat* /off
procmon>>>ltrace /traceprocmon>>>quit
Cette commande procmon désactive le suivi VRU PIM :
>>>trace * /off
Cette procédure décrit comment activer le suivi sur les deux serveurs CTIOS :
Le masque de suivi par défaut est 0x3 dans toutes les versions sauf la version 7.0(0), où il est 0x20003.
Si le masque de trace a une valeur élevée (0xf ou supérieure), il y a un impact important sur les performances du serveur CTIOS et le taux de réalisation des appels. Définissez le masque de trace à une valeur élevée uniquement lorsque vous déboguez un problème ; une fois que vous avez collecté les journaux nécessaires, vous devez rétablir la valeur par défaut du masque de trace.
À des fins de dépannage, définissez le masque de trace du serveur CTIOS sur :
Ces commandes opctest activent le suivi OPC sur une PG active :
opctest /cust <cust_inst> /node <node>
opctest:debug /agent /routing /cstacer /tpmsg /closedcalls
Voici un exemple tiré d’un environnement de travaux pratiques :
C:\Documents and Settings\ICMAdministrator>opctest /cust cc1 /node pg1a
OPCTEST Release 8.0.3.0 , Build 27188
opctest: debug /agent /routing /cstacer /tpmsg /closedcalls !-- Use debug /on in
order to restore default tracing levels
opctest: quit
Voici d'autres exemples :
opctest:debug /agent /routing /cstacer /rcmsg /closedcalls /inrcmsg
!-- General example
opctest:debug /agent /routing /cstacer /rcmsg /closedcalls /inrcmsg /NCT
!-- Network transfer example
opctest:debug /agent /routing /cstacer /rcmsg /closedcalls /inrcmsg /task /passthru
!-- Multimedia example
opctest:debug /agent /routing /cstacer /rcmsg /closedcalls /inrcmsg /passthru
!-- VRU PG example
Ces commandes procmon activent le suivi eagtpim sur une PG active :
C:\>procmon <cust_inst> <node> pim<pim instance
>>>>trace tp* /on
>>>trace precall /on
>>>trace *event /on
>>>trace csta* /on
Voici un exemple tiré d’un environnement de travaux pratiques :
C:\Documents and Settings\ICMAdministrator>procmon cc1 pg1a pim1
>>>>trace tp* /on
>>>>trace precall /on
>>>>trace *event /on
>>>>trace csta* /on
>>>>quit
Référez-vous à Utilisation de l'utilitaire Dumplog pour plus de détails. Utilisez la commande cdlog afin d'accéder au répertoire logfiles, comme illustré dans cet exemple :
c:\cdlog <customer_name> pg1a !-- Or, pgXa to depending on the PG number (X)
c:\icm\<customer_name>\<<PG#>>\logfiles\
Ces exemples montrent comment placer la sortie dans le fichier par défaut ; dans tous les cas, vous pouvez utiliser /of afin de définir un nom spécifique pour le fichier de sortie :
c:\icm\<customer_name>\<PG#>\logfiles\dumplog pim1 /bt <HH:MM> /et <HH:MM> /ms /o
!-- This PIM example places output in a default pim1.txt file
c:\icm\<customer_name>\<PG#>\logfiles\dumplog opc /bt <HH:MM> /et <HH:MM> /ms /o
!-- This OPC example places output in a default opc.txt file
c:\icm\<customer_name>\<PG#>\logfiles\dumplog jgw1 /bt <HH:MM> /et <HH:MM> /ms /o
c:\cdlog <customer_name> cg1a
c:\icm\<customer_name>\<cg#>\logfiles\
!-- This JTAPI example places output in a default jgw1.txt file
c:\icm\<customer_name>\cg#\logfiles\dumplog ctisvr /bt <HH:MM> /et <HH:MM> /ms /o
!-- This CTI server example places output in a default ctisvr.txt file
c:\ icm\<customer_name>\ctios\logfiles\dumplog ctios /bt <HH:MM> /et <HH:MM> /ms /o
!-- This CTIOS server example places output in a default ctios.txt file
Cette procédure décrit comment activer le suivi sur les serveurs CVP avec le logiciel de téléphone IP Cisco SIP :
Cette procédure décrit comment activer le suivi sur les serveurs CVP avec une passerelle H323 :
setcalltrace on
setinterfacetrace on
Collectez les fichiers CVP *.log et Error.log pour la période de test. Ces fichiers se trouvent dans le répertoire C:\Cisco\CVP\logs directory on both CVP servers.
Il s'agit des emplacements des fichiers journaux pour Unified CVP, où CVP_HOME est le répertoire dans lequel le logiciel Unified CVP est installé.
Type de journal | Emplacement |
---|---|
Journaux du serveur d'appels et/ou du serveur de rapports |
CVP_HOME\logs\ |
Journaux de la console d'exploitation | CVP_HOME\logs\OAMP\ |
Journaux du serveur VXML (Voice XML) | CVP_HOME\logs\VXML\ |
Journaux des agents SNMP (Simple Network Management Protocol) | CVP_HOME\logs\SNMP\ |
Journaux du gestionnaire de ressources Unified CVP | CVP_HOME\logs\ORM\ |
Un exemple d'emplacement est C:\Cisco\CVP.
Pour les applications vocales XML personnalisées telles qu'une application Audium déployée, vous pouvez activer un enregistreur de débogage.
Ajoutez cette ligne à la section <loggers> (dernière section) du fichier de configuration settings.xml dans le fichier C:\Cisco\CVP\VXMLServer\applications\APP_NAME\data\application\ directory:
<logger_instance name="MyDebugLogger"
class="com.audium.logger.application.debug.ApplicationDebugLogger"/>
Au moment de l'exécution, cet enregistreur affiche un journal VoiceXML détaillé sur le site \Cisco\CVP\VXMLServer\applications\APP_NAME\MyDebuggerLogger directory.
Cette procédure décrit comment augmenter les journaux de processus de badialer sur le Outbound Dialer (qui se trouve généralement sur une PG).
Exécutez l'utilitaire dumplog à partir du répertoire /icm/<instance>/dialer/logfiles :
dumplog badialer /bt hh:mm:ss /et hh:mm:ss /o
Cette procédure décrit comment augmenter le journal du processus de port de baigne.
dumplog baimport /bt hh:mm:ss /et hh:mm:ss /o
Cette procédure décrit comment augmenter le journal des processus du gestionnaire de campagne.
dumplog campaignmanager /bt hh:mm:ss /et hh:mm:ss /o
Sur la PG d'Avaya Communications Manager (ACD), utilisez l'utilitaire opctest afin d'augmenter les éléments suivants pour CallManager et Avaya.
C:\opctest /cust <instance> /node <pgname>
opctest: type debug /agent /closedcalls /cstacer /routing
opctest: q !-- Quits
Cette procédure décrit comment augmenter le suivi du processus ctisvr.
Cette procédure décrit comment activer les journaux de routeur :
Pour la version de test 8.5, utilisez plutôt le Portico du cadre de diagnostic.
debug level 3 component "icm:Router A" subcomponent icm:rtr
Utilisez l'utilitaire dumplog pour extraire les journaux de routeur de l'un des routeurs pendant la période des tests. Référez-vous à Utilisation de l'utilitaire Dumplog pour plus de détails.
Ceci est un exemple de demande de journal pour les journaux le 21/10/2011 entre 09:00:00 et 09:30:00 (au format 24 heures). Cette sortie est envoyée au fichier C:/router_output.txt:
C:\Documents and Settings\ICMAdministrator>cdlog u7x ra
C:\icm\u7x\ra\logfiles>dumplog rtr /bd 10/21/2011 /bt 09:00:00 /ed 10/21/2011
/et 09:30:00 /ms /of C:/router_output.txt
Envoyez le fichier de sortie (C:/router_output.txt) à Cisco pour le dépannage si nécessaire.
Ces commandes activent le suivi sur les serveurs CVP avec SIP :
#conf t
service timestamps debug datetime msec
service timestamps log datetime msec
service sequence-numbers
no logging console
no logging monitor
logging buffered 5000000 7
end
clear logging
Il s'agit d'une plate-forme très robuste qui peut gérer les débogages suggérés au volume d'appels fourni sans problème. Cependant, Cisco vous recommande :
logging <syslog server ip>
logging trap debugs
show proc cpu hist
Activez ces débogages :
debug isdn q931
debug voip ccapi inout
debug ccsip mess
debug http client all
debug voip application vxml all
debug vtsp all
debug voip application all
Après avoir passé l'appel et simulé le problème, arrêtez le débogage :
#undebug all
Collectez ce résultat :
term len 0
show ver
show run
show log
Ces commandes activent le suivi SIP sur Cisco Unified SIP Proxy (CUSP) :
(cusp)> config
(cusp-config)> sip logging
(cusp)> trace enable
(cusp)> trace level debug component sip-wire
N'oubliez pas de désactiver la connexion une fois que vous avez terminé.
Cette procédure décrit comment collecter les journaux :
username <userid> create
username <userid> password <password>
username <userid> group pfs-privusers
Dans UCCE version 8 et ultérieure, vous pouvez utiliser l'interface de ligne de commande (CLI) de Unified System afin de collecter les traces. Comparé aux utilitaires dumplog, l'interface de ligne de commande est une méthode très rapide et efficace pour obtenir un ensemble complet de journaux à partir d'un serveur tel qu'un PG ou un Rogger.
Cette procédure décrit comment démarrer l'analyse des problèmes et comment déterminer le traçage à activer. L'exemple collecte les journaux de ces serveurs :
show tech-support absdatetime mm-dd-yyyy:hh:mm mm-dd-yyyy:hh:mm redirect
dir c:\temp
Remplacez la première chaîne mm-jj-aaaa:hh:mm par une date et une heure qui sont environ 15 minutes avant l'événement.
Remplacez la deuxième chaîne mm-jj-aaaa:hh:mm par une date et une heure qui sont approximativement 15 minutes après la résolution de l'événement. Si l'événement se produit toujours, rassemblez au moins 15 minutes.
Recueillez ces informations supplémentaires si possible :
Il existe deux outils : un outil de cadre de diagnostic et l'outil CLI système. Les deux sont des icônes sur le bureau ou sous le répertoire Programs de chaque serveur.
Cette procédure décrit comment utiliser l'interface de ligne de commande Unified System pour le suivi.
show tech-support absdatetime mm-dd-yyyy:hh:mm mm-dd-yyyy:hh:mm redirect dir c:\temp