hudson.model

Class AdministrativeMonitor

java.lang.Object

hudson.model.AbstractModelObject

hudson.model.AdministrativeMonitor

All Implemented Interfaces:

ExtensionPoint, ModelObject, SearchableModelObject, SearchItem, org.kohsuke.stapler.StaplerProxy

Direct Known Subclasses:

AdminCallableMonitor, AdministrativeError, ApiTokenPropertyDisabledDefaultAdministrativeMonitor, ApiTokenPropertyEnabledNewLegacyAdministrativeMonitor, AsynchronousAdministrativeMonitor, CompletedInitializationMonitor, CSRFAdministrativeMonitor, DeprecatedAgentProtocolMonitor, DownloadSettings.Warning, HsErrPidList, HudsonHomeDiskUsageMonitor, Jenkins.EnforceSlaveAgentPortAdministrativeMonitor, LegacyApiTokenAdministrativeMonitor, MasterKillSwitchWarning, MonitorMarkedNodeOffline, NullIdDescriptorMonitor, OldDataMonitor, PluginManager.PluginCycleDependenciesMonitor, PluginManager.PluginUpdateMonitor, PluginWrapper.PluginWrapperAdministrativeMonitor, QueueItemAuthenticatorMonitor, ReverseProxySetupMonitor, RootUrlNotSetMonitor, SCMTrigger.AdministrativeMonitorImpl, SecurityIsOffMonitor, TooManyJobsButNoView, UpdateCenter.CoreUpdateMonitor, UpdateSiteWarningsMonitor, URICheckEncodingMonitor, ZFSInstaller, ZFSInstaller.MigrationCompleteNotice, ZFSInstaller.MigrationFailedNotice

public abstract class AdministrativeMonitor
extends AbstractModelObject
implements ExtensionPoint, org.kohsuke.stapler.StaplerProxy

Checks the health of a subsystem of Jenkins and if there's something that requires administrator's attention, notify the administrator.

How to implement?

Plugins who wish to contribute such notifications can implement this class and put Extension on it to register it to Jenkins.

Once installed, it's the implementer's responsibility to perform monitoring and activate/deactivate the monitor accordingly. Sometimes this can be done by updating a flag from code (see SCMTrigger for one such example), while other times it's more convenient to do so by running some code periodically (for this, use Trigger.timer)

AdministrativeMonitors are bound to URL by Jenkins.getAdministrativeMonitor(String). See getUrl().

Views

message.jelly

If isActivated() returns true, Jenkins will use the message.jelly view of this object to render the warning text. This happens in the http://SERVER/jenkins/manage page. This view should typically render a DIV box with class='alert alert-error' or class='alert alert-warning' with a human-readable text inside it. It often also contains a link to a page that provides more details about the problem.

Since:

1.273

Author:

Kohsuke Kawaguchi

See Also:

Jenkins.administrativeMonitors

Nested Class Summary

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

ExtensionPoint.LegacyInstancesAreScopedToHudson

Field Summary

Fields

Modifier and Type	Field and Description
String	id Human-readable ID of this monitor, which needs to be unique within the system.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AdministrativeMonitor()
protected	AdministrativeMonitor(String id)

Method Summary

Modifier and Type	Method and Description
static ExtensionList<AdministrativeMonitor>	all() All registered AdministrativeMonitor instances.
void	disable(boolean value) Mark this monitor as disabled, to prevent this from showing up in the UI.
void	doDisable(org.kohsuke.stapler.StaplerRequest req, org.kohsuke.stapler.StaplerResponse rsp) URL binding to disable this monitor.
String	getDisplayName()
String	getSearchUrl() Returns the URL of this item relative to the parent SearchItem.
Object	getTarget() Requires ADMINISTER permission for any operation in here.
String	getUrl() Returns the URL of this monitor, relative to the context path, like "administrativeMonitor/foobar".
abstract boolean	isActivated() Returns true if this monitor is activated and wants to produce a warning message.
boolean	isEnabled() Returns true if this monitor isn't disabled earlier.

Methods inherited from class hudson.model.AbstractModelObject

getSearch, getSearchIndex, getSearchName, makeSearchIndex, requirePOST, sendError, sendError, sendError, sendError, sendError

Methods inherited from class java.lang.Object

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

Field Detail

id

public final String id

Human-readable ID of this monitor, which needs to be unique within the system.

This ID is used to remember persisted setting for this monitor, so the ID should remain consistent beyond the Hudson JVM lifespan.

Constructor Detail

AdministrativeMonitor

protected AdministrativeMonitor(String id)

AdministrativeMonitor

protected AdministrativeMonitor()

Method Detail

getUrl

public String getUrl()

Returns the URL of this monitor, relative to the context path, like "administrativeMonitor/foobar".

getDisplayName

public String getDisplayName()

Specified by:

getDisplayName in interface ModelObject

getSearchUrl

public final String getSearchUrl()

Description copied from interface: SearchItem

Returns the URL of this item relative to the parent SearchItem.

Specified by:

getSearchUrl in interface SearchItem

Returns:

URL like "foo" or "foo/bar". The path can end with '/'. The path that starts with '/' will be interpreted as the absolute path (within the context path of Jenkins.)

disable

public void disable(boolean value)
             throws IOException

Mark this monitor as disabled, to prevent this from showing up in the UI.

Throws:

IOException

isEnabled

public boolean isEnabled()

Returns true if this monitor isn't disabled earlier.

This flag implements the ability for the admin to say "no thank you" to the monitor that he wants to ignore.

isActivated

public abstract boolean isActivated()

Returns true if this monitor is activated and wants to produce a warning message.

This method is called from the HTML rendering thread, so it should run efficiently.

doDisable

public void doDisable(org.kohsuke.stapler.StaplerRequest req,
                      org.kohsuke.stapler.StaplerResponse rsp)
               throws IOException

URL binding to disable this monitor.

Throws:

IOException

getTarget

@Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public Object getTarget()

Requires ADMINISTER permission for any operation in here.

Specified by:

getTarget in interface org.kohsuke.stapler.StaplerProxy

all

public static ExtensionList<AdministrativeMonitor> all()

All registered AdministrativeMonitor instances.