Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

配置数据路径调试和追踪选项

了解 SRX 系列设备的数据路径调试

数据路径调试或端到端调试支持,在数据包处理路径上的多个处理单元上提供跟踪和调试。执行数据包过滤器时,对生产系统的影响微乎其微。

如果您的目标是收集数据包捕获,我们强烈建议您利用 Junos OS 19.3R1 版中引入的操作模式数据包捕获。请参阅 从操作模式捕获数据包

在 SRX 系列防火墙上,数据包会经历一系列事件,这些事件涉及从入口到出口处理的不同组件。

借助数据路径调试功能,您可以在处理路径上的不同数据点跟踪和调试(捕获数据包)。数据包处理路径中的可用事件包括:NP 入口、负载平衡线程 (LBT)、jexec、数据包排序线程 (POT) 和 NP 出口。如果设置了特定模块的安全流跟踪标志,您还可以启用流模块追踪。

在每次事件中,您都可以指定四个操作(计数、数据包转储、数据包摘要和追踪)中的任何一个。数据路径调试提供过滤器来定义要捕获的数据包,并且仅跟踪匹配的数据包。数据包过滤器可以根据逻辑接口、协议、源 IP 地址前缀、源端口、目标 IP 地址前缀和目标端口过滤掉数据包。

SRX1400、SRX3400、SRX3600、SRX4600、SRX5400、SRX5600 和 SRX5800 支持数据路径调试。

要启用端到端调试,必须执行以下步骤:

  1. 定义捕获文件并指定最大捕获大小。

  2. 定义数据包过滤器,以便根据需求仅跟踪特定类型的流量。

  3. 定义操作配置文件,指定捕获数据包的处理路径上的位置(例如,LBT 或 NP 入口)。

  4. 启用数据路径调试。

  5. 捕获流量。

  6. 禁用数据路径调试。

  7. 查看或分析报告。

端口和接口选项的数据包过滤行为如下所示:

  • 如果仅 port 指定了,数据包过滤器会同时跟踪 IPv4 和 IPv6 流量。

  • 如果仅 interface 指定了,数据包过滤器会跟踪 IPv4、IPV6 和非 IP 流量。

从操作模式捕获数据包

数据路径调试或端到端调试在数据包处理路径上的多个处理单元提供跟踪和调试。数据包捕获是数据路径调试功能之一。您可以从操作模式执行数据包捕获,而不提交配置,对生产系统的影响最小。

您可以使用过滤器捕获数据包,以定义要捕获的数据包。数据包过滤器可以根据逻辑接口、协议、源 IP 地址前缀、源端口、目标 IP 地址前缀和目标端口过滤掉数据包。您可以修改数据包捕获输出的文件名、文件类型、大小和捕获大小。您还可以将过滤器扩展到两个过滤器,然后交换过滤器的值。

SRX4600、SRX5400、SRX5600 和 SRX5800 支持从操作模式捕获数据包。

要从操作模式捕获数据包,必须执行以下步骤:

  1. 在操作模式下,定义数据包过滤器,以使用 request packet-capture start CLI 命令根据您的需求跟踪流量类型。有关可用的数据包捕获过滤器选项,请参阅 request packet-capture start
  2. 捕获所需的数据包。
  3. 您可以使用 request packet-capture stop CLI 命令停止数据包捕获,也可以在收集请求数量的数据包后自动停止数据包捕获。
  4. 查看或分析捕获的数据包数据报告。

从操作模式捕获数据包的局限性包括:

  1. 配置模式数据包捕获和操作模式数据包捕获不能共存。

  2. 操作模式数据包捕获是一次性操作,系统不存储此命令的历史记录。

  3. 您应该在低流量速率下使用操作模式数据包捕获。

了解使用追踪选项的安全调试

Junos OS 追踪功能允许应用程序将安全调试信息写入文件。此文件中显示的信息基于您设置的标准。您可以使用这些信息来分析安全应用程序问题。

追踪功能以分布式方式运行,每个线程都会写入自己的追踪缓冲区。然后,在一个点收集这些追踪缓冲区,对其进行排序,并写入跟踪文件。跟踪消息使用进程间通信 (IPC) 协议进行交付。跟踪消息的优先级低于控制协议数据包(如 BGP、OSPF 和 IKE),因此交付并不可靠。

了解使用追踪选项的流调试

对于流追踪选项,您可以使用 、 destination-port、 、 protocolsource-portdestination-prefixinterfacesource-prefix的组合来定义数据包过滤器。如果为某个模块设置了安全流跟踪标志,则匹配特定数据包过滤器的数据包将触发流跟踪,并将调试信息写入跟踪文件。

调试数据路径(CLI 过程)

SRX1400、SRX3400、SRX3600、SRX5400、SRX5600 和 SRX5800 支持数据路径调试。

