12-Telemetry Command Reference

HomeSupportResource CenterH3C S6850 & S9850 Switch Series Command References-Release 655x-6W10112-Telemetry Command Reference
02-INT commands
Title Size Download
02-INT commands 91.56 KB

INT commands

display telemetry ifa

Use display telemetry ifa to display INT configuration.

Syntax

display telemetry ifa

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display INT configuration.

<Sysname> display telemetry ifa

  Telemetry ifa status: Enabled

  Telemetry ifa device-id: 10.1.1.10

  Telemetry ifa role:

    Twenty-FiveGigE1/0/3: Transit

  Telemetry ifa action:

    GigabitEthernet1/0/2:

      Telemetry ifa 1 acl 3000 action mirror-to-processor sampler S1

      Telemetry ifa 2 acl user-defined 5000 local-loopback action add-metadata

      Telemetry ifa 3 acl user-defined 5001 action add-metadata

  Telemetry ifa loopback:

    Twenty-FiveGigE1/0/4

Table 1 Command output

Field

Description

Telemetry ifa role

INT role:

·     Ingress—Entry node.

·     Transit—Transit node.

·     Egress—Exit node.

Telemetry ifa loopback

Interface on which internal loopback is enabled.

Telemetry ifa collector

Encapsulation parameters for INT packets.

Telemetry ifa action

Flexible INT configuration:

·     ifa 1—INT action ID.

·     acl—ACL used to match packets.

·     action add-metadata—Action of adding collected metadata on the transit node.

·     action mirror-to-processor drop—Action of mirroring packets to the INT processor and dropping the original packets on the entry node.

·     local-loopback action add-metadata—Action of adding collected metadata to looped back traffic on the entry node or exit node.

·     action mirror-to-processor—Action of mirroring packets to the INT processor.

·     sampler—Sampler used.

Related commands

telemetry ifa acl action add-metadata

telemetry ifa acl action mirror-to-processor drop

telemetry ifa acl local-loopback action add-metadata

telemetry ifa action mirror-to-processor

telemetry ifa collector

telemetry ifa device-id

telemetry ifa role

telemetry ifa acl action add-metadata

Use telemetry ifa acl action add-metadata to configure an INT action of adding collected metadata to incoming packets on the input interface on the transit node.

Use undo telemetry ifa to delete an INT action.

Syntax

telemetry ifa ifa-id acl user-defined { acl-number | name acl-name } action add-metadata

undo telemetry ifa ifa-id

Default

No INT action is configured.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

Predefined user roles

network-admin

Parameters

ifa-id: Specifies an INT action ID in the range of 1 to 65535.

user-defined: Specifies a user-defined ACL by its number or name.

acl-number: Specifies the ACL number in the range of 5000 to 5999.

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

Usage guidelines

After this command is executed, the device adds collected metadata to matching packets on the input interface to calculate the transmission delay of the link.

If the specified ACL does not contain rules, the action is not applied to any packets.

If an ACL is specified in the action of mirroring original packets on the entry node to the INT processor, the ACL specified in this command must contain the same traffic match criteria as that ACL and plus the statement to match the INT flag. The traffic match criteria and the statement to match the INT flag must be in the same ACL rule. For example, if the rule in the ACL in the action of mirroring original packets is rule permit tcp source 10.0.0.3 0, the rule in the ACL in this command must be rule permit tcp source 10.0.0.3 0 ifa l5 aaaaaaaabbbbbbbb ffffffffffffffff 0.

This command and the telemetry ifa role command are mutually exclusive on one interface.

If you execute this command multiple times for the action ID, the most recent configuration takes effect.

 Examples

# Add collected metadata to incoming packets on Twenty-FiveGigE 1/0/1 on the transit node.

<Sysname> system-view

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

[Sysname-Twenty-FiveGigE1/0/1] telemetry ifa 1 acl user-defined 5001 action add-metadata

Related commands

acl (ACL and QoS Command Reference)

telemetry ifa role

telemetry ifa acl action mirror-to-processor drop

