目  录

1 iFIT

1.1 iFIT配置命令

1.1.1 bind interface

1.1.2 delay-measure disable

1.1.3 delete dynamic-flow

1.1.4 device-id

1.1.5 display ifit flow dynamic

1.1.6 display ifit flow static

1.1.7 display ifit global-information

1.1.8 display ifit instance

1.1.9 display ifit statistic

1.1.10 dynamic-flow aging-time

1.1.11 encapsulation

1.1.12 flow

1.1.13 ifit enable

1.1.14 instance

1.1.15 measure enable

1.1.16 measure mode

1.1.17 period

1.1.18 reset ifit statistic

 

1 iFIT

1.1  iFIT配置命令

1.1.1  bind interface

bind interface命令用来将iFIT（In-situ Flow Information Telemetry，随流信息测量）目标流和接口绑定。

undo bind interface命令用来取消iFIT目标流和接口的绑定。

【命令】

bind interface interface-type interface-number

undo bind interface [ interface-type interface-number ]

【缺省情况】

iFIT目标流未绑定接口。

【视图】

iFIT实例视图

【缺省用户角色】

network-admin

【参数】

interface-type interface-number：表示接口类型和接口编号。不指定该参数时，表示恢复缺省情况。当前仅支持绑定三层物理接口和三层聚合接口。

【使用指导】

在入节点开启iFIT测量前，必须将iFIT目标流和接口绑定。绑定接口后，iFIT会解析流经该接口的报文，按照规则完成目标流的匹配，给目标流报文添加iFIT报文头，统计目标流报文个数，同时按周期将报文计数和时间戳等信息通过gRPC连接上报给分析器。

在同一视图下多次执行本命令，可以将同一iFIT目标流和多个接口绑定。一个iFIT实例可以配置一个目标流匹配规则，一个实例可以和多个接口绑定，每个绑定接口会按照同一规则匹配目标流，并给目标流分配不同的FlowID，iFIT会按接口独立测量目标流的时延和丢包性能。

【举例】

# 将iFIT目标流与接口Ten-GigabitEthernet3/1/1绑定。

<Sysname> system-view

[Sysname] ifit enable

[Sysname-ifit] instance abc

[Sysname-ifit-instance-abc] bind interface ten-gigabitethernet 3/1/1

# 将iFIT流与聚合接口Route-Aggregation 1绑定。

<Sysname> system-view

[Sysname] ifit enable

[Sysname-ifit] instance abc

[Sysname-ifit-instance-abc] bind interface route-aggregation 1

1.1.2  delay-measure disable

delay-measure disable命令用来关闭iFIT实例的时延测量功能。

undo delay-measure disable命令用来开启iFIT实例的时延测量功能。

【命令】

delay-measure disable

undo delay-measure disable

【缺省情况】

iFIT实例的时延测量功能处于开启状态。

【视图】

iFIT实例视图

【缺省用户角色】

network-admin

【使用指导】

缺省情况下实例的时延测量功能是开启的，如果不需要测量目标流的时延情况，可配置本命令。

【举例】

# 关闭iFIT实例的时延测量功能。

[Sysname] ifit enable

[Sysname-ifit] instance abc

[Sysname-ifit-instance-abc] delay-measure disable

1.1.3  delete dynamic-flow

delete dynamic-flow命令用于手工删除iFIT动态目标流。

【命令】

delete dynamic-flow { all | device-id device-id flow-id flow-id }

【视图】

iFIT视图

【缺省用户角色】

network-admin

【参数】

all：表示清除所有iFIT动态目标流。

device-id device-id：表示iFIT设备ID，device-id取值范围为1～1048575。

flow-id flow-id：表示iFIT流的标识，取值范围为1～1048575。

【使用指导】

FlowID由入节点生成，并通过iFIT报文头传递给中间节点和出节点，用于在iFIT测量网络中与DeviceID一起唯一地标识这条目标流，可通过display ifit flow static命令查看。

【举例】

# 手工删除iFIT动态目标流，DeviceID为2，FlowID为4098。

<Sysname> system-view

[Sysname] ifit enable

[Sysname-ifit] delete dynamic-flow device-id 2 flow-id 4098

【相关命令】

·     display ifit flow static

1.1.4  device-id

device-id命令用来配置iFIT设备ID。

undo device-id命令用来恢复缺省情况。

【命令】

device-id device-id

undo device-id

【缺省情况】

未配置iFIT设备ID。

【视图】

iFIT视图

【缺省用户角色】

network-admin

【参数】

device-id：表示iFIT设备ID，取值范围为1～1048575。

【使用指导】

在iFIT测量网络中，设备ID用来唯一标识一台设备。要使iFIT功能正常运行，设备ID必须配置，且要求iFIT测量网络内唯一。

【举例】

# 配置IFIT设备ID为100。

<Sysname> system-view

[Sysname] ifit enable

[Sysname-ifit] device-id 100

1.1.5  display ifit flow dynamic

display ifit flow dynamic命令用来显示iFIT动态目标流的相关信息。

【命令】

