PageViews: 134 / 112 / 63 hits / 25 nets since Jul 19 2015
home updates download manual documents feedback search stats
DeleGateIcon

Access Counter and Statitics

DeleGate/9.9.13
2017-11-23/09:01:03
Nets Hits Refs Mail info manual SHTML source
Access Counters and Statistics by DeleGate
PageViews: 112 hits / 25 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 -->
    134
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)" -->
    134 : 112 : 63 hits / 25 nets (since Jul 19 2015)
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--X -------- -------- -------- -------- --------
     16.0.0.0 -------- -------- -------- ----X--- -------- -------- -------- --------
     32.0.0.0 -------- -------- -------- -------- -XX----- -------- -------- 0-------
     48.0.0.0 -------- -------- -------- -17----- -------- -------- -------- --------
     64.0.0.0 -------- ---2---- -------- -------- -------- -------- -----X-- X-------
     80.0.0.0 -------X -------- -------- -------- -------- -------- -------- --------
     96.0.0.0 -------- -------- X------- -------- -------- ----6--- -------- --------
    112.0.0.0 -------- -------- -------- -------- -------- -----X-- -------- --------
    128.0.0.0 -------- -------- -------- -------- -------- -------- -------- --------
    144.0.0.0 -------- -------- -------- -------- -------- -------- ----X--- --------
    160.0.0.0 -------- ------X- -------- -----X-- -------- -------- -------- --------
    176.0.0.0 X------- -------- -------- -------- -------- -------- -------- --------
    192.0.0.0 -------- -------- -------- ----X--- -------- -------- -------- ----X---
    208.0.0.0 -X------ -------- -------- -------- ---5---- --X----- --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][  3] 2E0000D5  46.A
    LAST[1][  0] 36500002  54.B
    LAST[2][  0] 42F0009C  66.D
    LAST[3][  0] 42F0005D  66.D
    LAST[4][  0] 42F00002  66.D
    LAST[5][  1] D8F000E5 216.D
    LAST[6][  0] 6B100056 107.A
    LAST[7][  0] 36900027  54.C
    LAST[8][  0] 42F00015  66.D
    LAST[9][  0] 42F0001E  66.D
    
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 134 : 0.0/hour, 0.2/day, 4.8/month

PageViews: 112 hits / 25 nets
[ The source of this SHTML file (6 hits) ]