Issue
-
JobConfigHistory Plugin is impacting the performance of the instance.
-
I don’t know how I should configure the JobConfigHistory Plugin
-
The JobConfigHistory Plugin plugin consumes a lot of disk space.
-
inodes
are at 99% capacity on the volume withJENKINS_HOME
-
Saving Jenkins system configuration is very slow.
Environment
-
CloudBees CI (CloudBees Core) on modern cloud platforms - Managed controller
-
CloudBees CI (CloudBees Core) on modern cloud platforms - Operations Center
-
CloudBees CI (CloudBees Core) on traditional platforms - Client controller
-
CloudBees CI (CloudBees Core) on traditional platforms - Operations Center
Resolution
JobConfigHistory Plugin is a plugin designed to maintain the history of what has changed in the Jenkins job configuration and the system configuration. When a manual or programmatic save operation is performed in Jenkins, this plugin saves the history of what was changed (diff) and who made the changes (user).
Recommended configuration
Many customization possibilities will improve the performance of the JobConfigHistory Plugin.
The configuration can be edited at Manage Jenkins -> Configure System -> Job Config History:
-
Use different history directory than default
- Setting this option to a new location is good if you would like to store the job configuration history in another location other than$JENKINS_HOME/config-history
(like another mount or another drive). We strongly encourage users to set this to another mount/drive as the job config history plugin will increase the number of inodes for theJENKINS_HOME
directory. -
Max number of history entries to keep
- We recommend keeping this number to a minimum (about 1000). If left blank then all entries will be kept. -
Max number of days to keep history entries
- We recommend the max number of days to be 30 days. -
Max number of history entries to show per page
- (For Job Config History version 2.18 or later) We recommend keeping this number to a minimum (about 20). This control the number of history records being loaded when browsing the config history of a job. -
System configuration exclude file pattern
(default:queue\.xml|nodeMonitors\.xml|UpdateCenter\.xml|global-build-stats
) - If there is configuration in the System configuration page which is altered too often or if altering it does not impact users, then those options can be excluded from being added to the exclude file pattern. Please, keep the default configuration, adding more patterns if required. For example,queue\.xml|nodeMonitors\.xml|UpdateCenter\.xml|global-build-stats|OperationsCenterCredentialsProvider|LockableResourcesManager\.xml|MilestoneStep\.xml
-
Do not save duplicate history
- We recommend having this option disabled (un-checked). When enabled, this option removes duplicate entries or entries where nothing changes but this option is known to cause performance issues. -
Save Maven module configuration changes
- We recommend having this option disabled (un-checked). When enabled, and a maven project completes the job configuration is saved, which causes an increase in the amount of maven module configuration changes. -
Show build badges
- Set toNever
in order to not overload the history widget. -
Exclude users
- If you want to exclude changes by a specific user. For example, excludingSYSTEM
in a CJP operations center - CJP client controller configuration.