API DocumentationProduct Documentation
Product Documentation

Common Glob Patterns

Suggest Edits

Glob patterns specify sets of file names with wildcard characters. When you configure the Tetra File-Log Agent File Watcher Service, you can use glob patterns to monitor specified paths and detect changes in either certain files or folders.

🚧

IMPORTANT

It's recommended that you test your glob patterns by using a web application such as Glob tester before configuring them in the Tetra File-Log Agent.

Glob Pattern Syntax

The Tetra File-Log Agent supports the following glob syntax:

PatternsDescription
*matches any number of characters including none, excluding directory separator
**match zero or more directories
?matches a single character
/
-or-
\		path separators
[abc]matches one character in the brackets
[!abc]matches any character not in the brackets
{abc,123}comma-delimited set of literals, matched 'abc' or '123'

📘

NOTE

For alphabetical characters, only the standard 26 characters of the Latin alphabet are supported. Any alphabetical characters that aren't part of the standard Latin alphabet will cause data duplication.

Glob Pattern Examples

In the following examples, the path defined in the config.json is C:\temp\Source.

Searching Folders

Pattern:     * 
Description: Return all of the folders at the current folder path (C:\temp\Source)

Pattern:     A*
Description: Return all of the folders at the current folder path (C:\temp\Source) 
             with the folder name starting as A
             
Pattern:     */* 
Description: Return all of the folders at the first level under the current folder path (`C:\temp\Source`)

Pattern:     */*/*
Description: Return all of the folders at the second level under the current folder path (`C:\temp\Source`)

Pattern:     Logs
Description: Get a specific folder `Logs` at the current folder path (`C:\temp\Source`)

Patterns:    ** 
Description: Return all of the folders recursively under the current folder path 
             by traversing down the current folder path (`C:\temp\Source`)
             
Pattern:     **/AuditTrail
Description: Return all of the folder named as `AuditTrail` 
             by traversing down the current folder path (`C:\temp\Source`)

Pattern:     **/*AuditTrail*
Description: Return all of the folder named as `AuditTrail`
             by traversing down the current folder path (`C:\temp\Source`)
             
Pattern:     AuditTrail/2020-06-07
Description: Return the exact folder, `C:\temp\Source\AuditTrail\2020-06-07`

📘

NOTE

When using the Folder Mode for File Watcher Service, if the pattern is empty, the Agent will monitor the path itself.

Searching Files

Pattern: 		 *.txt	
Description: Return all of the files with extension as txt  at the current folder path (`C:\temp\Source`)

Pattern:     .{log,txt}
Description: Return all of the files with file extension either as .log or .txt at the current folder path (`C:\temp\Source`) 


Pattern:     info*.txt
Description: Return all of the files with the name starting with `info` at the current folder path (`C:\temp\Source`) 

Pattern:     info?.txt
Description: Return all of the files with the name starting with `info` and only has one character after that at the current folder path (`C:\temp\Source`). Same examples: info2.txt, infoz.txt 

Pattern:     info[123a].txt
Description: Return all of the files with the file name starting with `info` and only has one character after that. The matched character is among the characters of `1`, `2`, `3` or `a`. 

Pattern:     info[!123a].txt
Description: Return all of the files with the file name starting with `info` and only has one character after that. The matched character is not any of the characters of `1`, `2`, `3` or `a`. 

Pattern:     [!~]*.txt
Description: Return all of the files with file extension as txt and the file name doesn't start with ~. 
This pattern can be used  to exclude the temp files generated by the Windows. 


Pattern:     **/*
Description: Return all of the files 
             by traversing down the current folder path (C:\temp\Source)) recursively
             
Pattern:     **/EVO
Description: Return all of the files with file name starting with `EVO` by traversing down the current folder path  (C:\temp\Source)) recursively

Pattern:     **/*EVO*
Description: Return all of the files with file name containing `EVO` by traversing down the current folder path  (C:\temp\Source)) recursively

Pattern:     **/{EVO,LOG,ERROR}*
Description: Return all of the files with file name starting with `EVO`, `LOG`or `ERROR`, by traversing down the current folder path  (C:\temp\Source)) recursively

Updated about 1 month ago