display isis spf-log

Function

The display isis spf-log command displays the SPF calculation log of IS-IS.

Format

display isis spf-log [ process-id | vpn-instance vpn-instance-name ] [ ipv6 | [ level-1 | level-2 ] | verbose ] ^*

display isis process-id spf-log [ ipv6 | [ level-1 | level-2 ] | verbose ] ^*

Parameters

Parameter	Description	Value
process-id	Specifies the IS-IS process ID.	The value is an integer ranging from 1 to 65535.
vpn-instance vpn-instance-name	Displays SPF calculation logs about the multi-instance IS-IS process in the specified VPN instance.	The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.
ipv6	Displays SPF calculation logs in the IPv6 topology.	-
level-1	Displays SPF calculation logs on the IS-IS Level 1 routers.	-
level-2	Displays SPF calculation logs on the IS-IS Level 2 routers.	-
verbose	Displays the details of SPF calculation logs.	-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

If the SPT calculated by IS-IS is incorrect, you can run the display isis spf-log command to diagnose the fault. The command displays information about SPF calculation, such as the start time and duration of the SPF calculation, number of nodes, and events that trigger the SPF calculation. You can determine whether the events are the cause of the SPF calculation fault based on the start time of the SPF calculation.

Example

# View the SPF calculation log of IS-IS.

<sysname> display isis spf-log

                      SPF Log information for ISIS(1)
                        -------------------------------

                            ISIS(1) Level-1 SPF Log
                            -----------------------

 StartTime  Duration  Nodes  Count  Last Trigger LSP      Trigger Event
-------------------------------------------------------------------------------
 2011-08-14 13:14:55-08:00
            0         0      4      NULL                  ISPF_CIRC_DR_CHANGE
 2011-08-12 16:17:33-08:00
            0         0      4      1111.1111.1111.00-00  ISPF_CIRC_DR_CHANGE
 2011-08-12 16:16:23-08:00
            0         1      4      NULL                  FULL_SPF

<sysname> display isis spf-log verbose

                      SPF Log information for ISIS(1)
                        -------------------------------

                            ISIS(1) Level-1 SPF Log
                            -----------------------

 StartTime  Duration  Nodes  Count  Last Trigger LSP      Trigger Event
-------------------------------------------------------------------------------
 2011-08-14 13:14:55-08:00
            0         0      4      NULL                  ISPF_CIRC_DR_CHANGE
                                    NULL                  PRC_IPV4_PREFIX_ADD
                                    NULL                  ISPF_ADJ_STATE_CHANGE
                                    NULL                  ISPF_ADJ_USAGE_CHANGE
 2011-08-12 16:17:33-08:00
            0         0      2      1111.1111.1111.00-00  ISPF_CIRC_DR_CHANGE
                                    NULL                  LFA_LINK_DEL
 2011-08-12 16:16:23-08:00
            0         1      4      NULL                  FULL_SPF
            0         1      4      NULL                  FULL_SPF
            0         1      4      NULL                  FULL_SPF
            0         1      4      NULL                  FULL_SPF

**Table 1** Description of the display isis spf-log command output
Item	Description
StartTime	Start time of the SPF calculation in the format of YYYY-MM-DD hh:mm:ss-time zone
Duration	Time taken for the SPF calculation, in milliseconds
Nodes	Number of nodes whose SPT changes due to the SPF calculation
Count	Number of events that an IS-IS-enabled router receives during an SPF calculation interval
Last Trigger LSP	Most recent LSP that triggers the SPF calculation during an SPF calculation interval NULL indicates that the LSP is local. LSP ID (specific ID) indicates that the LSP is not local.
Trigger Event	Most recent event that triggers the SPF calculation: NEWAREA indicates that a new NET is configured. TUNNEL_ADJ indicates that a tunnel neighbor relationship is established. ADJDOWN indicates that a tunnel neighbor goes Down. NEWLSP indicates that the router receives an LSP of a new process. LSPCHANGE indicates that the received LSP is different from local LSPs. RST_T2_CANCEL indicates that the GR T2 Timer is disabled. RST_T3_EXPIRE indicates that the GR T3 Timer expires. RESTART_COMPLETE indicates that the GR is over. CIRC_VLINK_CHANGE indicates that the status of the VLink interface changes. PRC_IPV4_PREFIX_ADD indicates that an IPv4 route is added. PRC_IPV4_PREFIX_DEL indicates that an IPv4 route is deleted. PRC_IPV4_PREFIX_MODIFY indicates that an IPv4 route is modified. PRC_IPV4_PREFIX_MIGP_ADD indicates that an MIGP IPv4 route is added. PRC_IPV4_PREFIX_MIGP_DEL indicates that an MIGP IPv4 route is deleted. PRC_IPV4_PREFIX_MIGP_MODIFY indicates that an MIGP IPv4 route is modified. PRC_IPV6_PREFIX_ADD indicates that an IPv6 route is added. PRC_IPV6_PREFIX_DEL indicates that an IPv6 route is deleted. PRC_IPV6_PREFIX_MODIFY indicates that an IPv6 route is modified. ISPF_ADJ_STATE_CHANGE indicates that the IS-IS neighbor status changes. ISPF_ADJ_USAGE_CHANGE indicates that the IS-IS neighbor level changes. ISPF_ADJ_PROT_USAGE_CHANGE indicates that the protocol used by the IS-IS neighbor changes. ISPF_ADJ_NEXTHOP_CHANGE indicates that the next hop of the IS-IS neighbor changes. ISPF_CIRC_METRIC_CHANGE indicates that the cost on the interface changes. ISPF_CIRC_DR_CHANGE indicates that the DIS changes. ISPF_NODE_DEL indicates that the nodes in the SPT change. ISPF_NODE_OLOAD_CHANGE indicates that the overload bit of the system changes. ISPF_LINK_ADD indicates that a new link is added to the SPT. ISPF_LINK_DEL indicates that a link is deleted from the SPT. ISPF_LINK_METRIC_CHANGE indicates that the cost of a link changes. FULL_SPF indicates that a full SPF calculation is triggered. AREA_CFG_CHANGE indicates that the area of the process changes. AREA_LEARNT_CHANGE indicates that the area of the IS-IS neighbor changes. ISPF_TUNNEL_TYPE_CHANGE indicates that the tunnel type changes. PRC_LEAVE_MAN_OVERLOAD indicates that the system exits the set-overload state that is set manually. PRC_IPV4_SELFLSP_CHANGE indicates that the IPv4 route in the local LSP changes. PRC_IPV6_SELFLSP_CHANGE indicates that the IPv6 route in the local LSP changes. PRC_ALIAS_TLV_CHANGE indicates that the ALIAS TLV in the LSP changes. LFA_LINK_ADD indicates that a link is added to the routes for FRR. LFA_LINK_DEL indicates that a link is deleted from the routes for FRR. LFA_LINK_CHANGE indicates that the links of the routes for FRR change. LFA_NODE_ADD indicates that a node is added along the links of the routes for FRR. LFA_NODE_DEL indicates that a node is deleted from the links of the routes for FRR. LFA_NODE_CHANGE indicates that the nodes along the links of the routes for FRR change. KEY_RESRORE indicates that the local device receives an indirect next hop key.