home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / countv01.zip / readme.txt < prev   
Text File  |  1997-12-11  |  4KB  |  84 lines
  1. README for countHTTP v. 0.1 [10/12/1997]
  2.  
  3. I wrote this PowerWeb HTTP log parser for myself, since I needed to produce
  4. nice-looking reports for my clients and I did not find any abequate tool
  5. for server statistics calculation. It is a fairly simple Perl script, not
  6. very much optimized for speed (not suitable for dynamic on-line calculations),
  7. but it does most of what I need. If you need something different - tell me,
  8. I might be able to include it in the next version. Otherwise, use it on your
  9. own risk. I have tested it a lot, but can't guarantee bug-free operation.
  10. Anyway, this is version 0.1, so be prepared. I won't list a full disclamer here,
  11. simply state that I have no responsibility for the results of countHTTP
  12. usage in any way! Oh, well, and you are free to modify the code if you wish...
  13.  
  14. Features
  15.  
  16. 1. Calculate server average daily load (persentage of hits per hour);
  17. 2. Calculate server load profile (actual hits per month);
  18. 3. Calculate number of document requests per client;
  19. 4. Calculate subtotal number of requests from all clients for each document;
  20. 5. Calculate total number of requests from all clients for all documents;
  21. 6. Calculate total number of requests per each client;
  22. 7. All requests listings are sorted per number of hits (descending);
  23. 8. Client IP addresses are output by default, but may be resolved to client
  24.    names (using nslookup command). Beware that attempt to resolve all client
  25.    names for a large log file may take ages to complete. Also, due to the
  26.    nature of Perl forking mechanism and OS/2 TCP/IP 4.0x implementation, it
  27.    is almost impossible to interrupt this process once started. You may try
  28.    to kill the whole session, but success is not guaranteed!
  29. 9. Range of dates may be specified on command line, in which case only requests
  30.    within this range are included in all statistics calculations;
  31. 10.Perl regular expression may be also specified, in which case only requests for
  32.    matching documents (resources) are counted;
  33. 11.Strict HTML mode may be used, which calculates statistics only for HTML document
  34.    requests, ignoring GET/POST's, CGI script requests, requests for graphics, etc.
  35. 12.All requests from a specific network address range and/or domain name may be
  36.    ignored. Useful for filtering out your usual attempts to test/configure your
  37.    server via HTTP Web-based interface from workstation(s) on your LAN.
  38.  
  39. What countHTTP does not do at the moment.
  40.  
  41. 1. HTTP request status codes are ignored. Hence, statistics caluculations do not
  42.    distinguish between successfull requests and errors. All are counted.
  43. 2. Multihomed server configuration is not supported directly. I do not have this
  44.    configured here, so I was not able to include this feature. However, I suspect
  45.    you may implement it using regular expression option from the command line.
  46. 3. IP address range filtering works only for class C network address range,
  47.    subnetting is not supported.
  48.  
  49. Installation
  50.  
  51. countHTTP is a CMD-wrapped Perl script. You must have Perl5 installed on your
  52. system. Copy countHTTP.cmd in any directory included within your PATH statement.
  53. Perl interpreter is called with -S switch from countHTTP.cmd, so it must find
  54. script code anywhere on the PATH, if properly configured. Use countHTTP -help
  55. to obtain command line options description. By default script looks for HTTP.log
  56. file in the /powerweb/logs directory on the current drive. You may specify
  57. alternative file name and path via -f option. For your convinience, you may look
  58. inside the code using any text editor, locate the string:
  59.  
  60. *** UNCOMMENT AND EDIT THE TWO LINES BELOW ***
  61.  
  62. and set two variables to hold your own network address range and domain name.
  63. This also may be specified at command line, but editing the code once will
  64. allow you to avoid typing excessively long command line each time you call
  65. countHTTP.
  66.  
  67. Please, send comments/bug reports to:
  68.   ivan@protein.bio.msu.su
  69.  
  70. countHTTP is available at:
  71.   ftp://ftp.protein.bio.msu.su/pub/os2/tcpip/powerweb/countHTTPv01.zip
  72.  
  73.  
  74. ---
  75. Ivan Adzhubei
  76. Dept. Molecular Biology
  77. Faculty of Biology
  78. Moscow State University
  79. 119899 Moscow, Russia
  80. tel. +7 095 939 5485
  81. fax. +7 095 939 4658
  82. Web: http://www.protein.bio.msu.su/
  83. E-mail: ivan@protein.bio.msu.su
  84.