09-Track Commands
Chapters Download (43.74 KB)
Syntax
display track { track-entry-number | all }
View
Any view
Default Level
1: Monitor level
Parameters
track-entry-number: Displays information about the specified track entry, in the range 1 to 1024.
all: Displays information about all the track entries.
Description
Use the display track command to display track entry information.
Examples
# Display information about all the track entries.
<Sysname> display track all
Track ID: 1
Status: Positive (notify 13 seconds later)
Notification delay: Positive 20, Negative 30 (in seconds)
Reference object:
NQA entry: admin test
Reaction: 10
Track ID: 2
Status: Invalid
Duration: 0 days 0 hours 5 minutes 50 seconds
Notification delay: Positive 20, Negative 30 (in seconds)
Reference object:
BFD session:
Packet type: Echo
Interface : Vlan-interface2
Remote IP : 192.168.40.1
Local IP : 192.168.40.2
Track ID: 3
Status: Negative
Duration: 0 days 1 hours 25 minutes 14 seconds
Notification delay: Positive 20, Negative 30 (in seconds)
Reference object:
Track interface :
Interface status : Inserted
Interface : Vlan-interface3
Protocol : IPv4
Table 1-1 display track command output description
|
Field |
Description |
|
Track ID |
ID of a track entry |
|
Status |
Status of a track entry: l Positive: The track entry is normal. l Invalid: The track entry is invalid. l Negative: The track entry is abnormal. |
|
Duration |
Status duration after the status of the track entry was changed |
|
notify 13 seconds later |
The track module notifies the application modules of the track entry change 13 seconds later. The information is not displayed after the track module notifies the application modules. |
|
Notification delay: Positive 20, Negative 30 (in seconds) |
l The track module notifies the application modules that the status of the track entry changes to Positive after a delay time of 20 seconds. l The track module notifies the application modules that the status of the track entry changes to Negative after a delay time of 30 seconds. |
|
Reference object |
The objects referenced by the track entry |
|
NQA entry |
The NQA test group referenced by the track entry |
|
Reaction |
The reaction entry referenced by the track entry |
|
BFD session |
Information about the BFD object associated with the track entry |
|
Packet type |
Type of the BFD packet, which can only be Echo currently. |
|
Interface |
Outgoing interface of BFD echo packets |
|
Remote IP |
Remote IP address of the BFD echo packets |
|
Local IP |
Local IP address of the BFD echo packets |
|
Track interface |
Information of the interface associated with the track entry |
|
Interface status |
Interface status, which takes the two values: l Inserted l Removed |
|
Interface |
Interface to be monitored |
|
Protocol |
Physical status or Layer 3 protocol status of the monitored interface: l None: Physical status of the monitored interface. l IPv4: IPv4 protocol status of the monitored Layer 3 interface.. l IPv6: IPv6 protocol status of the monitored Layer 3 interface. |
Syntax
track track-entry-number bfd echo interface interface-type interface-number remote ip remote-ip local ip local-ip [ delay { negative negative-time | positive positive-time } * ]
undo track track-entry-number
View
System view
Default Level
2: System level
Parameters
track-entry-number: Track entry ID, in the range 1 to 1024.
interface interface-type interface-number: Specifies the outgoing interface for BFD echo packets. interface-type interface-number represents the interface type and interface number.
remote ip remote-ip: Specifies the remote IP address of the BFD echo packets.
local ip local-ip: Specifies the local IP address of the BFD echo packets.
delay: Specifies that the track module notifies the application modules of the track entry status change after a specified delay time. If this keyword is not provided, the track module notifies the application modules immediately when the track entry status changes.
negative negative-time: Specifies the delay time for the track module to notify the application modules that the status of the track entry changes to Negative. negative-time represents the delay time, ranging from 1 to 300, in seconds.
positive positive-time: Specifies the delay time for the track module to notify the application modules that the status of the track entry changes to Positive. positive-time represents the delay time, ranging from 1 to 300, in seconds.
Description
Use the track bfd echo command to create the track entry associated with the BFD session, specify to use echo packets in BFD probes, and specify the delay time for the track module to notify the application modules when the status of the track entry changes.
Use the undo track command to remove the created track entry.
By default, no track entry that is associated with BFD session is created.
Note that:
l When a track entry is created, you cannot modify the content associated with the track entry. Remove the track entry, and then reconfigure it.
l To modify the delay time for the track module to notify the application modules of the track entry status change after a track entry is created, use the track bfd echo delay command.
l When configuring collaboration between track and BFD, do not configure the local address or remote address of a BFD session as the virtual IP address of a VRRP group.
Related commands: display track.
Examples
# Create track entry 1 to associate it with BFD session, which makes a probe using echo packets; the outgoing interface is VLAN-interface 2; the remote IP address is 192.168.40.1; and the local IP address is 192.168.40.2.
<Sysname> system-view
[Sysname] track 1 bfd echo interface vlan-interface 2 remote ip 192.168.40.1 local ip 192.168.40.2
Syntax
track track-entry-number nqa entry admin-name operation-tag reaction item-number [ delay { negative negative-time | positive positive-time } * ]
undo track track-entry-number
View
System view
Default Level
2: System level
Parameters
track-entry-number: track entry ID, in the range 1 to 1024.
entry admin-name operation-tag: Specifies the NQA test group to be associated with the track entry. admin-name is the name of the administrator creating the NQA operation, a case insensitive string of 1 to 32 characters. operation-tag is the NQA operation tag, a case insensitive string of 1 to 32 characters.
reaction item-number: Specifies the reaction entry to be associated with the track entry. item-num is the reaction entry ID, in the range 1 to 10.
delay: Specifies that the track module notifies the application modules of the track entry status change after a specified delay time. If this keyword is not provided, the track module notifies the application modules immediately when the track entry status changes.
negative negative-time: Specifies the delay time for the track module to notify the application modules that the status of the track entry changes to Negative. negative-time represents the delay time, ranging from 1 to 300, in seconds.
positive positive-time: Specifies the delay time for the track module to notify the application modules that the status of the track entry changes to Positive. positive-time represents the delay time, ranging from 1 to 300, in seconds.
Description
Use the track nqa command to create the track entry to be associated with the specified reaction entry of the NQA test group, and specify the delay time for the track module to notify the application modules when the status of the track entry changes.
Use the undo track command to remove the created track entry.
By default, no track entry to be associated with the track entry is created.
Note that:
l After a track entry is created, you cannot modify the content associated with the track entry. Remove the track entry, and then reconfigure it.
l To modify the delay time for the track module to notify the application modules of the track entry status change after a track entry is created, use the track nqa delay command.
Related commands: nqa, and reaction in NQA Commands in the Command Reference - Part 12 - System Monitoring and display track.
Examples
# Create track entry 1 to associate it with reaction entry 3 of the NQA test group (admin-test).
<Sysname> system-view
[Sysname] track 1 nqa entry admin test reaction 3
Syntax
track track-entry-number interface interface-type interface-number [ delay { negative negative-time | positive positive-time } * ]
undo track track-entry-number
View
System view
Default Level
2: System level
Parameters
track-entry-number: track entry ID, in the range 1 to 1024.
interface-type interface-number: Type and number of the interface to be monitored.
delay: Specifies that the track module notifies the application modules of the track entry status change after a specified delay time. If this keyword is not provided, the track module notifies the application modules immediately when the track entry status changes.
negative negative-time: Specifies the delay time for the track module to notify the application modules that the status of the track entry changes to Negative. negative-time represents the delay time, ranging from 1 to 300, in seconds.
positive positive-time: Specifies the delay time for the track module to notify the application modules that the status of the track entry changes to Positive. positive-time represents the delay time, ranging from 1 to 300, in seconds.
Description
Use the track interface command to create a track entry to be associated with the physical status of a specified interface, and specify the delay time for the track module to notify the application modules when the status of the track entry changes.
Use the undo track command to remove the created track entry.
By default, no track entry to be associated with the physical status of a specified interface is created.
Note that:
l After a track entry is created, you cannot modify the content associated with the track entry. You need to remove the track entry, and then reconfigure it.
l To modify the delay time for the track module to notify the application modules of the track entry status change after a track entry is created, use the track interface delay command.
l After a track object to be associated with the physical status of a specified interface is created, the status of the track object is Positive if the physical status of the interface is up; the status of the track object is Negative if the physical status of the interface is down. You can use the display ip interface brief command to display the physical status of an interface.
Related commands: display ip interface brief in IP Addressing Commands in the Command Reference - Part 4 - IP Services, display track.
Examples
# Create track entry 1 to be associated with the physical status of interface GigabitEthernet 1/0/1.
<Sysname> system-view
[Sysname] track 1 interface gigabitethernet 1/0/1
Syntax
track track-entry-number interface interface-type interface-number protocol { ipv4 | ipv6 } [ delay { negative negative-time | positive positive-time } * ]
undo track track-entry-number
View
System view
Default Level
2: System level
Parameters
track-entry-number: track entry ID, in the range 1 to 1024.
interface-type interface-number: Type and number of the interface to be monitored.
ipv4: IPv4 protocol status of the interface to be monitored. When the IPv4 protocol status of an interface is up, the status of the track object is Positive; when the IPv4 protocol status of an interface is down, the status of the track object is Negative. To display the IPv4 protocol status of an interface, use the display ip interface brief command .
ipv6: IPv6 protocol status of the interface to be monitored. When the IPv6 protocol status of an interface is up, the status of the track object is Positive; when the IPv6 protocol status of an interface is down, the status of the track object is Negative. To display the IPv6 protocol status of an interface, use the display ipv6 interface command .
delay: Specifies that the track module notifies the application modules of the track entry status change after a specified delay time. If this keyword is not provided, the track module notifies the application modules immediately when the track entry status changes.
negative negative-time: Specifies the delay time for the track module to notify the application modules that the status of the track entry changes to Negative. negative-time represents the delay time, ranging from 1 to 300, in seconds.
positive positive-time: Specifies the delay time for the track module to notify the application modules that the status of the track entry changes to Positive. positive-time represents the delay time, ranging from 1 to 300, in seconds.
Description
Use the track interface protocol command to create a track entry to be associated with the protocol status of a specified interface, and specify the delay time for the track module to notify the application modules when the status of the track entry changes.
Use the undo track command to remove the created track entry.
By default, no track entry to be associated with the protocol status of a specified interface is created.
Note that:
l After a track entry is created, you cannot modify the content associated with the track entry. Remove the track entry, and then reconfigure it.
l To modify the delay time for the track module to notify the application modules of the track entry status change after a track entry is created, use the track interface protocol delay command .
Related commands: display track, display ip interface brief in IP Addressing Commands in the Command Reference - Part 4 - IP Services, display ipv6 interface in IPv6 Basics Commands in the Command Reference - Part 4 - IP Services.
Examples
# Create track entry 1 to be associated with the IPv4 protocol status of VLAN-interface 2.
<Sysname> system-view
[Sysname] track 1 interface vlan-interface 2 protocol ipv4
