Config File Syntax
uberAgent’s configuration file supports several advanced syntax features.
Windows
ConfigInclude
A @ConfigInclude
directive includes another configuration file. The other file is identified by name (without path) and must reside in the same directory as the configuration file including it.
Syntax:
@ConfigInclude FILE_NAME
PATH_REGEX
PATH_REGEX
stands for a regex in which environment variables can be used. It is matched against a file system path. The following rules apply:
- Environment variables (enclosed in percent signs, e.g.,
%ProgramFiles%
) are expanded first, regex matching happens second. - Paths are specified as regular expressions.
- Backslashes must be escaped by prepending a second backslash.
- Matching is case-insensitive.
- Specifying only the file name without the full path works but is not recommended.
Agents on All Operating Systems
PROCESS_NAME_REGEX
PROCESS_NAME_REGEX
stands for a regex that is matched against a process name. The following rules apply:
- Backslashes must be escaped by prepending a second backslash.
- Matching is case-insensitive.
- Only the file name is used for matching, not the full path.
URL_REGEX
URL_REGEX
stands for a regex that is matched against a URL. The following rules apply:
- Backslashes must be escaped by prepending a second backslash.
- Matching is case-sensitive.
Format of the URLs matched against URL_REGEX
:
- Origin and path (without query segment), e.g.:
https://uberagent.com/download/
- Port numbers are stripped from the URL if they match the default port number.