Stderr-log

From Resin 3.0

(Difference between revisions)
Jump to: navigation, search
(migration)
 
(migration)
Line 41: Line 41:
 
== Examples ==
 
== Examples ==
  
Capture all server output to <tt>log/stderr.log</tt> with [[resin.conf]]
+
[[resin.conf]] configuration to capture all [[System.err]] output to
configuration:
+
<tt>log/stderr.log</tt>:
  
 +
<!-- pre -->
 
  &lt;resin xmlns="http://caucho.com/ns/resin"
 
  &lt;resin xmlns="http://caucho.com/ns/resin"
 
         xmlns:resin="http://caucho.com/ns/resin/core"&gt;
 
         xmlns:resin="http://caucho.com/ns/resin/core"&gt;
Line 51: Line 52:
 
    
 
    
 
   ...
 
   ...
 +
<!-- /pre -->
  
The following example configures [[System.err]] for a
+
[[host]] configuration to capture all [[System.err]] output within a host to
[[host]].  Unless a [[web-app]] overrides with it's own <tt>stderr-log</tt>,
+
<tt>log/stderr.log</tt>.  Unless a [[web-app]] overrides with it's own <tt>stderr-log</tt>, all web-apps in the host will write to the same output file.
all web-apps in the host will write to the same output file.
+
  
 
<!-- pre -->
 
<!-- pre -->

Revision as of 23:02, 27 February 2006

Capture output sent to System.err.

directive meaning default
path output path for the stream either path-format or path is required
path-format the name of a file to write the log to, date format escape sequences are replaced with the current date and time either path or path-format is required
timestamp a timestamp in date format to use at the beginning of each log line. no timestamp
rollover-period how often to rollover the log. Specify a period in days (15D), weeks (2W), months (1M), or hours (1h) none
rollover-size maximum size of the file before a rollover occurs. Specify a size in bytes (50000), kb (128kb), or megabytes (10mb) 1mb
archive-format the format for the archive filename when a rollover occurs path + ".%Y%m%d" or path + ".%Y%m%d.%H" if rollover-period < 1 day

Environments

stderr-log can appear in any environment (i.e. within a server, host, or web-app).

Usage of the stderr-log overrides a previous usage in a containing environment. For example, specifying stderr-log as a child of a web-app causes a redirection of System.err for that web application only, and will override the System.err location in the enclosing host.

Examples

resin.conf configuration to capture all System.err output to log/stderr.log:

<resin xmlns="http://caucho.com/ns/resin"
       xmlns:resin="http://caucho.com/ns/resin/core">

  <stderr-log path='/var/log/foo/stderr.log'
              rollover-period='1W'/>
 
  ...

host configuration to capture all System.err output within a host to log/stderr.log. Unless a web-app overrides with it's own stderr-log, all web-apps in the host will write to the same output file.

...
<host id='foo.com'>
  <stderr-log path='/var/log/foo/stderr.log'
              rollover-period='1W'/>
  ...
</host>
...

See also

stdout-log 
Capture output sent to System.out
Logging 
A general overview of logging facilities in Resin
Rollover 
Details about rollover options
Archiving 
Details about archiving options
Personal tools