Use telemetry ifa acl action mirror-to-processor drop to configure an INT action of adding collected metadata to INT packets on the input interface on the exit node and dropping the original INT packets.

Use undo telemetry ifa to delete an INT action.

Syntax

telemetry ifa ifa-id acl user-defined { acl-number | name acl-name } action mirror-to-processor drop

undo telemetry ifa ifa-id

Default

No INT action is configured.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

Predefined user roles

network-admin

Parameters

ifa-id: Specifies an INT action ID in the range of 1 to 65535.

user-defined: Specifies a user-defined ACL by its number or name.

acl-number: Specifies the ACL number in the range of 5000 to 5999.

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

Usage guidelines

After this command is executed, the device mirrors matching INT packets on the input interface to the INT processor and drops the original INT packets. Then, the INT processor encapsulates the INT packets and sends them to the collector.

If the specified ACL does not contain rules, the action is not applied to any packets.

If an ACL is specified in the action of mirroring original packets on the entry node to the INT processor, the ACL specified in this command must contain the same traffic match criteria as that ACL and plus the statement to match the INT flag. The traffic match criteria and the statement to match the INT flag must be in the same ACL rule. For example, if the rule in the ACL in the action of mirroring original packets is rule permit tcp source 10.0.0.3 0, the rule in the ACL in this command must be rule permit tcp source 10.0.0.3 0 ifa l5 aaaaaaaabbbbbbbb ffffffffffffffff 0.

This command and the telemetry ifa role command are mutually exclusive on one interface.

If you execute this command multiple times for the action ID, the most recent configuration takes effect.

 Examples

# Add collected metadata to INT packets on Twenty-FiveGigE 1/0/1 on the exit node and drop the original INT packets.

<Sysname> system-view

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

[Sysname-Twenty-FiveGigE1/0/1] telemetry ifa 2 acl user-defined 5001 action mirror-to-processor drop

Related commands

acl (ACL and QoS Command Reference)

telemetry ifa role

telemetry ifa acl local-loopback action add-metadata

Use telemetry ifa acl local-loopback action add-metadata to configure an INT action of adding collected metadata to looped back traffic on the input interface on the entry or exit node.

Use undo telemetry ifa to delete an INT action.

Syntax

telemetry ifa ifa-id acl user-defined { acl-number | name acl-name } local-loopback action add-metadata

undo telemetry ifa ifa-id

Default

No INT action is configured.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

Predefined user roles

network-admin

Parameters

ifa-id: Specifies an INT action ID in the range of 1 to 65535.

user-defined: Specifies a user-defined ACL by its number or name.

acl-number: Specifies the ACL number in the range of 5000 to 5999.

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

Usage guidelines

After this command is executed, the device adds collected metadata to matching looped back traffic on the input interface to calculate the transmission delay of the link.

If the specified ACL does not contain rules, the action is not applied to any packets.

If an ACL is specified in the action of mirroring original packets on the entry node to the INT processor, the ACL specified in this command must contain the same traffic match criteria as that ACL and plus the statement to match the INT flag. The traffic match criteria and the statement to match the INT flag must be in the same ACL rule. For example, if the rule in the ACL in the action of mirroring original packets is rule permit tcp source 10.0.0.3 0, the rule in the ACL in this command must be rule permit tcp source 10.0.0.3 0 ifa l5 aaaaaaaabbbbbbbb ffffffffffffffff 0.

This command and the telemetry ifa role command are mutually exclusive on one interface.

If you execute this command multiple times for the action ID, the most recent configuration takes effect.

 Examples

# Add collected metadata to looped back traffic on Twenty-FiveGigE 1/0/1.

<Sysname> system-view

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

[Sysname-Twenty-FiveGigE1/0/1] telemetry ifa 2 acl user-defined 5001 loopback action add-metadata

Related commands

acl (ACL and QoS Command Reference)

telemetry ifa role

telemetry ifa action mirror-to-processor

Use telemetry ifa action mirror-to-processor to configure an INT action of mirroring original packets on the input interface on the entry or exit node to the INT processor.

Use undo telemetry ifa to delete an INT action.

Syntax

