Dans le cadre de la documentation associée à ce produit, nous nous efforçons d’utiliser un langage exempt de préjugés. Dans cet ensemble de documents, le langage exempt de discrimination renvoie à une langue qui exclut la discrimination en fonction de l’âge, des handicaps, du genre, de l’appartenance raciale de l’identité ethnique, de l’orientation sexuelle, de la situation socio-économique et de l’intersectionnalité. Des exceptions peuvent s’appliquer dans les documents si le langage est codé en dur dans les interfaces utilisateurs du produit logiciel, si le langage utilisé est basé sur la documentation RFP ou si le langage utilisé provient d’un produit tiers référencé. Découvrez comment Cisco utilise le langage inclusif.
Cisco a traduit ce document en traduction automatisée vérifiée par une personne dans le cadre d’un service mondial permettant à nos utilisateurs d’obtenir le contenu d’assistance dans leur propre langue. Il convient cependant de noter que même la meilleure traduction automatisée ne sera pas aussi précise que celle fournie par un traducteur professionnel.
Ce document décrit comment définir et collecter des suivis dans Cisco Unified Contact Center Enterprise (CCE).
Cisco vous recommande de prendre connaissance des rubriques suivantes :
Les informations contenues dans ce document sont basées sur les versions de logiciel suivantes :
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. Si votre réseau est en ligne, assurez-vous de bien comprendre l’incidence possible des commandes.
Il existe plusieurs options pour collecter les journaux des clients Finesse.
Save
HAR avec contenu.Remarque : La méthode recommandée pour collecter les journaux du serveur Cisco Finesse est via Secure Shell (SSH) et Secure File Transfer Protocol (SFTP). Cette méthode vous permet non seulement de collecter les journaux de services Web, mais aussi tous les journaux supplémentaires comme Fippa, openfire, Realm et Clientlogs.
file get activelog desktop recurs compress reltime hours 2
Remarque : Cette page fournit de bonnes informations sur le serveur d'appels CVP et il est très utile de dépanner certains scénarios.
7. Après avoir reproduit le problème, assurez-vous de restaurer les traces au niveau par défaut. Sélectionnez com.dynamicsoft.DsLibs.DsUALibs dans le Serv. Menu déroulant Mgr dans le coin supérieur gauche et définissez-le sur Erreur.
Dans de très rares cas, vous devez augmenter le niveau de traces des applications serveur VXML. D'un autre côté, il n'est pas recommandé de l'augmenter à moins qu'un ingénieur Cisco ne le demande.
Pour collecter les journaux d'application du serveur VXML, accédez au répertoire d'application spécifique sous le serveur VXML, par exemple : C:\Cisco\CVP\VXMLServer\applications\{nom de l'application}\logs\ActivityLog\ et collectez les journaux d'activité.
Dans la plupart des cas, le niveau de traces par défaut d'OAMP et d'ORM est suffisant pour déterminer la cause première du problème. Cependant, si le niveau de traces doit être augmenté, voici les étapes pour exécuter cette action :
omgr.traceMask=-1 omgr.logLevel=DEBUG org.hibernate.logLevel=DEBUG org.apache.logLevel=ERROR net.sf.ehcache.logLevel=ERROR
Informations sur le niveau de suivi
Niveau de suivi |
Description |
Niveau de consignation |
Masque de suivi |
0 |
Installation du produit par défaut. Impact sur les performances nul ou minimal attendu. |
INFOS |
Aucune |
1 |
Messages de suivi moins détaillés avec un impact limité sur les performances. |
DÉBOGUER |
CONFIGURATION_PÉRIPHÉRIQUE + |
2 |
Messages de suivi détaillés avec un impact moyen sur les performances. |
DÉBOGUER |
CONFIGURATION_PÉRIPHÉRIQUE + |
3 |
Message de suivi détaillé avec un impact élevé sur les performances. |
DÉBOGUER |
CONFIGURATION_PÉRIPHÉRIQUE + |
4 |
Message de suivi détaillé avec un impact très important sur les performances. |
DÉBOGUER |
MISC + |
5 |
Message de suivi détaillé le plus élevé. |
DÉBOGUER |
MISC + |
Dans CVVB, un fichier de trace est un fichier journal qui enregistre l'activité des sous-systèmes et des étapes des composants Cisco VVB.
Cisco VVB comporte deux composants principaux :
Vous pouvez spécifier les composants pour lesquels vous souhaitez collecter des informations et le niveau d'informations que vous souhaitez collecter.
Les niveaux de consignation s'étendent de :
Avertissement : Xdebugging5 ne doit pas être activé sur le système chargé en production.
Les journaux les plus courants que vous devez collecter sont le moteur. Le niveau de suivi par défaut du moteur CVB est suffisant pour résoudre la plupart des problèmes. Toutefois, si vous devez modifier le niveau de suivi d'un scénario spécifique, Cisco vous recommande d'utiliser les profils de journal système prédéfinis.
Profils du journal système
Nom |
Scénario dans lequel ce profil doit être activé |
VB par défaut |
Les journaux génériques sont activés. |
AppAdminVVB |
Pour les problèmes d'administration Web via AppAdmin, Cisco VVB Serviceability et d'autres pages Web. |
MediaVB |
Pour les problèmes de configuration ou de transmission multimédia. |
VoiceBrowserVVB |
Pour les problèmes de gestion des appels. |
MRCPVB |
Pour les problèmes d'interaction ASR/TTS avec Cisco VVB. |
ContrôleAppelVB |
Pour les problèmes liés au signal SIP sont publiés dans le journal. |
file get activelog /uccx/log/MIVR/*
#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
Avertissement : Toute modification apportée à une passerelle de production du logiciel Cisco IOS® peut entraîner une panne.
logging <syslog server ip>
logging trap debugs
show proc cpu hist
Avertissement : Si le CPU obtient une utilisation du CPU allant jusqu'à 70-80 %, le risque d'un impact sur les performances du service est considérablement augmenté. Par conséquent, n'activez pas de débogages supplémentaires si la GW atteint 60 %.
debug voip ccapi inout
debug ccsip mess
After you make the call and simulate the issue, stop the debugging:
#undebug all
term len 0
show ver
show run
show log
(cusp)> config
(cusp-config)> sip logging
(cusp)> trace enable
(cusp)> trace level debug component sip-wire
username <userid> create
username <userid> password <password>
username <userid> group pfs-privusers
Cisco recommande de définir des niveaux de suivi et de collecter les suivis via le Portique de structure de diagnostic ou les outils de CLI système.
Remarque : Pour plus d'informations sur Diagnostic Framework Portico et l'interface de ligne de commande du système, consultez le chapitre Diagnostic tools dans le document Serviceability Guide for Cisco Unified ICM/Contact Center Enterprise, Release 12.5(1).
Lorsque vous dépannez la plupart des scénarios UCCE, si le niveau de traces par défaut ne fournit pas suffisamment d'informations, définissez le niveau de traces sur 3 dans les composants requis (à quelques exceptions près).
Remarque : Pour plus d'informations, consultez la section Trace Level sur le Guide de facilité de maintenance pour Cisco Unified ICM/Contact Center Enterprise, version 12.5(1).
Par exemple, si vous dépannez des problèmes de numérotation sortante, le niveau de suivi doit être défini sur le niveau 2 si le numéroteur est occupé.
Pour CTISVR (CTISVR), les niveaux 2 et 3 ne définissent pas le niveau de registre exact recommandé par Cisco. Le registre de suivi recommandé pour CTISVR est 0XF8.
Avertissement : Définissez le niveau de suivi au niveau 3 lorsque vous tentez de reproduire le problème. Une fois le problème reproduit, définissez le niveau de trace sur default. Soyez particulièrement prudent lorsque vous définissez les suivis JTAPIGW, car les niveaux 2 et 3 définissent les suivis de bas niveau, ce qui peut avoir un impact sur les performances. Définissez le niveau 2 ou le niveau 3 dans le JTAPIGW en dehors de la période de production ou dans un environnement de laboratoire.
PCCE dispose de son propre outil pour configurer les niveaux de suivi. Il ne s'applique pas à l'environnement UCCE dans lequel le portlet de cadre de diagnostic ou l'interface de ligne de commande du système sont les méthodes privilégiées pour activer et collecter les journaux.
file get activelog /cuic/logs/cuic/*.* recurs compress reltime hours 1
file get activelog /cuic/logs/cuicsrvr/*.* recurs compress reltime hours 1
file get activelog tomcat/logs/*.* recurs compress
file get activelog livedata/logs/*.*
file get activelog ids/log/*.* recurs compress reltime days 1
Pour CUIC :
Pour LD :
Pour IDS :
Pour les services de la plate-forme, il est généralement conseillé de sélectionner les journaux Tomcat et Event Viewer :
Pour démarrer la capture, établissez une session SSH pour que le serveur VOS s'authentifie avec le compte d'administrateur de plate-forme.
1 bis. Syntaxe de commande
La commande est utils network capture
et la syntaxe est la suivante :
Syntax:
utils network capture [options]
options optional
page,numeric,file fname,count num,size bytes,src addr,dest addr,port
num,host protocol addr
options are:
page
- pause output
numeric - show hosts as dotted IP
addresses
file fname - output the information to a file
Note: The file is saved in platform/cli/fname.cap
fname should not contain the "." character
count num - a
count of the number of packets to capture
Note: The maximum count
for the screen is 1000, for a file is 100000
size bytes -
the number of bytes of the packet to capture
Note: The maximum
number of bytes for the screen is 128
For a file it can be
any number or ALL
src addr - the source address of the
packet as a host name or IPV4 address
dest addr - the
destination address of the packet as a host name or IPV4 address
port
num - the port number of the packet (either src or dest)
host
protocol addr - the protocol should be one of the following:
ip/arp/rarp/all. The host address of the packet as a host name or IPV4
address. This option will display all packets to and from that address.
Note: If "host" is provided, do not provide "src" or "dest"
1 ter. Capturer tous les trafics
Pour une capture typique, on peut collecter TOUS les paquets de TOUTES les tailles de et vers TOUTES les adresses dans un fichier de capture appelé packets.cap. Pour ce faire, exécutez simplement sur l'interface de ligne de commande admin utils network capture eth0 file packets count 100000 size all
1 quater. Capture basée sur le numéro de port
Afin de résoudre un problème de communication avec le gestionnaire de cluster, il peut être souhaitable d'utiliser l'option de port pour effectuer une capture en fonction d'un port spécifique (8500).
Pour plus d'informations sur les services qui nécessitent des communications sur chaque port, référez-vous au Guide d'utilisation des ports TCP et UDP pour la version applicable du composant respectif.
1 quinquies. Capture basée sur l’hôte
Pour résoudre un problème avec VOS et un hôte particulier, il peut être nécessaire d'utiliser l'option « host » pour filtrer le trafic en provenance et à destination d'un hôte particulier.
Il peut également être nécessaire d'exclure un hôte particulier, dans ce cas utilisez un "!" devant l'IP. Un exemple de ceci serait : utils network capture eth0 file packets count 100000 size all host ip !10.1.1.1
Pendant que la capture a commencé à reproduire le symptôme ou la condition du problème de sorte que les paquets nécessaires sont inclus dans la capture. Si le problème est intermittent, il peut être nécessaire d'exécuter la capture pendant une période prolongée. Si la capture se termine, c'est parce que la mémoire tampon est remplie. Redémarrez la capture et la capture précédente est automatiquement renommée afin de ne pas la perdre. Si une capture est nécessaire pendant une période prolongée, utilisez une session de surveillance sur un commutateur pour effectuer la capture au niveau du réseau.
Pour arrêter la capture, maintenez la touche Ctrl enfoncée et appuyez sur C du clavier. Cela entraîne la fin du processus de capture et aucun nouveau paquet n'est ajouté au vidage de capture.
4 bis. Transférer le fichier de capture via l'interface de ligne de commande vers un serveur SFTP
Utilisez la commande file get activelog platform/cli/packets.cap
pour collecter le fichier packets.cap sur le serveur SFTP.
Vous pouvez également collecter tous les fichiers .cap stockés sur le serveur et utiliser le fichier get activelog platform/cli/*.cap.
Enfin, indiquez l'adresse IP/le nom de domaine complet du serveur SFTP, le port, le nom d'utilisateur, le mot de passe et les informations de répertoire :
L'interface de ligne de commande indique la réussite ou l'échec du transfert de fichiers vers le serveur SFTP.
4 ter. Utilisez RTMT pour transférer un fichier de capture vers un PC local.
Lancez RTMT. S'il n'est pas installé sur le PC local, installez la version appropriée à partir de la page Administration de VOS, puis accédez au menu Applications > Plugins. Cliquez sur System, puis sur Trace & Log Central, puis double-cliquez sur Collect Files. Cliquez sur Next dans le premier menu.
Dans le deuxième menu, cochez la case Packet Capture Logs sur le serveur sur lequel la capture a été effectuée, puis cliquez sur Next.
Dans l'écran final, choisissez une plage temporelle lors de la capture et un répertoire de téléchargement sur le PC local.
RTMT ferme cette fenêtre et collecte le fichier et le stocke sur le PC local à l'emplacement spécifié.
Révision | Date de publication | Commentaires |
---|---|---|
3.0 |
28-May-2025 |
Recertification |
2.0 |
25-Apr-2024 |
Introduction, texte de remplacement, référencement, traduction automatique et mise en forme mis à jour. |
1.0 |
31-Aug-2022 |
Première publication |