开启跟踪

简介

思科智能联系管理(ICM)事件管理系统(EMS)为ICM进程提供应用程序接口(API)，用于报告事件。本文档讨论如何启用跟踪以帮助排除Cisco ICM中的问题。

先决条件

要求

Cisco 建议您了解以下主题：

• Cisco ICM

• Microsoft Windows NT版本4和Windows 2000

使用的组件

本文档中的信息基于以下软件和硬件版本：

• Cisco ICM版本4.6.2及以上版本

• Microsoft Windows版本4和Windows 2000

本文档中的信息都是基于特定实验室环境中的设备编写的。本文档中使用的所有设备最初均采用原始（默认）配置。如果您使用的是真实网络，请确保您已经了解所有命令的潜在影响。

规则

有关文档规则的详细信息，请参阅 Cisco 技术提示规则。

调高跟踪

在Cisco ICM中记录问题有两种方法：使用API或打开跟踪。

API

使用API以便：

• 将事件记录到本地EMS日志文件。

• 将事件记录到Microsoft Windows NT/2000应用程序事件日志中。

• 将事件发送到数据库服务器以存储在Cisco ICM数据库中。

• 将事件发送至中央客户服务转发服务，以交付给思科技术支持中心(TAC)。

调高跟踪

要排除ICM问题，可以使用以下过程之一启动跟踪：

• Microsoft Windows NT或Windows 2000注册表编辑器

• Regacc 实用程序

• OPCTest

• rttest

• Procmon

注意：完成后请务必关闭所有跟踪。此外，更重要的是，在完成测试时，不要使进程命令窗口处于打开状态。这会严重影响系统资源，特别是CPU利用率和内存。

Windows NT或Windows 2000注册表编辑器

要运行regedit32，请完成以下步骤：

1. 选择Start > Run。

2. 键入regedt32以打开Windows NT或Windows 2000注册表编辑器。

   以下是注册表编辑器和EMS外围设备接口管理器(PIM)设置的示例。要查看这些设置，请导航到此路径：

   • Cisco ICM版本4.6及更低版本：

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

   • Cisco ICM版本5.0及以上版本:

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

   理想情况下，您会看到“注册表编辑器”窗口左侧的键和右侧的值。

3. 双击要更改的值，将显示“DWORD编辑器”对话框。

4. 在“基”面板中，单击十六进制。

5. 更改值。

6. Click OK.

此表显示可在注册表编辑器中更改的值。最常见的更改值是AllLogFileMax、LogFileMax和TraceMask。不能更改日志文件计数。

价值	路径
EMSAllLogFileMax	进程的所有EMS日志文件的最大大小。默认值为6000000/6 MB或2000000/2 MB。
EMSAllLogFileCount	进程的EMS日志文件数。默认值为20，通常不需要更改。
EMSLogFileMax	每个EMS日志文件的最大大小。默认值为100000或100K。
EMSTraceMask	进程将更多数据记录到EMS日志文件的跟踪位。默认值为 0。
EMSUserData	将此留空。在procmon中设置跟踪位将自动填充此字段。
EMSDisplayToScreen	默认值为1。设置为0以便不在流程窗口中显示数据。这占用的CPU资源较少，并且使pcAnywhere访问更加轻松。

如果需要增加跟踪以便排除故障，请先确定计算机上的可用磁盘空间量。如果有足够的可用磁盘空间，请进行以下更改：

• 将EMSAllLogFileMax设置为100 MB。

  注意：首先，确保在安装Cisco ICM的驱动器上有足够的磁盘空间。

• 将EMSLogFileMax设置为10 MB。

• 将EMSDisplayToScreen设置为0。

• 必须对计划从中收集日志的每个进程进行注册表更改。

  注意：请记住EMSAllLogfilesMTax是累积的。如果将OPC、PIM1、PIM2和CTISVR的EMSAllLogfilesMax设置为100 MB，则使用400 MB的可用驱动器空间。

