"Fossies" - the Fresh Open Source Software Archive

Member "ftss-0.9.3/README" (2 Nov 2009, 2152 Bytes) of package /linux/www/old/ftss-0.9.3.tar.gz:

    1 ftss - FableTech Server Status for Apache
    2 
    3 
    4 1. Motivation
    5 
    6 Apache's status module is an easy way to get information about what your
    7 webserver is doing - at any time, except when you need that information.
    8 Because this information is normally gathered via the server-status page,
    9 it will is unavailable when the webserver is not responding. The system
   10 administrator can restart the daemon and hope to get at glimpse of the
   11 server-status page, a tiny clue about what is causing the trouble, before
   12 the server gets overloaded again.
   13 
   14 This project aims at helping the system administrator get his information
   15 in crisis situations.
   16 
   17 
   18 2. Setting up Apache
   19 
   20 2.1 You must enable mod_status with a line like this
   21 
   22  LoadModule status_module modules/mod_status.so
   23 
   24 The module is most likely already loaded or compiled into Apache's
   25 main executable.
   26 
   27 
   28 2.2 You must configure Apache to use a "name based" shared memory segment
   29 for the scoreboard with a line like this
   30 
   31  ScoreBoardFile /var/run/apache_status
   32 
   33 If you have more than one instance of Apache running on the same host,
   34 each instance MUST have its own file.
   35 
   36 
   37 2.3 You should enable extended status with a line like this
   38 
   39  ExtendedStatus On
   40 
   41 This will make Apache's status module store information in the scoreboard
   42 about the client, the vhost and the request being made. 
   43 
   44 
   45 2.4 Sample configuration
   46 
   47 LoadModule status_module modules/mod_status.so
   48 <IfModule mod_status.c>
   49   ScoreBoardFile /var/run/apache_status
   50   ExtendedStatus On
   51   <Location /server-status>
   52     SetHandler server-status
   53     Order deny,allow
   54     Deny from all
   55     Allow from localhost ip6-localhost
   56 #    Allow from .example.com
   57   </Location>
   58 </IfModule>
   59 
   60 
   61 3. Using ftss
   62 
   63 3.1 Running the program
   64 
   65 The program requires one argument; The path to the scoreboard file.
   66 
   67 It will print out a line for each worker thread, and each line will
   68 contain five tab-seperated fields:
   69 - the process id
   70 - the status (see the server-status page for a key)
   71 - the client
   72 - the vhost
   73 - the request line
   74 
   75 For example:
   76 # ftss /var/run/apache_status
   77 13762   K       127.0.0.1       127.0.0.1       GET / HTTP/1.1
   78 13763   _
   79 13764   _
   80 13765   _
   81 13766   _
   82 13767   _