Files Name Patterns

XpoLog name patterns provides the option to capture multiple files as part of the same log type.
Log files are usually being rotated / written with a dynamic name that keeps changing most commonly there's a date in the file name or a changing number.

When adding a log to XpoLog it is possible to use a name pattern (similar to a wild card) that capture the set of files which are part of the same log.

It is highly important to verify the name pattern carefully and ensure that it does not capture other types of files, the distinguish should be that using name patterns there should not be more than one active log file (file that is being updated) in the captured list.



Examples for different series of files:

  • log.log, log.log.1, log.log.2, ..., log.log.n  - may be defined as log.log{string}

  • log-01-12-2019.log, log-02-12-2019.log, ... - may be defined as log-{date,dd-MM-yyyy}.log

  • Important - if the same directory contains the following series:

    • Series I: xpolog-log.log, xpolog-log.log.1,... xpologlog.n

    • Series II: xpolog-memory.log, xpolog-memory.1.log, ... xpolog-memory.n.log

    • Series III: xpolog-audit.log, xpolog-audit-01-12-2019.log, xpolog-audit-02-12-2019.log, ...

    The name pattern used should capture on the desired series and not files from more than one series:

    • xpolog{string}.log --> this is a wrong name pattern as it will capture all files that start with 'xpolog' and end with .log which matches all 3 series.

    • The correct way is to ensure each series is captured separately, so 3 separate log types should be added in XpoLog:

      • Series I: xpolog-log.log{string}

      • Series II: xpolog-memory.{string}.log

      • Series III: xpolog-audit-{date,dd-MM-yyyy}.log

In case it is not possible to represent the specific name pattern to capture the desired series it is recommended to set the active file name only without a pattern.

Â