Aufdrehen der Ablaufverfolgung

Einleitung

Das Cisco Intelligent Contact Management (ICM) Event Management System (EMS) bietet eine Anwendungsprogrammschnittstelle (API) für ICM-Prozesse, mit denen Ereignisse gemeldet werden können. In diesem Dokument wird erläutert, wie die Ablaufverfolgung aktiviert wird, um bei der Fehlerbehebung in Cisco ICM zu helfen.

Voraussetzungen

Anforderungen

Cisco empfiehlt, dass Sie über Kenntnisse in folgenden Bereichen verfügen:

• Cisco ICM

• Microsoft Windows NT Version 4 und Windows 2000

Verwendete Komponenten

Die Informationen in diesem Dokument basierend auf folgenden Software- und Hardware-Versionen:

• Cisco ICM Version 4.6.2 und höher

• Microsoft Windows Version 4 und Windows 2000

Die Informationen in diesem Dokument beziehen sich auf Geräte in einer speziell eingerichteten Testumgebung. Alle Geräte, die in diesem Dokument benutzt wurden, begannen mit einer gelöschten (Nichterfüllungs) Konfiguration. Wenn Ihr Netz Live ist, überprüfen Sie, ob Sie die mögliche Auswirkung jedes möglichen Befehls verstehen.

Konventionen

Weitere Informationen zu Dokumentkonventionen finden Sie unter Cisco Technical Tips Conventions (Technische Tipps von Cisco zu Konventionen).

Nachverfolgung aufdrehen

Es gibt zwei Möglichkeiten, um Probleme in Cisco ICM zu dokumentieren: mit der API oder durch Aktivierung der Ablaufverfolgung.

API

Verwenden Sie die API, um:

• Ein Ereignis in die lokale EMS-Protokolldatei protokollieren.

• Protokollieren Sie ein Ereignis im Microsoft Windows NT/2000-Anwendungsereignisprotokoll.

• Senden Sie ein Ereignis zur Speicherung in der Cisco ICM-Datenbank an den Datenbankserver.

• Senden Sie eine Veranstaltung an den zentralen Forwarding-Service für den Kundenservice, damit diese an das Cisco Technical Assistance Center (TAC) weitergeleitet werden kann.

Nachverfolgung aufdrehen

Um ICM-Probleme zu beheben, können Sie die Ablaufverfolgung mit einem der folgenden Verfahren aktivieren:

• Microsoft Windows NT oder Windows 2000 Registry Editor

• Regacc-Dienstprogramm

• OPCTest

• reißen

• Procmon

Hinweis: Stellen Sie sicher, dass Sie die Ablaufverfolgung deaktivieren, wenn Sie fertig sind. Noch wichtiger ist, dass Sie nach Abschluss des Tests die Befehlsfenster für Prozesse nicht offen lassen. Dies hat erhebliche Auswirkungen auf die Systemressourcen, insbesondere auf die CPU-Auslastung und den Arbeitsspeicher.

Windows NT oder Windows 2000 Registry Editor

Führen Sie die folgenden Schritte aus, um regedit32 auszuführen:

1. Wählen Sie Start > Ausführen.

2. Geben Sie regedt32 ein, um den Registrierungs-Editor von Windows NT oder Windows 2000 zu öffnen.

   Dies ist ein Beispiel für die Einstellungen des Registrierungs-Editors und des EMS Peripheral Interface Manager (PIM). Um diese Einstellungen anzuzeigen, navigieren Sie zu diesem Pfad:

   • Cisco ICM Version 4.6 und früher:

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

   • Cisco ICM Version 5.0 und höher:

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

   Im Idealfall werden die Schlüssel auf der linken Seite des Fensters Registrierungs-Editor und die Werte auf der rechten Seite angezeigt.

3. Doppelklicken Sie auf den Wert, den Sie ändern möchten, und das Dialogfeld DWORD-Editor wird angezeigt.

4. Klicken Sie im Radix-Bedienfeld auf Hexadezimal.

5. Ändern des Werts

6. Klicken Sie auf OK.

Diese Tabelle zeigt die Werte, die Sie im Registrierungs-Editor ändern können. Die am häufigsten zu ändernden Werte sind AllLogFileMax, LogFileMax und TraceMask. Die Anzahl der Protokolldateien darf nie geändert werden.

