Assigning a log filter to a step

To use the log filter, you must assign the log filter to a project step using the step Result property. When you assign a log filter to a step, the filter patterns in the log filter are run on the step output whenever the project runs. A log filter does not, however, apply to adaptor output.

When you assign a log filter to a step, the step result that is set by the log filter overrides all other criteria for determining the success or failure of the step, including the exit status for the step commands or any step properties. For example, if the step run time exceeds the time specified by the step Timeout property, the step stops. But, its status is not considered a failure unless its associated log filter action causes it to be set to Fail.

To assign a log filter to a step, do the following:

  1. Select Projects or Libraries to access the step.
  2. Select the project or library that contains the step.
  3. Select the step to open the step Details panel.
  4. At Result, select the log filter that you want to run each time the step runs.

Enabling log filters to include entries in the step log

Log filters can be applied to the following step log line types:
  • EXEC
  • RESULT
  • ERROR
  • READ
  • WRITE
  • MANIFEST
  • TMO

When applied, the corresponding step log output lines are included in the filtered results. Log filters cannot be applied to the STEP type. The STEP type is always skipped by log filters.


Feedback