hudson.model.queue

Class LoadPredictor

java.lang.Object

hudson.model.queue.LoadPredictor

All Implemented Interfaces:

ExtensionPoint

Direct Known Subclasses:

BackFiller, LoadPredictor.CurrentlyRunningTasks

public abstract class LoadPredictor
extends Object
implements ExtensionPoint

Predicts future load to the system, to assist the scheduling decisions

When Hudson makes a scheduling decision, Hudson considers predicted future load — e.g., "We do currently have one available executor, but we know we need this for something else in 30 minutes, so we can't currently schedule a build that takes 1 hour."

This extension point plugs in such estimation of future load.

Author:

Kohsuke Kawaguchi

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	LoadPredictor.CurrentlyRunningTasks Considers currently running tasks and their completion.

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

ExtensionPoint.LegacyInstancesAreScopedToHudson

Constructor Summary

Constructors

Constructor and Description
LoadPredictor()

Method Summary

Modifier and Type	Method and Description
static ExtensionList<LoadPredictor>	all() All the registered instances.
Iterable<FutureLoad>	predict(Computer computer, long start, long end) Deprecated. as of 1.380 Use predict(MappingWorksheet, Computer, long, long)
Iterable<FutureLoad>	predict(MappingWorksheet plan, Computer computer, long start, long end) Estimates load starting from the 'start' timestamp, up to the 'end' timestamp.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

LoadPredictor

public LoadPredictor()

Method Detail

predict

public Iterable<FutureLoad> predict(MappingWorksheet plan,
                                    Computer computer,
                                    long start,
                                    long end)

Estimates load starting from the 'start' timestamp, up to the 'end' timestamp.

Parameters:

start - Where to start enumeration. Always bigger or equal to the current time of the execution.

plan - This is the execution plan for which we are making a load prediction. Never null. While this object is still being partially constructed when this method is called, some of its properties (like MappingWorksheet.item provide access to more contextual information.

Since:

1.380

predict

@Deprecated
public Iterable<FutureLoad> predict(Computer computer,
                                                long start,
                                                long end)

Deprecated. as of 1.380 Use predict(MappingWorksheet, Computer, long, long)

Estimates load starting from the 'start' timestamp, up to the 'end' timestamp.

Parameters:

start - Where to start enumeration. Always bigger or equal to the current time of the execution.

all

public static ExtensionList<LoadPredictor> all()

All the registered instances.