telemetry ifa ifa-id [ acl [ ipv6 | mac | user-defined ] { acl-number | name acl-name } ] action mirror-to-processor [ sampler sampler-name ]

undo telemetry ifa ifa-id

Default

No INT action is configured.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

Predefined user roles

network-admin

Parameters

ifa-id: Specifies an INT action ID in the range of 1 to 65535.

acl: Specifies an ACL by its number or name for matching packets. If you do not specify this keyword, the action takes effect on all packets.

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. If you do not specify a sampler, all packets are mirrored.

Usage guidelines

After this command is executed, the device samples ACL-matched packets received on the input interface, and mirrors sampled packets to the INT processor. Then, the INT processor adds an INT header to the sampled packets and sends them back to the input interface as INT packets by using internal loopback.

If the specified ACL does not contain rules, the action is not applied to any packets.

To specify an ACL by a number, follow these rules:

·     To specify an IPv4 ACL, directly specify the acl-number argument.

¡     To specify an IPv6 ACL, specify the ipv6 keyword and the acl-number argument.

·     To specify a Layer 2 or user-defined ACL, specify the mac or user-defined keyword and the acl-number argument, or directly specify the acl-number argument.

To specify an ACL by a name, follow these rules:

·     To specify an IPv4 ACL, directly specify the name acl-name option.

·     To specify an IPv6, Layer 2, or user-defined ACL, specify the ipv6, mac, or user-defined keyword and the name acl-name argument

A sampler selects a packet from sequential packets. You can specify a nonexistent sampler and then create it. For more information about samplers, see sampler configuration in Network Management and Monitoring Configuration Guide.

This command and the telemetry ifa role command are mutually exclusive on one interface.

If you execute this command multiple times for the action ID, the most recent configuration takes effect.

 Examples

# Mirror original packets on Twenty-FiveGigE 1/0/1 to the INT processor.

<Sysname> system-view

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

[Sysname-Twenty-FiveGigE1/0/1] telemetry ifa 1 acl 3000 action mirror-to-processor sampler S1

Related commands

acl (ACL and QoS Command Reference)

telemetry ifa role

telemetry ifa device-id

Use telemetry ifa device-id to specify a device ID for an INT node.

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

Syntax

telemetry ifa device-id address

undo telemetry ifa device-id

Default

An INT node does not have a device ID.

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. As a best practice, specify the loopback address of the device as the device ID.

Examples

# Specify IPv4 address 10.1.1.10 as the device ID.

<Sysname> system-view

[Sysname] telemetry ifa device-id 10.1.1.10

Related commands

telemetry ifa acl action add-metadata

telemetry ifa acl action mirror-to-processor drop

telemetry ifa acl local-loopback action add-metadata

telemetry ifa action mirror-to-processor

telemetry ifa role

telemetry ifa global enable

Use telemetry ifa global enable to enable INT globally.

Use undo telemetry ifa global enable to disable INT globally.

Syntax

telemetry ifa global enable

undo telemetry ifa global enable

Default

INT is enabled globally.

Views

System view

Predefined user roles

network-admin

Examples

# Enable INT globally.

<Sysname> system-view

[Sysname] telemetry ifa global enable

Related commands

telemetry ifa acl action add-metadata

telemetry ifa acl action mirror-to-processor drop

telemetry ifa acl local-loopback action add-metadata

telemetry ifa action mirror-to-processor

telemetry ifa collector

telemetry ifa device-id

telemetry ifa role

telemetry ifa loopback

 

 

NOTE:

This command is required only on the S9850 series switches.

Use telemetry ifa loopback to enable internal loopback on an interface on the entry node.

Use undo telemetry ifa loopback to disable internal loopback on an interface on the entry node.

Syntax

telemetry ifa loopback

undo telemetry ifa loopback

Default

Internal loopback is disabled on an interface on the entry node.

Views

Interface view

Predefined user roles

network-admin

Usage guidelines

In basic INT, when you specify an interface as an ingress interface on the entry node, the device prints the port list in the port group to which the ingress interface belongs. You must enable internal loopback on an interface in the port group other than the ingress interface.

