No relevant resource is found in the selected language.

This site uses cookies. By continuing to browse the site you are agreeing to our use of cookies. Read our privacy policy>Search

Reminder

To have a better experience, please upgrade your IE browser.

upgrade

NE40E V800R010C00 Configuration Guide - System Monitor 01

Rate and give feedback:
Huawei uses machine translation combined with human proofreading to translate this document to different languages in order to help you better understand the content of this document. Note: Even the most advanced machine translation cannot match the quality of professional translators. Huawei shall not bear any responsibility for translation accuracy and it is recommended that you refer to the English document (a link for which has been provided).
Configuring Telemetry Static Subscription

Configuring Telemetry Static Subscription

Telemetry static subscription indicates that a device functioning as a client initiates a connection to a collector functioning as a server to send data collected.

Usage Scenario

The controller uses commands to configure devices that support Telemetry, subscribe to data sources, and collect data. The protocol used to send data can be gRPC.

If the connection between a device and the collection is interrupted, the device connects to the collector and sends data again. However, the data sampled when the connection is being re-established is lost.

After an active/standby switchover is performed or the system saves Telemetry service configurations and restarts, the Telemetry service reloads its configurations and continues to run. However, the data sampled during the restart or active/standby switchover is lost. This poses high pressure on devices. Therefore, Telemetry static subscription is often used for coarse-grained data collection.

Pre-configuration Tasks

Before configuring Telemetry static subscription, configure a static or dynamic routing protocol so that devices can communicate at the network layer.

Configuration Procedures

Perform one or more of the following configurations as required.

Enabling Telemetry Sampling

Before configuring Telemetry static subscription to the data sampled, you need to enable the Telemetry sampling function. Otherwise, subscription tasks cannot be delivered.

Procedure

  1. Run:

    system-view

    The system view is displayed.

  2. Run:

    telemetry

    The Telemetry view is displayed.

  3. Run:

    sample enable

    The Telemetry sampling function is enabled.

  4. Run:

    commit

    The configuration is committed.

Configuring a Destination Collector

When you configure Telemetry static subscription to the data sampled, you need to create a destination group and specify a destination collector to which the data is sent.

Context

When static subscription is configured, a device functions as a client and a collector functions as a server. To statically subscribe to the data sampled, you need to configure the IP address and port number of a destination collector, and the protocol and encryption mode for data sending.

Procedure

  1. Run:

    system-view

    The system view is displayed.

  2. Run:

    telemetry

    The Telemetry view is displayed.

  3. Run:

    destination-group destination-name

    A destination group to which the data sampled is sent is created, and the destination-group view is displayed.

  4. Run:

    ipv4-address ip-address port port [ vpn-instance vpn-instance ] protocol grpc no-tls

    An IP address and a port number are configured for the destination collector, and a protocol and an encryption mode are configured for data sending.

    NOTE:

    This command can be run for no more than five times for each destination group.

  5. Run:

    commit

    The configuration is committed.

Configuring the Data to Be Sampled

When you configure Telemetry static subscription to the data sampled, you need to create a sampling sensor group and specify a sampling path and filter criteria.

Context

When static subscription is configured, a device functions as a client and a collector functions as a server. To statically subscribe to the data sampled, you need to configure a source of the data to be sampled.

Procedure

  1. Run:

    system-view

    The system view is displayed.

  2. Run:

    telemetry

    The Telemetry view is displayed.

  3. Run:

    sensor-group sensor-name

    A sampling sensor group is created, and the Sensor-group view is displayed.

  4. Run:

    sensor-path path [ condition express op-field field op-type op op-value value ]

    A sampling path is configured for the Telemetry sensor group.

  5. Run:

    commit

    The configuration is committed.

Creating a Subscription

When you configure Telemetry static subscription to the data sampled, you need to create a subscription to associate the configured destination group with the configured sampling sensor group so that data can be sent to the collector.

Context

When static subscription is configured, a device functions as a client and a collector functions as a server. To statically subscribe to the data sampled, you need to create a subscription to set up a data sending channel. The protocol used to send data can be gRPC.

