File: make_combined_log.1.xml

package info (click to toggle)
libapache-mod-log-sql 1.100-16.3
  • links: PTS, VCS
  • area: main
  • in suites: bullseye, sid, stretch
  • size: 1,168 kB
  • ctags: 622
  • sloc: sh: 2,470; ansic: 2,264; xml: 2,010; makefile: 322; perl: 250; sql: 64
file content (52 lines) | stat: -rw-r--r-- 1,947 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
<?xml version="1.0" standalone='no'?>
<!DOCTYPE spec SYSTEM "man.dtd">

<manpage name="make_combined_log.pl" section="1" desc="make combined logfile from SQL database">

<synopsis>
<cmd>make_combined_log.pl <arg>&lt;days&gt;</arg> <arg>&lt;virtual host&gt;</arg></cmd>
</synopsis>

<description>
<p>This perl script extracts the httpd access data from a MySQL database
and formats it properly for parsing by 3rd-party log analysis tools.</p>

<p>The script is intended to be run out by cron. Its commandline arguments
tell it how many days' worth of access records to extract, and which
virtual_host you are interested in (because many people log several
virthosts to one MySQL db.) This permits you to run it daily, weekly,
every 9 days -- whatever you decide.</p>
</description>

<section name = "Note">
<p>By "days" I mean "chunks of 24 hours prior to the moment this
script is run." So if you run it at 4:34 p.m. on the 12th, it will go
back through 4:34 p.m. on the 11th.</p>
</section>

<section name = "Known issues">
<p>Because GET and POST are not discriminated in the MySQL log, we'll just
assume that all requests are GETs.  This should have negligible effect
on any analysis software.  This could be remedied IF you stored the full
HTTP request in your database instead of just the URI, but that's going to
cost you a LOT of space really quickly...</p>

<p>Because this is somewhat of a quick hack it doesn't do the most robust
error checking in the world.  Run it by hand to confirm your usage before
putting it in crontab.</p>
</section>

<section name = "Author">
<p>Edward Rudd &lt;eddie@omegaware.com&gt;</p>
</section>

<section name = "Man page created by">
Michael A. Toth &lt;lirul.lists@gmail.com&gt; - based on comments of script
</section>

<section name = "Comments">
<p>This man page was written using <manref name="xml2man" section="1"
href="http://masqmail.cx/xml2man/"/> by the same author.</p>
</section>

</manpage>