Contents

Configuring telemetry streaming· 1

About telemetry streaming· 1

How telemetry streaming works· 1

Telemetry streaming timestamping· 1

Telemetry streaming tasks at a glance· 1

Prerequisites· 1

Configuring basic telemetry streaming functions· 1

Configuring telemetry streaming timestamping· 2

Display and maintenance commands for telemetry streaming· 3

Telemetry streaming configuration examples· 3

Example: Configuring telemetry streaming· 3

Configuring telemetry streaming

About telemetry streaming

Telemetry streaming is a network monitoring technology used to collect data from devices. It continuously streams data to a collector.

Telemetry streaming supports collecting the input interface, timestamp, and output interface of traffic.

How telemetry streaming works

The operating mechanism of telemetry streaming is as follows:

Table 1 Telemetry streaming samples a matching packet on the input interface and copies it to the telemetry streaming processor in the device. The telemetry streaming processor adds the input interface information to the packet.

2.     The telemetry streaming processor encapsulates the packet and routes it to the collector.

The collector can calculate the path and delay information according to the collected data from multiple nodes.

Telemetry streaming timestamping

With this function enabled, the device carries the timestamp in its packets sent to the collector. The collector can calculate the delay introduced when a node forwards packets. Additionally, the collector can use the timestamp information collected from multiple nodes to calculate the delay introduced when packets are forwarded along the path.

Telemetry streaming tasks at a glance

To configure telemetry streaming, perform the following tasks:

1.     Configuring basic telemetry streaming functions

2.     (Optional.) Configuring telemetry streaming timestamping

Prerequisites

Configure routing to make sure the devices can reach each other.

Configuring basic telemetry streaming functions

About this task

The device copies an original packet on the input interface and sends the copy to the telemetry streaming processor in the device. The telemetry streaming processor adds the input and output interface information to the packet, encapsulates it, and routes it to the collector.

Too many original packets will overwhelm the Telemetry processor and even cause it to drop packets. To address this problem, you can use an ACL or sampler on the input interface to reduce the packets sent to the collector. Only packets matching a permit ACL rule or sampled packets are sent to the collector.

If the data portion of original packets is large, you can enable the truncation function to save the link bandwidth consumed between the device and the collector and reduce the parsing load of the collector. The truncation function truncates the packets before sending them to the collector. The truncated packets retain complete input interface, output interface, and timestamp information.

Procedure

1.     Specify a device ID.

a.     Enter system view.

system-view

b.     Specify a device ID.

telemetry stream device-id address

By default, no device ID is specified.

2.     Configure addressing parameters to encapsulate in the packets sent to the collector.

telemetry stream collector source source-address destination destination-address source-port source-port destination-port destination-port [ vpn-instance vpn-instance-name ] [ truncation ]

By default, no addressing parameters are configured.

3.     Configure a telemetry streaming action on the input interface.

a.     Enter interface view.

interface interface-type interface-number

b.     Configure a telemetry streaming action on the interface.

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

By default, no telemetry streaming action is configured.

c.     Return to system view.

quit

For information about ACLs, see ACL and QoS Configuration Guide.

For information about samplers, see Network Management and Monitoring Configuration Guide.

4.     Enable telemetry streaming.

telemetry stream enable

By default, telemetry streaming is enabled.

Configuring telemetry streaming timestamping

About this task

This feature allows the device to add the timestamp information when a packet enters and leaves it.

Procedure

1.     Enter system view.

system-view

2.     Enable telemetry streaming timestamping.

telemetry stream timestamp enable

By default, telemetry streaming timestamping is disabled.

Display and maintenance commands for telemetry streaming

Execute display commands in any view.

 

Task	Command
Display ACL configuration and match statistics.	display acl [ ipv6 | mac | user-defined ] { acl-number | all | name acl-name } For more information about this command, see ACL and QoS Command Reference.
Display the configuration of samplers.	display sampler [ sampler-name ] [ slot slot-number ] For more information about this command, see Network Management and Monitoring Command Reference.
Display telemetry streaming configuration.	display telemetry stream

 

Telemetry streaming configuration examples

Example: Configuring telemetry streaming

Network configuration

As shown in Figure 1, configure telemetry streaming on Device B for the collector to calculate the delay when packets are forwarded by Device B.

Figure 1 Network diagram

‌

Table 2 Interface label and interface name mappings

Interface label	Interface name
Interface1	Ten-GigabitEthernet1/0/1
Interface2	Ten-GigabitEthernet1/0/2
Interface3	Ten-GigabitEthernet1/0/3
Interface4	Ten-GigabitEthernet1/0/4

 

Prerequisites

Assign IP addresses to interfaces and configure routing protocols. (Details not shown.)

Procedure

# Specify 10.0.0.1 as the device ID.

<DeviceB> system-view

[DeviceB] telemetry stream device-id 10.0.0.1

# Configure addressing parameters to encapsulate in telemetry streaming packets sent to the collector.

[DeviceB] telemetry stream collector source 20.0.0.2 destination 30.0.0.1 source-port 12 destination-port 14

# Enable telemetry streaming timestamping.

[DeviceB] telemetry stream timestamp enable

# Create sampler samp in random sampling mode, and set the sampling rate to 8. One packet from 256 (2 to the 8th power) packets is selected.

[DeviceB] sampler samp mode random packet-interval n-power 8

# Create IPv4 basic ACL 2000, and configure a rule to match packets with source IP address 192.168.1.2.

[DeviceB] acl basic 2000

[DeviceB-acl-ipv4-basic-2000] rule permit source 192.168.1.2 0

[DeviceB-acl-ipv4-basic-2000] quit

# Configure telemetry streaming action 1 to use ACL 2000 and sampler samp on Ten-GigabitEthernet 1/0/3.

[DeviceB] interface ten-gigabitethernet 1/0/3

[DeviceB-Ten-GigabitEthernet1/0/3] telemetry stream action 1 acl 2000 sampler samp

[DeviceB-Ten-GigabitEthernet1/0/3] quit

# Enable telemetry streaming.

[DeviceB] telemetry stream enable

Verifying the configuration

# Display the telemetry streaming configuration on Device B.

[DeviceB] display telemetry stream

Telemetry stream status          : Enabled

Telemetry stream timestamp status: Enabled

Telemetry stream device-id       : 10.0.0.1

Telemetry stream action:

  Ten-GigabitEthernet1/0/3:

    Telemetry stream action 1:

      ACL    : 2000

      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

  Truncation      : Enable