- Table of Contents
- Related Documents
-
Title | Size | Download |
---|---|---|
02-INT commands | 57.46 KB |
INT commands
INT and telemetry stream are mutually exclusive on the device. Configure only one of them.
You can enable sampling for only one of the following features on the device:
· INT.
· NetStream.
· IPv6 NetStream.
· Mirroring.
· sFlow.
· Telemetry stream.
· MOD.
For more information about NetStream, IPv6 NetStream, mirroring, and sFlow, see Network Management and Monitoring Configuration Guide. For more information about telemetry stream and MOD, see Telemetry Configuration Guide.
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 packet-drop : Disabled
Telemetry ifa device-id : 10.1.1.10
Telemetry ifa role:
HundredGigE1/0/3: Transit
Field |
Description |
Telemetry ifa role |
INT role: INT role, which can only be Transit (transit node). |
Telemetry ifa packet-drop |
Global INT packet dropping. This feature is not supported in the current software version. |
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 the specified ACL does not contain rules, no packets will match the ACL.
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.
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/0/1.
<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 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 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 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.
If you execute this command multiple times, the most recent configuration takes effect.
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 device-id