/hudson-core/src/main/resources/hudson/model/LoadStatistics/main.properties

 1# The MIT License
 2# 
 3# Copyright (c) 2004-2009, Sun Microsystems, Inc., Kohsuke Kawaguchi
 4# 
 5# Permission is hereby granted, free of charge, to any person obtaining a copy
 6# of this software and associated documentation files (the "Software"), to deal
 7# in the Software without restriction, including without limitation the rights
 8# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 9# copies of the Software, and to permit persons to whom the Software is
10# furnished to do so, subject to the following conditions:
11# 
12# The above copyright notice and this permission notice shall be included in
13# all copies or substantial portions of the Software.
14# 
15# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
21# THE SOFTWARE.
22
23title=Load statistics: {0}
24blurb=\
25  Load statistics keep track of three key metrics of resource utilization: \
26  <dl> \
27    <dt>Total number of executors</dt> \
28    <dd>\
29      For a computer, this is the number of executors that the computer has. \
30      For a label, this is the sum of all executors across all computers in this label. \
31      For the entire Hudson, this is the sum of all executors across all computers in this Hudson installation. \
32      Other than configuration changes, this value can also change when slaves go offline. \
33    </dd> \
34    <dt>Number of busy executors</dt> \
35    <dd>\
36      This line tracks the number of executors (among the executors counted above) \
37      that are carrying out builds. The ratio of this to the total number of executors \
38      gives you the resource utilization. If all your executors are busy for \
39      a prolonged period of time, consider adding more computers to your Hudson cluster.\
40    </dd>\
41    <dt>Queue length</dt>\
42    <dd>\
43      This is the number of jobs that are in the build queue, waiting for an \
44      available executor (of this computer, of this label, or in this Hudson, respectively.) \
45      This doesn't include jobs that are in the quiet period, nor does it include \
46      jobs that are in the queue because earlier builds are still in progress. \
47      If this line ever goes above 0, that means your Hudson will run more builds by \
48      adding more computers.\
49    </dd>\
50  </dl>\
51  The graph is exponential moving average of periodically collected data values. \
52  3 timespans are updated every 10 seconds, 1 minute, and 1 hour respectively.