When adding a Logs Directory to XpoLog, you can configure any of the following advanced settings:
- File Filters – enables specifying which files in the logs directory are to be scanned
- Scan Method – enables selecting the mechanisms used to match patterns to the logs during scanning
- Files Name Pattern – enables defining how to process files of similar names
- Log Settings – enables preventing XpoLog from indexing and/or running Analytics on incoming log files.
Defining the File Filters
By default, XpoLog scans all files from the selected directory. Especially in cases where the directory has many files, you may want to limit the number of files that XpoLog scans. In the File Filters advanced option, you can specify the names of the files to include and/or exclude in the scan, and also define the number of subdirectory levels to scan.
To define the file filters:
- Under Advanced Settings, click File Filters.
The File Filters definitions open. - In Include Files, type the names of the files to include in the scan, separated by commas.
- In Exclude Files, type the names of the files to exclude from the scan, separated by commas.
- In Subdirectories levels to scan, select Unlimited or a number from 1 to 10.
Defining the Scan Method
By default, during scanning, the automatic patterns that are matched to the logs are taken from an existing configuration that is based on log names, log content, and an automatic patterns generator. You can select to activate all these mechanisms (the defalut), or select the mechanisms to use.
To define the scan method:
- Under Advanced Settings, click Scan Method.
The Scan Method options open. - Select one of the following options:
Use existing configuration (file names and content) and automatic matching (the default) – Select this option to try and match patterns to detected logs by matching existing log patterns and log templates. In case no match is detected, runs automatic assignment of patterns. This method captures all readable files during scanning; however, it is the slowest method.
Use existing configuration (file names and content) – Select this option to try and match patterns to detected logs by matching existing log patterns and log templates. Files for which no existing log patterns or templates are matched are not captured.
Use existing configuration (file names only) – Select this option to try and match patterns by log templates only. Files for which no templates are matched are not captured.
Defining File Name Patterns
By default, XpoLog applies generic name patterns to files with the same naming convention. However, XpoLog enables you to set the wizard to capture each file separately.
To define file name patterns:
- Under Advanced Settings, click Files Name Pattern.
The Files Name Pattern options open. - Select one of the following options:
Unite files with similar names (apply name pattern automatically) (the default) – All files with similar names (such as rotating files, files with date suffixes, and files with numerical prefixes) will be captured as a single log type using a general name pattern.
Unite files with similar suffix (apply name pattern only at the end of the file name) – All files with similar name suffixes (such as rotating files, files with date suffixes) will be captured as a single log type using a general name pattern.
Capture each file separately (without name pattern) – A log type will be created for each file.
Defining Log Settings
By default, XpoLog indexes all incoming logs and runs Analytics on them. You can alter these defaults, by changing the log settings.
To define log settings:
- Under Advanced Settings, click Log Settings.
The Log Settings open. - Clear the Use indexing checkbox to prevent XpoLog from indexing the incoming log files.
- Clear the Generate analytics data checkbox to prevent XpoLog from performing Analytics on the incoming log files.