• 产品与解决方案
  • 行业解决方案
  • 服务
  • 支持
  • 合作伙伴
  • 新华三人才研学中心
  • 关于我们

12-Telemetry命令参考

目录

03-Telemetry Stream命令

本章节下载 03-Telemetry Stream命令  (215.00 KB)

docurl=/cn/Service/Document_Software/Document_Center/Home/Switches/00-Public/Command/Command_Manual/H3C_S6805_S9850_Release_66xx-5672/12/202402/2056095_30005_0.htm

03-Telemetry Stream命令


1 Telemetry Stream

说明

·     设备上只支持配置一个带采样的功能。带采样的镜像、Netstream(包括NetStream和IPv6 NetStream)、sFlow、INT、Telemetry Stream、MOD功能两两互斥。有关镜像、NetStream、IPv6 NetStream和sFlow的详细配置,请参见“网络管理和监控配置指导”中的“镜像”、“NetStream”、“IPv6 NetStream”和“sFlow”。有关INT和MOD的详细配置,请参见“Telemetry配置指导”中的“INT”和“MOD”。

·     无论是否配置采样,INT和Telemetry Stream都互斥。

 

1.1  Telemetry Stream命令

1.1.1  display telemetry stream

display telemetry stream命令用来显示Telemetry Stream的配置信息。

【命令】

display telemetry stream

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【举例】

# 显示Telemetry Stream的配置信息。

<Sysname> display telemetry stream

Telemetry stream status          : Enabled

Telemetry stream timestamp status: Disabled

Telemetry stream device ID       : 10.0.0.3

Telemetry stream action:

  Twenty-FiveGigE1/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 Index    : 2

  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 Index:出接口索引(仅时间戳功能关闭时显示)

·     (仅Release 6635及以上版本支持本字段)Truncation:报文截断功能,Enable表示功能处于开启状态。只有开启报文截断功能时才会显示本字段

 

1.1.2  telemetry stream action

telemetry stream action命令用来配置Telemetry Stream动作。

undo telemetry stream action命令用来恢复缺省情况。

【命令】

telemetry stream action action-id [ acl [ mac | user-defined ] { acl-number | name acl-name } | sampler sampler-name ] *

undo telemetry stream action action-id

【缺省情况】

未配置Telemetry Stream动作。

【视图】

二层以太网接口视图

三层以太网接口视图

【缺省用户角色】

network-admin

【参数】

action-id:表示动作ID,取值范围为1~32。

acl:表示引用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个字符的字符串,不区分大小写。未指定本参数时,表示不对报文进行采样。

【使用指导】

配置本命令后,设备会将接口收到的报文复制一份,并使用telemetry stream collector命令中指定的报文封装信息对报文进行封装,上送采集器。

如果仅需对某些流量开启Telemetry Stream功能,则可以引用ACL,此时只有命中ACL规则的报文才会被复制。

引用采样器可以减少复制和上送报文的数量,减轻设备和采集器的数据处理压力,但会降低监控信息的颗粒度,请合理配置采样率。

如果不指定macuser-defined,则表示IPv4 ACL。

引用二层ACL和用户自定义ACL时,必须首先指定macuser-defined,再指定其编号或名称。

如果本命令中引用的ACL不存在或其中没有配置任何规则,则表示没有流量会命中该ACL,即没有报文会被复制。

同一接口下配置多个Telemetry Stream动作时,仅支持引用同一个采样器。

【举例】

# 配置Telemetry Stream动作,并引用名为samp的采样器。

<Sysname> system-view

[Sysname] interface twenty-fivegige 1/0/1

[Sysname-Twenty-FiveGigE1/0/1] telemetry stream action 1 sampler samp

1.1.3  telemetry stream collector

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

【参数】

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:表示开启报文截断功能。不指定本参数时,表示不开启报文截断功能。

说明

仅Release 6635及以上版本支持truncation参数。

 

【使用指导】

设备将使用本命令中指定的封装信息封装报文,路由至远端采集器。

本命令中的目的IP地址需指定为采集器的IP地址,目的端口号需指定为采集器上相应软件的监听端口号。

开启Telemetry Stream的时间戳功能与本命令中的vpn-instance关键字互斥。

开启报文截断功能后,设备会对封装报文进行截断报,再上送给采集器,上送的报文中仍然包含完整的入、出接口信息和时间戳信息,不影响采集结果。

【举例】

# 配置上送采集器的报文的源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 timestamp enable

1.1.4  telemetry stream device-id

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

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

【命令】

telemetry stream device-id address

undo telemetry stream device-id

【缺省情况】

未配置设备ID。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

address:表示设备ID。可配置为任意非0.0.0.0的IPv4地址。本字段最终会填充在向采集器上报的信息中,便于采集器识别信息源。

【使用指导】

只有开启Telemetry Stream的时间戳功能时,本命令才会生效。

【举例】

# 配置设备ID为10.10.10.10。

<Sysname> system-view

[Sysname] telemetry stream device-id 10.10.10.10

1.1.5  telemetry stream enable

telemetry stream enable命令用来开启Telemetry Stream功能。

undo telemetry stream enable命令用来关闭Telemetry Stream功能。

【命令】

telemetry stream enable

undo telemetry stream enable

【缺省情况】

Telemetry Stream功能处于开启状态。

【视图】

系统视图

【缺省用户角色】

network-admin

【举例】

# 开启Telemetry Stream功能。

<Sysname> system-view

[Sysname] telemetry stream enable

1.1.6  telemetry stream timestamp 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

【使用指导】

配置本命令后,设备会向上送报文中添加原始报文进入、离开设备的时间戳,上送报文携带时间戳信息至采集器,便于采集器监控和分析流量时延。

本命令与配置上送采集器的报文的封装信息命令中的vpn-instance关键字互斥。

开启Telemetry Stream的时间戳功能时,还需要创建业务环回组,并为其添加一个二层以太网接口,此时时间戳功能才生效。有关业务环回组的详细介绍,请参见“二层技术-以太网交换配置指导”中的“业务环回组”。

【举例】

# 开启Telemetry Stream的时间戳功能。

<Sysname> system-view

[Sysname] telemetry stream timestamp enable

【相关命令】

·     service-loopback group(二层技术-以太网交换命令参考/业务环回组)

·     telemetry stream collector

 

不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!

新华三官网
联系我们