Wert	Pfad
EMSAllLogDateiMax	Maximale Gesamtgröße aller EMS-Protokolldateien für den Prozess. Der Standardwert ist entweder 6000000/6 MB oder 2000000/2 MB.
EMSAllLogFileCount	Anzahl der EMS-Protokolldateien für den Prozess. Der Standardwert ist 20 und muss normalerweise nicht geändert werden.
EMSLogDateiMax	Die maximale Größe jeder EMS-Protokolldatei. Der Standardwert ist 100000 oder 100 KB.
EMSTraceMask	Trace Bit (Nachverfolgungsbit), damit der Prozess mehr Daten in den EMS-Protokolldateien protokolliert. Der Standardwert ist 0.
EMSUserDaten	Lassen Sie dieses Feld leer. Durch Festlegen der Ablaufverfolgungsbits in procmon wird dieses Feld automatisch ausgefüllt.
EMSDisplayToScreen	Der Standardwert ist 1. Legen Sie den Wert auf 0 fest, damit die Daten im Prozessfenster nicht angezeigt werden. Dies ist weniger CPU-intensiv und ermöglicht einen einfacheren pcAnywhere-Zugriff.

Wenn Sie die Ablaufverfolgung erhöhen müssen, um Fehler zu beheben, bestimmen Sie zuerst den freien Speicherplatz auf dem Computer. Wenn genügend Speicherplatz verfügbar ist, nehmen Sie die folgenden Änderungen vor:

• Setzen Sie EMSAllLogFileMax auf 100 MB.

  Hinweis: Stellen Sie zunächst sicher, dass auf dem Laufwerk, auf dem Cisco ICM installiert ist, genügend Festplattenspeicher vorhanden ist.

• Stellen Sie EMSLogFileMax auf 10 MB ein.

• Setzen Sie EMSDisplayToScreen auf 0.

• Die Registrierungsänderungen müssen für jeden Prozess vorgenommen werden, von dem aus Sie Protokolle erfassen möchten.

  Hinweis: Denken Sie daran, dass EMSAllLogfilesMTax kumulativ ist. Wenn Sie EMSAllLogfilesMax für OPC, PIM1, PIM2 und CTISVR auf 100 MB festlegen, verwenden Sie 400 MB des verfügbaren Festplattenspeichers.

• Die vorgeschlagenen Dateigrößen stellen lediglich einen Bezugspunkt dar. Große und stark ausgelastete Contact Center müssen möglicherweise EMSAllLogfilesMax erhöhen, um sicherzustellen, dass Protokolle nicht überschrieben werden.

Nachrichtenspuren anzeigen

Sobald die Meldungen erfasst wurden, zeigen Sie sie mit dem Dumplog-EMS-Dienstprogramm an. Dumplog liest eine EMS-Protokolldatei, formatiert die Ereignisdaten und schreibt sie in eine Ausgabedatei. Wenn die Protokolldatei Nachrichtenverfolgungsereignisse enthält, wird jede verfolgte Nachricht in der Dumplog-Ausgabe im decodierten Format angezeigt.

Wenn die Daten erfasst wurden, setzen Sie die geänderten Werte zurück.

Regacc-Dienstprogramm

Das Dienstprogramm regacc ist befehlsgesteuert und kann in einer Telnet-Sitzung verwendet werden. Geben Sie regacc an der Eingabeaufforderung ein. In dieser Tabelle sind die gebräuchlichsten regacc-Befehle aufgeführt:

Command	Aufgaben
regcd	Ändert das aktuelle Registrierungsverzeichnis.
Regdir	Führt das aktuelle Registrierungsverzeichnis auf.
nachfüllen	Druckt das aktuelle Arbeitsverzeichnis.
nachregeln	Legt einen neuen Registrierungswert im aktuellen Arbeitsregistrierungsverzeichnis fest.
f	Beendet das Dienstprogramm regacc.
?	Zeigt die Hilfe zu regacc an.
Befehl /?	Zeigt die Syntax für einen einzelnen Befehl an.

In diesem Beispiel wird gezeigt, wie auf das Verzeichnis zugegriffen wird, das die Prozesse zum Aktivieren der Ablaufverfolgung enthält. Geben Sie den Befehl regcd ein, um das Verzeichnis zu wechseln, und dann den Befehl regdir, um den Inhalt des aktuellen Arbeitsverzeichnisses anzuzeigen.

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

Hinweis: Dieser Wert wird aufgrund von Platzbeschränkungen über mehrere Zeilen angezeigt.

In diesem Fall muss der PIM-Prozess zurückverfolgt werden. Der Befehl regcd wird verwendet, um in das Verzeichnis pim1 zu wechseln, und der Befehl regdir, um den Inhalt dieses Verzeichnisses anzuzeigen.

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

