了解思科
购买方式

已有帐户？

  •   个性化内容
  •   您的产品和支持

需要帐户？

创建帐户

关于 Debug 命令的重要信息

下载选项

  • PDF     (348.7 KB)
    在各种设备上使用 Adobe Reader 查看
  • ePub     (85.7 KB)
    在 iPhone、iPad、Android、Sony Reader 或 Windows Phone 上使用各种应用查看
  • Mobi (Kindle)     (92.7 KB)
    在 Kindle 设备上查看或在多个设备上使用 Kindle 应用查看
已更新: 2022 年 4 月 29 日
文档 ID:10374

非歧视性语言

思科可能会在某些地方提供本内容的当地语言翻译版本。请注意，翻译版本仅供参考，如有任何不一致之处，以本内容的英文版本为准。

关于此翻译

思科采用人工翻译与机器翻译相结合的方式将此文档翻译成不同语言，希望全球的用户都能通过各自的语言得到支持性的内容。 请注意：即使是最好的机器翻译，其准确度也不及专业翻译人员的水平。 Cisco Systems, Inc. 对于翻译的准确性不承担任何责任，并建议您总是参考英文原始文档（已提供链接）。

    简介

    本页提供有关使用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服务器。

    其他预调试任务

    1. 安装终端仿真器软件(例如，HyperTerminal) 以便将调试输出捕获到文件上。例如，在HyperTerminal中，单击 Transfer，然后单击 Capture Text，然后选择适当的选项。有关详细信息，请参阅从超级终端捕获文本输出。有关其他终端仿真器软件，请参考软件文献。

    2. 使用 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 创建链接到调试的访问列表。只有与访问列表条件匹配的数据包才会受到 debug ip packet。不必在所有接口上都应用此访问列表，但非常适用于调试操作。

    使用前 debugging ip packet，请注意路由器默认执行快速交换，或者如果配置为执行CEF交换，则可能执行CEF交换。也就是说，如果这些方法可用，则不向处理器提供数据包，因此，调试不显示任何内容。要使此功能正常运行，您需要在路由器上禁用快速交换 no ip route-cache （对于单播数据包）或 no ip mroute-cache （对于组播数据包）。 这种办法适用于传输业务的接口。使用 show ip route 命令。

    警告：

    • 对于处理大量数据包的路由器，启用路由器上快速交换可增加CPU利用率，从而使设备处于“挂起”状态，并失去对等连接。

    • 对于运行多协议标记 (MPLS) 交换的路由器，不要禁用路由器上的快速交换。MPLS是与CEF一起使用的。因此，禁用接口上的快速交换可导致很严重的后果。

    下面研究一个示例方案：

    Debug Commands - debug ip packet Command Sample Scenario

    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

    相关信息

    修订历史记录

    版本 发布日期 备注
    2.0
    29-Apr-2022
    已更新和删除断开的链接。
    1.0
    02-Dec-2013
    初始版本

    此文档是否有帮助?

    Feedback反馈

    联系我们

    本文档适用于以下产品