Man Linux: Main Page and Category List

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@linux.duke.edu>

SEE ALSO

       epylog(8), Epylog(3), epylog.conf(5)