Configuring CloudBees SCM Reporting notifications

All notification options are applied by default; however, you may want to remove certain notifications. You can also update the default maximum number of log lines (10) that appear when fatal errors are reported.

To configure CloudBees SCM Reporting notifications for GitHub or Bitbucket:
  1. Navigate to the CloudBees CI master.

  2. Select the GitHub Organization, Bitbucket Team/Project, or Multibranch Pipeline project.

  3. Select Configure.

  4. On the General tab, under Projects > GitHub Organization or Bitbucket Team/Project > Behaviours, select Add.

    add scm config
    If you are using a Multibranch Pipeline project, select Add under Branch Sources > Bitbucket or GitHub > Behaviours.
  5. Under General, select CloudBees SCM Reporting from the options.

    select cb scm reporting
  6. Configure the following available notifications:

    • Fatal errors: Enter the maximum number of log lines you wish to include when fatal errors are reported. Select the X to turn off the notification.

    • JaCoCo coverage: Select the X to turn off the notification.

    • Pipeline stages: Select which Pipeline stages you want included in your notifications: All Stages, Only failed stages, or Failed or fixed stages. Select the X to turn off the notification.

    • Test results: Select the X to turn off the notification.

    • Warnings-NG issues: Select the X to turn off the notification.

      cb scm reporting options
  7. (Optional) Select the Limit line annotations to visible diff checkbox if you only want to see build warnings associated with the PR. Otherwise, notifications will include warnings for the build that are not associated with the PR.

  8. Select Save.

If you select CloudBees SCM Reporting but remove all notifications, no special notifications will be sent for that project (only the OSS build status).

To disable CloudBees SCM Reporting notifications by default on a specific master, select Manage Jenkins > Configure System. Then, under CloudBees SCM Reporting, uncheck the Enabled by default checkbox.

Even if you have disabled CloudBees SCM Reporting notifications by default, you can still enable notifications on selected projects.

Viewing GitHub Checks tab notifications

If you have enabled GitHub App authentication for your GitHub Organization, the CloudBees CI SCM Reporting feature will send richer notifications to the Checks tab in GitHub.

These richer notifications include:

Furthermore, these notifications help create a more durable audit log, since the URL, which includes the check run ID, will be available as a record in GitHub’s database, even after you have deleted your CloudBees CI build logs.

check run id

Failed checks will display a Re-run link if you have write access to the repository.

Rerun link in GitHub
Figure 1. Rerun link in GitHub

Selecting this link will trigger a new build of the same commit in CloudBees CI, and soon new checks should appear. This is useful in case you believe a build failure was transient: for example, caused by a network outage or a flaky test.

Disabling OSS build status notifications

If you want to limit the redundancy of the build notifications you receive in the Conversations tab in GitHub, you can disable the OSS build status notifications by installing either the Skip Notifications Trait plugin or the Disable GitHub Multibranch Status plugin.

These options will appear near the CloudBees SCM Reporting plugin section in your organization or folder configuration when the plugins are installed.