Contents

Telemetry streaming commands· 1

display telemetry stream·· 1

telemetry stream action· 2

telemetry stream collector 3

telemetry stream device-id· 4

telemetry stream enable· 5

telemetry stream timestamp enable· 5

 

Telemetry streaming commands

display telemetry stream

Use display telemetry stream to display telemetry streaming configuration.

Syntax

display telemetry stream

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display telemetry streaming configuration.

<Sysname> display telemetry stream

Telemetry stream status          : Enabled

Telemetry stream timestamp status: Disabled

Telemetry stream device ID       : 10.0.0.3

Telemetry stream action:

  HundredGigE1/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

Table 1 Command output

Field	Description
Telemetry stream status	Telemetry streaming status: ·     Enabled. ·     Disabled.
Telemetry stream timestamp status	Telemetry streaming timestamp status: ·     Enabled. ·     Disabled.
Telemetry stream action	Telemetry streaming action: ·     Inactive indicates that the action is not issued because telemetry streaming is disabled. ·     Failed indicates that the action fails to be issued.
Telemetry stream collector	Encapsulation parameters for telemetry streaming packets. The following fields appear only if telemetry streaming timestamp is disabled: ·     Destination MAC. ·     VLAN ID. ·     Output Index—Output interface index. ·     Truncation—This field is displayed only if the truncation function is enabled.

‌

telemetry stream action

Use telemetry stream action to configure a telemetry streaming action.

Use undo telemetry stream action to delete a telemetry streaming action.

Syntax

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

undo telemetry stream action action-id

Default

No telemetry streaming action is configured.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

Layer 3 Ethernet subinterface view

Predefined user roles

network-admin

Parameters

action-id: Specifies an action ID in the range of 1 to 32.

acl: Specifies an ACL.

·     ipv6: Specifies the IPv6 ACL type.

·     mac: Specifies the Layer 2 ACL type.

·     user-defined: Specifies the user-defined ACL type.

·     acl-number: Specifies the ACL number. The following are available value ranges:

¡     2000 to 2999 for basic ACLs.

¡     3000 to 3999 for advanced ACLs.

¡     4000 to 4999 for Layer 2 ACLs.

¡     5000 to 5999 for user-defined ACLs.

·     name acl-name: Specifies the ACL name, a case-insensitive string of 1 to 63 characters.

sampler sampler-name: Specifies a sampler by its name, a case-insensitive string of 1 to 31 characters. If you do not specify a sampler, 500 packets are sampled from 1000 packets. For more information about samplers, see Network Management and Monitoring Configuration Guide.

Usage guidelines

When receiving a packet on an interface configured with a telemetry streaming action, the device copies the packet, encapsulates the copied packet with the configured addressing parameters, and sends it to the collector.

Specifying an ACL limits telemetry streaming to the traffic that matches the ACL. To specify an IPv4 ACL, do not specify the mac, ipv6, or user-defined keyword. To specify a Layer 2 or user-defined ACL, you must specify the mac or user-defined keyword before specifying the ACL number or name.

Specifying a sampler reduces the number of packets copied and sent to the collector, but provides less granular monitoring.

An S9825 switch supports referencing a maximum of three samplers. An S9855 switch supports referencing a maximum of seven samplers. If you want to reference a sampler after the maximum of samplers is reached, you must first remove one sampler that has been referenced.

When specifying an ACL, follow these restrictions and guidelines:

·     If the specified ACL does not exist or does not have any rules, no traffic will match the ACL.

·     If the vpn-instance vpn-instance-name option is specified in an ACL rule, the rule takes effect only on VPN packets. If the vpn-instance vpn-instance-name option is not specified in an ACL rule, the rule takes effect on both public network packets and VPN packets.

Examples

# Configure telemetry streaming action 1 on HundredGigE 1/0/1 to use sampler samp.

<Sysname> system-view

[Sysname] interface hundredgige 1/0/1

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

telemetry stream collector

Use telemetry stream collector to configure the addressing parameters to encapsulate in telemetry streaming packets sent to the collector.

Use undo telemetry stream collector to restore the default.

Syntax

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

Default

No addressing parameters are configured for telemetry streaming packets.

Views

System view

Predefined user roles

network-admin

Parameters

source source-address: Specifies the source IP address for telemetry streaming packets.

destination destination-address: Specifies the destination IP address for telemetry streaming packets.

source-port source-port: Specifies the source port number for telemetry streaming packets.

destination-port destination-port: Specifies the destination port number for telemetry streaming packets.

vpn-instance vpn-instance-name: Specifies a VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the device forwards the telemetry streaming packets to the collector according to the routing table of the public network.

truncation: Enables the truncation function. If you do not specify this keyword, the truncation function is disabled.

Usage guidelines

The device uses the addressing parameters to route the telemetry streaming packets to the collector.

The destination IP address must be the IP address of the collector, and the destination port number must be the listening port number on the collector.

The vpn-instance vpn-instance-name option of this command is mutually exclusive with the telemetry stream timestamp enable command.

If telemetry streaming timestamping is not enabled, the outgoing interface for the destination IP address can only be one of the following interfaces:

·     Layer 2 Ethernet interface.

·     Layer 3 Ethernet interface.

·     Layer 2 Ethernet subinterface.

·     Layer 2 aggregate interface.

·     Layer 3 aggregate interface.

·     Layer 2 aggregate subinterface.

Examples

# Specify source IP address 10.10.10.10, destination IP address 20.20.20.20, source port number 10, and destination port number 20 for telemetry streaming packets.

<Sysname> system-view

[Sysname] telemetry stream collector source 10.10.10.10 destination 20.20.20.20 source-port 10 destination-port 20

Related commands

telemetry stream timestamp enable

telemetry stream device-id

Use telemetry stream device-id to specify a device ID.

Use undo telemetry stream device-id to restore the default.

Syntax

telemetry stream device-id address

undo telemetry stream device-id

Default

No device ID is specified.

Views

System view

Predefined user roles

network-admin

Parameters

address: Specifies an IPv4 address as the device ID. You can specify any IPv4 address other than 0.0.0.0. The specified IP address is encapsulated in a copied packet for the collector to identify the source of the packet.

Usage guidelines

This command takes effect only if telemetry streaming timestamp is enabled.

Examples

# Specify IPv4 address 10.10.10.10 as the device ID.

<Sysname> system-view

[Sysname] telemetry stream device-id 10.10.10.10

telemetry stream enable

Use telemetry stream enable to enable telemetry streaming.

Use undo telemetry stream enable to disable telemetry streaming.

Syntax

telemetry stream enable

undo telemetry stream enable

Default

Telemetry streaming is enabled.

Views

System view

Predefined user roles

network-admin

Examples

# Enable telemetry streaming.

<Sysname> system-view

[Sysname] telemetry stream enable

telemetry stream timestamp enable

Use telemetry stream timestamp enable to enable telemetry streaming timestamping.

Use undo telemetry stream timestamp enable to disable telemetry streaming timestamping.

Syntax

telemetry stream timestamp enable

undo telemetry stream timestamp enable

Default

Telemetry streaming timestamping is disabled.

Views

System view

Predefined user roles

network-admin

Usage guidelines

This command enables the device to add to a copied packet the timestamps when the original packet enters and leaves the device.

This command is mutually exclusive with the vpn-instance vpn-instance-name option in the telemetry stream collector command.

Examples

# Enable telemetry streaming timestamping.

<Sysname> system-view

[Sysname] telemetry stream timestamp enable

Related commands

service-loopback group (Layer 2—LAN Switching Command Reference)

telemetry stream collector