Return-Path: X-Original-To: apmail-httpd-cvs-archive@www.apache.org Delivered-To: apmail-httpd-cvs-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 7A574C649 for ; Tue, 1 May 2012 14:59:31 +0000 (UTC) Received: (qmail 82984 invoked by uid 500); 1 May 2012 14:59:31 -0000 Delivered-To: apmail-httpd-cvs-archive@httpd.apache.org Received: (qmail 82939 invoked by uid 500); 1 May 2012 14:59:31 -0000 Mailing-List: contact cvs-help@httpd.apache.org; run by ezmlm Precedence: bulk Reply-To: dev@httpd.apache.org list-help: list-unsubscribe: List-Post: List-Id: Delivered-To: mailing list cvs@httpd.apache.org Received: (qmail 82932 invoked by uid 99); 1 May 2012 14:59:31 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 01 May 2012 14:59:31 +0000 X-ASF-Spam-Status: No, hits=-2000.0 required=5.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 01 May 2012 14:59:25 +0000 Received: from eris.apache.org (localhost [127.0.0.1]) by eris.apache.org (Postfix) with ESMTP id 73D1223888CD; Tue, 1 May 2012 14:59:03 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Subject: svn commit: r1332679 - /httpd/httpd/branches/2.4.x/docs/manual/programs/ Date: Tue, 01 May 2012 14:59:02 -0000 To: cvs@httpd.apache.org From: rbowen@apache.org X-Mailer: svnmailer-1.0.8-patched Message-Id: <20120501145903.73D1223888CD@eris.apache.org> Author: rbowen Date: Tue May 1 14:59:02 2012 New Revision: 1332679 URL: http://svn.apache.org/viewvc?rev=1332679&view=rev Log: Splits the docs for log_server_status and split-logfile into their own separate docs. The "other" file has dwindled over the years, and having "other" just list two things seems a little silly. Also, update log_server_status doc to reflect current reality. Added: httpd/httpd/branches/2.4.x/docs/manual/programs/log_server_status.html httpd/httpd/branches/2.4.x/docs/manual/programs/log_server_status.html.en httpd/httpd/branches/2.4.x/docs/manual/programs/log_server_status.xml httpd/httpd/branches/2.4.x/docs/manual/programs/log_server_status.xml.meta httpd/httpd/branches/2.4.x/docs/manual/programs/split-logfile.html httpd/httpd/branches/2.4.x/docs/manual/programs/split-logfile.html.en httpd/httpd/branches/2.4.x/docs/manual/programs/split-logfile.xml httpd/httpd/branches/2.4.x/docs/manual/programs/split-logfile.xml.meta Modified: httpd/httpd/branches/2.4.x/docs/manual/programs/other.html.en httpd/httpd/branches/2.4.x/docs/manual/programs/other.xml Added: httpd/httpd/branches/2.4.x/docs/manual/programs/log_server_status.html URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/programs/log_server_status.html?rev=1332679&view=auto ============================================================================== --- httpd/httpd/branches/2.4.x/docs/manual/programs/log_server_status.html (added) +++ httpd/httpd/branches/2.4.x/docs/manual/programs/log_server_status.html Tue May 1 14:59:02 2012 @@ -0,0 +1,5 @@ +# GENERATED FROM XML -- DO NOT EDIT + +URI: log_server_status.html.en +Content-Language: en +Content-type: text/html; charset=ISO-8859-1 Added: httpd/httpd/branches/2.4.x/docs/manual/programs/log_server_status.html.en URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/programs/log_server_status.html.en?rev=1332679&view=auto ============================================================================== --- httpd/httpd/branches/2.4.x/docs/manual/programs/log_server_status.html.en (added) +++ httpd/httpd/branches/2.4.x/docs/manual/programs/log_server_status.html.en Tue May 1 14:59:02 2012 @@ -0,0 +1,71 @@ + + + +log_server_status - Log periodic status summaries - Apache HTTP Server + + + + + + +
+

Modules | Directives | FAQ | Glossary | Sitemap

+

Apache HTTP Server Version 2.4

+
+
<-
+

log_server_status - Log periodic status summaries

+
+

Available Languages:  en  | + ko  | + tr 

+
+ +

This perl script is designed to be run at a frequent interval by + something like cron. It connects to the server and downloads the status + information. It reformats the information to a single line and logs it to + a file. Adjust the variables at the top of the script to specify the + location of the resulting logfile. mod_status will + need to be loaded and configured in order for this script to do its + job.

+
+
top
+
+

Usage

+ +

The script contains the following section.

+ +
+my $wherelog = "/usr/local/apache2/logs/";  # Logs will be like "/usr/local/apache2/logs/19960312"
+my $server   = "localhost";        # Name of server, could be "www.foo.com"
+my $port     = "80";               # Port on server
+my $request = "/server-status/?auto";    # Request to send
+
+ + +