要配置设备进行数据路径调试:

  1. 指定以下 request 命令,以便为数据包处理路径上的多个处理单元设置数据路径调试:
  2. 使用以下命令为数据路径调试指定跟踪选项:
  3. 使用 request 安全数据包过滤器命令,您可以设置数据包过滤器,以指定要执行数据路径调试操作的相关数据包。最多同时支持四个过滤器。例如,以下命令设置第一个数据包过滤器:
  4. 使用 request 安全操作配置文件命令,可以为指定过滤器的数据包匹配设置操作。仅支持默认操作配置文件,这是网络处理器 ezchip 入口、ezchip 出口、spu.lbt 和 spu.pot 的追踪选项:

设置流调试跟踪选项(CLI 过程)

以下示例显示可以使用设置 security flow traceoptions的选项。

  • 要匹配 filter1 数据包过滤器的 imap 目标端口,请使用以下语句:

  • 要为 filter1 数据包过滤器设置 1.2.3.4 目标 IPv4 前缀地址,请使用以下语句:

  • 要为 filter1 数据包过滤器设置 fxp0 逻辑接口,请使用以下语句:

  • 要匹配 filter1 数据包过滤器的 TCP IP 协议,请使用以下语句:

  • 要匹配 filter1 数据包过滤器的 HTTP 源端口,请使用以下语句:

  • 要为 filter1 数据包过滤器设置 5.6.7.8 IPv4 前缀地址,请使用以下语句:

设置安全跟踪选项(CLI 过程)

使用以下配置语句在 CLI 配置编辑器中配置安全跟踪选项。

  • 要禁用远程跟踪,请输入以下语句:

  • 要向本地文件写入跟踪消息,请输入以下语句。系统将跟踪文件 /var/log/ 保存在目录中。

  • 要为跟踪文件指定名称,请输入以下语句。有效值的范围从 1 到 1024 个字符。名称不能包含空格、/或 % 字符。默认文件名是安全性。

  • 要指定可累积的最大追踪文件数,请输入以下语句。有效值的范围从 2 到 1000。默认值为 3。

  • 要指定系统在将信息记录到文件中时使用的匹配标准,请输入以下语句。输入正则表达式。接受通配符 (*) 字符。

  • 要允许任何用户读取跟踪文件,请输入语句 world-readable 。否则,输入 no-world-readable 语句。

  • 要指定追踪文件可增长到的最大大小,请输入以下语句。一旦文件达到指定大小,它将压缩并重命名 filename为 0.gz,下一个文件命名为 filename1.gz,以如此命名。有效值的范围从 10240 到 1,073,741,824。

  • 要打开追踪选项并执行多个跟踪操作,请设置以下标志。

  • 要指定这些跟踪选项设置适用于或不适用的组,请输入以下语句:

显示日志和跟踪文件

输入命令以显示 monitor start 对系统日志和跟踪文件的实时添加信息:

设备将记录添加到指定的 filename文件中时,记录会显示在屏幕上。例如,如果您配置了名为 system-log 的系统日志文件(包括 syslog [edit system] 层次结构级别的语句),则可以输入 monitor start system-log 命令以显示添加到系统日志中的记录。

要显示正在监控的文件列表,请输入 monitor list 命令。要停止显示指定文件的记录,请输入 monitor stop filename 命令。

显示安全追踪选项的输出

目的

显示安全追踪选项的输出。

行动

show security traceoptions使用命令显示追踪文件的输出。例如:

此示例的输出如下所示:

显示组播跟踪操作

要监控和显示组播跟踪操作,请输入 mtrace monitor 命令:

此示例仅 mtrace 显示查询。但是,当设备捕获响应 mtrace 时,显示屏会类似,但也会显示完整 mtrace 响应(与命令输出中 mtrace from-source 显示的完全一样)。

表 1 汇总了显示的输出字段。

表 1: CLI mtrace 监控命令输出摘要

字段

说明

Mtrace operation-type at time-of-day

  • operation-type—组播跟踪操作类型:queryresponse

  • time-of-day- 捕获组播跟踪查询或响应的日期和时间。

by

发出查询的主机的 IP 地址。

resp to address

address-响应目标地址。

qid qid

qid- 查询 ID 号。

packet from source to destination

  • source-查询或响应源的 IP 地址。

  • destination-查询或响应目标的 IP 地址。

from source to destination

  • source-组播源的 IP 地址。

  • destination-组播目标的 IP 地址。

via group address

address- 正在跟踪的组地址。

mxhop=number

number- 最大跃点设置。

显示设备列表

要显示设备与指定目标主机之间的设备列表,请输入 traceroute 使用以下语法的命令:

表 2 介绍了 traceroute 命令选项。

表 2: CLI traceroute 命令选项

选项

说明

host

将 traceroute 数据包发送到您指定的主机名或 IP 地址。

interface interface-name

(可选)在指定的接口上发送 traceroute 数据包。如果未包含此选项,则所有接口上都会发送 traceroute 数据包。

