Manual Pages


Table of Contents

NAME

na_httpstat - display HTTP statistics

SYNOPSIS

httpstat [ -adehrst ] [ -c count ] [ -i ipv4|ipv6 ] [ interval ]

httpstat [ -zaderst ] [ -i ipv4|ipv6 ]

DESCRIPTION

httpstat displays statistical information about HTTP (HyperText Transfer Protocol) for the node. It can also be used to reinitialize this information.

If no arguments are given, httpstat displays statistical information since last reboot or last zeroed.

When the -c count option is specified new data is displayed every interval until the count expires. The first output line contains the total information from the last reboot or last zero. Subsequent lines contain the difference between the current value and the previous value.

If the interval argument is specified, the first line of displayed data contains cumulative statistics. Each subsequent line shows incremental statistics for the interval (in seconds) until the count is reached.

The -i option filters the stats on the basis of the IP protocol used. When -i option is used with `ipv4' as the argument, only stats for connections established over IPv4 protocol are displayed. When -i option is used with `ipv6' as the argument, only stats for connections established over IPv6 protocol are displayed. When -i option is not used, stats for connections established over both IPv4 and IPv6 protocols are displayed. The -i option can be used along with -r, -e, -d, -a... options.

The -h option suppresses the printing of the header information and the cumulative statistics.

The -z option can be used to zero a combination of the statistics counters, depending on which of the following options is also included. The "service" statistics cannot be zeroed.

The -d option selects detailed information about the types of successful requests received (Details).

The -e option prints statistics abouts errors (Errors).

The -r option prints statistics abouts requests (Request).

The -s option prints service statistics (Service).

The -t option prints timeout statistics (Timeout).

The -a option selects "all" statistics. When all or more than one type of statistic is selected, it always appears in "Request", "Details", "Errors", "Timeouts", and "Service" order.

Request (-r)
Accept The number of new connections accepted by the node.

Reuse The number of new requests received on existing connections.

Reponse
The number of reponses sent.

InBytes
The number of bytes received for all incoming requests.

OutBytes
The number of bytes sent, including all HTTP headers, but not including data generated by servlets.

Detail (-d)

Get
The number of requests for files received.

Head
The number of requests for file information received.

Redirect
The number of requests redirected to another file.

NotMod
The number of times clients (browsers) were told that requested files were not modified.

Post
The number of POST requests received.

Put
The number of PUT requests received.

Servlet
The number of servlet requests received.

Error (-e)
Errors The number of HTTP protocol error responses returned.

BadReq The number of unrecognized requests received.

LogDiscard
The number of log entries discarded because the log was full.

UnAuth The number of requests denied because they lacked authorization.

RcvErr The number of requests aborted because of errors on the input socket.

Service (-s)

Open
The number of currently open connections.

Peak
The maximum number of connections ever achieved.

Waits The current number of connections accepted, but waiting for a connection structure.

Timeout (-t)
Pending
These are connection structures reclaimed after the network connection was started, but before any data was sent to the node.

Active These are connection structures reclaimed after the network connection was started, and a partial request was sent, but before the complete request arrived.

Idle These connections were reclaimed after a complete request, but before the open connection could receive another request.

HA CONSIDERATIONS

In takeover mode, the HTTP statistics displayed reflect the sum of operations that take place on the live node and the operations that the live node performs on behalf of the failed node. The display does not differentiate between the operations on the live node's disks and the operations on the failed node's disks.

The HTTP statistics are cumulative; a giveback does not zero out the HTTP statistics. After giving back the failed partner's resources, the live node does not subtract the statistics about HTTP operations it performed on behalf of the failed node in takeover mode.

EXAMPLES

  Here are some examples using httpstat:

  httpstat
              Requests
       Accept      Reuse   Response    InBytes   OutBytes

    Total Stats:
            7          0          1       2235        248

    IPv4 Stats:
            3          0          0        950         68

    IPv6 Stats:
            4          0          1       1285        180


  httpstat -d
               Details
          Get       Head   Redirect     NotMod       Post        Put    Servlet      Zapid

    Total Stats:
           24          0          0         34          0          0          1          0

    IPv4 Stats:
           17          0          0         11          0          0          1          0

    :IPv6 Stats:
            7          0          0         23          0          0          0          0


  httpstat -i ipv4

              Requests
       Accept      Reuse   Response    InBytes   OutBytes
            3          0          0        950         68


  httpstat -i ipv6

              Requests
       Accept      Reuse   Response    InBytes   OutBytes
            4          0          1       1285        180


  httpstat -e -i ipv4

                Errors
       Errors     BadReq LogDiscard     UnAuth     RcvErr
            5          0          0          0          0



SEE ALSO
       na_netstat(1),   na_options(1),   na_partner(1),   na_sys-
       stat(1).



                6 Jun 1998             na_httpstat(1)