File Content

The File Content component scans for the existence or occurrences of a specified string pattern within application and system log files and uses those file in the application profile of which it is a part. It is intended for scanning text files such as logs, for example, and not binary files. For best performance, select as few files to scan as possible. Using regular expressions to specify filename and scan pattern can affect performance. It is imperative to create detailed regular expressions, specifically for specifying the scan pattern, in order to achieve the best results.

Important: This component is only available for use after upgrading to WhatsUp Gold v16.4.1.

Configure the following for the file content component:

Name. Enter a unique name for the component.
Description. (Optional) Enter any additional information about the component to display within the UI.
Critical. Click to select this check box if the component is critical.
Polling frequency. Select a time (in minutes or hours) you want APM to wait between polls.
Path of the folder to monitor. The Universal Naming Convention (UNC) file path WhatsUp Gold uses to access the folder.
Include all files. Select this option to configure the component to scan all accessible files.
Include files with names matching the following wildcard/regular expression. Select either wildcard or regular from the list, then enter all or part of a file name for which the component should search.
Note: Wildcards expressions can be used to filter your file search results. For example, to list all text files with .txt extension, you would use: *.txt

Or, to find all text files named file_1.txt, file_2.txt, you would use: file?.txt

For these examples, the * wildcard is used for matching multiple characters and the ? wildcard is used for matching a single character.
Pattern to scan. Enter the literal string or regular expression for which the component should search.
Important: Only single line expressions are supported.
Pattern is a literal string. Select this option if the pattern you entered is a literal string and the monitor should search the pattern without attempting to interpret anything entered as a regular expression.
Perform case sensitive comparison. Select this option to ensure the component considers upper and lower case characters as entered.
Scan entire file contents. Select this option to search an entire file for the pattern.
Scan only the content added to the file since the last poll. Select this option to limit the search to only new information in a file.
Note: If the Scan only the content added to the file since the last poll option is selected, WhatsUp Gold tracks the offset within the file reached during scanning, then picks up from that point during the next scan. This is not necessarily the end of the file as a timeout could result in not reaching the end of the file. If a file scanned is deleted, then re-created with new content, then one of two things can happen: If the recreated file is smaller than the last scanned offset for that file, WhatsUp Gold start scanning from the beginning of the file. Or, if the recreated file is the same size or larger than the last scanned offset, then WhatsUp Gold picks up the scanning from the last scanned offset.
Timeout (seconds). Enter the length of time WhatsUp Gold attempts to connect. When the time you enter is exceeded without connecting, a timeout occurs and WhatsUp Gold stops trying to connect. This is considered a failed connection. The timeout can not be configured greater than 60 seconds.
Ignore Timeout Error. Enable this option to ignore any timeout errors encountered when scanning files.

Specify the number of instances of the pattern the component must find to report as either up or down.