{jenkins-plugin-info:pluginId=cloudbees-jenkins-advisor}


 

In February 2018 CloudBees decided to end the CloudBees Jenkins Advisor free program.

This feature remains available for CloudBees customers.

Thank you to everyone who used CloudBees Jenkins Advisor.


CloudBees Jenkins Advisor
is a free diagnostics services which distills years of Jenkins expertise into recommendations tailored to your Jenkins environment.


Now you can use CloudBees Jenkins Advisor if you are running on any Jenkins version 2.19.3 or higher.


This plugin periodically uploads support bundles to a diagnostics service hosted by CloudBees. Once an issue is detected, it advises you on solutions using CloudBees’ expansive knowledge base of common and known issues.

For more help with diagnosing your identified issues, check out the CloudBees Support Community and the CloudBees Jenkins Knowledge Base

This proactive approach support will help you to fix issues before they impact your software delivery process - increasing your team's uptime, performance and productivity.

 

Usage Requirements 

Getting started

To start, install the CloudBees Jenkins Advisor plugin from the Jenkins update center, sign up for a CloudBees account, and from the "Manage" page, select "Manage CloudBees Jenkins Advisor"

Now add your CloudBees account credentials and test to ensure your instance can connect successfully to the CloudBees Jenkins Advisor hosted service.


Once you have successfully connected your Jenkins instance, you will receive a confirmation email, followed shortly by your first diagnostics report if any issues are detected. Your instance will be re-scanned daily for new issues, as well as after each restart of your master.


Advanced Configurations

Configuring analyzed data

You can configure what contents in your support bundle are sent to CloudBees by selecting the "Advanced Configuration" section, and selecting/unselecting the types of data that should or should no be uploaded.

There are a few command line/configuration file options to control when and how your data uploads to the CloudBees Jenkins Advisor service.

Setting custom upload intervals

To control how often your instance attempts to upload data for analysis, you can set a custom recurrence period. This setting cannot be overridden at runtime, and will require a restart to take effect. The default period is (60 * 24) (24hrs).

Override this setting by using a Java System Property:

-Dcom.cloudbees.jenkins.plugins.advisor.BundleUpload.recurrencePeriodMinutes=60

Setting custom upload timeout

To control how long your instance waits while attempting to connect and upload data to the Advisor service, you can set a custom advisor upload timeout. This can be changed dynamically and temporary at runtime via Jenkins Script Console:


System.setProperty("com.cloudbees.jenkins.plugins.advisor.client.AdvisorClientConfig.advisorUploadTimeoutMinutes", "120");Settings are lost after restart.

Or permanently by amending Jenkins Java System Properties:


-Dcom.cloudbees.jenkins.plugins.advisor.client.AdvisorClientConfig.advisorUploadTimeoutMinutes=120

This setting defaults to 60 (minutes)


Troubleshooting and Debugging

CloudBees Jenkins Advisor's tasks are AsyncPeriodicWork, so it stores its logs under  /logs/tasks

If you do not receive a welcome email soon after activating your connection, please check this folder errors in your logs. Errors can include:

Changelog

February 2018

Termination of the free service

1.3 (17 Nov. 2017)

Now supports 2.19.3+!

Connectivity indicator display on configuration page

Logging improvements

Additional test coverage

1.2 (5 Sept. 2017)

Fix for "Connect Now" error.

1.1 (25 Aug. 2017)

Change admin notification.

Security fixes.

1.0 (22 Aug. 2017)

First release.