目录

简介

先决条件

要求

使用的组件

Dumplog 程序执行什么？

如何到达日志文件目录

使用率

dumplog 用法示例

简介

本文档介绍dumplog实用程序，该实用程序允许您查看思科智能联系管理(ICM)进程日志。

先决条件

要求

Cisco 建议您了解以下主题：

- 如何解决软件问题

- Cisco ICM

使用的组件

本文档中的信息基于Cisco ICM。

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

Dumplog 程序执行什么？

dumplog实用程序将Cisco ICM进程写入的二进制日志文件转换为可读格式。转换后，可以引用日志文件内容以深入了解ICM操作。通常，dumplog用作故障排除工具，但也可以用于教学。

可以直接从ICM服务器上的命令提示符调用dumplog实用程序，也可以从到ICM服务器的Telnet会话调用。

注意：以下示例假设ICM安装在C驱动器上。如果ICM安装在不同的驱动器上，则会相应地更改目录位置。

有关本文档中使用的服务器名称约定，请参阅ICM服务器名称约定。

如何到达日志文件目录

Cisco ICM日志文件目录的路径为<root>\icm\customer instance name\node name，其中<root>是安装ICM的驱动器，例如C、D或E。

例如，如果您认为思科ICM呼叫路由器安装在C驱动器上，geocscortra上的日志文件目录将位于：c:\icm\csco\rtra\logfiles。

注意：这可以用作日志文件目录的快捷方式：c:\>cdlog <cust_inst> <ICM_Node>。

使用率

dumplog实用程序的命令行选项显示在此部分。它们可以帮助您解决问题，因为它们允许您在特定时间段内查看Cisco ICM日志文件。可使用/bd、/bt、/ed和/et开关定义时间段。用户还可以搜索特定字符串，以进一步隔离可疑的ICM行为并对其进行故障排除。

此信息也可在Cisco智能呼叫路由器管理员指南中找到。

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

参数说明

进程名称

除非使用其他参数指定不同的日期或时间，否则此命令将转储此进程的当前日期日志。

[/dir Dirs]

Directory指定/dir交换机之后命令行上列出的任何进程的日志文件位置。如果未使用/dir开关，则默认情况下使用当前目录。

[/if]

InputFile指定要转储的特定.ems文件。/if令牌是可选的。如果指定输入文件，/bd、/bt、/ed、/et、/hr和/all参数将被忽略。

/o

将输出写入\logfiles目录中的文本文件。当您将.txt后缀添加到指定的进程前缀或输入文件名（不带.ems后缀）时，会形成文件名名。 文件会写入当前目录。

/of

OutputFile指定输出文本文件；例如，c:\temp\mylog.txt。

/c

指定连续输出。该命令在到达日志结尾后不会退出。相反，它会等待并写入日志中显示的任何其他条目。

/bd

BeginDate(mm/dd/yyyy)指定开始日期。如果与/bt一起使用，则指定日期范围。否则，dumplog仅转储指定日期的事件。

/bt

BeginTime(hh:mm:ss)指定开始时间。使用/et以指定时间范围。

/ed

结束日期(mm/dd/yyyy)指定结束日期。使用with/bd以指定天数范围。

/et

EndTime(hh:mm:ss)指定结束时间。使用/bt以指定时间范围。

/hr

HoursBack指定从当前时间回退的小时数。

/all

显示指定进程日志文件的所有信息。

/last

显示进程的最新日志文件中的信息。

/prev

显示进程的下一个到最后一个日志文件中的信息。

/m

MatchString仅显示包含指定字符串匹配的事件。

/x

ExcludeString仅显示不包含指定字符串匹配的事件。

[/ms]

显示以时间戳为单位的毫秒。

[/mc]

转储合并的日志时，请使用多种颜色。每个过程都有不同的颜色。必须指定ProcessPrefix或InputFile。如果仅提供ProcessPrefix值（例如，rtr、nm或lgr），则dumplog在默认情况下显示该进程的当前日期日志。

/ciscoLog

启用CiscoLog功能。

/unzipCmdPrefix

解压缩的前缀参数，例如gzip -d -c。

/unzipCmdInfix

用于解压缩的Infix参数，例如">"。

/unzipCmdPostfix

用于解压缩的Postfix参数，例如“”。

/unzipTempfile

用于解压的临时文件，例如“temp.ems”。

/zipPostfix

文件postfix参数，例如“.gz”。

/tzadjustoff

将EMS文件复制到不同时区的系统时，或者如果更改了系统时区，如果没有此选项，则所有查询都是相对于生成日志文件的计算机进行的。否则，将使用/tzadjustoff来切换与此计算机时间相关的查询行为。

注意：要使用Microsoft记事本查看重定向的日志文件，请将日志文件保存到文本文件(使用dumplog /of参数)，然后使用notepad filename命令从命令提示符打开文本文件。

dumplog 用法示例

本示例显示如何从1999年4月29日到1999年4月30日转储路由器上的rtr日志文件。它输出到一个名为rtr.txt的日志文件。现在可以使用标准文本编辑器（如记事本）查看文件rtr.txt。

c:\icm\csco\rtra\logfiles dumplog rtr /bd 04/29/1999 /ed 04/30/1999 /o

此命令从外围网关(PG)中转储pgag日志文件，该日志文件从上次打开新日志文件进行输出时开始。

c:\icm\csco\rtra\logfiles dumplog pgag /last

此命令以隔行方式转储来自多个进程的日志并将输出写入单个输出文件。

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.

还支持使用连字符的语法。

dumplog -ms -hr 1 -of output.txt rtr mds rts