• 建议的文件大小只是参考点。大型和繁忙的联系中心可能需要增加EMSAllLogfilesMax以确保日志不会被覆盖。

显示消息跟踪

捕获消息后，使用dumplog EMS实用程序显示这些消息。Dumplog读取EMS日志文件，格式化事件数据，并将格式化数据写入输出文件。如果日志文件包含消息跟踪事件，则每个跟踪消息在dumplog输出中以解码格式显示。

捕获数据后，重置更改的值。

Regacc 实用程序

regacc实用程序是命令驱动的，可以在Telnet会话中使用。在命令提示符下键入regacc。下表列出了最常用的regacc命令：

命令	功能
regcd	更改当前注册表目录。
regdir	列出当前注册表目录。
regpwd	打印当前工作目录。
regset	在当前工作注册表目录中设置新的注册表值。
问	退出regacc实用程序。
?	显示regacc的帮助。
命令/?	显示单个命令的语法。

此示例显示如何访问包含进程以启动跟踪的目录。发出regcd命令以更改目录，然后发出regdir命令以显示当前工作目录的内容。

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

注意：由于空间限制，此值显示在多行上。

在这种情况下，PIM进程需要跟踪。regcd命令用于移入pim1目录，而regdir命令用于查看该目录的内容。

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

使用regset命令更改值。在本示例中，EMSLogFileMax大小从5 MB更改为1 MB。

注意：更改值时必须使用十六进制格式。

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

OPCTest、Rttest和Procmon

以下是对跟踪中所用进程的说明。

OPCTest

您可以使用OPCTest以便只为OPC进程启用跟踪。使用debug命令打开各个跟踪仪表。在OPCTest中，键入debug /?了解关于命令的详细信息。

如果进程断言或服务已停止，则您指定的选项将关闭。仍然需要使用regacc或regedt32命令来增加EMSAllLogFilesMax和EMSLogFilesMax，以便数据不会在输出中换行。

要从OPCTest关闭跟踪，请发出debug /noall命令。完成测试时，不要忘记最小化所有进程窗口。

有关OPCTest的详细信息，请参阅使用OPC测试命令行实用程序。

Rttest

您可以发出rttest命令以仅对RTR进程启用跟踪。请使用debug命令打开各个跟踪仪表。在rttest中，键入debug /?了解关于命令的详细信息。

如果进程断言或服务已停止，则您指定的选项将关闭。仍然需要使用regacc或regedt32命令来增加EMSAllLogFilesMax和EMSLogFilesMax，以便数据不会在输出中换行。

有关rttest的详细信息，请参阅Cisco ICM rttest实用程序。

Procmon

您可以使用procmon在pims、mis和ctiserver进程上启用跟踪。遗憾的是，没有标准选项可以启用这些进程的跟踪。例如，Definity交换机的选项是debug，而要启动VRU PIM跟踪，必须设置跟踪计量器并使用ltrace命令以查看跟踪计量器。要查看有关procmon使用的详细信息，请在DOS提示符下键入以下命令：

procmon custname device process

发出mhelp命令以列出各个进程的选项。

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

regacc实用程序内置于procmon中。在procmon中，可以发出mhelp命令以查看regacc命令。

如果进程断言或服务已停止，则您指定的选项将关闭。仍然需要使用regacc或regedt32命令增加EMSAllLogFilesMax和EMSLogFilesMax，以使数据不会在输出中换行。

要从procmon关闭跟踪，请输入debug /noall。完成测试时，不要忘记最小化所有进程窗口。

有关procmon的详细信息，请参阅使用远程进程监控器控制台(Procmon)。

相关信息

• 使用OPC test命令行实用程序
• Cisco ICM rttest 实用程序
• 使用远程进程监控台 (Procmon)
• 如何使用 Dumplog 程序
• 技术支持 - Cisco Systems