Log filters may contain one or more filter patterns. Each filter pattern is associated with an action, and optionally an access group for notification. You define a log filter first and then associate the log filter with a step in the project.
To create a log filter, do the following:
Select
.The Management Console displays the list of Log Filters and the New Log Filter form.
At Name, enter a name for the log filter, then click Save.
The Management Console saves the log filter and displays the New Pattern form.
Enter a regular expression in the Pattern field. (The regular expression must be Perl-compatible.) Build Forge searches step output for the pattern when the project runs. For details, see Filter Patterns.
At Action, choose a filter action to take when the filter pattern is found. The default property, Set Fail, sets the step status to Fail. For details, see Filter Actions.
At Notify, optionally select an access group to send members a notification e-mail when the filter is activated.
Click Save.
To use the log filter, choose a project step and set the step's Result property to the new log filter. See Assigning a Log Filter to a Step.