11-Telemetry Command Reference

HomeSupportSwitchesS9820 SeriesReference GuidesCommand ReferencesH3C S9820-8C Switch Command References-Release 6715-6W10011-Telemetry Command Reference
02-INT commands
Title Size Download
02-INT commands 74.65 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

# (Common INT.) Display the INT configuration on the transit node.

<Sysname> display telemetry ifa

  Telemetry ifa status          : Enabled

  Telemetry ifa packet-drop     : Disabled

  Telemetry ifa device-id       : 10.1.1.10

  Telemetry ifa timestamp-format: ts

  Telemetry ifa role:

    HundredGigE1/1/1: Transit

# (Flexible INT.) Display the INT configuration on the transit node.

<Sysname> display telemetry ifa

  Telemetry ifa status          : Enabled

  Telemetry ifa packet-drop     : Disabled

  Telemetry ifa device-id       : 10.1.1.10

  Telemetry ifa timestamp-format: ts

  Telemetry ifa action:

    HundredGigE1/1/1:

      Telemetry ifa 1 acl user-defined 5000 action add-metadata

Table 1 Command output

Field

Description

Telemetry ifa role

INT role:

INT role, which can only be Transit (transit node).

Telemetry ifa status timestamp-format

Timestamp format of INT packets:

·     md—Metadata format.

·     tsTimestamp format.

Telemetry ifa packet-drop

Global INT packet dropping: Enabled or Disabled.

Telemetry ifa action

Flexible INT configuration:

·     ifa 1—Action ID.

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

Related commands

telemetry ifa acl action add-metadata

telemetry ifa device-id

telemetry ifa role

telemetry ifa acl action add-metadata

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

Use undo telemetry ifa acl action add-metadata to delete an action.

Syntax

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

undo telemetry ifa ifa-id

Default

No action is configured.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

Predefined user roles

network-admin

Parameters

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

user-defined: Specifies a user-defined ACL.

acl-number: Specifies a user-defined ACL by its number in the range of 5000 to 5999.

name acl-name: Specifies a user-defined ACL by its name, a case-insensitive string of 1 to 63 characters.

Usage guidelines

This command adds collected data to INT packets matching the specified ACL for calculating the transmission delay of the network.

If an ACL is used on the entry node to match original packets, the ACL specified in this command must have the same identification attributes plus an attribute to identify the INT flag. The identification attributes and the attribute to identify the INT flag must be in the same rule. For example, the rule in the ACL used on the entry node is rule permit tcp source 10.0.0.3 0, the rule in the ACL specified in this command must be rule permit tcp source 10.0.0.3 0 ifa l5 aaaaaaaabbbbbbbb ffffffffffffffff 0.

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 non-VPN packets and VPN packets.

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

You can execute this command multiple times to configure different actions for different traffic types. If you execute this command multiple times with the same ifa-id, the most configuration takes effect.

 Examples

# Configure an action of adding collected data to incoming INT packets on HundredGigE 1/1/1.

<Sysname> system-view

[Sysname] interface hundredgige 1/1/1

[Sysname-HundredGigE1/1/1] telemetry ifa 1 acl user-defined 5001 action add-metadata

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 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 device-id

telemetry ifa role

telemetry ifa global packet-drop

Use telemetry ifa global packet-drop to enable global INT packet dropping.

Use undo telemetry ifa global packet-drop to disable global INT packet dropping.

Syntax

telemetry ifa global packet-drop

undo telemetry ifa global packet-drop

Default

Global INT packet dropping is disabled.

Views

System view

Predefined user roles

network-admin

Usage guidelines

Execute this command if you do not want to send INT packets to the downstream node.

Examples

# Enable global INT packet dropping.

<Sysname> system-view

[Sysname] telemetry ifa global packet-drop

Related commands

display telemetry ifa

telemetry ifa role (interface view)

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

transit: Specifies the interface as a transit interface.

Usage guidelines

In a common INT network, specify the input interface on the transit node as the transit interface. The transit interface adds a timestamp when forwarding INT packets.

Examples

# Specify HundredGigE 1/1/1 as the transit interface.

<Sysname> system-view

[Sysname] interface hundredgige 1/1/1

[Sysname-HundredGigE1/1/1] telemetry ifa role transit

Related commands

telemetry ifa device-id

telemetry ifa timestamp-format

Use telemetry ifa timestamp-format to specify the timestamp format inserted into INT packets.

Use undo telemetry ifa timestamp-format to restore the default.

Syntax

telemetry ifa timestamp-format ts

undo telemetry ifa timestamp-format

Default

The timestamp format is md.

Views

System view

Predefined user roles

network-admin

Parameters

ts: Specifies the timestamp format.

Usage guidelines

The metadata format is not supported in the current software version. For INT to work correctly, execute the telemetry ifa timestamp-format ts command.

This command does not affect the timestamp format of received INT packets.

Examples

# Specify the timestamp format.

<Sysname> system-view

[Sysname] telemetry ifa timestamp-format ts

 

  • Cloud & AI
  • InterConnect
  • Intelligent Computing
  • Intelligent Storage
  • Security
  • SMB Products
  • Intelligent Terminal Products
  • Product Support Services
  • Technical Service Solutions
All Services
  • Resource Center
  • Policy
  • Online Help
  • Technical Blogs
All Support
  • Become A Partner
  • Partner Policy & Program
  • Global Learning
  • Partner Sales Resources
  • Partner Business Management
  • Service Business
All Partners
  • Profile
  • News & Events
  • Online Exhibition Center
  • Contact Us
All About Us
新华三官网