Introduction
Ce document décrit l'utilitaire dumplog, qui vous permet d'afficher les journaux de processus Cisco Intelligent Contact Management (ICM).
Conditions préalables
Exigences
Cisco vous recommande de prendre connaissance des rubriques suivantes :
- Résolution des problèmes logiciels
- Cisco ICM
Composants utilisés
Les informations contenues dans ce document sont basées sur Cisco ICM.
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.
Que fait l'utilitaire Dumplog ?
L'utilitaire dumplog convertit les fichiers journaux binaires écrits par les processus Cisco ICM dans un format lisible. Une fois converti, le contenu du fichier journal peut être référencé afin d'obtenir un aperçu du fonctionnement d'ICM. En général, dumplog est utilisé comme un outil de dépannage, mais il peut être éducatif aussi bien.
L'utilitaire dumplog peut être appelé soit à partir d'une invite de commandes directement sur le serveur ICM, soit à partir d'une session Telnet vers le serveur ICM.
Note: Les exemples suivants supposent qu'ICM est installé sur le lecteur C. Si le logiciel ICM est installé sur un autre lecteur, les emplacements des répertoires sont modifiés en conséquence.
Pour connaître les conventions de nom de serveur utilisées dans ce document, consultez Conventions de nom de serveur ICM.
Comment accéder au répertoire des fichiers journaux
Le chemin d'accès au répertoire du fichier journal Cisco ICM est <root>\icm\customer instance name\node name, où <root> est le lecteur sur lequel ICM est installé, par exemple, C, D ou E.
Par exemple, si vous considérez que le routeur d'appels Cisco ICM est installé sur le lecteur C, le répertoire logfile sur geocscortra se trouve à l'emplacement suivant : c:\icm\csco\rtra\logfiles.
Note: Il peut être utilisé comme raccourci vers le répertoire logfiles : c:\>cdlog <cust_inst> <ICM_Node>.
Utilisation
Les options de ligne de commande de l'utilitaire dumplog sont présentées dans cette section. Ils peuvent vous aider à résoudre des problèmes, car ils vous permettent d'afficher les fichiers journaux Cisco ICM dans un délai spécifique. La période peut être définie avec les commutateurs /bd, /bt, /ed et /et. L'utilisateur peut également rechercher une chaîne spécifique afin d'isoler et de dépanner un comportement ICM douteux.
Ces informations sont également disponibles dans le Guide de l'administrateur de Cisco Intelligent Call Router.
dumplog [ProcessName(s)] [/dir Dirs] [/if InputFile] [/o]
[/of OutputFile]
[/c] [/bd BeginDate(mm/dd/yyyy)] [/bt BeginTime(hh:mm:ss)]
[/ed EndDate(mm/dd/yyyy)] [/et EndTime(hh:mm:ss)] [/hr HoursBack]
[/all] [/last] [/prev] [bin] [/m MatchString] [/x ExcludeString] [/ms] [/debug]
[/ciscoLog]
[/unzipCmdPrefix Prefix for Unzip command]
[/unzipCmdInfix Infix for Unzip command]
[/unzipCmdPostfix Postfix for Unzip command]
[/unzipTempfile Temporary filename for unzip command]
[/zipPostfix Postfix of zipped files]
[/tzadjustoff]
[/help] [?]
Descriptions des paramètres
| Nom(s) du processus |
La commande vide le journal du jour actuel pour ce processus, sauf si vous spécifiez des dates ou des heures différentes avec d'autres arguments. |
| [/dir Dirs] |
Directory spécifie l'emplacement des fichiers journaux pour tous les processus répertoriés sur la ligne de commande après le commutateur /dir. Si aucun commutateur /dir n'est utilisé, le répertoire actuel est utilisé par défaut. |
| [/if] |
InputFile spécifie un fichier .ems spécifique à vider. Le jeton /if est facultatif. Si vous spécifiez un fichier d'entrée, les arguments /bd, /bt, /ed, /et, /hr et /all sont ignorés. |
| /o |
Écrit le résultat dans un fichier texte du répertoire \logfiles. Le nom de fichier est formé lorsque vous ajoutez le suffixe .txt au préfixe de processus ou au nom de fichier d'entrée spécifié (sans le suffixe .ems). Le fichier est écrit dans le répertoire actif. |
| /of |
OutputFile spécifie un fichier texte de sortie ; par exemple, c:\temp\mylog.txt. |
| /c |
Spécifie la sortie continue. La commande ne se ferme pas après avoir atteint la fin du journal. Au lieu de cela, il attend et écrit toutes les autres entrées qui apparaissent dans le journal. |
| /bd |
BeginDate(mm/jj/aaaa) spécifie la date de début. Si utilisé avec /bt, ceci spécifie une plage de dates. Sinon, dumplog vide les événements uniquement pour la date spécifiée. |
| /bt |
BeginTime(hh:mm:ss) spécifie l'heure de début. Utilisez avec /et afin de spécifier une plage de temps. |
| /ed |
EndDate(mm/jj/aaaa) spécifie la date de fin. Utilisez avec /bd afin de spécifier une plage de jours. |
| /et |
EndTime(hh:mm:ss) spécifie l'heure de fin. Utilisez avec /bt afin de spécifier une plage de temps. |
| /hr |
HoursBack spécifie un nombre d'heures en arrière à partir de l'heure actuelle. |
| /all |
Affiche toutes les informations des fichiers journaux de processus spécifiés. |
| /last |
Affiche les informations du fichier journal le plus récent du processus. |
| /prev |
Affiche les informations de l'avant-dernier fichier journal du processus. |
| /m |
MatchString affiche uniquement les événements qui contiennent une correspondance pour la chaîne spécifiée. |
| /x |
ExcludeString affiche uniquement les événements qui ne contiennent pas de correspondance pour la chaîne spécifiée. |
| [/ms] |
Affiche les millisecondes en horodatages. |
| [/mc] |
Utilisez plusieurs couleurs lorsque vous videz des journaux fusionnés. Une couleur différente est attribuée à chaque processus. Vous devez spécifier un ProcessPrefix ou un InputFile. Si vous ne donnez qu'une valeur ProcessPrefix (par exemple, rtr, nm ou lgr), dumplog affiche le journal du jour actuel pour ce processus par défaut. |
| /ciscoLog |
Active la fonctionnalité CiscoLog. |
| /unzipCmdPrefix |
Paramètres de préfixe pour unzip, par exemple gzip -d -c. |
| /unzipCmdInfix |
Paramètre Infix pour unzip, par exemple ">". |
| /unzipCmdPostfix |
Paramètre Postfix pour unzip, par exemple "". |
| /unzipTempfile |
Fichier temporaire pour la décompression, par exemple "temp.ems". |
| /zipPostfix |
Paramètre de suffixe de fichier, par exemple ".gz". |
| /tzadjustoff |
Lorsque les fichiers EMS sont copiés sur un système dans un fuseau horaire différent, ou si le fuseau horaire sur le système est modifié, sans cette option, toutes les requêtes effectuées sont relatives à la machine sur laquelle les fichiers journaux ont été générés. Sinon, /tzajustoff est utilisé afin de changer le comportement où les requêtes sont faites par rapport à ce temps machine. |
Note: Afin d'afficher les fichiers journaux redirigés avec le Bloc-notes Microsoft, enregistrez le fichier journal dans un fichier texte (utilisez l'argument dumplog /of), et ouvrez le fichier texte à partir de l'invite de commandes avec la commande notepad filename.
Exemple d'utilisation Dumplog
Cet exemple montre comment vider le fichier journal rtr sur le routeur du 29 avril 1999 au 30 avril 1999. Il génère un fichier journal appelé rtr.txt. Le fichier rtr.txt peut maintenant être visualisé avec un éditeur de texte standard tel que le Bloc-notes.
c:\icm\csco\rtra\logfiles dumplog rtr /bd 04/29/1999 /ed 04/30/1999 /o
Cette commande vide le fichier journal de pagg depuis une passerelle périphérique (PG) et commence à la dernière fois qu'un nouveau fichier journal a été ouvert pour la sortie.
c:\icm\csco\rtra\logfiles dumplog pgag /last
Cette commande vide les journaux de plusieurs processus de la manière entrelacée et écrit le résultat dans un fichier de sortie unique.
dumplog /ms /hr 1 /of output.txt rtr mds rts
14:51:40:298 ra-rts Trace: Received 1 System Capacity Real Time records
14:51:40:298 ra-rts Trace: Updating base System Capacity Real Time record for ID1 1 and ID2 0, cbRecSize=96
14:51:43:298 ra-rtr Trace: TIP: TIPUpLink::sendCongestionControlTIPMsg Sent CongestionControlEvent
14:51:46:298 ra-rtr Trace: TIP: TIPUpLink::sendCongestionControlTIPMsg Sent CongestionControlEvent
14:51:49:298 ra-rtr Trace: TIP: TIPUpLink::sendCongestionControlTIPMsg Sent CongestionControlEvent
14:51:49:688 ra-mds MDS Process is reporting periodic overall metering statistics.
Une syntaxe avec des tirets est également prise en charge.
dumplog -ms -hr 1 -of output.txt rtr mds rts
Commentaires