Track

Object tracking monitors the state of interfaces, IP/IPv6 routes, IP SLA operations, or combinations of other track objects on NX-OS, and publishes an up/down state that first-hop redundancy protocols such as HSRP can react to, for example by decrementing the group priority when an uplink fails. Each track object is identified by a numeric ID and tracks exactly one of: interface line-protocol or IPv4/IPv6 routing state, IPv4 or IPv6 route reachability (optionally for HMM-owned routes and within a VRF), IP SLA reachability or state, or a track list combining multiple objects with boolean (and/or) or threshold (percentage/weight) logic. Optional up and down delays, in seconds or milliseconds, dampen state changes to avoid flapping.

Diagram

Classes

nxos

Name	Type	Constraint	Mandatory	Default Value
devices	List	devices	No
device_groups	List	device_groups	No
global	Class	global	No
templates	List	templates	No

devices (nxos)

Name	Type	Constraint	Mandatory	Default Value
configuration	Class	configuration	No

device_groups (nxos)

Name	Type	Constraint	Mandatory	Default Value
configuration	Class	configuration	No

global (nxos)

Name	Type	Constraint	Mandatory	Default Value
configuration	Class	configuration	No

templates (nxos)

Name	Type	Constraint	Mandatory	Default Value
configuration	Class	configuration	No

configuration (nxos.devices)

Name	Type	Constraint	Mandatory	Default Value
tracks	List	tracks	No

tracks (nxos.devices.configuration)

Name	Type	Constraint	Mandatory	Default Value
id	Integer	min: 1, max: 512	Yes
interface_type	Choice	ethernet, loopback, mgmt, port-channel, vlan, vni	No
interface_id	Any	String or Integer[min: 0]	No
interface_line_protocol	Boolean	true, false	No
interface_ip_routing	Boolean	true, false	No
interface_ipv6_routing	Boolean	true, false	No
ip_route	IP		No
ip_route_reachability_hmm	Boolean	true, false	No
ipv6_route	IP		No
ipv6_route_reachability_hmm	Boolean	true, false	No
ip_sla	Integer	min: 1, max: 2147483647	No
ip_sla_reachability	Boolean	true, false	No
ip_sla_state	Boolean	true, false	No
list_boolean	Choice	and, or	No
list_threshold	Choice	percentage, weight	No
vrf	String		No
delay_up	Integer	min: 0, max: 180	No
delay_down	Integer	min: 0, max: 180	No
delay_up_milliseconds	Integer	min: 100, max: 60000	No
delay_down_milliseconds	Integer	min: 100, max: 60000	No
threshold_percentage_up	Integer	min: 0, max: 100	No
threshold_percentage_down	Integer	min: 0, max: 100	No
threshold_weight_up	Integer	min: 0, max: 255	No
threshold_weight_down	Integer	min: 0, max: 255	No
objects	List	objects	No

objects (nxos.devices.configuration.tracks)

Name	Type	Constraint	Mandatory	Default Value
id	Integer	min: 1, max: 512	Yes
not	Boolean	true, false	No
weight	Integer	min: 1, max: 255	No

Examples

Example 1: Track uplink interface line-protocol with delayed state changes

nxos:
  devices:
    - name: LEAF1
      configuration:
        tracks:
          - id: 10
            interface_type: ethernet
            interface_id: 1/49
            interface_line_protocol: true
            delay_up: 20
            delay_down: 10

Example 2: Track IPv4 and IPv6 route reachability within a VRF

nxos:
  devices:
    - name: BORDER1
      configuration:
        tracks:
          - id: 20
            ip_route: 0.0.0.0/0
            vrf: TENANT-A
          - id: 21
            ipv6_route: ::/0
            vrf: TENANT-A
          - id: 22
            ip_route: 10.1.1.1/32
            ip_route_reachability_hmm: true
            vrf: TENANT-A

Example 3: Track IP SLA reachability with millisecond delays

nxos:
  devices:
    - name: LEAF1
      configuration:
        tracks:
          - id: 30
            ip_sla: 1
            ip_sla_reachability: true
            delay_up_milliseconds: 500
            delay_down_milliseconds: 200

Example 4: Boolean and weighted threshold track lists combining multiple uplinks

nxos:
  devices:
    - name: LEAF1
      configuration:
        tracks:
          - id: 11
            interface_type: ethernet
            interface_id: 1/49
            interface_line_protocol: true
          - id: 12
            interface_type: ethernet
            interface_id: 1/50
            interface_ip_routing: true
          - id: 100
            list_boolean: or
            objects:
              - id: 11
              - id: 12
          - id: 101
            list_threshold: weight
            threshold_weight_up: 20
            threshold_weight_down: 10
            objects:
              - id: 11
                weight: 10
              - id: 12
                weight: 10