Jenkins Build Failure Analyzer

The Build Failure Analyzer Jenkins plugin analyzes the causes of failed builds and presents the causes on the build page.

It does this by using a knowledge base of build failure causes maintained from scratch.

Plugin Documentation

Official plugin documentation: https://plugins.jenkins.io/build-failure-analyzer/

Make sure your Jenkins server has this plugin installed before proceeding.

Plugin Permissions

To configure the Build Failure Analyzer plugin’s permissions select: Manage Jenkins -> Configure Global Security -> Authorization section

The table under the Authorization section will show the Build Failure Analyzer column.

Users and/or groups can add or remove the following permissions:

  • View Causes

  • Update Causes

  • Remove Causes

View Causes

Depending on the permissions granted to the groups to use the Build Failure Analyzer, users will be able to see the Failure Cause Management option in the left side menu in Jenkins.

This option will display the current causes in a table with:

  • Name

  • Categories

  • Description

  • Comment

  • Modified

  • Remove Cause Icon (Depending on permissions)

Jenkins Failure Cause Management table.

Update Causes

The Create New option adds a new cause.

A new cause will require the following information:

  • Name

  • Description

  • Comment

  • Categories (It will autocomplete for any existing categories)

  • Indications (What to look for in the log. Regex pattern or text)

  • Modification history (Date, time and username)

Jenkins Create New Build Cause.

To update an existing cause, click on a cause’s name from the current table.

Delete Causes

The last column of the causes table will show a remove icon for those groups with permissions to Remove Causes. No icon will appear if this permission is not granted.

The same Remove option will appear if the user clicks on the name of any of the causes in the table.