- Table of Contents
- Related Documents
-
Title | Size | Download |
---|---|---|
02-INT commands | 74.65 KB |
telemetry ifa acl action add-metadata
telemetry ifa global packet-drop
telemetry ifa role (interface view)
telemetry ifa timestamp-format
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
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. · ts—Timestamp 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