epylog-modules(5)

Section: Applications/System (5)
Updated: 0.9

NAME

epylog-modules - epylog module cofiguration.

SYNOPSIS

epylog uses pluggable modules to perform analysis and report on syslog strings. This manpage explains the format of the module config files.

modules.d

Epylog config files are placed in the modules.d directory of the cfgdir specified in epylog.conf. Any file ending in .conf in that directory is considered a module config file. Most common location for modules.d directory is in /etc/epylog/modules.d.

module.conf

The name of the config file doesn't carry much meaning, however it MUST end in .conf in order to be recognized as a module config file.

The config file for each module is separated into two parts: [module] and [conf].

[module]

desc

The description of the module. It will be shown in the final report.

exec

This is where the "body" of the module is located. Most modules that come with the distribution will be placed in /usr/share/epylog/modules, but depending on your setup, you may place them elsewhere.

files

List the logfiles requested by this module in this field. Separate multiple entries by comma. Epylog will handle rotated files, but you need to specify the mask appropriately. E.g. the most common logrotate setup will place rotated files in the same directory and add .0, .1, .2, etc to the end of the file. Therefore, a file entry would look like so:
/var/log/filename[.#]
If you have compression turned on, your entry will look like so:
/var/log/filename[.#.gz]
Lastly, for advanced configurations, more complex entries may be required. E.g. if your logrotate saves rotated files in a subdirectory in /var/log, you can specify it like so:
/var/log/[rotate/]filename[.#.gz]
This will work, too:
/var/log/filename[/var/rotate/filename.#.gz]
In any case, "#" will be where the increments will go.

enabled

Can be either "yes" or "no". If "no" is specified, Epylog will completely ignore this module.

internal

Can be either "yes" or "no". If "yes", then the module is handled as an internal module, and if "no", then the external module API is used. See doc/modules.txt for more information about the module APIs.

outhtml

Specifies whether the output produced by the module is HTML or not. Can be either "yes" or "no".

priority

An unsigned int. Most commonly a number from 0 to 10. Modules with the lowest number will be considered the highest prioroty and will be both invoked and presented in the final report before the others.

[conf]

This is where per-module configuration directives go. Some modules have these, some don't. Look in the module config file -- the available values should be listed and described there.

COMMENTS

Lines starting with "#" will be considered commented out.

AUTHORS

Konstantin Ryabitsev <icon.[at].linux.duke.edu>

SEE ALSO

epylog(8), epylog.conf(5)