Reporters

Reporters are like publishers but only applicable to Maven projects.

Component: reporters

Macro:reporter Entry Point:jenkins_jobs.reporters

Example:

job:
  name: test_job
  project-type: maven

  reporters:
    - email:
        recipients: breakage@example.com

email

Email notifications on build failure.

Parameters:

• recipients (str) – Recipient email addresses
• notify-every-unstable-build (bool) – Send an email for every unstable build (default true)
• send-to-individuals (bool) – Send an email to the individual who broke the build (default false)
• notify-for-each-module (bool) – Send an email for each module (e.g. failed, unstable). (default true)

Example:

reporters:
  - email:
      recipients: breakage@example.com

findbugs

FindBugs reporting for builds

Requires the Jenkins FindBugs Plugin.

Parameters:

• rank-priority (bool) – Use rank as priority (default false)
• include-files (str) – Comma separated list of files to include. (Optional)
• exclude-files (str) – Comma separated list of files to exclude. (Optional)
• can-run-on-failed (bool) – Weather or not to run plug-in on failed builds (default false)
• healthy (int) – Sunny threshold (optional)
• unhealthy (int) – Stormy threshold (optional)
• health-threshold (str) – Threshold priority for health status (‘low’, ‘normal’ or ‘high’, defaulted to ‘low’)
• dont-compute-new (bool) – If set to false, computes new warnings based on the reference build (default true)
• use-delta-values (bool) – Use delta for new warnings. (default false)
• use-previous-build-as-reference (bool) – If set then the number of new warnings will always be calculated based on the previous build. Otherwise the reference build. (default false)
• use-stable-build-as-reference (bool) – The number of new warnings will be calculated based on the last stable build, allowing reverts of unstable builds where the number of warnings was decreased. (default false)
• thresholds (dict) –
  thresholds:

  • unstable (dict)

    unstable:

    • total-all (int)
    • total-high (int)
    • total-normal (int)
    • total-low (int)
    • new-all (int)
    • new-high (int)
    • new-normal (int)
    • new-low (int)

  • failed (dict)

    failed:

    • total-all (int)
    • total-high (int)
    • total-normal (int)
    • total-low (int)
    • new-all (int)
    • new-high (int)
    • new-normal (int)
    • new-low (int)

Minimal Example:

project-type: maven
reporters:
    - findbugs

Full Example:

project-type: maven
reporters:
    - findbugs:
        rank-priority: true
        include-files: 'f,d,e,.*'
        exclude-files: 'a,c,d,.*'
        can-run-on-failed: true
        healthy: 80
        unhealthy: 10
        use-delta-values: true
        health-threshold: 'high'
        thresholds:
            unstable:
                total-all: 90
                total-high: 80
                total-normal: 50
                total-low: 20
                new-all: 95
                new-high: 85
                new-normal: 55
                new-low: 25
            failed:
                total-all: 80
                total-high: 70
                total-normal: 40
                total-low: 10
                new-all: 85
                new-high: 75
                new-normal: 45
                new-low: 15
        dont-compute-new: false
        use-delta-values: true
        use-previous-build-as-reference: true
        use-stable-build-as-reference: true