as-number-lookup

(可选)显示设备和目标主机之间每个中间跃点的自治系统 (AS) 编号。

bypass-routing

(可选)绕过路由表,仅将 traceroute 数据包发送至直连接口上的主机。如果主机不在直连接口上,将返回错误消息。

使用此选项可以通过没有路由的接口显示到本地系统的路由。

gateway address

(可选)使用您指定的网关进行路由。

inet

(可选)强制将追踪路由数据包传输至 IPv4 目标。

inet6

(可选)强制将追踪路由数据包传输至 IPv6 目标。

no-resolve

(可选)抑制显示路径上跃点的主机名。

routing-instance routing-instance-name

(可选)使用您为 traceroute 指定的路由实例。

source address

(可选)使用您在 traceroute 数据包中指定的源地址。

tos number

(可选)设置 traceroute 数据包的 IP 标头中的服务类型 (TOS) 值。指定从到 0 的值 255

ttl number

(可选)设置 traceroute 数据包的生存时间 (TTL) 值。指定从到的0128跃点计数。

wait seconds

(可选)设置等待响应的最大时间。

要退出 traceroute 命令,按 Ctrl-C。

以下是命令输出 traceroute 的示例:

显示中的字段与 J-Web traceroute 诊断工具显示的字段相同。

示例:在 SRX 系列设备上配置端到端调试

此示例说明如何在带有 SRX5K-MPC 的 SRX 系列防火墙上配置和启用端到端调试。

要求

此示例使用以下硬件和软件组件:

  • SRX5600 设备,装有 SRX5K-MPC,并配备 100 千兆以太网 CFP 收发器

  • 适用于 SRX 系列防火墙的 Junos OS 12.1X47-D15 或更高版本

开始之前:

配置此功能之前,不需要除设备初始化之外的特殊配置。

概述

数据路径调试通过在数据包处理路径上的多个处理单元提供跟踪和调试,增强了故障排除能力。借助数据路径调试功能,您可以在处理路径上的不同数据点跟踪和调试(捕获数据包)。您可以在每个事件中指定操作(计数、数据包转储、数据包摘要和跟踪),还可以设置过滤器来定义要捕获的数据包。

在此示例中,定义流量过滤器,然后应用操作配置文件。操作配置文件指定了处理单元上的各种操作。入口和出口被指定为处理路径上的位置,用于捕获传入和传出流量的数据。

接下来,在操作模式下启用数据路径调试,最后查看数据捕获报告。

注:

SRX1400、SRX3400、SRX3600、SRX5400、SRX5600 和 SRX5800 支持数据路径调试。

配置

程序

CLI 快速配置

要快速配置此示例,请复制以下命令,将其粘贴到文本文件中,删除所有换行符,更改详细信息,以便与网络配置匹配,将命令复制并粘贴到层级的 [edit] CLI 中,然后从配置模式进入 commit

逐步过程

以下示例要求您在配置层次结构中的各个级别上导航。有关如何操作的说明,请参阅《Junos OS CLI 用户指南中的在配置模式下使用 CLI 编辑器

要配置数据路径调试:

  1. 编辑数据包处理路径上的多个处理单元的安全数据路径调试选项:

  2. 启用捕获文件、文件格式、大小和文件数量。

  3. 为操作配置文件配置操作配置文件、事件类型和操作。

结果

在配置模式下,输入命令以确认 show security datapath-debug 您的配置。如果输出未显示预期的配置,请重复此示例中的配置说明,以便进行更正。

完成设备配置后,请从配置模式进入 commit

启用数据路径调试

程序

逐步过程

配置数据路径调试后,必须从操作模式在设备上启动进程。

  1. 启用数据路径调试。

  2. 在验证配置和查看报告之前,必须禁用数据路径调试。

    注:

    捕获完数据后,必须停止调试过程。如果尝试在不停止调试进程的情况下打开捕获的文件,则通过任何第三方软件(例如,tcpdump 和 wireshark)都无法打开获取的文件。

验证

确认配置工作正常。

验证数据路径调试数据包捕获详细信息

目的

通过启用数据路径调试配置来验证捕获的数据。

行动

在操作模式下,输入 show security datapath-debug capture 命令。

为简洁起瞻博网络 show ,命令输出被截短,仅显示几个示例。其他示例已替换为椭圆 (...)。

要查看结果,请从 CLI 操作模式访问本地 UNIX shell 并导航至目录 /var/log/<file-name>。可以使用实用程序读取 tcpdump 结果。

注:

完成数据路径调试故障排除后,请移除所有 traceoptions (不限于流跟踪选项)和完整的数据路径调试配置,包括需要手动启动/停止的数据包捕获(packet-转储)的数据路径调试配置。如果调试配置的任何部分保持活动状态,它将继续使用设备的资源(CPU/内存)。