本页提供有关使用Cisco IOS®平台上可用的调试的一些常规指南,以及正确使用的示例 debug ip packet
命令和条件调试。
注意:对于特定 debug 命令,本文档不会介绍其使用方法,也不会解释其输出。有关特定的 debug
命令。
输出 debug
特权EXEC命令提供诊断信息,通常包含与协议状态和网络活动相关的各种网络间事件。
Cisco 建议您了解以下主题:
-
使用控制台、辅助和 VTY 端口连接到路由器
-
Cisco IOS 常见配置问题
-
解释 Cisco IOS 调试输出
本文档不限于特定的软件和硬件版本。
本文档中的信息都是基于特定实验室环境中的设备编写的。本文档中使用的所有设备最初均采用原始(默认)配置。如果您使用的是真实网络,请确保您已经了解所有命令的潜在影响。
使用 debug
命令。当解决具体问题时,通常只推荐在路由器技术支持人员提供指导的情况下使用这些命令。
在互联网络处于高负载的情况下,启用调试功能会中断路由器的运行。因此,如果已启用日志记录,则在控制台端口中的日志消息出现过载后,接入服务器可能会间歇性地停止响应。
在您开始之前 debug
命令,请始终考虑此命令将生成的输出以及这可能需要的时间。例如,如果您的路由器具有一个基本速率接口(BRI), debug isdn q931
也许不会伤害系统。但是,在具有完整 E1 配置的 AS5800 上执行相同的调试可能会生成太多输入,以至于它可能会挂起并停止响应。
在调试之前,使用 show processes cpu
命令。在开始调试之前,请验证是否有足够的 CPU 可用。有关如何处理高 CPU 负载的详细信息,请参阅解决思科路由器上的高 CPU 使用率问题。例如,如果您有一台进行桥接的带有 ATM 接口的思科 7200 路由器,根据所配置的子接口数量,重启路由器可能会占用大量 CPU。这是因为:对于每个虚电路(VC),都需要生成网桥协议数据单元(BPDU)数据包。在这样的重要时间内启动调试功能可能会使CPU利用率急剧增加,并导致系统挂起或网络断开。
注意:运行调试时,您通常不会看到路由器提示,特别是当调试非常密集时。但是,在大多数情况下,您可以使用 no debug all 或 undebug all 命令来停止调试。有关安全使用调试的详细信息,请参阅获取调试输出部分。
有关文档规则的详细信息,请参阅 Cisco 技术提示规则。
除了上面提到的几点,请确保您了解调试对平台稳定性的影响。您还应该考虑应该连接到路由器上的哪个接口。本部分介绍了一些指导原则。
路由器可显示各种接口的调试输出,其中包括控制面板、aux和vty端口。路由器还可将发送到内部缓冲器的日志消息记录到外部unix syslog服务器上。下面讨论每种方法的使用说明和注意事项:
控制台端口
如果您在控制台上连接,在正常配置下,无需执行额外操作。调试输出应自动显示。但是,确保 logging console level
设置为所需,且未禁用日志记录 no logging console
命令。
警告:对路由器的控制台端口进行过多调试会导致其被挂起。这是因为:在执行路由器其他功能之前,路由器对控制面板输出自动划分优先权。若路由器处理发送到控制面板端口的大型调试输出,路由器可能处于挂起状态。所以,若出现过多的调试输出,则使用vty (telnet)端口或日志缓冲器来获得调试输出。下面提供这方面的更多信息。
注意:默认情况下,控制台端口上会启用日志记录。即使实际上使用一些其他端口或方法(如:Aux、vty或缓冲器)来捕获输出,控制面板端口通常也要处理调试输出。因此,思科建议在正常运行条件下始终启用 no logging console 命令,并使用其他方法捕获调试。在需要使用控制面板的情况下,暂时将 logging console 设置为启用状态。
AUX 端口
如果通过辅助端口连接,请键入 terminal monitor
命令。另请验证 no logging on
命令尚未激活。
注意:如果您使用辅助端口监控路由器,请记住,当路由器重新启动时,辅助端口不会显示引导序列输出。请连接到控制台端口以查看引导顺序。
VTY端口
如果通过辅助端口或通过telnet连接,请键入 terminal monitor
命令。另请验证 no logging on
命令。
将信息记录到内部缓冲器
默认的日志记录设备是控制台;除非另有指定,否则所有消息都会显示在控制台上。
要将消息记录到内部缓冲区,请使用 logging buffered
路由器配置命令。以下是该命令的完整语法:
logging buffered
no logging buffered
的 logging buffered
命令将日志消息复制到内部缓冲区,而不是将其写入控制台。缓冲器具有循环特性,新消息将覆盖旧消息。要显示在缓冲区中记录的消息,请使用特权EXEC命令 show logging
。所显示的第1个消息是缓冲器中最旧的消息。可以指定缓冲器的大小,以及要记录的信息的重要级别。
提示:在输入缓冲区大小之前,请确保设备中有足够的可用内存。使用Cisco IOS show proc mem
命令,查看可用内存。
的 no logging buffered
命令取消使用缓冲区并将消息写入控制台(默认)。
将信息记录到UNIX Syslog服务器
若要将日志信息记录到syslog服务器主机上,则使用日志路由器配置命令。此命令的全部句法如下:
logging
no logging
的 logging
命令标识接收日志记录消息的系统日志服务器主机。<ip-address> 参数是主机的IP地址。通过多次发布此命令,可建立接收日志消息的syslog服务器列表。
的 no logging
命令从syslog列表中删除具有指定地址的syslog服务器。
-
安装终端仿真器软件(例如,HyperTerminal) 以便将调试输出捕获到文件上。例如,在HyperTerminal中,单击 Transfer
,然后单击 Capture Text
,然后选择适当的选项。有关详细信息,请参阅从超级终端捕获文本输出。有关其他终端仿真器软件,请参考软件文献。
-
使用 service timestamps
指令:
router(config)#service timestamps debug datetime msec
router(config)#service timestamps log datetime msec
这些命令以MMM DD HH:MM:SS格式向调试添加时间戳,表示根据系统时钟的日期和时间。若未设置系统时钟,则日期和时间之前带有星号(*)以说明日期和时间可能不正确。
通常合理的办法是配置毫秒时间标记,这是因为:在查看调试输出时,通过这种办法可实现更高级别的准确性。对于相互联系的调试事件,毫秒时间标记提供了更好的指示说明。但是,值得注意的是,在控制面板端口输出大量信息时,可能不与事件的实际定时发生联系。例如,如果启用 debug x25
所有VC都位于具有200条VC的机箱上,并且输出记录到缓冲区(使用 no logging console
和 logging buffered
命令),调试输出(缓冲区内)中显示的时间戳可能不是数据包通过接口的确切时间。因此,不要使用msec时间标记来证明性能情况,但可使用这种时间标记来获得事件发生时间的相对信息。
要停止调试,请使用 no debug all
或 undebug all
命令。使用命令验证调试是否已关闭 show debug
。
请记住, no logging console
和 terminal no monitor
仅防止输出分别在控制台、Aux或vty上输出。它不会停止调试,因此会耗尽路由器资源。
的 debug ip packet
命令生成有关路由器未快速交换的数据包的信息。但是,由于生成每个数据包的输出,所以输出尺寸扩大,并因此使路由器处于“挂起”状态。因此,仅使用 debug ip packet
按本节所述的最严格控制。
限制输出的最佳方法 debug ip packet
创建链接到调试的访问列表。只有与访问列表条件匹配的数据包才会受到 debug ip packet
。不必在所有接口上都应用此访问列表,但非常适用于调试操作。
使用前 debugging ip packet
,请注意路由器默认执行快速交换,或者如果配置为执行CEF交换,则可能执行CEF交换。也就是说,如果这些方法可用,则不向处理器提供数据包,因此,调试不显示任何内容。要使此功能正常运行,您需要在路由器上禁用快速交换 no ip route-cache
(对于单播数据包)或 no ip mroute-cache
(对于组播数据包)。 这种办法适用于传输业务的接口。使用 show ip route
命令。
警告:
下面研究一个示例方案:
router_122 上配置的访问列表为:
access-list 105 permit icmp host 10.10.10.2 host 13.1.1.1
access-list 105 permit icmp host 13.1.1.1 host 10.10.10.2
此访问列表允许所有互联网控制消息协议(ICMP)数据包从主机router_121(IP地址为10.10.10.2)传输到主机router_123(IP地址为13.1.1.1),以及传输到其他方向上。允许数据包传输到任一方向是很重要的,否则路由器可能会丢弃返回的ICMP数据包。
在router_122上仅删除一个接口上的快速交换。这意味着您只能看到发往该接口的数据包的调试,从IOS拦截数据包的角度来看。在调试中,此类数据包显示有“d=”。 由于您尚未关闭另一接口的快速交换,因此返回的数据包不受 debug ip packet
。此输出显示如何禁用快速交换:
router_122(config)#interface virtual-template 1
router_122(config-if)#no ip route-cache
router_122(config-if)#end
现在必须激活 debug ip packet
访问列表(访问列表105)。
router_122#debug ip packet detail 105
IP packet debugging is on (detailed) for access list 105
router_122#
00:10:01: IP: s=13.1.1.1 (Serial3/0), d=10.10.10.2 (Virtual-Access1),
g=10.10.10.2, len 100, forward
00:10:01: ICMP type=0, code=0
! -- ICMP packet from 13.1.1.1 to 10.10.10.2.
! -- This packet is displayed because it matches the
! -- source and destination requirements in access list 105
00:10:01: IP: s=13.1.1.1 (Serial3/0), d=10.10.10.2 (Virtual-Access1),
g=10.10.10.2, len 100, forward
00:10:01: ICMP type=0, code=0
00:10:01: IP: s=13.1.1.1 (Serial3/0), d=10.10.10.2 (Virtual-Access1),
g=10.10.10.2, len 100, forward
00:10:01: ICMP type=0, code=0
下面删除其他接口(router_122)上的快速路由。 这意味着这两个接口上的所有数据包现在都进行分组交换(这是 debug ip packet
):
router_122(config)#interface serial 3/0
router_122(config-if)#no ip route-cache
router_122(config-if)#end
router_122#
00:11:57: IP: s=10.10.10.2 (Virtual-Access1), d=13.1.1.1
(Serial3/0), g=172.16.1.6, len 100, forward
00:11:57: ICMP type=8, code=0
! -- ICMP packet (echo) from 10.10.10.2 to 13.1.1.1
00:11:57: IP: s=13.1.1.1 (Serial3/0), d=10.10.10.2 (Virtual-Access1),
g=10.10.10.2, len 100, forward
00:11:57: ICMP type=0, code=0
! -- ICMP return packet (echo-reply) from 13.1.1.1 to 10.10.10.2
00:11:57: IP: s=10.10.10.2 (Virtual-Access1), d=13.1.1.1 (Serial3/0),
g=172.16.1.6, len 100, forward
00:11:57: ICMP type=8, code=0
00:11:57: IP: s=13.1.1.1 (Serial3/0), d=10.10.10.2 (Virtual-Access1),
g=10.10.10.2, len 100, forward
00:11:57: ICMP type=0, code=0
请注意:debug ip packet 输出不显示任何不符合访问列表标准的数据包。有关此过程的更多信息,请参阅了解 Ping 和 Traceroute 命令。
有关如何构建访问列表的详细信息,请参阅标准 IP 访问列表日志记录。
当启用条件触发调试功能时,路由器会为进出指定接口上的路由器的数据包生成调试消息;路由器不会为通过其他接口进出的数据包生成调试输出。
下面介绍条件调试的简单实施。请考虑以下场景:下面所示的路由器 (trabol) 有两个接口(serial 0 和 serial 3),均运行 HDLC 封装。
您可以使用 debug serial interface
命令,以观察所有接口上收到的HDLC keepalive数据包。您可以观察两个接口上的 keepalive。
traxbol#debug serial interface
Serial network interface debugging is on
traxbol#
*Mar 8 09:42:34.851: Serial0: HDLC myseq 28, mineseen 28*, yourseen 41, line up
! -- HDLC keeplaive on interface Serial 0
*Mar 8 09:42:34.855: Serial3: HDLC myseq 26, mineseen 26*, yourseen 27, line up
! -- HDLC keeplaive on interface Serial 3
*Mar 8 09:42:44.851: Serial0: HDLC myseq 29, mineseen 29*, yourseen 42, line up
*Mar 8 09:42:44.855: Serial3: HDLC myseq 27, mineseen 27*, yourseen 28, line up
为接口Serial 3启用条件调试。这意味着只显示接口Serial 3的调试。请使用 debug interface <interface_type interface_number>
命令。
traxbol#debug interface serial 3
Condition 1 set
请使用 show debug condition
命令,以验证状态调试是否处于活动状态。请注意,串接口3处于激活状态。
traxbol#show debug condition
Condition 1: interface Se3 (1 flags triggered)
Flags: Se3
traxbol#
请注意,现在只显示串接口3的调试:
*Mar 8 09:43:04.855: Serial3: HDLC myseq 29, mineseen 29*, yourseen 30, line up
*Mar 8 09:43:14.855: Serial3: HDLC myseq 30, mineseen 30*, yourseen 31, line up
请使用 undebug interface <interface_type interface_number>
命令以删除条件调试。建议您在删除条件触发之前关闭调试(例如,使用 undebug all 命令)。通过这种办法,可避免删除条件时出现调试输出泛滥。
traxbol#undebug interface serial 3
This condition is the last interface condition set.
Removing all conditions may cause a flood of debugging
messages to result, unless specific debugging flags
are first removed.
Proceed with removal? [yes/no]: y
Condition 1 has been removed
traxbol
您现在可以观察到,系统显示了接口 serial 0 和 serial 3 的调试。
*Mar 8 09:43:34.927: Serial3: HDLC myseq 32, mineseen 32*, yourseen 33, line up
*Mar 8 09:43:44.923: Serial0: HDLC myseq 35, mineseen 35*, yourseen 48, line up
警告:某些调试操作本身是有条件的。ATM 调试就是一个例子。对于 ATM 调试,您应该明确指定应为其启用调试的接口,而不是在所有 ATM 接口上启用调试并指定条件。
本部分介绍了将 ATM 数据包调试限制在一个子接口的正确方法:
arielle-nrp2#debug atm packet interface atm 0/0/0.1
!--- Note that you explicitly specify the sub-interface to be used for debugging
ATM packets debugging is on
Displaying packets on interface ATM0/0/0.1 only
arielle-nrp2#
*Dec 21 10:16:51.891: ATM0/0/0.1(O):
VCD:0x1 VPI:0x1 VCI:0x21 DM:0x100 SAP:AAAA CTL:03 OUI:0080C2 TYPE:0007
Length:0x278
*Dec 21 10:16:51.891: 0000 FFFF FFFF FFFF 0010 7BB9 BDC4 0800 4500 025C 01FE
0000 FF11 61C8 0A30
*Dec 21 10:16:51.891: 4B9B FFFF FFFF 0044 0043 0248 0000 0101 0600 0015 23B7
0000 8000 0000 0000
*Dec 21 10:16:51.891: 0000 0000 0000 0000 0000 0000 0010 7BB9 BDC3 0000 0000
0000 0000 0000 0000
*Dec 21 10:16:51.891: 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000
0000 0000 0000 0000
*Dec 21 10:16:51.891: 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000
0000 0000 0000 0000
*Dec 21 10:16:51.891: 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000
0000 0000 0000 0000
*Dec 21 10:16:51.891: 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000
0000 0000 0000 0000
*Dec 21 10:16:51.895: 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000
0000 0000 0000 0000
*Dec 21 10:16:51.895:
arielle-nrp2#
如果尝试启用 atm debugging
在所有接口(具有应用条件)上,如果路由器具有大量ATM子接口,则路由器可能会挂起。下面举例说明了atm 调试的不正确方法。
在本例中,您可以看到应用了一个条件,但也可以看到该条件没有任何影响。您仍然可以看到来自另一个接口的数据包。在本实验场景中,您只有两个接口,流量非常小。如果接口数量较多,则所有接口的调试输出都会非常高,这可能会导致路由器挂起。
arielle-nrp2#show debugging condition
Condition 1: interface AT0/0/0.1 (1 flags triggered)
Flags: AT0/0/0.1
! -- A condition for a specific interface.
arielle-nrp2#debug atm packet
ATM packets debugging is on
Displaying all ATM packets
arielle-nrp2#
*Dec 21 10:22:06.727: ATM0/0/0.2(O):
! -- You see debugs from interface ATM0/0/0/.2, even though the condition
! -- specified ONLY AT0/0/0.1
VCD:0x2 VPI:0x5 VCI:0x37 DM:0x100 SAP:AAAA CTL:03 OUI:0080C2
TYPE:000E Length:0x2F
*Dec 21 10:22:06.727: 0000 0000 0180 0000 107B B9BD C400 0000 0080
0000 107B B9BD C480 0800 0014
*Dec 21 10:22:06.727: 0002 000F 0000
*Dec 21 10:22:06.727: un a
*Dec 21 10:22:08.727: ATM0/0/0.2(O):
VCD:0x2 VPI:0x5 VCI:0x37 DM:0x100 SAP:AAAA CTL:03 OUI:0080C2
TYPE:000E Length:0x2F
*Dec 21 10:22:08.727: 0000 0000 0180 0000 107B B9BD C400 0000 0080
0000 107B B9BD C480 0800 0014
*Dec 21 10:22:08.727: 0002 000F 0000
*Dec 21 10:22:08.727: ll
*Dec 21 10:22:10.727: ATM0/0/0.2(O):
VCD:0x2 VPI:0x5 VCI:0x37 DM:0x100 SAP:AAAA CTL:03 OUI:0080C2
TYPE:000E Length:0x2F
*Dec 21 10:22:10.727: 0000 0000 0080 0000 107B B9BD C400 0000 0080
0000 107B B9BD C480 0800 0014
*Dec 21 10:22:10.727: 0002 000F 0000
*Dec 21 10:22:10.727:
*Dec 21 10:22:12.727: ATM0/0/0.2(O):
VCD:0x2 VPI:0x5 VCI:0x37 DM:0x100 SAP:AAAA CTL:03 OUI:0080C2
TYPE:000E Length:0x2F
*Dec 21 10:22:12.727: 0000 0000 0080 0000 107B B9BD C400 0000 0080
0000 107B B9BD C480 0800 0014
*Dec 21 10:22:12.727: 0002 000F 0000
*Dec 21 10:22:12.727:
*Dec 21 10:22:13.931: ATM0/0/0.1(O):
!--- You also see debugs for interface ATM0/0/0.1 as you wanted.
VCD:0x1 VPI:0x1 VCI:0x21 DM:0x100 SAP:AAAA CTL:03 OUI:0080C2
TYPE:0007 Length:0x278
*Dec 21 10:22:13.931: 0000 FFFF FFFF FFFF 0010 7BB9 BDC4 0800 4500
025C 027F 0000 FF11 6147 0A30
*Dec 21 10:22:13.931: 4B9B FFFF FFFF 0044 0043 0248 0000 0101 0600
001A 4481 0000 8000 0000 0000
*Dec 21 10:22:13.931: 0000 0000 0000 0000 0000 0000 0010 7BB9 BDC3
0000 0000 0000 0000 0000 0000
*Dec 21 10:22:13.931: 0000 0000 0000 0000 0000 0000 0000 0000 0000
0000 0000 0000 0000 0000 0000
*Dec 21 10:22:13.931: 0000 0000 0000 0000 0000 0000 0000 0000 0000
0000 0000 0000 0000 0000 0000
*Dec 21 10:22:13.931: 0000 0000 0000 0000 0000 0000 0000 0000 0000
0000 0000 0000 0000 0000 0000
*Dec 21 10:22:13.931: 0000 0000 0000 0000 0000 0000 0000 0000 0000
0000 0000 0000 0000 0000 0000
*Dec 21 10:22:13.935: 0000 0000 0000 0000 0000 0000 0000 0000 0000
0000 0000 0000 0000 0000 0000