/build-time-blame-plugin

A Jenkins plugin for analyzing the historical console output of a Job with the goal of determining which steps are taking the most time.

Primary LanguageGroovyMIT LicenseMIT

Build Time Blame Plugin

A Jenkins plugin for analyzing the historical console output of a Job with the goal of determining which steps are taking the most time.

Requirements:

What it does:

This plugin scans console output for successful builds. If the line matches one of the configured regex keys, it will store the timestamp generated for that line by the Timestamper Plugin. Then, it generates a report showing how those steps contributed to the total build time. This is intended to help analyze which steps in the build process are good candidates for optimization.

The plugin produces:

  • A Build Time Trend graph showing what portion of the total build time each step has taken over the scanned builds. Build Time Trend

  • A Last Successful Build Times table showing each line that was matched in the most recent build. This helps analyze if the steps being matched are correct. Last Successful Build Times

  • A Mean Successful Build Times table showing the mean amount of time each step has taken across all successful builds.

    Mean Successful Build Times

How to use it:

  1. Install Plugin

  2. Restart Jenkins

  3. Each job will now have a new action:

    Build Time Blame Report

  4. Enable Timestamps for any jobs you want to analyze (the report will only include results for builds where this plugin was enabled):

    Timestamper Plugin

  5. The report will be pre-populated with regex to denote the start and end of the job.

  6. Add/Update regex statements to match parts of the build process.

    • Regex Search Key: Lines in the console output that match this regex string will be added to the report. Any leading or trailing spaces will be excluded before checking if the rest of the line matches the regex. These keys should match when the particular step has begun. Make sure to add another match for when that step is complete or the next begins to get the correct elapsed time in the report.
    • Label: The matches will be shown with this label in the report.
    • Only Use First Match: If this box is checked, the search key will not be checked against after the first line it matches.
  7. (Optional) Set a limit on the "Maximum Builds To Process"

    • By default, the logs for all successfully completed builds will be scanned. For some jobs with long logs or many builds, limiting the report may allow it to load more quickly.
  8. Click Reprocess Report. This will regenerate the report by searching for the configured steps in the console output for each successful run of the job that had Timestamps enabled. Note: This process can take some time for jobs with a lot of console output and/or a lot of build history.

  9. When the report executes, the results for each build are cached. When the report is reloaded, the plugin will check for other successful builds that have not been processed and update the report accordingly.