1
.TH "epylog.conf" "5" "1.0" "Konstantin Ryabitsev" "Applications/System"
4
\fBepylog.conf\fR \- epylog configuration
7
\fBepylog\fR config file is a simple plaintext file in win.ini style
11
Epylog will look in /etc/epylog/epylog.conf by default, but you can
12
override that by passing \-c switch on the command line.
17
This is where epylog should look for other configuration information,
18
most notably, \fBmodules.d\fR directory. See \fIepylog-modules(5)\fR
22
Where to create temporary directories and put temporary files. Note
23
that log files can grow VERY big and epylog might create several
24
copies of them for processing purposes. Make sure there is no danger
25
of filling up that partition. A good place on a designated loghost is
26
/var/tmp, since that is usually a separate partition dedicated
30
Where epylog should save its state data, namely the offsets.xml
31
file. The sanest place for this is /var/lib/epylog.
34
By default, if a line is matched against a module, no other modules
35
will be tried. This helps speed things up tremendously. However, you
36
may have several modules that process the same lines (although this is
37
not a very good setup). In that case you may set this to "yes". The
38
default value is "no".
41
How many processing threads to start. 50 is a good default value, but
42
you may set it to less or more, depending on your system.
47
What should be the title of the report. For mailed reports, this is
48
the subject of the message. For the ones published on the web, this is
49
the title of the page (as in <title></title>).
52
Which html template should be used for the final report. See the
53
source of the default template for the format used.
56
Can be either "yes" or "no". If "no" is specified, strings that didn't
57
match any of the modules will not be appended to the report. Not very
58
wise! A good setting is "yes".
61
Lists the publishers to use. The value is the name of the section
62
where to look for the publisher configuration. E.g.:
64
.B publishers = nfspub
66
will look for a section called "[nfspub]" for publisher
67
initialization. The name of the publisher has nothing to do with the
68
method it uses for publishing. The fact that the default are named
69
[file] and [mail] is only a matter of convenience. List multiple
70
values separated by a comma.
75
Method must be set to "mail" for this publisher to be considered a
79
Can be either a hostname of an SMTP server to use, or the location of
80
a sendmail binary. If the value starts with a "/" it will be
81
considered a path. E.g. valid entries:
83
.B smtpserv = mail.example.com
85
.B smtpserv = /usr/sbin/sendmail -t
88
The list of email addresses where to mail the report. Separate
89
multiple entries by a comma. If ommitted, "root@localhost" will be
93
Can be one of the following: \fBhtml\fR, \fBplain\fR, or \fBboth\fR. If
94
you use a mail client that doesn't support html mail, then you better
95
use "plain" or "both", though you will miss out on visual cueing that
96
epylog uses to notify of important events.
99
This is only useful if you use format other than "html". Epylog will
100
use a lynx-compliant tool to transform HTML into plain text. The
101
following browsers are known to work: lynx, elinks, w3m.
104
Whether to include the gzipped raw logs with the message. If set to
105
"yes", it will attach the file with all processed logs with the
106
message. If you use a file publisher in addition to the mail
107
publisher, this may be a tad too paranoid.
110
If the size of rawlogs.gz is more than this setting (in kilobytes),
111
then raw logs will not be attached. Useful if you have a 50Mb log and
112
check your mail over a slow uplink.
117
Method must be set to "file" for this config to work as a file
121
Where to place the directories with reports. A sensible location would
122
be in /var/www/html/epylog. Note that the reports may contain
123
sensitive information, so make sure you place a .htaccess in that
124
directory and require a password, or limit by host.
127
These are the masks to be used for the created directories and
128
files. For format values look at strftime documentation here:
129
http://www.python.org/doc/current/lib/module-time.html
132
A digit specifying the number of days after which the old directories
133
should be removed. Default is 7.
136
Optionally send notifications to these email addresses when new
137
reports become available. Comment out if no notification is
138
desired. This is definitely redundant if you also use the mail
142
Use this smtp server when sending notifications. Can be either a
143
hostname or a path to sendmail. Defaults to "/usr/sbin/sendmail -t".
146
When generating a notification message, use this as publication root
147
to make a link. E.g.:
149
.B pubroot = http://www.example.com/epylog
151
will make a link: http://www.example.com/epylog/dirname/filename.html
154
Lines starting with "#" will be considered commented out.
158
Konstantin Ryabitsev <icon@linux.duke.edu>
162
epylog(3), epylog(8), epylog-modules(5)