Track commands -- display track

Use display track to display track entry information.

Syntax

display track { track-entry-number | all [ negative | positive ] } [ brief ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

track-entry-number: Specifies the track entry ID in the range of 1 to 1024.

all: Specifies all track entries.

negative: Specifies track entries in Negative state.

positive: Specifies track entries in Positive state.

brief: Displays brief information about track entries.

Examples

# Display information about all track entries. (Applicable to routers.)

<Sysname> display track all

Track ID: 1

State: Positive

Duration: 0 days 0 hours 0 minutes 7 seconds

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

Tracked object:

NQA entry: admin test

Reaction: 10

Remote IP/URL: --

Local IP: --

Interface: --

Track ID: 2

State: NotReady

Duration: 0 days 0 hours 0 minutes 32 seconds

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

Tracked object:

BFD session mode: Echo

Outgoing interface: GigabitEthernet1/0/1

VPN instance name: --

Remote IP: 192.168.40.1

Local IP: 192.168.40.2

Track ID: 3

State: Negative

Duration: 0 days 0 hours 0 minutes 32 seconds

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

Tracked object:

Interface: GigabitEthernet1/0/2

Protocol: IPv4

Track ID: 4

State: Negative

Duration: 0 days 0 hours 0 minutes 32 seconds

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

Tracked object:

CFD service instance: MEP 2 in Ethernet service instance 1

Track ID: 5

State: Positive

Duration: 0 days 0 hours 0 minutes 32 seconds

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

Tracked object:

IP route: 0.0.0.0/0 reachability

VPN instance name: --

Protocol: BGP

Nexthop interface : GigabitEthernet1/0/3

Track ID: 6

State: Positive

Duration: 0 days 0 hours 0 minutes 32 seconds

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

Tracked object:

LLDP interface: GigabitEthernet1/0/4

# Display information about track entries in Negative state. (Applicable to routers.)

<Sysname> display track all negative brief

ID Status Type Remote IP/URL Local IP Interface

1 Negative Interface -- -- GE1/0/1

10 Negative Interface -- -- GE1/0/2

# Display information about all track entries. (Applicable to switches.)

<Sysname> display track all

Track ID: 1

State: Positive

Duration: 0 days 0 hours 0 minutes 7 seconds

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

Tracked object:

NQA entry: admin test

Reaction: 10

Remote IP/URL: --

Local IP: --

Interface: --

Track ID: 2

State: NotReady

Duration: 0 days 0 hours 0 minutes 32 seconds

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

Tracked object:

BFD session mode: Echo

Outgoing interface: Vlan-interface2

VPN instance name: --

Remote IP: 192.168.40.1

Local IP: 192.168.40.2

Track ID: 3

State: Negative

Duration: 0 days 0 hours 0 minutes 32 seconds

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

Tracked object:

Interface: Vlan-interface3

Protocol: IPv4

Track ID: 4

State: Negative

Duration: 0 days 0 hours 0 minutes 32 seconds

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

Tracked object:

CFD service instance: MEP 2 in Ethernet service instance 1

Track ID: 5

State: Positive

Duration: 0 days 0 hours 0 minutes 32 seconds

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

Tracked object:

IP route: 0.0.0.0/0 reachability

VPN instance name: --

Protocol: BGP

Nexthop interface : Vlan-Interface4

Track ID: 6

State: Positive

Duration: 0 days 0 hours 0 minutes 32 seconds

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

Tracked object:

LLDP interface: Vlan-interface4

# Display information about track entries in Negative state. (Applicable to switches.)

<Sysname> display track all negative brief

ID Status Type Remote IP/URL Local IP Interface

1 Negative Interface -- -- Vlan2

10 Negative Interface -- -- Vlan3

Table 1 Command output

Field | Description
Track ID | ID of a track entry.
State | States of a track entry: · Positive—The tracked object operates correctly. · NotReady—The tracked object is invalid. · Negative—The tracked object is abnormal.
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.
Tracked object | Tracked object associated with the track entry.
NQA entry | NQA operation associated with the track entry.
Reaction | Reaction entry associated with the track entry.
BFD session mode | BFD session mode. Only echo mode is supported.
Outgoing interface | Outgoing interface of BFD echo packets.
VPN instance name | ‌ Name of the VPN instance to which BFD session packets belong. If the packets belong to the public network, two consecutive hyphens (--) are displayed.
Remote IP/URL | Remote IP address or URL. If no remote IP address or URL exists, two consecutive hyphens (--) are displayed.
Local IP | Local IP address. If no local IP address exists, two consecutive hyphens (--) are displayed.
Interface | Interface to be monitored. If no interface is to be monitored, two consecutive hyphens (--) are displayed.
Protocol | Link states or Layer 3 protocol states of the monitored interface: · None—Link 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.
IP route | Route associated with the track entry.
VPN instance name | ‌ Name of the VPN instance to which the route belongs. If the route belongs to the public network, two consecutive hyphens (--) are displayed.
Protocol | Protocol type of the route. If the route does not exist, N/A is displayed.
Nexthop interface | Next hop of the route. If the route does not exist, N/A is displayed.
LLDP interface | Monitored LLDP interface.
Type | Monitored object type: · BFD. · CFD. · Interface. · LLDP. · NQA. · Route.

Related commands

track bfd

track cfd

track interface

track interface physical

track interface protocol

track ip route reachability

track lldp neighbor

track nqa

Track commands -- track bfd

Use track bfd to create a track entry and associate it with a BFD session.

Use undo track to remove the track entry.

Syntax

track track-entry-number bfd echo interface interface-type interface-number remote ip remote-ip-address local ip local-ip-address [ delay { negative negative-time | positive positive-time } * ]

undo track track-entry-number

Default

No track entries exist.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

track-entry-number: Specifies the track entry ID in the range of 1 to 1024.

interface interface-type interface-number: Specifies the outgoing interface by its type and number of the BFD echo packets.

remote ip remote-ip-address: Specifies the destination IP address of the BFD echo packets.

local ip local-ip-address: Specifies the source IP address of the BFD echo packets.

delay: Specifies the delay before the Track module notifies the application modules of the track entry state change. If you do not specify this keyword, the Track module notifies the application modules immediately when the track entry state changes.

negative negative-time: Specifies the delay before the Track module notifies the application modules that the track entry state has changed to Negative. The negative-time argument represents the notification delay in the range of 1 to 300 seconds.

positive positive-time: Specifies the delay before the Track module notifies the application modules that the track entry state has changed to Positive. The positive-time argument represents the notification delay in the range of 1 to 300 seconds.

Usage guidelines

After a track entry is created, you can only use the track bfd delay command to modify its notification delay settings. If you execute the track bfd delay command multiple times, the most recent configuration takes effect.

To modify other settings for the track entry, execute the undo track command to remove the track entry, and then execute the track bfd command again.

When you associate Track with BFD, the virtual IP address of a VRRP group cannot be the local or remote address of a BFD session.

Examples

# Associate track entry 1 with 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 through GigabitEthernet 1/0/1. (Applicable to routers.)

<Sysname> system-view

[Sysname] track 1 bfd echo interface gigabitethernet 1/0/1 remote ip 192.168.40.1 local ip 192.168.40.2

# Associate track entry 1 with BFD to monitor the link between local IP address 1.1.1.2 and remote IP address 1.1.1.1 by sending BFD echo packets through VLAN-interface 2. (Applicable to switches.)

<Sysname> system-view

[Sysname] track 1 bfd echo interface vlan-interface 2 remote ip 1.1.1.1 local ip 1.1.1.2

Related commands

display track

Track commands -- track cfd

Use track cfd to create a track entry and associate it with CFD.

Use undo track to remove the track entry.

Syntax

track track-entry-number cfd cc service-instance instance-id mep mep-id [ delay { negative negative-time | positive positive-time } * ]

undo track track-entry-number

Default

No track entries exist.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

track-entry-number: Specifies the track entry ID in the range of 1 to 1024.

service-instance instance-id: Specifies a service instance by its ID in the range of 1 to 32767.

mep mep-id: Specifies a MEP by its ID in the range of 1 to 8191.

delay: Specifies the delay before the Track module notifies the application modules of the track entry state change. If you do not specify this keyword, the Track module notifies the application modules immediately when the track entry state changes.

negative negative-time: Specifies the delay before the Track module notifies the application modules that the track entry state has changed to Negative. The negative-time argument represents the notification delay in the range of 1 to 300 seconds.

positive positive-time: Specifies the delay before the Track module notifies the application modules that the track entry state has changed to Positive. The positive-time argument represents the notification delay in the range of 1 to 300 seconds.

Usage guidelines

After a track entry is created, you can only use the track cfd delay command to modify its notification delay settings. If you execute the track cfd delay command multiple times, the most recent configuration takes effect.

To modify other settings for the track entry, execute the undo track command to remove the track entry, and then execute the track cfd command again.

Examples

# Create track entry 1 and specify the CFD service instance ID as 2 and MEP ID as 3.

<Sysname> system-view

[Sysname] track 1 cfd cc service-instance 2 mep 3

Related commands

cfd mep

cfd service-instance

display track

Track commands -- track interface

Use track interface to create a track entry and associate it with the link state of an interface.

Use undo track to remove the track entry.

Syntax

track track-entry-number interface interface-type interface-number [ delay { negative negative-time | positive positive-time } * ]

undo track track-entry-number

Default

No track entries exist.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

track-entry-number: Specifies the track entry ID in the range of 1 to 1024.

interface-type interface-number: Specifies an interface by its type and number.

delay: Specifies the delay before the Track module notifies the application modules of the track entry state change. If you do not specify this keyword, the Track module notifies the application modules immediately when the track entry state changes.

negative negative-time: Specifies the delay before the Track module notifies the application modules that the track entry state has changed to Negative. The negative-time argument represents the notification delay in the range of 1 to 300 seconds.

positive positive-time: Specifies the delay before the Track module notifies the application modules that the track entry state has changed to Positive. The positive-time argument represents the notification delay in the range of 1 to 300 seconds.

Usage guidelines

When you associate Track with interface management to monitor the link status of an interface, the track entry state changes as follows:

· The track entry state is Positive if the link state of the interface is up.

· The track entry state is Negative if the link state of the interface is down.

To display the link state of an interface, use the display ip interface brief command.

After a track entry is created, you can only use the track interface delay command to modify its notification delay settings. If you execute the track interface delay command multiple times, the most recent configuration takes effect.

To modify other settings for the track entry, execute the undo track command to remove the track entry, and then execute the track interface command again.

Examples

# Create track entry 1 and associate it with the link state of interface GigabitEthernet 1/0/1. (Applicable to routers.)

<Sysname> system-view

[Sysname] track 1 interface gigabitethernet 1/0/1

# Create track entry 1 and associate it with the link state of interface VLAN-interface 10. (Applicable to switches.)

<Sysname> system-view

[Sysname] track 1 interface vlan-interface 10

Related commands

display ip interface brief (Layer 3—IP Services Command Reference)

display track

Track commands -- track interface physical

Use track interface physical to create a track entry and associate it with the physical state of an interface.

Use undo track to remove the track entry.

Syntax

track track-entry-number interface interface-type interface-number physical [ delay { negative negative-time | positive positive-time } * ]

undo track track-entry-number

Default

No track entries exist.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

track-entry-number: Specifies the track entry ID in the range of 1 to 1024.

interface-type interface-number: Specifies an interface by its type and number.

delay: Specifies the delay before the Track module notifies the application modules of the track entry state change. If you do not specify this keyword, the Track module notifies the application modules immediately when the track entry state changes.

negative negative-time: Specifies the delay before the Track module notifies the application modules that the track entry state has changed to Negative. The negative-time argument represents the notification delay in the range of 1 to 300 seconds.

positive positive-time: Specifies the delay before the Track module notifies the application modules that the track entry state has changed to Positive. The positive-time argument represents the notification delay in the range of 1 to 300 seconds.

Usage guidelines

After a track entry is created, you can only use the track interface physical delay command to modify its notification delay settings. If you execute the track interface physical delay command multiple times, the most recent configuration takes effect.

To modify other settings for the track entry, execute the undo track command to remove the track entry, and then execute the track interface physical command again.

Examples

# Create track entry 1 and associate it with the physical state of GigabitEthernet 1/0/1. (Applicable to routers.)

<Sysname> system-view

[Sysname] track 1 interface gigabitethernet 1/0/1 physical

# Create track entry 1 and associate it with the physical state of VLAN-interface 2. (Applicable to switches.)

<Sysname> system-view

[Sysname] track 1 interface vlan-interface 2 physical

Track commands -- track interface protocol

Use track interface protocol to create a track entry and associate it with the protocol state of an interface.

Use undo track to remove the track entry.

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

Default

No track entries exist.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

track-entry-number: Specifies the track entry ID in the range of 1 to 1024.

interface-type interface-number: Specifies an interface by its type and number.

ipv4: Monitors the IPv4 protocol state. When the IPv4 protocol state of an interface is up, the state of the track object is Positive. When the IPv4 protocol state of an interface is down, the state of the track object is Negative. To display the IPv4 protocol state of an interface, use the display ip interface brief command.

ipv6: Monitors the IPv6 protocol state. When the IPv6 protocol state of an interface is up, the state of the track object is Positive. When the IPv6 protocol state of an interface is down, the state of the track object is Negative. To display the IPv6 protocol state of an interface, use the display ipv6 interface brief command.

delay: Specifies the delay before the Track module notifies the application modules of the track entry state change. If you do not specify this keyword, the Track module notifies the application modules immediately when the track entry state changes.

negative negative-time: Specifies the delay before the Track module notifies the application modules that the track entry state has changed to Negative. The negative-time argument represents the notification delay in the range of 1 to 300 seconds.

positive positive-time: Specifies the delay before the Track module notifies the application modules that the track entry state has changed to Positive. The positive-time argument represents the notification delay in the range of 1 to 300 seconds.

Usage guidelines

After a track entry is created, you can only use the track interface protocol delay command to modify its notification delay settings. If you execute the track interface protocol delay command multiple times, the most recent configuration takes effect.

To modify other settings for the track entry, execute the undo track command to remove the track entry, and then execute the track interface protocol command again.

Examples

# Create track entry 1 and associate it with the IPv4 protocol state of interface GigabitEthernet 1/0/1. (Applicable to routers.)

<Sysname> system-view

[Sysname] track 1 interface gigabitethernet 1/0/1 protocol ipv4

# Create track entry 1 and associate it with the IPv4 protocol state of interface VLAN-interface 2. (Applicable to switches.)

<Sysname> system-view

[Sysname] track 1 interface vlan-interface 2 protocol ipv4

Related commands

display ip interface brief (Layer 3—IP Services Command Reference)

display ipv6 interface brief (Layer 3—IP Services Command Reference)

display track

Track commands -- track ip route reachability

Use track ip route reachability to create a track entry and associate it with a route entry.

Use undo track to remove the track entry.

Syntax

track track-entry-number ip route [ vpn-instance vpn-instance-name ] ip-address { mask-length | mask } reachability [ delay { negative negative-time | positive positive-time } * ]

undo track track-entry-number

Default

No track entries exist.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

track-entry-number: Specifies the track entry ID in the range of 1 to 1024.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, this command creates the track entry for routes on the public network.

ip-address: Specifies the IP address of the route entry associated with the track entry in dotted decimal notation.

mask-length: Specifies the mask length in the range of 0 to 32.

mask: Specifies the mask of the IP address, in dotted decimal notation.

delay: Specifies the delay before the Track module notifies the application modules of the track entry state change. If you do not specify this keyword, the Track module notifies the application modules immediately when the track entry state changes.

negative negative-time: Specifies the delay before the Track module notifies the application modules that the track entry state has changed to Negative. The negative-time argument represents the notification delay in the range of 1 to 300 seconds.

positive positive-time: Specifies the delay before the Track module notifies the application modules that the track entry state has changed to Positive. The positive-time argument represents the notification delay in the range of 1 to 300 seconds.

Usage guidelines

After a track entry is created, you can only use the track ip route reachability delay command to modify its notification delay settings. If you execute the track ip route reachability delay command multiple times, the most recent configuration takes effect.

To modify other settings for the track entry, execute the undo track command to remove the track entry, and then execute the track ip route reachability command again.

Route management does not immediately notify the Track module of the route status changes when the following conditions are met:

· An active/standby device switchover or a RIB process switchover has occurred.

· The status of the monitored route entry is changed before the routing protocol completes the graceful restart.

You can resolve the problem by configuring the nonstop routing feature.

Examples

# Create track entry 1 to monitor the status of the route entry 10.1.1.0/24.

<Sysname> system-view

[Sysname] track 1 ip route 10.1.1.0 24 reachability

Related commands

display ip route (Layer 3—IP Routing Command Reference)

display track

Track commands -- track lldp neighbor

Use track lldp neighbor to create a track entry and associate it with the neighbor availability status of an LLDP interface.

Use undo track to remove the track entry.

Syntax

track track-entry-number lldp neighbor interface interface-type interface-number [ delay { negative negative-time | positive positive-time } * ]

undo track track-entry-number

Default

No track entries exist.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

track-entry-number: Specifies the track entry ID in the range of 1 to 1024.

interface interface-type interface-number: Specifies an LLDP interface by its type and number.

delay: Specifies the delay before the Track module notifies the application modules of the track entry state change. If you do not specify this keyword, the Track module notifies the application modules immediately when the track entry state changes.

negative negative-time: Specifies the delay before the Track module notifies the application modules that the track entry state has changed to Negative. The negative-time argument represents the notification delay in the range of 1 to 300 seconds.

positive positive-time: Specifies the delay before the Track module notifies the application modules that the track entry state has changed to Positive. The positive-time argument represents the notification delay in the range of 1 to 300 seconds.

Usage guidelines

After a track entry is created, you can only use the track lldp neighbor delay command to modify its notification delay settings. If you execute the track lldp neighbor delay command multiple times, the most recent configuration takes effect.

To modify other settings for the track entry, execute the undo track command to remove the track entry, and then execute the track lldp neighbor command again.

Examples

# Create track entry 1 to monitor the neighbor availability status of GigabitEthernet1/0/1

<Sysname> system-view

[Sysname] track 1 lldp neighbor interface gigabitethernet 1/0/1

Related commands

display track

Track commands -- track nqa

Use track nqa to create a track entry and associate it with the reaction entry of an NQA operation.

Use undo track to remove the track entry.

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

Default

No track entries exist.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

track-entry-number: Specifies the track entry ID in the range of 1 to 1024.

entry admin-name operation-tag: Specifies the NQA operation to be associated with the track entry. The admin-name argument specifies the name of the NQA operation administrator who creates the NQA operation, and is a case-insensitive string of 1 to 32 characters. The operation-tag argument specifies 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. The item-number argument is the reaction entry ID in the range of 1 to 10.

delay: Specifies the delay before the Track module notifies the application modules of the track entry state change. If you do not specify this keyword, the Track module notifies the application modules immediately when the track entry state changes.

negative negative-time: Specifies the delay before the Track module notifies the application modules that the track entry state has changed to Negative. The negative-time argument represents the notification delay in the range of 1 to 300 seconds.

positive positive-time: Specifies the delay before the Track module notifies the application modules that the track entry state has changed to Positive. The positive-time argument represents the notification delay in the range of 1 to 300 seconds.

Usage guidelines

After a track entry is created, you can only use the track nqa delay command to modify its notification delay settings. If you execute the track nqa delay command multiple times, the most recent configuration takes effect.

To modify other settings for the track entry, execute the undo track command to remove the track entry, and then execute the track nqa command again.

Examples

# Create track entry 1 and associate it with reaction entry 3 of the NQA operation admin-test.

<Sysname> system-view

[Sysname] track 1 nqa entry admin test reaction 3

Related commands

display track