Citrix ADC High Availability Counters

Citrix ADC High Availability Counters

book

Article ID: CTX131802

calendar_today

Updated On:

Description

This article contains information about the newnslog High Availability (HA) counters and their brief description.

Using the Counters

Log on to the NetScaler using an SSH client, change to SHELL, navigate to the /var/nslog directory, and then use the ‘nsconmsg’ command to see comprehensive statistics using the different counters available. For the detailed procedure refer to Citrix Blog - NetScaler ‘Counters’ Grab-Bag!.

The newnslog HA Counter

The following table lists the newnslog HA counters with a brief description of the counter.

newnslog Counter

Description

ha_cur_deadinterval

HA Dead Interval in 10ms.

ha_cur_derived_inc

Derived incarnation based on IOCTLs received.

ha_cur_drop_bpdu

Flag to drop BPDU packets.

ha_cur_hellointerval

HA Hello Interval in 10ms.

ha_cur_inc_state

Independent network configuration state.

ha_cur_init_time

The counter tracks the time until end of initialization.

ha_cur_l3

HA over L3.

ha_cur_master_state

This counter indicates the high availability state of the node. Possible values are:

  • STAYSECONDARY – Indicates that the selected node remains as the secondary node in a high availability setup. In this case a forced failover does not change the state instead, returns an appropriate error message. This is a configured value and not a statistic.
  • PRIMARY – Indicates that the selected node is the primary node in a high availability setup.
  • SECONDARY – Indicates that the selected node is the secondary node in a high availability setup.
  • CLAIMING – Indicates that the secondary node is in the process of taking over as the primary node. This is the intermediate state in the transition of the secondary node to primary status.
  • FORCE CHANGE - Indicates that the secondary node is forcibly changing its status to primary due to a forced failover issued on the secondary node.

ha_cur_nics_hw_monitor

NICs that are monitored.

ha_cur_nics_sw_monitor

This counter tracks the Network Interface Cards (NICs) that are monitored by heart beat.

ha_cur_nodes_num

The counter tracks whether a NetScaler appliance is configured as a high availability setup. Possible values are YES and NO. If the value is NO, the following high availability statistics are invalid.

ha_cur_nodes_num_dummy

The counter tracks the dummy entry to prevent API breakage.

ha_cur_peer_inc

The peer node incarnation as detected by the heart beats.

ha_cur_sync_time

The time at which the next synchronize starts.

ha_cur_system_state

The counter tracks the state of the HA node, based on its health, in a high availability setup. Possible values are:

  • UP – Indicates that the node is accessible and can function as either a primary or secondary node.
  • DISABLED – Indicates that the high availability status of the node is manually disabled. Synchronization and propagation cannot take place between the peer nodes.
  • INIT – Indicates that the node is in the process of becoming part of the high availability configuration.
  • PARTIALFAIL – Indicates that one of the high availability monitored interfaces has failed because of a card or link failure. This state triggers a failover.
  • COMPLETEFAIL – Indicates that all the interfaces of the node are unusable, because the interfaces on which high availability monitoring is enabled are not connected or are manually disabled. This state triggers a failover.
  • DUMB – Indicates that the node is in listening mode. It does not participate in high availability transitions or transfer configuration from the peer node. This is a configured value, not a statistic.
  • PARTIALFAILSSL – Indicates that the SSL card has failed. This state triggers a failover.
  • ROUTEMONITORFAIL – Indicates that the route monitor has failed. This state triggers a failover.

ha_cur_system_state_dummy

The counter tracks the dummy entry to prevent API breakage.

ha_err_bad_app_id

The counter tracks the number of times HA heartbeat was detected with an invalid app_id.

ha_err_bad_master_state

The counter tracks the number of times HA heart beat was detected with an invalid master state.

ha_err_bad_packet_length

The counter tracks the number of times HA heart beat was detected with a different packet size.

ha_err_bad_state