In enhanced INT, the interface where the telemetry ifa action mirror-to-processor command is executed belongs to a port group. You must enable internal loopback on an interface in the port group other than that interface.

After you enable internal loopback on an interface, all settings on the interface are lost, and the interface can be used only for internal loopback.

If you specify multiple interfaces in the port group as ingress interfaces, you may enable internal loopback only on one interface in the port group.

To determine which ports are in one group, execute the display drv system 9 command in probe view. The ports in the same pipe belong to the same group.

Examples

# Enable internal loopback on Twenty-FiveGigE1/0/1 on the entry node.

<Sysname> system-view

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

[Sysname-Twenty-FiveGigE1/0/1] telemetry ifa loopback

All configurations on the interface will be lost. Continue?[Y/N]:y

[Sysname–Twenty-FiveGigE1/0/1]

Related commands

telemetry ifa acl action add-metadata

telemetry ifa acl action mirror-to-processor drop

telemetry ifa acl local-loopback action add-metadata

telemetry ifa action mirror-to-processor

telemetry ifa collector

telemetry ifa device-id

telemetry ifa role

telemetry ifa role

Use telemetry ifa role to specify an INT role for an interface.

Use undo telemetry ifa role to restore the default.

Syntax

telemetry ifa role { egress | ingress | transit }

undo telemetry ifa role

Default

An interface does not take any INT role.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

Predefined user roles

network-admin

Parameters

egress: Specifies the interface as an egress interface.

ingress: Specifies the interface as an ingress interface.

transit: Specifies the interface as a transit interface.

Usage guidelines

In an INT network, specify the interface on the entry node as the ingress interface. Specify the interface on the transit node as the transit interface. Specify the interface on the exit node as the egress interface.

Interfaces in different roles take different actions on incoming packets.

·     The ingress interface adds a timestamp and encapsulates the packet as an INT packet.

·     The transit interface adds a timestamp for the INT packet.

·     The egress interface adds a timestamp, encapsulates the INT packet according to the specified addressing parameters, and sends it to the collector.

If you execute this command multiple times, the most recent configuration takes effect.

This command is mutually exclusive with any command that is used to configure an INT action on one interface.

Examples

# Specify Twenty-FiveGigE 1/0/1 as the transit interface.

<Sysname> system-view

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

[Sysname-Twenty-FiveGigE1/0/1] telemetry ifa role transit

Related commands

telemetry ifa acl action add-metadata

telemetry ifa acl action mirror-to-processor drop

telemetry ifa acl local-loopback action add-metadata

telemetry ifa action mirror-to-processor

telemetry ifa device-id

telemetry ifa collector

Use telemetry ifa collector to configure the addressing parameters to encapsulate in INT packets sent to the collector.

Use undo telemetry ifa collector to restore the default.

Syntax

telemetry ifa collector source source-address destination dest-address source-port port destination-port port [ vlan vlan-id ]

undo telemetry ifa collector

Default

No addressing parameters are configured for INT packets.

Views

System view

Predefined user roles

network-admin

Parameters

source source-address: Specifies the source IP address for INT packets.

destination dest-address: Specifies the destination IP address for INT packets.

source-port port: Specifies the source port number for INT packets.

destination-port port: Specifies the destination port number for INT packets.

vlan vlan-id: Specifies a VLAN ID in the range of 1 to 4094.

Usage guidelines

Use this command on the exit node. The exit node uses the addressing parameters to find the outgoing interface for INT packets and sends the packets to the collector.

Do not specify the IP address of the management Ethernet port on the local device for the destination dest-address option.

Examples

# Specify source IP address 1.1.1.1, destination IP address 2.2.2.2, source port number 67, and destination port number 68 for INT packets.

<Sysname> system-view

[Sysname] telemetry ifa collector source 1.1.1.1 destination 2.2.2.2 source-port 67 destination-port 68

Related commands

telemetry ifa acl action add-metadata

telemetry ifa acl action mirror-to-processor drop

telemetry ifa acl local-loopback action add-metadata

telemetry ifa action mirror-to-processor

telemetry ifa device-id

telemetry ifa role