配置Telemetry静态订阅
Telemetry静态订阅是指设备作为客户端，采集器作为服务端，由设备主动发起到采集器的连接，进行数据采集上送。
- 配置目标采集器
当用户配置Telemetry静态订阅采样数据或自定义事件时，需要创建上送目标组，并指定好采样数据要上送的目标采集器。 - 配置采样数据或自定义事件
当用户配置Telemetry静态订阅采样数据或自定义事件时，需要创建采样传感器组，并指定好采样路径和过滤条件。 - 创建订阅
当用户配置Telemetry静态订阅采样数据或自定义事件时，需要创建订阅，将配置好的上送目标组和采样传感器组进行关联，完成数据上送。 - 检查Telemetry配置结果
当用户完成Telemetry静态订阅采样数据或自定义事件的配置后，可以查看采样传感器组、上送目标组及订阅信息等。
配置目标采集器
当用户配置Telemetry静态订阅采样数据或自定义事件时，需要创建上送目标组，并指定好采样数据要上送的目标采集器。
操作步骤
- 执行命令system-view，进入系统视图。
- 执行命令telemetry，进入Telemetry视图。
- 执行命令destination-group destination-name，创建采样数据的上送目标组并进入Destination-group视图。
- 执行命令ipv4-address ip-address port port [ vpn-instance vpn-instance ] [ protocol { grpc [ no-tls ] | udp } ]，配置上送目标采集器的IP地址、端口号、上送目标采集器的协议和加密方式。
说明：
此命令允许对每个上送目标组配置的次数上限为5。
此命令和Subscription视图下的protocol（Subscription视图）命令都可以配置上送目标采集器的协议和加密方式，如果配置的上送目标采集器关联到订阅，生效规则如下：在Subscription视图下配置了protocol（Subscription视图）命令，则以Subscription视图下配置的协议和加密方式为准。
在Subscription视图下没有配置protocol（Subscription视图）命令，则以Destination-group视图下配置的协议和加密方式为准。
- 执行命令commit，提交配置。
配置采样数据或自定义事件
当用户配置Telemetry静态订阅采样数据或自定义事件时，需要创建采样传感器组，并指定好采样路径和过滤条件。
背景信息
当设备作为客户端，采集器作为服务端，进行静态订阅采样数据或自定义事件时，用户需要配置采样数据源。
在Telemetry监控资源对象的性能指标超过自定义阈值时，用户可配置Telemetry的自定义事件，及时上报给采集器，用于业务策略判断。
操作步骤
- 配置采样数据
- 执行命令sensor-path path { [ condition express op-field field op-type op op-value value [ { and | or } op-type op op-value value ] ] | [ policy reset-when-start ] } *，配置Telemetry传感器采样路径。
说明：
在同一个采样传感器组下配置的采样路径数量上限为5条，包括此命令配置的采样路径和sensor-path self-defined-event命令配置的Telemetry自定义事件中的采样路径加在一起，当采样路径达到配置上限时，设备会显示路径数目最大量提示信息。
相同的采样路径名称只能同时在10个采样传感器组下配置，当采样路径达到配置上限时，设备会显示路径数目最大量提示信息。
当采样传感器组被订阅且配置了冗余抑制，则无法在此采样传感器组下配置带有过滤条件的采样路径。
当前仅采样路径huawei-qos:qos/qosPortQueueStatInfos/qosPortQueueStatInfo支持初始配置时清零。
- 执行命令sensor-path path { [ condition express op-field field op-type op op-value value [ { and | or } op-type op op-value value ] ] | [ policy reset-when-start ] } *，配置Telemetry传感器采样路径。
- 配置自定义事件
- 执行命令sensor-path path self-defined-event condition express op-field field op-type op op-value value [ { and | or } op-type op op-value value ] { [ suppress-period period ] | [ level level ] }* [ description description ]，配置Telemetry的自定义事件。
说明：
在同一个采样传感器组下配置的采样路径数量上限为5条，包括此命令配置的Telemetry自定义事件中的采样路径和sensor-path命令配置的采样路径加在一起，当采样路径达到配置上限时，设备会显示路径数目最大量提示信息。
相同的采样路径名称只能同时在10个采样传感器组下配置，当采样路径达到配置上限时，设备会显示路径数目最大量提示信息。
当采样传感器组被订阅且配置了冗余抑制，则无法在此采样传感器组下配置Telemetry的自定义事件。
- 执行命令sensor-path path self-defined-event condition express op-field field op-type op op-value value [ { and | or } op-type op op-value value ] { [ suppress-period period ] | [ level level ] }* [ description description ]，配置Telemetry的自定义事件。
创建订阅
当用户配置Telemetry静态订阅采样数据或自定义事件时，需要创建订阅，将配置好的上送目标组和采样传感器组进行关联，完成数据上送。
背景信息
当设备作为客户端，采集器作为服务端，进行静态订阅采样数据或自定义事件时，用户需要创建订阅来建立数据上送通道，数据上送协议支持GRPC或UDP。
如果要配置客户端的SSL策略，使得客户端和服务端建立安全的SSL连接，需要先确保SSL策略已经创建完成，如何创建可参考《配置指南 基础配置》的“配置绑定SSL Policy”章节。
操作步骤
- 基于GRPC协议创建的静态订阅
- 执行命令sensor-group sensor-name [ sample-interval sample-interval [ suppress-redundant [ heartbeat-interval heartbeat-interval ] ] ]，关联采样传感器组，并可配置该采样传感器组的采样周期、冗余抑制和心跳间隔。
说明：
如果关联的采样传感器组下配置的采样路径带有阈值过滤条件，则无法配置冗余抑制，即阈值过滤和冗余抑制是互斥的。
- 执行命令destination-group destination-name，配置关联上送目标组。
说明：
此命令支持的在同一订阅下可以关联的上送目标组数量上限为5个，每个目标组可以配置5个IP地址和端口号。
- （可选）执行命令dscp dscp-value，配置上送数据报文的DSCP值。
说明：
在网络数据传输比较稳定的时候，Telemetry不需要对上送的数据报文进行DSCP值更改，当数据传输出现时延丢包时，可以在Telemetry视图下配置上送报文的DSCP值，提高报文传输的优先级，保证网络数据传输的质量。
- （可选）执行命令protocol { grpc [ no-tls ] | udp }，配置关联到本订阅的上送目标采集器的协议和加密方式。
说明：
此命令和Destination-group视图下的ipv4-address命令都可以配置上送目标采集器的协议和加密方式，如果配置的上送目标采集器关联到订阅，生效规则如下：配置了此命令，则以Subscription视图下此命令配置的协议和加密方式为准。
没有配置此命令，则以Destination-group视图下的ipv4-address命令配置的协议和加密方式为准。
- （可选）配置客户端的SSL策略或客户端对服务端进行SSL校验功能。
执行命令quit，退回到Telemetry视图。
执行命令quit，退回到系统视图。
执行命令grpc，进入GRPC视图。
执行命令grpc client，进入GRPC客户端视图。
执行命令ssl-policy ssl-policy-name [ verify-cn cn-name ]，配置Telemetry静态订阅时客户端的SSL策略。
说明：
如果使用ipv4-address命令或protocol（Subscription视图）命令配置了参数no-tls，表示不采用TLS加密方式，则此命令配置的客户端SSL策略功能不生效。
执行命令ssl-verify peer，配置Telemetry静态订阅时客户端对服务端进行SSL校验。
说明：
如果使用ipv4-address命令或protocol（Subscription视图）命令配置了参数no-tls，表示不采用TLS加密方式，则此命令配置的客户端对服务端进行SSL校验功能不生效。
- 执行命令sensor-group sensor-name [ sample-interval sample-interval [ suppress-redundant [ heartbeat-interval heartbeat-interval ] ] ]，关联采样传感器组，并可配置该采样传感器组的采样周期、冗余抑制和心跳间隔。
- 基于UDP协议创建的静态订阅
- 执行命令sensor-group sensor-name [ sample-interval sample-interval [ suppress-redundant [ heartbeat-interval heartbeat-interval ] ] ]，关联采样传感器组，并可配置该采样传感器组的采样周期、冗余抑制和心跳间隔。
说明：
如果关联的采样传感器组下配置的采样路径带有阈值过滤条件，则无法配置冗余抑制，即阈值过滤和冗余抑制是互斥的。
- 执行命令destination-group destination-name，配置关联上送目标组。
说明：
此命令支持的在同一订阅下可以关联的上送目标组数量上限为5个，每个目标组可以配置5个IP地址和端口号。
- （可选）执行命令local-source-address
ipv4 ip-address [ port port ]，配置UDP协议上送方式的源IP地址和端口号。
说明：
配置的源IP地址必须是一个存在的业务接口IP地址，否则可能导致业务不通。
- （可选）执行命令dscp dscp-value，配置上送数据报文的DSCP值。
说明：
在网络数据传输比较稳定的时候，Telemetry不需要对上送的数据报文进行DSCP值更改，当数据传输出现时延丢包时，可以在Telemetry视图下配置上送报文的DSCP值，提高报文传输的优先级，保证网络数据传输的质量。
- （可选）执行命令protocol { grpc [ no-tls ] | udp }，配置关联到本订阅的上送目标采集器的协议和加密方式。
说明：
此命令和Destination-group视图下的ipv4-address命令都可以配置上送目标采集器的协议和加密方式，如果配置的上送目标采集器关联到订阅，生效规则如下：配置了此命令，则以Subscription视图下此命令配置的协议和加密方式为准。
没有配置此命令，则以Destination-group视图下的ipv4-address命令配置的协议和加密方式为准。
- 执行命令sensor-group sensor-name [ sample-interval sample-interval [ suppress-redundant [ heartbeat-interval heartbeat-interval ] ] ]，关联采样传感器组，并可配置该采样传感器组的采样周期、冗余抑制和心跳间隔。
检查Telemetry配置结果
当用户完成Telemetry静态订阅采样数据或自定义事件的配置后，可以查看采样传感器组、上送目标组及订阅信息等。
操作步骤
- 使用display telemetry sensor [ sensor-name ]命令查看采样传感器信息。
- 使用display telemetry destination [ destination-name ]命令查看上送目标组信息。
- 使用display telemetry subscription [ subscription-name ]命令查看订阅信息。
- 使用display telemetry sensor-path命令查看Telemetry传感器采样路径。
任务示例
<HUAWEI> display telemetry sensor group1
----------------------------------------------------------------------------------------
Sensor-name:group1
1. Sensor-path : huawei-devm:devm/cpuInfos/cpuInfo
Sensor-type : sample
Path-state : NA
Op-field : -
Op-type1 : -
Op-value1 : -
Relation : -
Op-type2 : -
Op-value2 : -
Policy : -
2. Sensor-path : huawei-devm:devm/cpuInfos/cpuInfo
Sensor-type : self-defined-event
Path-state : NA
Op-field : systemCpuUsage
Op-type1 : le
Op-value1 : 10
Relation : and
Op-type2 : gt
Op-value2 : 90
Self defined event :
Level : 7
Suppress-period : 20
Description : event1
3. Sensor-path : huawei-mpls:TNLREROUTED
Sensor-type : event
Path-state : NA
4. Sensor-path : huawei-sem:hwCPUUtilizationResume
Sensor-type : alarm
Path-state : NA
----------------------------------------------------------------------------------------
<HUAWEI> display telemetry destination 1
----------------------------------------------------------------------------------------
Dest-name Dest-addr Dest-port State Vpn-name Protocol Istls FailedReason
----------------------------------------------------------------------------------------
1 10.135.84.185 50000 RESOLVED - GRPC NO-TLS NA
----------------------------------------------------------------------------------------
<HUAWEI> display telemetry subscription 1
---------------------------------------------------------------------------
Sub-name : 1
Dscp : 0
Protocol : GRPC
Encoding : GPB
Send bytes : 0
Send packets : 0
Total send delay : 0
Total send error : 0
Total send drop : 302
Total other error : 0
Last send-time : 2017-08-31 15:42:35
Sensor group:
----------------------------------------------------------------------
Sensor-name Sample-interval(ms) Heart-interval(s) Suppression State
----------------------------------------------------------------------
senso1 60000 - NO RESOLVED
----------------------------------------------------------------------
Destination group:
----------------------------------------------------------------------
Dest-name Dest-IP Dest-port State Vpn-name Protocol
----------------------------------------------------------------------
dest1 10.135.84.185 50000 RESOLVED - GRPC
----------------------------------------------------------------------
Sub-state : PASSIVE
---------------------------------------------------------------------------
Total subscription number is : 1
<HUAWEI> display telemetry sensor-path
Sample(S) : Serial sample.
Sample(P) : Parallel sample.
Parallel sampled data may not be sent through UDP in out-of-band mode.
------------------------------------------------------------------------------------------------------------------
Type MinPeriod(ms) MaxEachPeriod Path
------------------------------------------------------------------------------------------------------------------
Event -- -- huawei-bfd:hwBfdSessDown
Event -- -- huawei-bfd:hwBfdSessUp
Alarm -- -- huawei-bgp:BACKWARD
Alarm -- -- huawei-bgp:ESTABLISHED
Sample(S) 10000 -- huawei-devm:devm/cpuInfos/cpuInfo
Sample(S) 10000 -- huawei-devm:devm/memoryInfos/memoryInfo
Sample(S) 10000 -- huawei-ifm:ifm/interfaces/interface
Sample(P) 100 20 huawei-ifm:ifm/interfaces/interface/ifClearedStat
Sample(S) 10000 -- huawei-ifm:ifm/interfaces/interface/ifDynamicInfo
Sample(P) 100 20 huawei-ifm:ifm/interfaces/interface/ifStatistics
Sample(P) 1000 20 huawei-ifm:ifm/interfaces/interface/ifStatistics/ethPortErrSts
Sample(S) 100 20 huawei-ifm:interfaces/interface
Alarm -- -- huawei-isiscomm:isisAdjacencyChange
Alarm -- -- huawei-mpls:Session-Down-MIB
Alarm -- -- huawei-mpls:Session-Up-MIB
Event -- -- huawei-mpls:TNLREROUTED
Sample(S) 10000 -- huawei-mpls:mpls/mplsTe/rsvpTeTunnels/rsvpTeTunnel/tunnelPaths/tunnelPath
Alarm -- -- huawei-mpls:mplsLdpSessionDown
Alarm -- -- huawei-ospfv2:ospfNbrStateChange
Alarm -- -- huawei-ospfv2:ospfVirtNbrStateChange
Alarm -- -- huawei-ospfv3:ospfv3NbrStateChange
Alarm -- -- huawei-sem:hwCPUUtilizationResume
Alarm -- -- huawei-sem:hwCPUUtilizationRisingAlarm
Alarm -- -- huawei-sem:hwStorageUtilizationResume
Alarm -- -- huawei-sem:hwStorageUtilizationRisingAlarm
------------------------------------------------------------------------------------------------------------------
