12-Telemetry Command Reference

HomeSupportResource CenterSwitchesH3C S9820 Switch SeriesH3C S9820 Switch SeriesTechnical DocumentsCommandCommand ReferencesH3C S9820-64H Switch Command References-Release 655x-6W10112-Telemetry Command Reference
02-INT commands
Title Size Download
02-INT commands 56.41 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:

    HundredGigE1/0/3: Transit

  Telemetry ifa action:

    GigabitEthernet1/0/2:

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

Table 1 Command output

Field

Description

Telemetry ifa role

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

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.

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 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 HundredGigE 1/0/1 on the transit node.

<Sysname> system-view

[Sysname] interface hundredgige 1/0/1

[Sysname-HundredGigE1/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 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 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 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 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 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.

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

Examples

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

<Sysname> system-view

[Sysname] interface hundredgige 1/0/1

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

Related commands

telemetry ifa acl action add-metadata

telemetry ifa device-id