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 panel.
- At Name, enter a name for the log filter,
and then click Save. The Management Console
saves the log filter and displays the New Pattern panel.
- For each filter pattern that you define for the log filter, do
the following:
- 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 email 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.