Filtering Log Messages by Text in GxTail
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.
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. See Filter Properties Dialog - Online Help for functional descriptions of these options.
- 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.
Last modified: 3/8/2018 5:39:55 PM