PageViews: 161 / 134 / 119 hits / 41 nets since Jun 28 10:32
home updates download manual documents feedback search stats ITS more
DeleGateIcon

Access Counter and Statitics

DeleGate/9.9.13
2020-10-23/07:56:19
Nets Hits Refs Mail info manual SHTML source
Access Counters and Statistics by DeleGate
PageViews: 134 hits / 41 nets

Access counter and statistics by DeleGate

Yutaka Sato @ DeleGate.ORG
May 11, 2006

Basic functionality for access counters and real-time statistics were built-into DeleGate/9.2.0. It is applied not only to access count from clients but also to general counts including Referers, errors, and more, in future. So far, the following counters have been implemented.

  • count for each requested URL on origin/proxy HTTP DeleGate (example)
  • count for each Referer URL on origin/proxy HTTP DeleGate (example)
  • count for each transferred file on origin FTP DeleGate (example)
  • count for each error or rejection in SMTP DeleGate (example)
  • count for each session of FTP, SMTP, NNTP DeleGate (example)
  • count for each packet incoming to DNS DeleGate (example)
This built-in counter is intended to be used to show real-time statistics of DeleGate servers too. It will be convenient to be able to get statistics in real-time and without keeping a large volume of log files.


Basic Usage

Counters are enabled with the COUNTER parameter, as follows in the simplest.

    COUNTER=do

A SSI tag "COUNTER" is introduced to show values in counters. The simplest example is the access counter of the SHTML page including the tag.

    <!--#echo var=COUNTER -->
    161
There are three types of counters based on (client's) IP address; the first one is incremented on every hit, the second one is incremented excluding repetitive hit by the same IP address, and the third one is incremented excluding repetitive hit by one of last ten IP addresses. Each counter is represented with %T, %U, and %V respectively in a format string given by the fmt="formatString" attribute.
    <!--#echo var=COUNTER fmt="%T : %U : %V hits / %N nets (since %tC)" -->
    161 : 134 : 119 hits / 41 nets (since Jun 28 10:32)
Yet another count is "network count" which is represented as "%N" in the format string. It is introduced to be a metrics of the coverage or distribution of (client's) IP addresses on the address space. It is not a counter incremented on each hit, but the number of bits in a bit map of network addresses. In the current implementation, the width of the network mask is 10 bits, therefore the logical maximum number of "%N" is 1024. The map of networks can be shown with "%M" as follows.
    <!--#echo var=COUNTER fmt="%M" -->
    
      0.0.0.0 -------- -------X ------XX -------- -------- -------- -------- --------
     16.0.0.0 ----X--- --X----- -------- -------- -------- -------- -------- --------
     32.0.0.0 -------- ---X---- -------- -----X-- -X------ -------- -------- ---X----
     48.0.0.0 -------- -------- -------- 3--X---- -------- -------- -------- ---1----
     64.0.0.0 X-7----- --XX---- ------X- -------- -------- -------- -----X-- X-------
     80.0.0.0 -------X -------- -------- -------- ------X- -------- -------- -------X
     96.0.0.0 -------- -------- X------- -------- -------- -------- -----4-- --------
    112.0.0.0 -------- -------- -------- -------- -------- -------- -------- --------
    128.0.0.0 -------- -------- -------- -------- ---X---- -X-X---- -------- --------
    144.0.0.0 -------- -----0-- -------- -------- -------- -------- -----X-- -----X--
    160.0.0.0 -------- -------- -------- -------- -------- -------- -------5 --------
    176.0.0.0 X------- --X----- -------- -------- ------2- -------- -------- --------
    192.0.0.0 ---X---- ---X---- -------X -------- -------- -----XX- -------- --------
    208.0.0.0 -------- -------- -------- -------- 8--X---- -------- -------- --------
    
In the map, each true bit is marked with 'X' while false bit is marked with '-'. The recent ten networks are marked with a digit from '0' to '9'. The recent ten IP addresses can be shown with "%L" as follows.
    <!--#echo var=COUNTER fmt="%L" -->
    
    LAST[0][  0] 93500012 147.B
    LAST[1][  0] 3ED000F0  62.D
    LAST[2][  0] B9B00029 185.C
    LAST[3][  0] 3620003F  54.A
    LAST[4][  4] 6D600013 109.B
    LAST[5][  0] ADE000D7 173.D
    LAST[6][  0] 93500011 147.B
    LAST[7][  0] 408000F2  64.C
    LAST[8][  0] D81000CE 216.A
    LAST[9][  0] B9800080 185.C
    
This table of recent 10 addresses is managed in the LRU order, that is the entry of the least recentry hit is pushed out from the table.

    <!--#echo var=COUNTER fmt="Hits %T : %mHT/hour, %mdT/day, %mmT/month" -->
    Hits 161 : 0.1/hour, 1.4/day, 42.7/month

PageViews: 134 hits / 41 nets
[ The source of this SHTML file (58 hits) ]