The counter tracks the number of times HA heart beat was detected with an invalid state.

ha_err_bad_type

The counter tracks the number of times HA heart beat was detected with an invalid type.

ha_err_heartbeat

The counter tracks the number of times heart beats are detected after losing them after a dead interval.

ha_err_master_dispute

The counter tracks the number of HA master disputes.

ha_err_nodes_down

The counter tracks the total number of heart beats missed when the state of the peer node was marked as DOWN.

ha_err_nsb_mem_fail

The counter tracks the total number of times memory allocation failed while sending heart beats.

ha_err_pkt_rx_dst_mac

The counter tracks the number of packets received with the wrong destination MAC address.

ha_err_pkt_rx_no_sw_monitor

The counter tracks the number of packets received on unmonitored links.

ha_err_pkt_rx_node

The counter tracks the number of packets received that were not from an HA node.

ha_err_pkt_rx_not_init

The counter tracks the number of non-INIT packets received from a node with the state marked as DOWN.

ha_err_pkt_rx_sig

The counter tracks the number of packets received with wrong signature.

ha_err_pkt_rx_sn

The counter tracks the number of packets received with the same SEQ number.

ha_err_pkt_rx_ver

The counter tracks the number of packets received with wrong version.

ha_err_prop_mem_fail

The counter tracks the total number of times memory allocation failed during command propagation.

ha_err_prop_timeout

The counter tracks the number of times propagation timed out.

ha_err_silent

The counter tracks the total number of times heart beat packets that were not received on any enabled interface for the duration of the Dead Interval.

ha_err_sw_monitor_fail

The counter tracks the total number of times heart beats were not received from the peer node within the Hello Interval time. (OBSOLETE)

ha_err_sync_failure

The counter tracks the number of times the configuration of the primary and secondary nodes failed to synchronize since the last transition. A synchronization failure results in mismatched configuration. It can be caused by a mismatch in the Remote Procedural Call (RPC) password on the two nodes forming the high availability setup.

ha_tot_arp_mac_updates

The counter tracks the number of ARP MAC updates.

ha_tot_bpdu_dropped

The counter tracks the number of BPDU packets dropped.

ha_tot_cfg_flush

The counter tracks the number of times the NetScaler configuration was flushed.

ha_tot_cfgsyncs

The counter tracks the number of times the HA nodes synchronized configurations.

ha_tot_hb_mac_updates

The counter tracks the number of Heartbeat MAC updates.

ha_tot_master_change

The counter tracks the total number of master state changes that the NetScaler appliance has made from primary to secondary and vice-versa.

ha_tot_master_claim

The counter tracks the number of Master claims.

ha_tot_pkt_rx

The counter tracks the number of heart beat packets received from the peer node. Heart beats are sent at regular intervals (default is 200 milliseconds) to determine the state of the peer node.

ha_tot_pkt_tx

The counter tracks the number of heartbeat packets sent to the peer node. Heartbeats are sent at regular intervals (default is 200 milliseconds) to determine the state of the peer node.

ha_tot_prop_ioctlq_extract

The counter tracks the number of IOCTLs extracted from the queue for propagation.

ha_tot_recovers_num

The counter tracks the total number of times HA engine recovered from tight loops. Total number of times HA timers are not called for MAX down time.

ha_tot_reqd_init

The counter tracks the number of REQ_INIT packets received

ha_tot_state_fail

The counter tracks the number of times state changed to PARTIAL_FAIL/PARTIAL_FAIL_SSL/ROUTEMONITOR_FAIL/COMPLETE_FAIL.

ha_tot_state_init

The counter tracks the number of times state changed to INIT.

ha_tot_state_up

The counter tracks the number of times state changed to UP.

sys_cur_last_transition_time

The counter tracks the time when the last master state transition occurred. You can use this statistic for debugging.

Issue/Introduction

This article contains information about the newnslog High Availability (HA) counters and their brief description.