Procedure

  1. Run:

    system-view

    The system view is displayed.

  2. Run:

    telemetry

    The Telemetry view is displayed.

  3. Run:

    subscription subscription-name

    A subscription is created to associate a destination group with a sampling sensor group, and the subscription view is displayed.

  4. Run:

    sensor-group sensor-name [ sample-interval sample-interval [ suppress-redundant [ heartbeat-interval heartbeat-interval ] ] ]

    A sampling sensor group is associated with the subscription, and a sampling interval, a heartbeat interval, and redundancy suppression are configured for the sampling sensor group.

    NOTE:

    If a sampling path of the associated sampling sensor group has threshold filter criteria, redundancy suppression cannot be configured. That is, threshold filtering and redundancy suppression are mutually exclusive.

  5. Run:

    destination-group destination-name

    A destination group is associated with the subscription.

    NOTE:

    A maximum of five destination groups can be associated with each subscription using this command. Five IP addresses and five port numbers can be configured for each destination group.

  6. (Optional) Run:

    dscp dscp-value

    A DSCP value is set for data packets sent.

    NOTE:

    When network data transmission is stable, Telemetry does not need to change the DSCP value of the data packets sent. When packet loss occurs during data transmission, you can configure a DSCP value in the Telemetry view for the data packets sent. You can improve the priority of packet transmission to ensure the quality of network data transmission.

  7. Run:

    commit

    The configuration is committed.

Verifying the Telemetry Configuration

After configuring Telemetry static subscription to the data sampled, check information about the sampling sensor group, destination group, and subscription.

Prerequisites

The Telemetry static subscription functions have been configured.

Procedure

  • Run the display telemetry sensor [ sensor-name ] command to check the sampling sensor information.
  • Run the display telemetry destination [ destination-name ] command to check information about a destination group to which the data sampled is sent.
  • Run the display telemetry subscription [ subscription-name ] command to check the subscription information.

Example

Run the display telemetry sensor [ sensor-name ] command to check the sampling sensor information.
<HUAWEI> display telemetry sensor group1
----------------------------------------------------------------------
Sensor-name     Path-state Op-field   Op-type    Op-value   Path      
----------------------------------------------------------------------
group1          RESOLVED   -          -          -          huawei-devm:devm/cpuInfos/cpuInfo
----------------------------------------------------------------------
Run the display telemetry destination [ destination-name ] command to check the destination collector information.
<HUAWEI> display telemetry destination 1
-----------------------------------------------------------------------------------------------------
Dest-name   Dest-addr        Dest-port   State     Vpn-name  Protocol  Encoding  Istls  FailedReason
-----------------------------------------------------------------------------------------------------
1           10.1.1.1         355         RESOLVED  -         GRPC      GPB       NO-TLS BUILDING    
 ----------------------------------------------------------------------------------------------------
Run the display telemetry subscription [ subscription-name ] command to check the subscription information.
<HUAWEI> display telemetry subscription 1
---------------------------------------------------------------------------
Sub-name           : 1
Dscp               : 1
Protocol           : GRPC 
Encoding           : GPB 
Send bytes         : 0 
Send packets       : 0 
Total send delay   : 0 
Total send error   : 0 
Total send drop    : 28504 
Total other error  : 0  
Last send-time     : 2017-08-31 15:42:35.000
Sensor group:
----------------------------------------------------------------------------
Sensor-name  Sample interval(ms)  Heart interval(s)  Suppression  State     
----------------------------------------------------------------------------
a            100                  60                 NO           RESOLVED  
----------------------------------------------------------------------------
Destination group:
---------------------------------------------------------------------------------------
Dest-name   Dest-IP          Dest-port   State        Vpn-name     Protocol   Encoding
---------------------------------------------------------------------------------------
1           10.1.1.1          100         RESOLVED     -            GRPC       GPB     
---------------------------------------------------------------------------------------
Sub-state          : PASSIVE 
---------------------------------------------------------------------------------------

Total subscription number is :  1  
Download
Updated: 2018-07-12

Document ID: EDOC1100028538

Views: 28253

Downloads: 213

Average rating:
This Document Applies to these Products
Related Version
Related Documents
Share
Previous Next