About log filters

Use log filters to specify the success criteria for a step. A filter stores one or more regular expressions.

If filtering is not set up, Build Forge determines the success or failure of a step command by the command's exit status, where 0 is success and 1 is failure. If multiple commands are used in the Command property, only the exit status of the last command issued affects the step result status. Note that some commands always return a 0 exit status. A reporting command like net use prints a list of mapped network drives. The command always succeeds, even if the list does not contain the desired drive.

Log filters allow you to evaluate the output from the commands in a step rather than the exit status.

For example, for the net use command, you can use a log filter to look for a specific drive and mark the step as successful if it is found.

About the Log Filters panel

Use the Log Filters panel to create, edit, and delete log filters. To view the panel, select Projects > Log Filters.

Screen image of Log Filters panel in the Projects panel

The panel has the following fields.

Name
The name for the log filter.
Access
The access group of users who can use this filter.

Feedback