Der Befehl regset wird verwendet, um den Wert zu ändern. In diesem Beispiel wird die Größe von EMSLogFileMax von 5 MB auf 1 MB geändert.

Hinweis: Wenn Sie Werte ändern, müssen Sie Hexadezimalformate verwenden.

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

OPCTest, Rtest und Procmon

Hier finden Sie eine Erläuterung der bei der Verfolgung verwendeten Prozesse.

OPCTest

Sie können OPCTest verwenden, um die Ablaufverfolgung nur für den OPC-Prozess zu aktivieren. Mit dem Befehl debug können Sie einzelne Trace-Meter aktivieren. Geben Sie in OPCTest debug /? ein. für weitere Informationen über den Befehl.

Wenn der Prozess aktiviert wird oder Dienste beendet werden, werden die von Ihnen angegebenen Optionen deaktiviert. Es ist weiterhin notwendig, den Befehl regacc oder regedt32 zu verwenden, um die EMSAllLogFilesMax und EMSLogFilesMax so zu erhöhen, dass die Daten nicht in die Ausgabe eingebunden werden.

Um die Ablaufverfolgung von OPCTest zu deaktivieren, geben Sie den Befehl debug /noall ein. Vergessen Sie nicht, alle Prozessfenster zu minimieren, wenn Sie den Test abgeschlossen haben.

Weitere Informationen zu OPCTest finden Sie unter Verwenden des OPC-Test-Befehlszeilendienstprogramms.

Rtest

Sie können den Befehl rtest ausführen, um die Ablaufverfolgung nur für den RTR-Prozess zu aktivieren. Verwenden Sie den Befehl debug, um einzelne Ablaufverfolgungsmeter zu aktivieren. Geben Sie in rtest debug /? ein. für weitere Informationen über den Befehl.

Wenn der Prozess aktiviert wird oder Dienste beendet werden, werden die von Ihnen angegebenen Optionen deaktiviert. Es ist weiterhin notwendig, den Befehl regacc oder regedt32 zu verwenden, um die EMSAllLogFilesMax und EMSLogFilesMax so zu erhöhen, dass die Daten nicht in die Ausgabe eingebunden werden.

Weitere Informationen zum Testen finden Sie im Cisco ICM Testprogramm.

Procmon

Sie können procmon verwenden, um die Ablaufverfolgung für die pims-, mis- und ctiserver-Prozesse zu aktivieren. Leider gibt es keine Standardoption, um die Ablaufverfolgung für diese Prozesse zu aktivieren. Die Option für den Definity-Schalter ist beispielsweise debug. Um eine VRU-PIM-Ablaufverfolgung zu starten, müssen Sie hingegen den Ablaufverfolgungszähler festlegen und den Befehl ltrace verwenden, um die Ablaufverfolgungszähler anzuzeigen. Um weitere Informationen über die Verwendung von procmon anzuzeigen, geben Sie dies an einer DOS-Eingabeaufforderung ein:

procmon custname device process

Führen Sie den Befehl mhelp aus, um die Optionen für den einzelnen Prozess aufzulisten.

Nachfolgend finden Sie ein Beispiel für die Optionen für den Definity-Switch:

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] [/?]

Das Dienstprogramm regacc ist in procmon integriert. Innerhalb von procmon können Sie den Befehl mhelp ausführen, um die regacc-Befehle anzuzeigen.

Wenn der Prozess aktiviert wird oder Dienste beendet werden, werden die von Ihnen angegebenen Optionen deaktiviert. Es ist weiterhin notwendig, die Befehle regacc oder regedt32 zu verwenden, um EMSAllLogFilesMax und EMSLogFilesMax so zu erhöhen, dass die Daten nicht in die Ausgabe eingebunden werden.

Um die Ablaufverfolgung von procmon zu deaktivieren, geben Sie debug /noall ein. Vergessen Sie nicht, alle Prozessfenster zu minimieren, wenn Sie den Test abgeschlossen haben.

Weitere Informationen zu procmon finden Sie unter Remote Process Monitor Console (Procmon) verwenden.

Zugehörige Informationen

• Verwenden des OPC-Testbefehlszeilendienstprogramms
• Das Testprogramm Cisco ICM
• Verwenden der Remote Process Monitor Consle (Procmon)
• Verwenden des Dienstprogramms Dumplog
• Technischer Support – Cisco Systems