Filters control which messages are visible in the log window by visually collapsing lines that meet the filter criteria. Filter criteria apply a simple string or complex regular expression to message text. You can specify text that a message must include or exclude. You can filter on a Process ID, Thread ID or Job ID, or you can specify a string or expression that message content must include or exclude. Regular expressions are supported.
You can set filtering criteria two ways:
-
Manually set filtering criteria in the Filter Properties dialog box.
-
Read filtering criteria from one or more saved profiles.
Before You Begin
Ensure that the file to be filtered is open in the active window.
Procedures
Set Filter Criteria Manually
-
Click Edit > Filter.
-
Ensure the Enable Filter check box is selected.
-
Optional: Enter any combination of Process ID, Thread ID and Job ID values.
-
Enter a string or regular expression that a message must contain (in Include Containing String), or must not contain (in Exclude Containing String).
-
If you want the value you entered above to be evaluated as a regular expression, select the Regular Expression check box. Note that if you select this option, the other restrictive options (such as Case Sensitive) become disabled.
-
Optional: Select other filtering options as desired. For more information, see "Filter Properties" in Help for GxTail Dialog Boxes.
-
Optional: To save only the messages that meet your critieria, click the File Open button,
, then navigate to a folder and enter a name for the file where you will save them. Click Open. -
Optional: To place the messages that meet your criteria onto the Windows clipboard, select Copy the Filtered lines to the clipboard.
-
Click OK.
Read Filter Criteria from Saved Profiles
-
On the GxTail toolbar, click
. -
In Folder Path, enter the path to the folder that contains the profile you want to load.
-
In Profile Name, enter the profile names to load. Separate multiple profile names with commas.
-
In File Names, enter the start of a file name. GxTail terminates the name with an implied 'any characters' wildcard. For example, if you enter CVD, filtering infers CVD*.*, which also works to match all log files of that type that have iteration numbers (such as CVD_1.log and CVD_2.log.) Separate multiple file names with commas.
-
Click OK.