- 产品与解决方案
- 行业解决方案
- 服务
- 支持
- 合作伙伴
- 新华三人才研学中心
- 关于我们
02-Telemetry Stream命令
本章节下载： 02-Telemetry Stream命令 (209.32 KB)
目 录
1.1.1 display telemetry stream
1.1.3 telemetry stream collector
1.1.4 telemetry stream device-id
1.1.6 telemetry stream timestamp enable
设备仅在独立运行模式下支持MDC。关于MDC的详细介绍请参见“虚拟化技术配置指导”中的“MDC”。
display telemetry stream命令用来显示Telemetry Stream的配置信息。
【命令】
display telemetry stream
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
mdc-admin
mdc-operator
【举例】
# 显示Telemetry Stream的配置信息。
<Sysname> display telemetry stream
Telemetry stream status : Enabled
Telemetry stream timestamp status: Disabled
Telemetry stream device ID : 1.1.1.1
Telemetry stream action:
Ten-GigabitEthernet3/0/1:
Telemetry stream action 1:
ACL : user-defined abc
Sampler: samp
Telemetry stream action 2:
ACL : user-defined abcd
Sampler: samp
Telemetry stream collector:
Source IP : 20.0.0.2
Destination IP : 30.0.0.1
Source port : 12
Destination port: 14
VPN instance : abc
Destination MAC : 0CDA-411D-9F4C
VLAN ID : 20
Output Interface: Ten-GigabitEthernet3/0/1
Truncation : Enable
表1-1 display telemetry stream命令显示信息描述表
|
字段 |
描述 |
|
Telemetry stream status |
Telemetry stream的状态 · Enabled：开启 · Disabled：关闭 |
|
Telemetry stream timestamp status |
Telemetry stream时间戳功能的状态 · Enabled：开启 · Disabled：关闭 |
|
Telemetry stream device ID |
设备ID |
|
Telemetry stream action |
Telemetry Stream动作。Inactive表示未下发，Failed表示下发失败 · ACL：表示引用ACL · Sampler：表示引用采样器 |
|
Telemetry stream collector |
上送采集器的报文的封装信息 · Source IP：源IP地址 · Destination IP：目的IP地址 · Source port：源端口号 · Destination port：目的端口号 · VPN instance：VPN实例 · Destination MAC：目的MAC地址 · VLAN ID：VLAN编号 · Output Interface：出接口名称 · Truncation：报文截断功能，Enable表示功能处于开启状态。只有开启报文截断功能时才会显示本字段 |
telemetry stream action命令用来配置Telemetry Stream动作。
undo telemetry stream action命令用来恢复缺省情况。
【命令】
telemetry stream action action-id [ acl [ ipv6 | mac | user-defined ] { acl-number | name acl-name } | sampler sampler-name ] *
undo telemetry stream action action-id
【缺省情况】
未配置Telemetry Stream动作。
【视图】
二层以太网接口视图
三层以太网接口视图
三层以太网子接口视图
【缺省用户角色】
network-admin
mdc-admin
【参数】
action-id：表示动作ID，取值范围为1～32。
acl：表示引用ACL。
· ipv6：表示IPv6 ACL。
· mac：表示二层ACL。
· user-defined：表示用户自定义ACL。
· acl-number：指定ACL的编号。取值范围及其代表的ACL类型如下：
¡ 2000～2999：表示基本ACL。
¡ 3000～3999：表示高级ACL。
¡ 4000～4999：表示二层ACL。
¡ 5000～5999：表示用户自定义ACL。
· name acl-name：表示ACL名称，为1～63个字符的字符串，不区分大小写。
sampler sampler-name：表示引用采样器名称，sampler-name为采样器的名称，为1～31个字符的字符串，不区分大小写。未指定本参数时，表示按2：1随机采样，即1000个报文随机采样500个。
【使用指导】
配置本命令后，设备会将接口收到的报文复制一份，并使用telemetry stream collector命令中指定的报文封装信息对报文进行封装，上送采集器。
如果仅需对某些流量开启Telemetry Stream功能，则可以引用ACL，此时只有命中ACL规则的报文才会被复制。
引用采样器可以减少复制和上送报文的数量，减轻设备和采集器的数据处理压力，但会降低监控信息的颗粒度，请合理配置采样率。
如果不指定ipv6、mac和user-defined，则表示IPv4 ACL。
引用二层ACL和用户自定义ACL时，必须首先指定mac和user-defined，再指定其编号或名称。
引用ACL时，需要注意的是：
· 若引用的ACL不存在，或者引用的ACL中没有配置规则，则表示没有流量会命中该ACL，即没有报文会被复制。
· 在引用的ACL中，ACL规则是否支持vpn-instance参数，以及vpn-instance参数的生效情况与设备的型号有关，请以设备的实际情况为准。
多次执行本命令，可以为接口配置多个动作，每个接口最多支持同时配置24个动作。
【举例】
# 配置Telemetry Stream动作，并引用名为samp的采样器。
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/0/1
[Sysname-Ten-GigabitEthernet3/0/1] telemetry stream action 1 sampler samp
telemetry stream collector命令用来配置上送采集器的报文的封装信息。
undo telemetry stream collector命令用来恢复缺省情况。
【命令】
telemetry stream collector source source-address destination destination-address source-port source-port destination-port destination-port [ vpn-instance vpn-instance-name ] [ truncation ]
undo telemetry stream collector
【缺省情况】
未配置上送采集器的报文的封装信息。
【视图】
系统视图
【缺省用户角色】
network-admin
mdc-admin
【参数】
source source-address：表示上送采集器的报文封装的源IP地址。
destination destination-address：表示上送采集器的报文封装的目的IP地址。
source-port source-port：表示上送采集器的报文封装的源端口号。
destination-port destination-port：表示上送采集器的报文封装的目的端口号。
vpn-instance vpn-instance-name：表示上送采集器的报文由该VPN实例对应出接口的路由信息指导转发。vpn-instance-name表示VPN实例名称，为1～31个字符的字符串，区分大小写。如果未指定本参数，则表示上送采集器的报文由公网的路由信息指导转发。
truncation：表示开启报文截断功能。不指定本参数时，表示不开启报文截断功能。
【使用指导】
设备将使用本命令中指定的封装信息封装报文，路由至远端采集器。
本命令中的目的IP地址需指定为采集器的IP地址，此IP地址对应的路由出接口不能是管理用以太网接口、VXLAN隧道接口、GRE隧道接口或其他IPv4隧道接口，且出接口不能配置成VXLAN的AC。
开启报文截断功能可以减小对设备至采集器之间的带宽占用，同时也能减轻采集器解析报文的压力。开启报文截断功能后，设备会对封装报文进行截断报，再上送给采集器，上送的报文中仍然包含完整的入、出接口信息和时间戳信息，不影响采集结果。
对于SF系列接口板，通过本命令配置的destination-port destination-port和source-port source-port参数实际不生效，上送采集器的报文不包含源端口号和目的端口号。
【举例】
# 配置上送采集器的报文的源IP地址为10.10.10.10、目的IP地址为20.20.20.20、源端口号为10、目的端口号为20。
<Sysname> system-view
[Sysname] telemetry stream collector source 10.10.10.10 destination 20.20.20.20 source-port 10 destination-port 20
telemetry stream device-id命令用来配置设备ID。
undo telemetry stream device-id命令用来恢复缺省情况。
【命令】
telemetry stream device-id address
undo telemetry stream device-id
【缺省情况】
未配置设备ID。
【视图】
系统视图
【缺省用户角色】
network-admin
mdc-admin
【参数】
address：表示设备ID。可配置为任意非0.0.0.0的IPv4地址。本字段最终会填充在向采集器上报的信息中，便于采集器识别信息源。
【使用指导】
只有开启Telemetry Stream的时间戳功能时，本命令才会生效。
【举例】
# 配置设备ID为1.1.1.1。
<Sysname> system-view
[Sysname] telemetry stream device-id 1.1.1.1
telemetry stream enable命令用来开启Telemetry Stream功能。
undo telemetry stream enable命令用来关闭Telemetry Stream功能。
【命令】
telemetry stream enable
undo telemetry stream enable
【缺省情况】
Telemetry Stream功能处于开启状态。
【视图】
系统视图
【缺省用户角色】
network-admin
mdc-admin
【举例】
# 开启Telemetry Stream功能。
<Sysname> system-view
[Sysname] telemetry stream enable
telemetry stream timestamp enable命令用来开启Telemetry Stream的时间戳功能。
undo telemetry stream timestamp enable命令用来关闭Telemetry Stream的时间戳功能。
【命令】
telemetry stream timestamp enable
undo telemetry stream timestamp enable
【缺省情况】
Telemetry Stream的时间戳功能处于关闭状态。
【视图】
系统视图
【缺省用户角色】
network-admin
mdc-admin
【使用指导】
配置本命令后，设备会向上送报文中添加原始报文进入、离开设备的时间戳，上送报文携带时间戳信息至采集器，便于采集器监控和分析流量时延。
本命令与配置上送采集器的报文的封装信息命令中的vpn-instance关键字互斥。
开启Telemetry Stream的时间戳功能时，还需要创建业务环回组，并为其添加一个二层以太网接口，此时时间戳功能才生效。有关业务环回组的详细介绍，请参见“二层技术-以太网交换配置指导”中的“业务环回组”。
本命令仅在已配置了PTP功能的设备上支持。
设备仅在独立运行模式下支持MDC。仅缺省MDC支持配置PTP功能，非缺省MDC不支持配置PTP功能。关于MDC的详细介绍请参见“虚拟化技术配置指导”中的“MDC”。关于PTP的详细介绍请参见“网络管理和监控配置指导”中的“PTP”。
【举例】
# 开启Telemetry Stream的时间戳功能。
<Sysname> system-view
[Sysname] telemetry stream timestamp enable
【相关命令】
· service-loopback group（二层技术-以太网交换命令参考/业务环回组）
· telemetry stream collector
不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!
支持
售前咨询
售后咨询
人工在线咨询
