You are viewing a plain text version of this content. The canonical link for it is here.
Posted to bugs@httpd.apache.org by bu...@apache.org on 2010/08/30 14:12:05 UTC

DO NOT REPLY [Bug 49844] New: No documentation on the logging format of RewriteLog

https://issues.apache.org/bugzilla/show_bug.cgi?id=49844

           Summary: No documentation on the logging format of RewriteLog
           Product: Apache httpd-2
           Version: 2.2-HEAD
          Platform: All
        OS/Version: All
            Status: NEW
          Severity: normal
          Priority: P2
         Component: Documentation
        AssignedTo: bugs@httpd.apache.org
        ReportedBy: p.org@gmx.at


I could not find any OFFICIAL (=within Apache domains)
documentation/explanation of the logging format generated through the directive
"RewriteLog", nor useful INOFFICIAL (=external) resources.

The first place where I would expected it:
http://httpd.apache.org/docs/2.2/mod/mod_rewrite.html#rewritelog

Neither was I lucky at:
http://wiki.apache.org/httpd/Logs
http://httpd.apache.org/docs/2.2/mod/mod_log_config.html

And googling for various combinations of these key words:
Format understand explained Apache RewriteLog rewrite log
also did not deliver useful results! Only unanswered forum questions such as:
http://stackoverflow.com/questions/2023959/understanding-apache-rewritelog

Please add OFFICIAL documentation, and please meanwhile point me to an
INOFFICIAL ressource, if you know any. Thanks!

-- 
Configure bugmail: https://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.

---------------------------------------------------------------------
To unsubscribe, e-mail: bugs-unsubscribe@httpd.apache.org
For additional commands, e-mail: bugs-help@httpd.apache.org


DO NOT REPLY [Bug 49844] No documentation on the logging format of RewriteLog

Posted by bu...@apache.org.
https://issues.apache.org/bugzilla/show_bug.cgi?id=49844

Eric Covener <co...@gmail.com> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
           Severity|normal                      |enhancement

-- 
Configure bugmail: https://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.

---------------------------------------------------------------------
To unsubscribe, e-mail: bugs-unsubscribe@httpd.apache.org
For additional commands, e-mail: bugs-help@httpd.apache.org


DO NOT REPLY [Bug 49844] No documentation on the logging format of RewriteLog

Posted by bu...@apache.org.
https://issues.apache.org/bugzilla/show_bug.cgi?id=49844

Rich Bowen <rb...@apache.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
         AssignedTo|bugs@httpd.apache.org       |docs@httpd.apache.org

--- Comment #3 from Rich Bowen <rb...@apache.org> 2010-10-29 11:06:57 EDT ---
Moving docs bugs to docs@httpd.a.o ownership.

-- 
Configure bugmail: https://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.

---------------------------------------------------------------------
To unsubscribe, e-mail: bugs-unsubscribe@httpd.apache.org
For additional commands, e-mail: bugs-help@httpd.apache.org


DO NOT REPLY [Bug 49844] No documentation on the logging format of RewriteLog

Posted by bu...@apache.org.
https://issues.apache.org/bugzilla/show_bug.cgi?id=49844

--- Comment #1 from ww.galen@gmail.com 2010-09-21 04:44:18 EDT ---
As a start, here's the printf format and description of the fields, extracted
from mod_rewrite
(http://svn.apache.org/viewvc/httpd/httpd/trunk/modules/mappers/mod_rewrite.c?view=markup#l437):

"%s %s %s [%s/sid#%pp][rid#%pp/%s%s%s] %s%s%s%s"

  remote host,
  remote login name,
  HTTP user,

  HTTP host,
  virtual host ID (a memory address),

  request ID (a memory address),
  subrequest or initial request,
  count of internal redirects,

  directory (if from a per-directory rewrite),
  text

I'm not sure how best to write that up, since custom log formatting doesn't
support some of those fields. It's approximately:

  %h %l %u [%V/sid#$sid][rid#$rid/(initial|subreq){/redir#$rcount}] {[perdir
$dir]} $msg

"()" indicates grouping, "{}" indicates a field that may not be present, and
"$" starts a field that doesn't have a custom log format specifier.

-- 
Configure bugmail: https://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.

---------------------------------------------------------------------
To unsubscribe, e-mail: bugs-unsubscribe@httpd.apache.org
For additional commands, e-mail: bugs-help@httpd.apache.org


DO NOT REPLY [Bug 49844] No documentation on the logging format of RewriteLog

Posted by bu...@apache.org.
https://issues.apache.org/bugzilla/show_bug.cgi?id=49844

--- Comment #2 from Stefan Nowak <p....@gmx.at> 2010-09-21 07:33:09 EDT ---
PROPOSAL FOR HOW TO WRITE UP THE DOCUMENTATION:
(How I, from the user perspective, would like to have it)

1) Log line format (as you wrote it)
2) Syntax annotations for (1) (as you wrote it)
3) A table which describes all the variable names, like at:
http://httpd.apache.org/docs/current/mod/mod_log_config.html#formats
4) Some sample lines, as examples are always good for understanding!


FURTHER QUESTIONS:

Q.1) My log lines, as generated by httpd 2.0.63, look a bit different than
yours. I try to show you its syntax, using pseudo variables for the observed
differences:

%h %l %u [$date] [%V/sid#$sid][rid#$rid/(initial|subreq)] {\($rcount\)}
{[perdir
$dir]} $msg

[$date] A date with a formatting like [30/Aug/2010:16:14:34 +0200]
{\($rcount\)} The optional counter comes AFTER the square brackets which
enclose the request ID group, within LITERAL round brackets, i.e. (3).

Q.2) How shall I interpret $rcount?
If I see this counter in a log line, does it mean:
a) This log line represents the N-th cycle of an internal redirect?
or
b) In the process logged in this line, httpd has used N internal redirects?

I ain't sure, as my subsequent log lines show $rcount numerical series like:
2,3,5,4,4,5,4,2,2,1,1,2,3,1,...
which are more logically explained by (b) as (a) would create numerical series,
which steadily increase, and at the end fall back to 1, like:
1,2,3,1,2,3,4,1,2,1,2,3,...


THANKS for answers in advance!

-- 
Configure bugmail: https://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.

---------------------------------------------------------------------
To unsubscribe, e-mail: bugs-unsubscribe@httpd.apache.org
For additional commands, e-mail: bugs-help@httpd.apache.org