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:

Before You Begin

Ensure that the file to be filtered is open in the active window.


Set Filter Criteria Manually

  1. Click Edit > Filter.
  2. Ensure the Enable Filter check box is selected.
  3. Optional: Enter any combination of Process ID, Thread ID and Job ID values.
  4. Enter a string or regular expression that a message must contain (in Include Containing String), or must not contain (in Exclude Containing String).
  5. 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.
  6. Optional: Select other filtering options as desired. See Filter Properties Dialog - Online Help for functional descriptions of these options.
  7. 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.
  8. Optional: To place the messages that meet your criteria onto the Windows clipboard, select Copy the Filtered lines to the clipboard.
  9. Click OK.

Read Filter Criteria from Saved Profiles

  1. On the GxTail toolbar, click .
  2. In Folder Path, enter the path to the folder that contains the profile you want to load.
  3. In Profile Name, enter the profile names to load.  Separate multiple profile names with commas.
  4. 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.
  5. Click OK.

Last modified: 3/8/2018 5:39:55 PM