You'll need to ensure that these variables have the correct values, +and you'll need to have the /server-status handler +configured at the location specified, and the specified log location +needs to be writable by the user which will run the script.

+ +

Run the script periodically via cron to produce a daily log file, +which can then be used for statistical analysis.

+ +
+
+

Available Languages:  en  | + ko  | + tr 

+
+ \ No newline at end of file Added: httpd/httpd/branches/2.4.x/docs/manual/programs/log_server_status.xml URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/programs/log_server_status.xml?rev=1332679&view=auto ============================================================================== --- httpd/httpd/branches/2.4.x/docs/manual/programs/log_server_status.xml (added) +++ httpd/httpd/branches/2.4.x/docs/manual/programs/log_server_status.xml Tue May 1 14:59:02 2012 @@ -0,0 +1,59 @@ + + + + + + + + +Programs + +log_server_status - Log periodic status summaries + + +

This perl script is designed to be run at a frequent interval by + something like cron. It connects to the server and downloads the status + information. It reformats the information to a single line and logs it to + a file. Adjust the variables at the top of the script to specify the + location of the resulting logfile. mod_status will + need to be loaded and configured in order for this script to do its + job.

+ + +
Usage + +

The script contains the following section.

+ + +my $wherelog = "/usr/local/apache2/logs/"; # Logs will be like "/usr/local/apache2/logs/19960312" +my $server = "localhost"; # Name of server, could be "www.foo.com" +my $port = "80"; # Port on server +my $request = "/server-status/?auto"; # Request to send + + +

You'll need to ensure that these variables have the correct values, +and you'll need to have the /server-status handler +configured at the location specified, and the specified log location +needs to be writable by the user which will run the script.

+ +

Run the script periodically via cron to produce a daily log file, +which can then be used for statistical analysis.

+ +
+ + Added: httpd/httpd/branches/2.4.x/docs/manual/programs/log_server_status.xml.meta URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/programs/log_server_status.xml.meta?rev=1332679&view=auto ============================================================================== --- httpd/httpd/branches/2.4.x/docs/manual/programs/log_server_status.xml.meta (added) +++ httpd/httpd/branches/2.4.x/docs/manual/programs/log_server_status.xml.meta Tue May 1 14:59:02 2012 @@ -0,0 +1,12 @@ + + + + + log_server_status + /programs/ + .. + + + en + + Modified: httpd/httpd/branches/2.4.x/docs/manual/programs/other.html.en URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/programs/other.html.en?rev=1332679&r1=1332678&r2=1332679&view=diff ============================================================================== --- httpd/httpd/branches/2.4.x/docs/manual/programs/other.html.en (original) +++ httpd/httpd/branches/2.4.x/docs/manual/programs/other.html.en Tue May 1 14:59:02 2012 @@ -13,7 +13,7 @@ -
+

Modules | Directives | FAQ | Glossary | Sitemap

Apache HTTP Server Version 2.4

@@ -26,49 +26,13 @@  tr 

-

The following programs are simple support programs included with the - Apache HTTP Server which do not have their own manual pages. They are not - installed automatically. You can find them after the configuration process - in the support/ directory.

- - -
top
-
-

log_server_status

-

This perl script is designed to be run at a frequent interval by - something like cron. It connects to the server and downloads the status - information. It reformats the information to a single line and logs it to - a file. Adjust the variables at the top of the script to specify the - location of the resulting logfile.

-
top
-
-

split-logfile

-

This perl script will take a combined Web server access log file and - break its contents into separate files. It assumes that the first field of - each line is the virtual host identity, put there using the "%v" - variable in LogFormat. -

- -

- LogFormat "%v %h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\"" - combined_plus_vhost
- CustomLog logs/access_log combined_plus_vhost -

- -

Log files will be created, in the directory where are running the - script, for each virtual host name that appears in the combined log file. - These logfiles will named after the hostname, with a - .log file extension.

- -

The combined log file is read from stdin. Records read will be appended - to any existing log files.

+

This page used to contain documentation for programs which now + have their own docs pages. Please update any links.

-

split-logfile < access_log

- - -
+

log_server_status

+

split-lofile

+ +

Available Languages:  en  |  ko  | Modified: httpd/httpd/branches/2.4.x/docs/manual/programs/other.xml URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/programs/other.xml?rev=1332679&r1=1332678&r2=1332679&view=diff ============================================================================== --- httpd/httpd/branches/2.4.x/docs/manual/programs/other.xml (original) +++ httpd/httpd/branches/2.4.x/docs/manual/programs/other.xml Tue May 1 14:59:02 2012 @@ -26,44 +26,11 @@ Other Programs

-

The following programs are simple support programs included with the - Apache HTTP Server which do not have their own manual pages. They are not - installed automatically. You can find them after the configuration process - in the support/ directory.

- - -
log_server_status -

