Skip to main content

Configuration Parameters

Configuration Parameters

The plugin receives all parameters directly via the command line:

advlogparser [--idx-dir <dir>] <log_dir> [<name_regex>] [<content_regex>] [<source_type>]

General Parameters

ParameterDescription
--idx-dirDirectory where index files are stored. The plugin must be able to read and write in this directory. Default: /tmp.

Log-Specific Parameters

ParameterDescription
log_dir *Directory containing the log files to process. All files in the directory are listed and filtered using name_regex.
name_regexRegular expression to filter file names within the directory. Default: .* (all files).
content_regexRegular expression to filter lines within the log content. Only matching lines are included in the output. Default: .* (all lines).
source_typeValue of the <source> field in the generated log module. Identifies the data source in Pandora FMS. Required if you expect to generate modules.

* Required parameter.

Regular Expression Examples

File name filter (name_regex):

.*\.log              → only files with .log extension
access.*\.log        → files starting with "access" and ending in ".log"
(app|sys)\.log       → files named "app.log" or "sys.log"

Content filter (content_regex):

(?i)error                → lines containing "error" (case-insensitive)
(?i)error|critical|fail  → lines containing error, critical, or fail
^ERROR                   → lines starting with ERROR
[0-9]{3}\s               → lines containing a 3-digit code followed by a space