Track configuration commands 1

display track· 1

track bfd echo· 3

track interface· 4

track interface protocol 5

track nqa· 6

 

display track

Syntax

display track { track-entry-number | all } [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

track-entry-number: Displays information about the specified track entry, in the range of 1 to 1024.

all: Displays information about all the track entries.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use the display track command to display track entry information.

Examples

# Display information about all track entries.

<Sysname> display track all

Track ID: 1

  Status: Positive (notify 13 seconds later)

  Duration: 0 days 0 hours 0 minutes 7 seconds

  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 0 minutes 32 seconds

  Notification delay: Positive 20, Negative 30 (in seconds)

  Reference object:

    BFD session:

    Packet type: Echo

    Interface   : GigabitEthernet 3/1/1

    Remote IP   : 192.168.40.1

    Local IP    : 192.168.40.2

Track ID: 3

  Status: Negative

  Duration: 0 days 0 hours 0 minutes 32 seconds

  Notification delay: Positive 20, Negative 30 (in seconds)

  Reference object:

    Track interface  :

    Interface status : Inserted

    Interface        : GigabitEthernet 3/1/9

    Protocol         : IPv4

Table 1 Output description

Field	Description
Track ID	ID of a track entry.
Status	Status of a track entry: ·       Positive—The tracked object functions properly. ·       Invalid—The tracked object is invalid. ·       Negative—The tracked object is abnormal.
notify 13 seconds later	The track module notifies the application modules of the track entry state change 13 seconds later. The information is not displayed after the track module notifies the application modules.
Duration	Time period during which the track entry stays in the state.
Notification delay: Positive 20, Negative 30 (in seconds)	·       The track module notifies the application modules that the status of the track entry changes to Positive after a delay time of 20 seconds. ·       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 tracked object associated with the track entry.
NQA entry	The NQA test group associated with the track entry.
Reaction	The reaction entry associated with the track entry.
BFD session	Information about the BFD session associated with the track entry.
Packet type	Type of the BFD session packets, which can only be Echo.
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: ·       Inserted ·       Removed
Interface	Interface to be monitored.
Protocol	Physical status or Layer 3 protocol status of the monitored interface: ·       None—Physical status of the monitored interface. ·       IPv4—IPv4 protocol status of the monitored Layer 3 interface. ·       IPv6—IPv6 protocol status of the monitored Layer 3 interface.

 

track bfd echo

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 of 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 destination IP address of the BFD echo packets.

local ip local-ip: Specifies the source 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 specific 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 in seconds, in the range of 1 to 300.

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 in seconds, in the range of 1 to 300.

Description

Use the track bfd echo command to create a track entry, associate it 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 track entry.

By default, no track entry exists.

After a track entry is created, you cannot change its settings except the delay time. To change the delay time for this track entry, use the track bfd echo delay command. To modify other settings of this track entry, first delete the entire track entry, and then recreate a new track entry.

When configuring collaboration between track and BFD, do not configure the virtual IP address of a VRRP group as the local or remote address of a BFD session.

Related commands: display track.

Examples

# Create track entry 1, which uses BFD to monitor the link between local IP address 192.168.40.2 and remote IP address 192.168.40.1 by sending BFD echo packets.

<Sysname> system-view

[Sysname] track 1 bfd echo interface GigabitEthernet 3/1/1 remote ip 192.168.40.1 local ip 192.168.40.2

track interface

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 of 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 specific 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 in seconds, in the range o 1 to 300.

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 in seconds, in the range of 1 to 300.

Description

Use the track interface command to create a track entry, associate it with the physical status of a specific 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 track entry.

By default, no track entry exists.

After a track entry is created, you cannot change its settings except the delay time. To change the delay time, use the track interface delay command. To modify other settings of this track entry, first delete the entire track entry, and then create a new track entry.

When a track entry to be associated with the physical status of a specific interface is created, the status of the track entry is Positive if the physical status of the interface is up. The status of the track entry is Negative if the physical status of the interface is down. To display the physical status of an interface, use the display ip interface brief command.

Related commands: display track; display ip interface brief (Layer 3—IP Services Command Reference).

Examples

# Create track entry 1 and associate it with the physical status of interface GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] track 1 interface GigabitEthernet 3/1/1

track interface protocol

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 of 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 specific 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 in seconds, in the range of 1 to 300.

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 in seconds, in the range of 1 to 300.

Description

Use the track interface protocol command to create a track entry, associate it with the protocol status of a specific 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 track entry.

By default, no track entry exists.

After a track entry is created, you cannot change its settings except the delay time. To change the delay time, use the track interface protocol delay command. To modify other settings of this track entry, first delete the entire track entry, and then recreate a new track entry.

Related commands: display track; display ip interface brief (Layer 3—IP Services Command Reference); display ipv6 interface (Layer 3—IP Services Command Reference).

Examples

# Create track entry 1 and associate it with the IPv4 protocol status of interface GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] track 1 interface GigabitEthernet 3/1/1 protocol ipv4

track nqa

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 of 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 NQA test group administrator who creates the NQA operation, and is a case-insensitive string of 1 to 32 characters. operation-tag is the NQA operation tag, and is a case-insensitive string of 1 to 32 characters.

reaction item-number: Specifies the reaction entry to be associated with the track entry. item-number is the reaction entry ID, in the range of 1 to 10.

delay: Specifies that the track module notifies the application modules of the track entry status change after a specific 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 in seconds, in the range of 1 to 300.

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 in seconds, in the range of 1 to 300.

Description

Use the track nqa command to create a track entry, associate it 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 track entry.

By default, no track entry to be associated with the track entry is created.

After a track entry is created, you cannot change its settings except the delay time. To change the delay time, use the track nqa delay command. To modify other settings of this track entry, first delete the entire track entry, and then recreate a new track entry.

Related commands: display track; nqa and reaction (Network Management and Monitoring Command Reference).

Examples

# Create track entry 1 and 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