show health

Description                                                    Show status information for health monitors.

Syntax                                                                  show health
{
database |
external
[name] |
gateway |
monitor [name] |
postfile [name] |
stat
[all-partitions | partition {shared | name}]
}

Parameter

Description

database

Show the database health check log.

external [name]

Shows configuration settings for the specified external health monitoring program.

gateway

Shows configuration settings and statistics for gateway health monitoring.

monitor [name]

Shows configuration settings and status for the specified health monitor.

postfile [name]

Shows the files used for POST requests in HTTP/HTTPS health checks.

stat

Shows health monitoring statistics. The statistics apply to all health monitoring activity on the ACOS device.

Mode                                                                   All

Usage                                                                  To display health monitor information for a specific partition only, use the partition name option.

Example                                                            The following command shows configuration settings and status for health monitor “ping”:

ACOS#show health monitor ping

Monitor Name:  ping

Interval:      30

Max Retry:     3

Timeout:       5

Status:        In use

Method:        ICMP

The output shows the method used for the monitor, and the settings for each of the parameters that are configurable for that method.

Example                                                            The following command shows the configuration settings of external health monitoring pro­gram “http.tcl”:

ACOS#show health external http.tcl

External Program                Description

http.tcl                        check http method

!!! Content Begin !!!

set ax_env(Result) 1

 

# Open a socket

if {[catch {socket $ax_env(ServerHost) $ax_env(ServerPort)} sock]} {

   puts stderr "$ax_env(ServerHost): $sock"

} else {

   fconfigure $sock -buffering none -eofchar {}

 

   # Send the request

puts $sock "GET / HTTP/1.0\n"

 

   # Wait for the response from http server

   set line [read $sock]

 

if { [ regexp "HTTP/1.. (\[0-9\]+) " $line match status] } {

      puts "server $ax_env(ServerHost) response : $status"

   }

close $sock

 

   # Check exit code

   if { $status == 200 } {

      set ax_env(Result) 0

   }

}

!!! Content End !!!

 

Example                                                            The following command shows health monitoring statistics:

ACOS#show health stat

Health monitor statistics

Total run time:                        : 2 hours 1345 seconds

Number of burst:                       : 0

max scan jiffie:                       : 326

min scan jiffie:                       : 1

average scan jiffie:                   : 1

Opened socket:                         : 1140

Open socket failed:                    : 0

Close socket:                          : 1136

Send packet:                           : 0

Send packet failed:                    : 259379

Receive packet:                        : 0

Receive packet failed                  : 0

Retry times:                           : 4270

Timeout:                               : 0

Unexpected error:                      : 0

Conn Immediate Success:                : 0

Socket closed before l7:               : 0

Socket closed without fd notify:       : 0

Configured health-check rate (/500ms)  : Auto configured

Current health-check rate (/500ms):    : 1600

External health-check max rate(/200ms) : 2

Total number:                          : 8009

Status UP:                             : 8009

Status DOWN:                           : 0

Status UNKN:                           : 0

Status OTHER:                          : 0

 

IP address           Port  Health monitor  Status Cause(Up/Down) Retry PIN

--------------------------------------------------------------------------------

10.0.0.11            80    http            UP     11 /0  @0      0     0  /0  0

10.0.0.12            80    http            UP     10 /0  @0      0     0  /0  0

The following table describes the fields in the command output.

Field

Description

Total run time

Time elapsed since the health monitoring process started.

Number of burst

Number of times the system detected that a health check would leave the ACOS device as a traffic burst, and remedied the situation.

max scan jiffie

These are internal counters used by technical support for debugging purposes.

min scan jiffie

average scan jiffie

Opened socket

Number of sockets opened.

Open socket failed

Number of failed attempts to open a socket.

Close socket

Number of sockets closed.

Send packet

Number of health check packets sent to the target of the health monitor.

Send packet failed

Number of sent health check packets that failed. (This is the number of times a tar­get server or service failed its health check.)

Receive packet

Number of packets received from the target in reply to health checks.

Receive packet failed

Number of failed receive attempts.

Retry times

Number of times a health check was resent because the target did not reply.

Timeout

Number of times a response was not received before the health check timed out.

Unexpected error

Number of unexpected errors that occurred.

Conn Immediate Success

These are internal counters used by technical support for debugging purposes.

Socket closed before l7

Socket closed without fd notify

Configured health-check rate

If auto-adjust is enabled, shows “Auto configured”.

If auto-adjust is disabled, shows the manually configured threshold.

Current health-check rate

If auto-adjust is enabled, shows the total number of health monitors divided by the global health-check timeout:

total-monitors / global-timeout

If auto-adjust is disabled, shows the manually configured threshold.

External health-check max rate

The external health-check probe rate.

Total number

Total number of health checks performed.

Status UP

Number of health checks that resulted in status UP.

Status DOWN

Number of health checks that resulted in status DOWN.

Status UNKN

Number of health checks that resulted in status UNKN.

Status OTHER

Number of health checks that resulted in status OTHER.

IP address

IP address of the real server.

Port

Protocol port on the server.

Health monitor

Name of the health monitor.

If the name is “default”, the default health monitor settings for the protocol port type are being used. (See “health-check” in the Command Line Interface Reference for ADC for Layer 3 health checks or “port” in the Command Line Interface Reference for ADC for Layer 4-7 health checks.)

Status

Indicates whether the service passed the most recent health check.

Cause (Up/Down)

Up and Down show internal codes for the reasons the health check reported the server or service to be up or down. (See Up and Down Causes for the show health stat Command.)

Retry

Number of retries.

PIN

Indicates the following:

  Current number of retries – Displayed to the left of the slash ( / ). The number of times the most recent health check was retried before a response was received or the maximum number of retries was used.

  Current successful up-retries – Displayed to the right of the slash ( / ). Number of successful health check replies received for the current health check. This field is applicable if the up-retry option is configured for the health check. (See health monitor.)

Table of Contents

Index

Glossary

-Search-

Back