This perl script is designed to be run at a frequent interval by - something like cron. It connects to the server and downloads the status - information. It reformats the information to a single line and logs it to - a file. Adjust the variables at the top of the script to specify the - location of the resulting logfile.

-
- -
split-logfile -

This perl script will take a combined Web server access log file and - break its contents into separate files. It assumes that the first field of - each line is the virtual host identity, put there using the "%v" - variable in LogFormat. -

- - - LogFormat "%v %h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\"" - combined_plus_vhost
- CustomLog logs/access_log combined_plus_vhost - - -

Log files will be created, in the directory where are running the - script, for each virtual host name that appears in the combined log file. - These logfiles will named after the hostname, with a - .log file extension.

+

This page used to contain documentation for programs which now + have their own docs pages. Please update any links.

-

The combined log file is read from stdin. Records read will be appended - to any existing log files.

- - split-logfile < access_log - - -
+

log_server_status

+

split-lofile

+ Added: httpd/httpd/branches/2.4.x/docs/manual/programs/split-logfile.html URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/programs/split-logfile.html?rev=1332679&view=auto ============================================================================== --- httpd/httpd/branches/2.4.x/docs/manual/programs/split-logfile.html (added) +++ httpd/httpd/branches/2.4.x/docs/manual/programs/split-logfile.html Tue May 1 14:59:02 2012 @@ -0,0 +1,5 @@ +# GENERATED FROM XML -- DO NOT EDIT + +URI: split-logfile.html.en +Content-Language: en +Content-type: text/html; charset=ISO-8859-1 Added: httpd/httpd/branches/2.4.x/docs/manual/programs/split-logfile.html.en URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/programs/split-logfile.html.en?rev=1332679&view=auto ============================================================================== --- httpd/httpd/branches/2.4.x/docs/manual/programs/split-logfile.html.en (added) +++ httpd/httpd/branches/2.4.x/docs/manual/programs/split-logfile.html.en Tue May 1 14:59:02 2012 @@ -0,0 +1,70 @@ + + + +split-logfile - Split up multi-vhost logfiles - Apache HTTP Server + + + + + + +
+

Modules | Directives | FAQ | Glossary | Sitemap

+

Apache HTTP Server Version 2.4

+
+
<-
+

split-logfile - Split up multi-vhost logfiles

+
+

Available Languages:  en  | + ko  | + tr 

+
+ +

This perl script will take a combined Web server access log file and + break its contents into separate files. It assumes that the first field of + each line is the virtual host identity, put there using the "%v" + variable in LogFormat. +

+
+
top
+
+

Usage

+ +

Create a log file with virtual host information in it:

+ +

+ LogFormat "%v %h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\"" + combined_plus_vhost
+ CustomLog logs/access_log combined_plus_vhost +

+ +

Log files will be created, in the directory where you run the + script, for each virtual host name that appears in the combined log file. + These logfiles will named after the hostname, with a + .log file extension.

+ +

The combined log file is read from stdin. Records read will be appended + to any existing log files.

+ +

split-logfile < access_log

+ + +
+
+

Available Languages:  en  | + ko  | + tr 

+
+ \ No newline at end of file Added: httpd/httpd/branches/2.4.x/docs/manual/programs/split-logfile.xml URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/programs/split-logfile.xml?rev=1332679&view=auto ============================================================================== --- httpd/httpd/branches/2.4.x/docs/manual/programs/split-logfile.xml (added) +++ httpd/httpd/branches/2.4.x/docs/manual/programs/split-logfile.xml Tue May 1 14:59:02 2012 @@ -0,0 +1,59 @@ + + + + + + + + +Programs + +split-logfile - Split up multi-vhost logfiles + + +

This perl script will take a combined Web server access log file and + break its contents into separate files. It assumes that the first field of + each line is the virtual host identity, put there using the "%v" + variable in LogFormat. +

+ + +
Usage + +

Create a log file with virtual host information in it:

+ + + LogFormat "%v %h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\"" + combined_plus_vhost
+ CustomLog logs/access_log combined_plus_vhost + + +

Log files will be created, in the directory where you run the + script, for each virtual host name that appears in the combined log file. + These logfiles will named after the hostname, with a + .log file extension.

+ +

The combined log file is read from stdin. Records read will be appended + to any existing log files.

+ + split-logfile < access_log + + +
+ + Added: httpd/httpd/branches/2.4.x/docs/manual/programs/split-logfile.xml.meta URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/programs/split-logfile.xml.meta?rev=1332679&view=auto ============================================================================== --- httpd/httpd/branches/2.4.x/docs/manual/programs/split-logfile.xml.meta (added) +++ httpd/httpd/branches/2.4.x/docs/manual/programs/split-logfile.xml.meta Tue May 1 14:59:02 2012 @@ -0,0 +1,12 @@ + + + + + split-logfile + /programs/ + .. + + + en + +