display ifit flow dynamic [ device-id device-id flow-id flow-id ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

device-id device-id：表示iFIT设备ID，device-id取值范围为1～1048575。

flow-id flow-id：显示指定流的丢包测量数据。flow-id表示目标流的标识，取值范围是1～1048575。

【使用指导】

静态目标流是入节点上通过手工配置的规则匹配到的业务流。在入节点上使用flow命令配置完iFIT流匹配规则，且开启iFIT测量功能后，入节点会生成一个iFIT静态目标流。该目标流由DeviceID+FlowID唯一标识，其中，DeviceID由device-id命令配置，FlowID为取值范围在1～1048575的随机数，由入节点生成。DeviceID+FlowID会封装在iFIT报文头中传递给中间节点和出节点。在入节点可通过display ifit flow static命令查看静态目标流的DeviceID和FlowID。

动态目标流是设备动态学习到的业务流。对于入节点，如果设备收到的报文匹配静态目标流的配置，则入节点会生成一个和静态流Flow ID相同的动态目标流；对于中间节点和出节点，则通过解析收到的报文，根据报文中携带的iFIT报文头动态学习生成动态目标流。

【举例】

# 显示iFIT动态目标流的相关信息。

<Sysname> display ifit flow dynamic

Device ID                : 1

Flow ID                  : 4099

Flow type                : Dynamic

Flow direction           : Unidirection

Period                   : 10 sec

Actual aging-time        : 300 sec

Aging threshold          : 90%

Interface information

Name                          Direction

Ten-GigabitEthernet3/1/1      TransitInput

Ten-GigabitEthernet3/1/2      TransitOutput

表1-1 display ifit flow dynamic命令显示信息描述表

字段	描述
Device ID	iFIT设备的标识
Flow ID	iFIT目标流的标识
Flow type	iFIT流类型，取值为： ·     Static：静态目标流 ·     Dynamic：动态目标流
Flow direction	iFIT流方向，取值为unidirection表示单向流
Period	测量周期，单位是秒
Actual aging-time	动态目标流实际的老化时间
Aging threshold	动态目标流的老化阈值百分比，动态目标流条数占设备支持的动态目标流总条数的百分比
Interface information	收到该iFIT目标流报文的接口的信息
Name	接口的名称
Direction	iFIT目标流经过接口的方向，取值为： ·     Ingress表示目标流从该接口进入穿越网络 ·     TransitInput表示目标流从该接口进入本节点 ·     TransitOutput表示目标流从该接口离开本节点 ·     Egress表示目标流从该接口离开穿越网络

 

【相关命令】

·     display ifit flow static

·     flow

1.1.6  display ifit flow static

display ifit flow static命令用来显示iFIT静态目标流的相关信息。

【命令】

display ifit flow static [ flow-id flow-id ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

flow-id flow-id：显示指定流的丢包测量数据。flow-id表示目标流的标识，取值范围是1～1048575。

【使用指导】

静态目标流是入节点上通过手工配置的规则匹配到的业务流。在入节点上使用flow命令配置完iFIT流匹配规则，且开启iFIT测量功能后，入节点会生成一个iFIT静态目标流。该目标流由DeviceID+FlowID唯一标识，其中，DeviceID由device-id命令配置，FlowID为取值范围在1～1048575的随机数，由入节点生成。DeviceID+FlowID会封装在iFIT报文头中传递给中间节点和出节点。在入节点可通过display ifit flow static命令查看静态目标流的DeviceID和FlowID。

【举例】

# 显示FlowID为4097的iFIT静态目标流的配置信息（该目标流为公网IPv4 over SRv6基于五元组粒度的测量）。

<Sysname> display ifit flow static flow-id 4097

Instance name                  : 1

Device ID                      : 1

Flow ID                        : 4097

Flow information:

  Flow type                    : Static

  Flow direction               : Unidirection

  Source IP/mask length        : 1.1.1.1/24

  Destination IP/mask length   : 2.2.2.2/32

  Protocol                     : TCP

  Source port                  : Any

  Destination port             : Any

  DSCP                         : 23

  VPN instance name            : --

Measurement information:

  Period                       : 10 sec

  Measurement mode             : e2e

  Loss measurement             : Enabled

  Delay measurement            : Enabled

  Measurement configuration    : Enabled

  Measurement status           : Active

Bound interface:

  Ten-GigabitEthernet3/1/1

# 显示FlowID为4099的iFIT静态目标流的配置信息（MPLS/SR-MPLS私网IPv6基于五元组粒度的测量）。

<Sysname> display ifit flow static flow-id 4099

Instance name                  : 3

Device ID                      : 1

Flow ID                        : 4099

Flow information:

  Flow type                    : Static

  Flow direction               : Unidirection

  Source IPv6/prefix length      : 1::1/68

  Destination IPv6/prefix length : 2::2/128

  Protocol                     : UDP

  Source port                  : 8080

  Destination port             : 2308

  DSCP                         : --

  VPN instance name            : vpn3

Measurement information:

  Period                       : 30 sec

  Measurement mode             : e2e

  Loss measurement             : Enabled

  Delay measurement            : Enabled

  Measurement configuration    : Enabled

  Measurement status           : Active

Bound interface:

  Ten-GigabitEthernet3/1/1

# 显示FlowID为4100的iFIT静态目标流的配置信息（该目标流为L3VPN over SRv6组网基于PeerLocator粒度的测量）。

<Sysname> display ifit flow static flow-id 4100

Instance name                  : 4

Device ID                      : 1

Flow ID                        : 4100

Flow information:

  Flow type                    : Static

  Flow direction               : Unidirection

  Source IPv6                  : Any

  Destination IPv6             : Any

  DSCP                         : --

  VPN instance name            : 1

  Peer locator                 : 1::1/32

Measurement information:

  Period                       : 30 sec

  Measurement mode             : e2e

  Loss measurement             : Enabled

  Delay measurement            : Enabled

  Measurement configuration    : Enabled

  Measurement status           : Active

Bound interface:

  Ten-GigabitEthernet3/1/1

表1-2 display ifit flow static命令显示信息描述表

字段	描述
Instance Name	iFIT实例的名称
Device ID	生成iFIT目标流的设备的标识
Flow ID	iFIT目标流的标识
Flow information	iFIT目标流的信息
Flow type	iFIT流类型，取值为： ·     Static：静态目标流 ·     Dynamic：动态目标流
Flow direction	iFIT流方向，取值为unidirection表示单向流
Source IP/maskLength	目标流的源IP地址及其掩码长度
Destination IP/maskLength	目标流的目的IP地址及其掩码长度
Source IPv6/prefix length	目标流的源IPv6地址及其前缀长度
Destination IPv6/prefix length	目标流的目的IPv6地址及其前缀长度
Protocol	目标流的协议号，取值为： ·     0～5、7～16、18～131、133～255中的任意整数：表示除UDP、TCP和SCTP外的协议的编号 ·     UDP：UDP协议 ·     TCP：TCP协议 ·     SCTP：SCTP协议
Source port	目标流的源端口
Destination port	目标流的目的端口
DSCP	目标流的DSCP
VPN-instance name	iFIT流绑定的VPN名称
VSI name	iFIT流绑定的VSI名称
Xconnect-group	iFIT流绑定的交叉连接组名称
Connection	iFIT流绑定的交叉连接名称
Measurement information	测量信息
Period	测量周期
Measurement mode	测量模式，取值为： ·     e2e：端到端测量 ·     trace：逐跳测量
Next hop configuration	目标流的下一跳。该参数已经被其它配置方式替代，为了兼容历史软件版本，用户可以输入该参数，但实际不生效
Peer locator	iFIT流的目的Locator段
Loss measurement	是否测量丢包情况，取值为： ·     Enabled：表示测量 ·     Disabled：表示不测量
Delay measurement	是否测量时延，取值为： ·     Enabled：表示测量 ·     Disabled：表示不测量
Measurement configuration	测量是否开启，取值为： ·     Enabled：表示已开启 ·     Disabled：表示未开启
Measurement status	测量的实际激活状态，取值为： ·     Active：表示正在进行测试 ·     Inactive：表示当前未在进行测试
Bound interface	iFIT目标流绑定的接口

 

【相关命令】

·     display ifit flow dynamic

·     flow

1.1.7  display ifit global-information

display ifit global-information命令用来显示iFIT目标流的全局信息。

【命令】

display ifit global-information

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【举例】

# MPLS组网下，显示iFIT目标流的全局信息。

<Sysname> display ifit global-information

Current instance count        : 2

Enabled instance count        : 1

Current static flow count     : 1

Current dynamic flow count    : 1

Global next hop configuration : 1.1.1.1

                                2.2.2.2

# SRV6组网下，显示iFIT目标流的全局信息。

<Sysname> display ifit global-information

Current instance count        : 2

Enabled instance count        : 1

Current static flow count     : 1

Current dynamic flow count    : 1

Global next hop configuration : --

表1-3 display ifit flow命令显示信息描述表

字段	描述
Current instance count	配置的iFIT实例个数
Enabled instance count	开启了iFIT功能的实例个数
Current static flow count	静态目标流的条数
Current dynamic flow count	动态目标流的条数
Global next hop configuration	全局配置的下一跳的值 ·     对于MPLS/SR-MPLS组网，必须全局配置下一跳来指定哪个对端PE支持iFIT。设备仅对发往该对端PE的业务流进行iFIT处理 ·     对于SRv6、G-SRv6组网，无需配置本命令，即便配置也不生效

 

1.1.8  display ifit instance

display ifit instance命令用来显示iFIT实例的相关信息。

【命令】

display ifit instance [ instance-name ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

instance-name：显示指定实例下配置的目标流的相关信息。instance-name表示iFIT实例的名称，为1～31个字符的字符串，区分大小写。

【举例】

# 显示iFIT实例1的相关信息。

<Sysname> display ifit instance 1

Instance name                  : 1

Device ID                      : 1

Flow information:

  Flow type                    : Static

  Flow direction               : Unidirection

  Source IP/mask length        : 1.1.1.1/24

  Destination IP/mask length   : 2.2.2.2/32

  Protocol                     : TCP

  Source port                  : Any

  Destination port             : Any

  DSCP                         : 23

  VPN instance name            : --

Measurement information:

  Period                       : 10 sec

  Measurement mode             : e2e

  Loss measurement             : Enabled

  Delay measurement            : Enabled

  Measurement configuration    : Disabled

  Measurement status           : Inactive

Flow items:

  Flow ID                     Interface

  --                          --

# 显示iFIT实例2的相关信息。

<Sysname> display ifit instance 2

Instance name                    : 2

Device ID                        : 1

Flow information:

  Flow type                      : Static

  Flow direction                 : Unidirection

  Source IP                      : Any

  Destination IP                 : Any

  DSCP                           : --

  VPN instance name              : 1

  Peer locator                   : 1::1/32

Measurement information:

  Period                         : 30 sec

  Measurement mode               : e2e

  Loss measurement               : Enabled

  Delay measurement              : Enabled

  Measurement configuration      : Enabled

  Measurement status             : Active

Flow items:

  Flow ID                       Interface

  2                             Ten-GigabitEthernet3/1/1

# 显示iFIT实例3的相关信息。

<Sysname> display ifit instance 3

Instance name                  : 3

Device ID                      : 1

Flow information:

  Flow type                    : Static

  Flow direction               : Unidirection

  Source IPv6/prefix length      : 1::1/68

  Destination IPv6/prefix length : 2::2/128

  Protocol                     : UDP

  Source port                  : 8080

  Destination port             : 2308

  DSCP                         : --

  VPN instance name            : vpn3

Measurement information:

  Period                       : 30 sec

  Measurement mode             : e2e

  Loss measurement             : Enabled

  Delay measurement            : Enabled

  Measurement configuration    : Enabled

  Measurement status           : Active

Flow items:

  Flow ID                     Interface

  11                          Ten-GigabitEthernet3/1/1

  12                          Ten-GigabitEthernet3/1/2

# 显示iFIT实例4的相关信息。

<Sysname> display ifit instance 4

Instance name                  : 4

Device ID                      : 1

Flow information:

  Flow type                    : Static

  Flow direction               : Unidirection

  Source IPv6                  : Any

  Destination IPv6             : Any

  DSCP                         : --

  VPN instance name            : 1

  Peer locator                 : 1::1/32

Measurement information:

  Period                       : 30 sec

  Measurement mode             : e2e

  Loss measurement             : Enabled

  Delay measurement            : Enabled

  Measurement configuration    : Enabled

  Measurement status           : Active

Flow items:

  Flow ID                     Interface

  11                          Ten-GigabitEthernet3/1/1

  12                          Ten-GigabitEthernet3/1/2

表1-4 display ifit instance命令显示信息描述表

字段	描述
Instance Name	iFIT实例的名称
Device ID	iFIT设备的标识
Flow information	iFIT目标流的信息
Flow type	iFIT流类型，取值为： ·     Static：静态目标流 ·     Dynamic：动态目标流
Flow direction	iFIT流方向，取值为unidirection表示单向流
Source IP/maskLength	目标流的源IP地址及其掩码长度
Destination IP/maskLength	目标流的目的IP地址及其掩码长度
Source IPv6/prefix length	目标流的源IPv6地址及其前缀长度
Destination IPv6/prefix length	目标流的目的IPv6地址及其前缀长度
Protocol	目标流的协议号，取值为： ·     0～5、7～16、18～131、133～255中的任意整数：表示除UDP、TCP和SCTP外的协议的编号 ·     UDP：UDP协议 ·     TCP：TCP协议 ·     SCTP：SCTP协议
Source port	目标流的源端口
Destination port	目标流的目的端口
DSCP	目标流的DSCP
VPN-instance name	iFIT流绑定的VPN名称
VSI name	iFIT流绑定的VSI名称
Xconnect-group	iFIT流绑定的交叉连接组名称
Connection	iFIT流绑定的交叉连接名称
Measurement information	测量信息
Period	测量周期
Measurement mode	测量模式，取值为： ·     e2e：端到端测量 ·     trace：逐跳测量
Next hop configuration	目标流的下一跳。该参数已经被其它配置方式替代，为了兼容历史软件版本，用户可以输入该参数，但实际不生效
Peer locator	iFIT流的目的Locator段
Loss measurement	是否测量丢包情况，取值为： ·     Enabled：表示测量 ·     Disabled：表示不测量
Delay measurement	是否测量时延，取值为： ·     Enabled：表示测量 ·     Disabled：表示不测量
Measurement configuration	测量是否开启，取值为： ·     Enabled：表示已开启 ·     Disabled：表示未开启
Measurement status	测量的实际激活状态，取值为： ·     Active：表示正在进行测试 ·     Inactive：表示当前未在进行测试
Flow items	iFIT目标流。只有配置measure enable命令后，才会显示具体Flow的信息
Flow ID	iFIT目标流的标识，取值为--，表示还未为该流分配流ID
Interface	iFIT目标流绑定的接口

 

1.1.9  display ifit statistic

display ifit statistic命令用来显示iFIT动态目标流最近10个周期生成的iFIT测量信息。

【命令】

display ifit statistic device-id device-id flow-id flow-id [ verbose ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

flow-id flow-id：显示iFIT动态目标流的iFIT测量数据。flow-id表示目标流的标识，取值范围是1～1048575。

verbose：显示指定实例或者指定流的详细测量信息。不指定该参数时，显示iFIT简要测量信息。

【使用指导】

静态业务流是手工配置的流匹配规则，动态业务流才对应真正的业务流，所以，只有动态目标流才有统计信息。因为设备学习生成动态目标流需要时间，所以，对于新生成的动态目标流，其第一、第二个周期产生的测量数据的精准度无法保证，不可信任，建议控制器不要使用新动态目标流第一、第二个周期产生的测量数据。

FlowID由入节点生成，并通过iFIT报文头传递给中间节点和出节点，用于在iFIT测量网络中与DeviceID唯一的标识这条目标流，可通过display ifit flow static命令查看。

【举例】

# 显示DeviceID为1 FlowID为123的目标流的简要测量信息。

<Sysname> display ifit statistic device-id 1 flow-id 123

Period ID      Direction         PktCount    Timestamp (sec, nsec)   Interface

159627365      TransitIn         1500 1596273655,349433112   XGE3/1/1

# 显示DeviceID为1 FlowID为123的目标流的详细测量信息。

<Sysname> display ifit statistic device-id 1 flow-id 123 verbose

Period ID            : 159627365

Period started at    : 2020-08-01 17:20:55

Direction            : TransitInput

Interface            : Ten-GigabitEthernet3/1/1(Route-Aggregation1)

PktCount             : 1500

ByteCount            : 1295489456450

Timestamp (sec, nsec): 2020-08-01 17:20:55.349433112 (1619278726, 349433112)

TTL                  : 0

Trust flag           : Trusted

表1-5 display ifit statistic命令显示信息描述表

字段	描述
PeriodID	测量周期的编号
Period started at	测量周期开始时间
Direction	流对于接口的方向，取值为： ·     Ingress表示目标流从该接口进入穿越网络 ·     TransitIn在简要显示信息中表示目标流从该接口进入本节点 ·     TransitInput在详细显示信息中表示目标流从该接口进入本节点 ·     TransitOut在简要显示信息中表示目标流从该接口离开本节点 ·     TransitOutput在详细显示信息中表示目标流从该接口离开本节点 ·     Egress表示目标流从该接口离开穿越网络
Interface	接口名或者接口名（接口所属的聚合接口的名称）
PktCount	该周期测量到的报文个数
ByteCount	该周期测量到的字节个数
Timestamp (sec, nsec)	用于计算时延的时间戳（时间戳中的秒值部分，时间戳中的纳秒值部分），详细信息中显示格式为“年-月-日 时:分:秒.纳秒”
TTL	（暂不支持）报文的TTL值
Trust flag	本周期上报的数据是否可以信任： ·     Trusted：可信任 ·     Untrusted：不可信任。对于新生成的动态目标流，其第一、第二个周期产生的测量数据的精准度无法保证，不可信任，建议控制器不要使用新动态目标流第一、第二个周期产生的测量数据

 

【相关命令】

·     display ifit flow static

1.1.10  dynamic-flow aging-time

dynamic-flow aging-time命令用来配置动态目标流的老化参数。

undo dynamic-flow aging-time命令用来恢复缺省情况。

【命令】

dynamic-flow aging-time multi-value [ threshold-percent threshold-percent ]

undo dynamic-flow aging-time

【缺省情况】

动态目标流的老化时间是测量周期的10倍，但是不能小于5分钟。

【视图】

iFIT视图

【缺省用户角色】

network-admin

【参数】

multi-value：用于配置动态目标流的老化时间。动态目标流的老化时间＝测量周期×multi-value，取值范围为2～100。

threshold-percent threshold-percent：用于配置动态目标流的老化阈值百分比，取值范围为0～100，缺省值为30。

【使用指导】

设备在创建动态流的时候会为该动态流创建老化定时器。当设备收到该流的报文，就会让老化定时器重新计时。如果直到老化定时器超时，仍没有收到该流的报文，设备会认为该流不活跃。

同时，设备会按周期查看当前动态流的总数，当动态流的总数大于老化阈值（老化阈值=设备支持的动态流最大数×threshold-percent），设备会自动将不活跃的流老化，即将不活跃的动态流的信息从设备中删除，以免不活跃的流持续占用系统资源。

动态目标流的老化时间必须大于等于5分钟，如果根据命令行配置计算出来的动态目标流的老化时间小于5分钟，则实际生效的动态目标流的老化时间为5分钟。

【举例】

# 配置iFIT动态目标流的老化时间为测量周期的20倍。

<Sysname> system-view

[Sysname] ifit enable

[Sysname-ifit] dynamic-flow aging-time 20

1.1.11  encapsulation

encapsulation命令用来配置对下一跳为指定值的报文进行iFIT处理。

undo encapsulation命令用来取消iFIT对下一跳的要求。

【命令】

encapsulation { nexthop ip-address | nexthop-ipv6 ipv6-address }

undo encapsulation [ nexthop ip-address | nexthop-ipv6 ipv6-address ]

【缺省情况】

iFIT不要求报文的下一跳为指定值。

【视图】

iFIT视图

【缺省用户角色】

network-admin

【参数】

nexthop ip-address：指定MPLS、SR-MPLS组网中，对端PE的IPv4地址。

nexthop-ipv6 ip-address：该参数已经被其它配置方式替代，为了兼容历史软件版本，用户可以输入该参数，但实际不生效。

【使用指导】

在MPLS、SR-MPLS组网中，配置flow命令后，必须配置该命令来指定哪个对端PE支持iFIT。设备仅对发往该PE的业务流进行iFIT处理，包括封装iFIT报文头，统计报文个数、打时间戳，向分析器上报测量信息。

在SRv6、G-SRv6组网中，设备会自动对所有下一跳封装iFIT报文，用户无需配置下一跳。即便配置encapsulation命令，也不生效。

【举例】

# 配置对下一跳为1.1.0.1的报文进行iFIT处理。

<Sysname> system-view

[Sysname] ifit enable

[Sysname-ifit] encapsulation nexthop 1.1.0.1

【相关命令】

·     flow

1.1.12  flow

flow命令用来配置iFIT静态目标流。

undo flow命令用来取消iFIT静态目标流配置。

【命令】

(1)     MPLS/SR-MPLS公网组网情况下：

¡     基于五元组粒度的测量

（IPv4业务流）

flow unidirection source-ip { src-ip-address [ src-mask-length ] | any } destination-ip { dest-ip-address [ dest-mask-length ] | any } [ protocol { { sctp | tcp | udp } [ source-port src-port-number ] [ destination-port dest-port-number ] | protocol-number } ] [ dscp dscp-value ]

undo flow

（IPv6业务流）

暂不支持

(2)     MPLS/SR-MPLS私网组网情况下：

¡     基于五元组粒度的测量

（IPv4业务流）

flow unidirection source-ip { src-ip-address [ src-mask-length ] | any } destination-ip { dest-ip-address [ dest-mask-length ] | any } [ protocol { { sctp | tcp | udp } [ source-port src-port-number ] [ destination-port dest-port-number ] | protocol-number } ] [ dscp dscp-value ] vpn-instance vpn-instance-name

undo flow

（IPv6业务流）

flow unidirection source-ipv6 { src-ipv6-address [ src-prefix-length ] | any } destination-ipv6 { dest-ipv6-address [ dest-prefix-length ] | any } [ protocol { { sctp | tcp | udp } [ source-port src-port-number ] [ destination-port dest-port-number ] | protocol-number } ] [ dscp dscp-value ] vpn-instance vpn-instance-name

undo flow

(3)     EVPN VPLS over MPLS/SR-MPLS组网情况下：

¡     基于五元组粒度的测量

（IPv4业务流）

flow unidirection source-ip { src-ip-address [ src-mask-length ] | any } destination-ip { dest-ip-address [ dest-mask-length ] | any } [ protocol { { sctp | tcp | udp } [ source-port src-port-number ] [ destination-port dest-port-number ] | protocol-number } ] [ dscp dscp-value ] vsi vsi-name

undo flow

（IPv6业务流）

flow unidirection source-ipv6 { src-ipv6-address [ src-prefix-length ] | any } destination-ipv6 { dest-ipv6-address [ dest-prefix-length ] | any } [ protocol { { sctp | tcp | udp } [ source-port src-port-number ] [ destination-port dest-port-number ] | protocol-number } ] [ dscp dscp-value ] vsi vsi-name

undo flow

(4)     EVPN VPWS over MPLS/SR-MPLS组网情况下：

¡     基于五元组粒度的测量

（IPv4业务流）

flow unidirection source-ip { src-ip-address [ src-mask-length ] | any } destination-ip { dest-ip-address [ dest-mask-length ] | any } [ protocol { { sctp | tcp | udp } [ source-port src-port-number ] [ destination-port dest-port-number ] | protocol-number } ] [ dscp dscp-value ] xconnect-group group-name connection connection-name

undo flow

（IPv6业务流）

flow unidirection source-ipv6 { src-ipv6-address [ src-prefix-length ] | any } destination-ipv6 { dest-ipv6-address [ dest-prefix-length ] | any } [ protocol { { sctp | tcp | udp } [ source-port src-port-number ] [ destination-port dest-port-number ] | protocol-number } ] [ dscp dscp-value ] xconnect-group group-name connection connection-name

undo flow

(5)     公网IPv4 over SRv6/G-SRv6组网情况下：

¡     基于五元组粒度的测量

（IPv4业务流）

flow unidirection source-ip { src-ip-address [ src-mask-length ] | any } destination-ip { dest-ip-address [ dest-mask-length ] | any } [ protocol { { sctp | tcp | udp } [ source-port src-port-number ] [ destination-port dest-port-number ] | protocol-number } ] [ dscp dscp-value ]

undo flow

（IPv6业务流）

flow unidirection source-ipv6 { src-ipv6-address [ src-prefix-length ] | any } destination-ipv6 { dest-ipv6-address [ dest-prefix-length ] | any } [ protocol { { sctp | tcp | udp } [ source-port src-port-number ] [ destination-port dest-port-number ] | protocol-number } ] [ dscp dscp-value ]

undo flow

¡     基于PeerLocator粒度的测量

（IPv4业务流）

flow unidirection source-ip any destination-ip any peer-locator ipv6-address prefix-length

undo flow

（IPv6业务流）

flow unidirection source-ipv6 any destination-ipv6 any peer-locator ipv6-address prefix-length

undo flow

(6)     L3VPN/EVPN L3VPN over SRv6/G-SRv6组网情况下：

¡     基于五元组粒度的测量

（IPv4业务流）

flow unidirection source-ip { src-ip-address [ src-mask-length ] | any } destination-ip { dest-ip-address [ dest-mask-length ] | any } [ protocol { { sctp | tcp | udp } [ source-port src-port-number ] [ destination-port dest-port-number ] | protocol-number } ] [ dscp dscp-value ] vpn-instance vpn-instance-name

undo flow

（IPv6业务流）

flow unidirection source-ipv6 { src-ipv6-address [ src-prefix-length ] | any } destination-ipv6 { dest-ipv6-address [ dest-prefix-length ] | any } [ protocol { { sctp | tcp | udp } [ source-port src-port-number ] [ destination-port dest-port-number ] | protocol-number } ] [ dscp dscp-value ] vpn-instance vpn-instance-name

undo flow

¡     基于PeerLocator粒度的测量

（IPv4业务流）

flow unidirection source-ip any destination-ip any [ vpn-instance vpn-instance-name ] peer-locator ipv6-address prefix-length

undo flow

（IPv6业务流）

flow unidirection source-ipv6 any destination-ipv6 any [ vpn-instance vpn-instance-name ] peer-locator ipv6-address prefix-length

undo flow

(7)     EVPN VPLS over SRv6/G-SRv6组网情况下：

¡     基于五元组粒度的测量

（IPv4业务流）

flow unidirection source-ip { src-ip-address [ src-mask-length ] | any } destination-ip { dest-ip-address [ dest-mask-length ] | any } [ protocol { { sctp | tcp | udp } [ source-port src-port-number ] [ destination-port dest-port-number ] | protocol-number } ] [ dscp dscp-value ] vsi vsi-name

undo flow

（IPv6业务流）

flow unidirection source-ipv6 { src-ipv6-address [ src-prefix-length ] | any } destination-ipv6 { dest-ipv6-address [ dest-prefix-length ] | any } [ protocol { { sctp | tcp | udp } [ source-port src-port-number ] [ destination-port dest-port-number ] | protocol-number } ] [ dscp dscp-value ] vsi vsi-name

undo flow

¡     基于PeerLocator粒度的测量

flow unidirection vsi vsi-name peer-locator ipv6-address prefix-length

undo flow

(8)     EVPN VPWS over SRv6/G-SRv6组网情况下：

¡     基于五元组粒度的测量

（IPv4业务流）

flow unidirection source-ip { src-ip-address [ src-mask-length ] | any } destination-ip { dest-ip-address [ dest-mask-length ] | any } [ protocol { { sctp | tcp | udp } [ source-port src-port-number ] [ destination-port dest-port-number ] | protocol-number } ] [ dscp dscp-value ] xconnect-group group-name connection connection-name

undo flow

（IPv6业务流）

flow unidirection source-ipv6 { src-ipv6-address [ src-prefix-length ] | any } destination-ipv6 { dest-ipv6-address [ dest-prefix-length ] | any } [ protocol { { sctp | tcp | udp } [ source-port src-port-number ] [ destination-port dest-port-number ] | protocol-number } ] [ dscp dscp-value ] xconnect-group group-name connection connection-name

undo flow

¡     基于PeerLocator粒度的测量

flow unidirection xconnect-group group-name connection connection-name peer-locator ipv6-address prefix-length

undo flow

【缺省情况】

未配置iFIT静态目标流。

【视图】

iFIT实例视图

【缺省用户角色】

network-admin

【参数】

unidirection：指定目标流为单向流。

source-ip src-ip-address：指定目标流的源IPv4地址，点分十进制格式。

src-mask-length：指定目标流的源IPv4地址的掩码长度，取值范围为1～32。不指定该参数时，表示精确匹配源IPv4地址。

destination-ip dest-ip-address：指定目标流的目的IPv4地址，点分十进制格式。

dest-mask-length：指定目标流的目的IPv4地址的掩码长度，取值范围为1～32。不指定该参数时，表示精确匹配目的IPv4地址。

source-ipv6 src-ipv6-address：指定目标流的源IPv6地址。

src-prefix-length：指定目标流的源IPv6地址的前缀长度，取值范围为1～128。不指定该参数时，表示精确匹配源IPv6地址。

destination-ipv6 dest-ipv6-address：指定目标流的目的IPv6地址。

dest-prefix-length：指定目标流的目的IPv6地址的前缀长度，取值范围为1～128。不指定该参数时，表示精确匹配目的IPv6地址。

protocol：指定目标流承载的协议类型。不指定该参数时，表示对目标流承载的协议类型无限制。

·     { sctp | tcp | udp }：指定目标流承载的协议类型为SCTP、TCP或者UDP。

·     destination-port dest-port-number：指定目标流的目的端口号，取值范围为0～65535。不指定该参数时，表示对目标流的目的端口号无限制。

·     source-port src-port-number：指定目标流的源端口号，取值范围为0～65535。不指定该参数时，表示对目标流的源端口号无限制。

·     protocol-number：指定目标流承载的协议类型为除SCTP、TCP和UDP之外的其他协议，取值范围为0～255，但不能为132、6和17，因为132、6和17分别代表SCTP、TCP和UDP协议。

dscp dscp-value：指定目标流的DSCP（Differentiated Services Code Point，区分服务代码点）值，取值范围为0～63。

vpn-instance vpn-instance-name：指定流所属的VPN实例。vpn-instance-name表示MPLS L3VPN的VPN实例名称，为1～31个字符的字符串，区分大小写。如果未指定本参数，则表示位于公网中。

vsi vsi-name：指定流所属的VSI（Virtual Switch Instance，虚拟交换实例）实例。vsi-name表示VSI的名称，为1～31个字符的字符串，区分大小写。关于VSI的介绍和配置请参见“Segment Routing配置指导”中的“EVPN VPLS over SRv6”。

xconnect-group group-name：指定流所属的交叉连接组。group-name交叉连接组的名称，为1～31个字符的字符串，不能包含字符“-”，区分大小写。关于交叉连接组的介绍和配置请参见“Segment Routing配置指导”中的“EVPN VPWS over SRv6”。

connection connection-name：指定流所属的交叉连接。connection-name表示交叉连接的名称，为1～20个字符的字符串，不能包含字符“-”，区分大小写。关于交叉连接组的介绍和配置请参见“Segment Routing配置指导”中的“EVPN VPWS over SRv6”。

source-ip any：任意的源IPv4地址。

destination-ip any：任意的目的IPv4地址。

source-ipv6 any：任意的源IPv6地址。

destination-ipv6 any：任意的目的IPv6地址。

nexthop ip-address：指定目标流的下一跳IPv4地址。该参数已经被其它配置方式替代，为了兼容历史软件版本，用户可以输入该参数，但实际不生效。

nexthop-ipv6 ip-address：该参数已经被其它配置方式替代，为了兼容历史软件版本，用户可以输入该参数，但实际不生效。

peer-locator prefix prefix-length：指定目标流所属的Locator段。prefix表示IPv6地址前缀。prefix-length表示IPv6地址前缀长度，取值范围为32～120。配置的IPv6地址前缀不能为IPv4兼容地址。

【使用指导】

目标流是iFIT测量的对象，是实施测量的关键要素，每次测量前都必须在入节点配置目标流。中间节点和出节点上无需配置目标流，设备通过报文中包含的iFIT报文头自动学习到目标流。

执行本命令，可以为iFIT测量实例配置目标流的特征。根据不同的业务场景，设备支持按照以下粒度来进行iFIT测量：

·     基于五元组的测量粒度：该粒度用于测量指定业务流的通信质量，用户可以通过五元组来匹配业务流。iFIT支持的所有组网均支持该测量粒度。

·     基于PeerLocator的测量粒度：该粒度用于测量端到端间的整体流量的通信质量。对于IPv6网络，使用peer-locator参数可以指定隧道。用户可以对隧道中的任意业务流量进行iFIT测量。仅SRv6、G-SRv6组网支持该测量粒度。

一个iFIT实例下只能配置一条目标流。同一个iFIT实例下多次执行本命令，最新配置生效。

不同iFIT实例不能配置相同的目标流。

源IP地址和目的IP地址只能是合法单播IP地址，不能为广播IP地址。

对于MPLS/SR-MPLS组网，配置flow命令后，还必须配置encapsulation命令指定哪个对端PE支持iFIT。设备仅对发往该对端PE的业务流进行iFIT处理，包括封装iFIT报文头，统计报文个数、打时间戳，向分析器上报测量信息。对于SRv6、G-SRv6组网，配置flow命令即可，即便配置encapsulation命令，也不生效。

【举例】

# IPv4业务流，MPLS/SR-MPLS私网组网情况下配置基于五元组粒度的测量：单向、源IP为1.1.1.1/24、目的IP为2.2.2.2/24、VPN为vpn1。

<Sysname> system-view

[Sysname] ifit enable

[Sysname-ifit] instance abc

[Sysname-ifit-instance-abc] flow unidirection source-ip 1.1.1.1 24 destination-ip 2.2.2.2 24 vpn-instance vpn1

# IPv4业务流，EVPN VPLS over SRv6/G-SRv6组网情况下，配置基于五元组粒度的测量：单向、源IP为1.1.1.1/24、目的IP为2.2.2.2/24、VSI为1。

<Sysname> system-view

[Sysname] ifit enable

[Sysname-ifit] instance abc

[Sysname-ifit-instance-abc] flow unidirection source-ip 1.1.1.1 destination-ip 2.2.2.2 vsi 1

# IPv4业务流，EVPN VPWS over SRv6/G-SRv6组网情况下，配置基于五元组粒度的测量：单向、源IP为1.1.1.1/24、目的IP为2.2.2.2/24、交叉连接组为1、交叉连接为2。

<Sysname> system-view

[Sysname] ifit enable

[Sysname-ifit] instance abc

[Sysname-ifit-instance-abc] flow unidirection source-ip 1.1.1.1 destination-ip 2.2.2.2 xconnect-group 1 connection 2

# EVPN VPLS over SRv6/G-SRv6组网情况下，配置基于PeerLocator粒度的测量：单向、VSI为1、Peer Locator为2001::1。

<Sysname> system-view

[Sysname] ifit enable

[Sysname-ifit] instance abc

[Sysname-ifit-instance-abc] flow unidirection vsi 1 peer-locator 2001::1 64

# EVPN VPWS over SRv6/G-SRv6组网情况下，配置基于PeerLocator粒度的测量：单向、交叉连接组为1、交叉连接为2、Peer Locator为2001::1。

<Sysname> system-view

[Sysname] ifit enable

[Sysname-ifit] instance abc

[Sysname-ifit-instance-abc] flow unidirection xconnect-group 1 connection 2 peer-locator 2001::1 64

# IPv4业务流，L3VPN/EVPN L3VPN over SRv6/G-SRv6组网情况下，配置基于PeerLocator粒度的测量：单向、Peer Locator为2001::1。

<Sysname> system-view

[Sysname] ifit enable

[Sysname-ifit] instance abc

[Sysname-ifit-instance-abc] flow unidirection source-ip any destination-ip any peer-locator 2001::1 64

# IPv6业务流，L3VPN/EVPN L3VPN over SRv6/G-SRv6组网情况下，配置基于PeerLocator粒度的测量：单向、Peer Locator为2001::1。

<Sysname> system-view

[Sysname] ifit enable

[Sysname-ifit] instance abc

[Sysname-ifit-instance-abc] flow unidirection source-ipv6 any destination-ipv6 any peer-locator 2001::1 64

【相关命令】

·     encapsulation

1.1.13  ifit enable

ifit enable命令用来全局开启iFIT功能，并进入iFIT视图。如果iFIT功能已经开启，执行该命令直接进入iFIT视图。

undo ifit enable命令用来全局关闭iFIT功能。

【命令】

ifit enable

undo ifit enable

【缺省情况】

iFIT功能处于关闭状态。

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

iFIT是一种测量协议，当用户需要实时测量网络的丢包及时延情况时，可以使能iFIT随流测量功能。

要使用iFIT测量功能，用户需要：

·     在iFIT测量网络的入节点上开启iFIT功能、配置iFIT设备ID、创建实例、并在实例下配置目标流等参数。实例下手工配置的目标流称为静态目标流。入节点会根据本设备上配置的iFIT设备ID为该实例绑定的静态目标流自动生成FlowID，FlowID和本设备上配置的iFIT设备ID会封装到iFIT报文头中传递给中间节点和出节点，用于在iFIT测量网络中唯一的标识这条目标流。

·     在iFIT测量网络的中间节点和出节点上开启iFIT功能即可，不需要配置实例和目标流。中间节点和出节点根据报文中是否携带iFIT报文头来决定是否对报文进行iFIT处理。如果收到的报文携带了iFIT报文头，再进一步根据iFIT报文头中的FlowID、测量周期编号、时间戳等信息对报文进行iFIT测量。

【举例】

# 开启iFIT功能并进入iFIT视图。

<Sysname> system-view

[Sysname] ifit enable

[Sysname-ifit]

1.1.14  instance

instance命令用来创建iFIT实例并进入iFIT实例视图。如果指定的iFIT实例已存在，则直接进入该iFIT实例的视图。

undo instance命令用来删除iFIT实例。

【命令】

instance instance-name

undo instance instance-name

【缺省情况】

不存在iFIT实例。

【视图】

iFIT视图

【缺省用户角色】

network-admin

【参数】

instance-name：表示iFIT实例的名称，为1～31个字符的字符串，区分大小写。

【使用指导】

用户需要在测量网络的入节点上创建实例。实例视图下可以配置目标流匹配规则，一个iFIT实例可以配置一个目标流匹配规则，一个实例可以和多个接口绑定，每个绑定接口会按照同一规则匹配目标流，并给目标流分配不同的FlowID，iFIT会按接口独立测量目标流的时延和丢包性能。

中间节点和出节点上无需创建实例，中间节点和出节点只需要开启iFIT功能，即可进行iFIT测量。中间节点和出节点开启iFIT功能后，根据iFIT报文头自动识别iFIT目标流，并在本机对该目标流进行测量，这种自动识别的目标流称为动态目标流。

【举例】

# 创建iFIT测量实例abc并进入iFIT实例视图。

<Sysname> system-view

[Sysname] ifit enable

[Sysname-ifit] instance abc

[Sysname-ifit-abc]

1.1.15  measure enable

measure enable命令用来开启iFIT实例的测量功能。

undo measure enable命令用来关闭iFIT实例的测量功能。

【命令】

measure enable

undo measure enable

【缺省情况】

iFIT实例的测量功能处于关闭状态。

【视图】

iFIT实例视图

【缺省用户角色】

network-admin

【使用指导】

本命令用于开启iFIT实例的测量功能，iFIT可以测量目标流的时延和丢包情况。

配置本命令前，必须配置iFIT设备的ID、创建实例、配置目标流，否则，配置失败。

配置本命令后，不允许修改device-id命令以及iFIT实例视图下的配置。如需修改，请先关闭iFIT实例的测量功能。

【举例】

# 开启iFIT实例的测量功能。

[Sysname] ifit enable

[Sysname-ifit] instance abc

[Sysname-ifit-instance-abc] measure enable

1.1.16  measure mode

measure mode命令用来配置iFIT的测量类型。

undo measure mode命令用来恢复缺省情况。

【命令】

measure mode { e2e | trace }

undo measure mode

【缺省情况】

iFIT的测量类型为端到端测量功能。

【视图】

iFIT实例视图

【缺省用户角色】

network-admin

【参数】

e2e：指定为端到端测量类型。该模式下，只有入节点和出节点上报测量数据，用于计算测量结果。

trace：指定为逐跳测量类型。该模式下，目标流途经的设备上，只要开启了iFIT功能，并且检测到了iFIT报文，就会上报测量数据。

【使用指导】

通过iFIT获得的性能指标可以作为评价网络性能的直接依据，对于网络的故障诊断和用户业务测量具有重要的意义。

当用户希望测量整个网络的丢包和时延性能时，可以选择端到端测量模式；当用户希望准确定位每个网络节点的丢包和时延性能时，可以选择逐跳测量模式。

【举例】

# 设置iFIT的测量类型为逐跳测量。

<Sysname> system-view

[Sysname] ifit enable

[Sysname-ifit] instance abc

[Sysname-ifit-instance-abc] measure mode trace

1.1.17  period

period命令用来配置iFIT实例的测量周期。

undo period命令用来恢复缺省情况。

【命令】

period period

undo period

【缺省情况】

iFIT实例的测量周期为30秒。

【视图】

iFIT实例视图

【缺省用户角色】

network-admin

【参数】

period：表示iFIT实例的测量周期，取值为1、10、30、60、300，单位为秒。

【使用指导】

iFIT按周期统计性能参数：

·     发送端记录每个发送周期内首个iFIT报文的发送时间，并统计每个发送周期内接口发送的iFIT报文个数。发送周期=测量周期。

·     接收端记录每个接收周期内首个iFIT报文的接收时间，并统计每个接收周期内接口接收的iFIT报文个数。由于网络存在延时，为了最大程度地避免网络延时与乱序对统计结果的不良影响，接收周期=（1+1/3）个测量周期。

如果入节点到出节点的网络传输时延较大，大于1/3个测量周期，例如将测量周期配置为1秒，而网络传输时延大于1/3秒（333毫秒），则可能会影响iFIT丢包统计结果的准确性，因为iFIT会将超过接收周期到达的报文认定为丢包。此时，可以将测量周期修改为一个更大的值。

【举例】

# 将iFIT实例abc的测量周期配置为60秒。

<Sysname> system-view

[Sysname] ifit enable

[Sysname-ifit] instance abc

[Sysname-ifit-instance-abc] period 60

1.1.18  reset ifit statistic

reset ifit statistic命令用来清除iFIT动态目标流最近10个周期生成的iFIT测量信息。

【命令】

reset ifit statistic [ device-id device-id flow-id flow-id | instance instance-name ]

【视图】

任意视图

【缺省用户角色】

network-admin

【参数】

device-id device-id：表示iFIT设备ID，device-id取值范围为1～1048575。

flow-id flow-id：清除指定流的iFIT测量数据。flow-id表示目标流的标识，取值范围是1～1048575。

instance instance-name：清除指定实例的iFIT测量数据。instance-name表示iFIT实例的名称，为1～31个字符的字符串，区分大小写。只有入节点上支持实例，中间节点和出节点上不支持实例。

【使用指导】

FlowID由入节点生成，并通过iFIT报文头传递给中间节点和出节点，用于在iFIT测量网络中与DeviceID唯一的标识这条目标流，可通过display ifit flow static命令查看。

【举例】

# 清除DeviceID为1，FlowID为40962的目标流的测量信息。

<Sysname> reset ifit statistic device-id 1 flow-id 40962

【相关命令】

·     display ifit flow static

·     display ifit statistic