- 产品与解决方案
- 行业解决方案
- 服务
- 支持
- 合作伙伴
- 关于我们
02-Telemetry Stream命令
本章节下载： 02-Telemetry Stream命令 (215.51 KB)
目 录
1.1.1 display telemetry stream
1.1.3 telemetry stream collector
1.1.4 telemetry stream device-id
设备仅在独立运行模式下支持MDC。关于MDC的详细介绍请参见“虚拟化技术配置指导”中的“MDC”。
display telemetry stream命令用来显示Telemetry Stream的配置信息和下发状态。
【命令】
（独立运行模式）
display telemetry stream [ slot slot-number ]
（IRF模式）
display telemetry stream [ chassis chassis-number slot slot-number ]
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
mdc-admin
mdc-operator
【参数】
slot slot-number：指定单板。slot-number为单板所在的槽位号。如果不指定本参数，则表示指定主用主控板。（独立运行模式）
chassis chassis-number slot slot-number：指定单板。chassis-number表示设备在IRF中的成员编号，slot-number表示单板所在的槽位号。如果不指定本参数，则表示指定Master设备主用主控板。（IRF模式）
【举例】
# 显示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: (Configuration succeeded)
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 |
本系列设备默认开启时间戳功能且无法关闭，Enabled 和Disabled都表示时间戳处于开启状态 |
|
Telemetry stream device ID |
设备ID |
|
Telemetry stream action |
Telemetry Stream动作。Inactive表示未下发，Failed表示下发失败 · ACL：表示引用ACL · Sampler：表示引用采样器 |
|
Telemetry stream collector: (Configuration succeeded) |
telemetry stream collector命令配置的上送采集器的报文封装信息下发驱动是否成功，以及封装的具体信息： · Configuration succeeded：配置下发成功 · Configuration failed：配置下发失败，原因可能为芯片资源不足 · 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中，若某规则指定了vpn-instance参数，则表示该规则仅对VPN报文有效；若规则未指定vpn-instance参数，则表示该规则对公网报文和VPN报文均有效。
多次执行本命令，可以为接口配置多个动作，每个接口最多支持同时配置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地址。本字段最终会填充在向采集器上报的信息中，便于采集器识别信息源。
【举例】
# 配置设备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
不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!
支持
