GigaSpaces XAP 10.0.1 API

org.openspaces.admin
Interface Admin

All Superinterfaces:
DumpProvider, StatisticsMonitor

public interface Admin
extends StatisticsMonitor, DumpProvider

The main interface for accessing Admin API. Created using the AdminFactory class.

Provides access to the main elements in the Admin API and in GigaSpaces such as the GridServiceAgents, LookupServices, GridServiceManagers, GridServiceContainers, ProcessingUnits, and Spaces.

Also allows to change monitoring (not statistics) interval (works in a polling fashion) of state changing elements such as the processing unit, the Grid Service Agent, and the Space.

Implements the StatisticsMonitor interface, allowing in one single call (StatisticsMonitor.startStatisticsMonitor()) to start statistics monitors on all the elements it manages (such as the Spaces, and VirtualMachines.

Provides one stop shop for registering all event listeners that extend AdminEventListener using the addEventListener(AdminEventListener) and their removal removeEventListener(AdminEventListener). The actual event listener interfaces will be automatically detected and added to the correct component.

Author:
kimchy

Field Summary
 
Fields inherited from interface org.openspaces.admin.StatisticsMonitor
DEFAULT_HISTORY_SIZE, DEFAULT_MONITOR_INTERVAL
 
Method Summary
 void addEventListener(AdminEventListener eventListener)
          Smart addition of event listeners.
 void addEventListener(AdminEventListener eventListener, boolean withStatisticsHistory)
          Smart addition of event listeners.
 void close()
          Closes the Admin, releasing any resource and stops listening for events from the lookup service.
 DumpResult generateDump(Set<DumpProvider> dumpProviders, DumpGeneratedListener listener, String cause, Map<String,Object> context, String... processor)
          Generates dump for an explicit set of dump providers.
 AlertManager getAlertManager()
          Returns the alert manager through which alert strategies are managed, alerts are fired and alert events are registered for.
 Applications getApplications()
           
 ElasticServiceManagers getElasticServiceManagers()
          Returns the elastic service managers discovered.
 int getEventListenersCount()
          Returns number of registered event listeners.
 GatewayProcessingUnits getGatewayProcessingUnits()
          Returns the Gateway Processing Units discovered.
 Gateways getGateways()
          Returns the gateways discovered.
 GridComponent getGridComponentByUID(String uid)
          Returns the Grid Component represented by this UID; e.g.
 GridServiceAgents getGridServiceAgents()
          Returns the grid service agents discovered.
 GridServiceContainers getGridServiceContainers()
          Returns the grid service containers discovered.
 GridServiceManagers getGridServiceManagers()
          Returns the grid service managers discovered.
 String[] getGroups()
          Returns the lookup groups this admin uses.
 LookupLocator[] getLocators()
          Returns the lookup locators this admin uses.
 LookupServices getLookupServices()
          Returns the lookup services discovered.
 Machines getMachines()
          Returns the machines discovered.
 OperatingSystems getOperatingSystems()
          Returns the Operating Systems discovered.
 ProcessingUnits getProcessingUnits()
          Returns the Processing Units discovered.
 Spaces getSpaces()
          Returns the spaces discovered.
 Transports getTransports()
          Returns the transports discovered.
 VirtualMachines getVirtualMachines()
          Returns the Virtual Machines discovered.
 Zones getZones()
          Returns the zones discovered.
 void removeEventListener(AdminEventListener eventListener)
          Smart removal of event listeners.
 void setAgentProcessessMonitorInterval(long interval, TimeUnit timeUnit)
          Sets the Grid Service Agent processes monitor (not statistics) interval.
 void setDefaultTimeout(long timeout, TimeUnit timeUnit)
          The default timeout to be used for operations that have a wait for mechanism, i.e. operations with overloaded methods containing (..., long timeout, TimeUnit timeUnit).
 void setProcessingUnitMonitorInterval(long interval, TimeUnit timeUnit)
          Sets the processing unit monitor (not statistics) interval.
 void setSchedulerCorePoolSize(int coreThreads)
          The Admin API uses a shared scheduler thread pool to perform *all* scheduled operations (monitoring, statistics monitoring).
 void setSpaceMonitorInterval(long interval, TimeUnit timeUnit)
          Sets the Space monitor (not statistics) interval.
 
Methods inherited from interface org.openspaces.admin.StatisticsMonitor
isMonitoring, setStatisticsHistorySize, setStatisticsInterval, startStatisticsMonitor, stopStatisticsMonitor
 
Methods inherited from interface org.openspaces.admin.dump.DumpProvider
generateDump, generateDump
 

Method Detail

getGroups

String[] getGroups()
Returns the lookup groups this admin uses.

See Also:
AdminFactory.addGroup(String)

getLocators

LookupLocator[] getLocators()
Returns the lookup locators this admin uses.

See Also:
AdminFactory.addLocator(String)

setProcessingUnitMonitorInterval

void setProcessingUnitMonitorInterval(long interval,
                                      TimeUnit timeUnit)
Sets the processing unit monitor (not statistics) interval. The monitor basically checks the status of each processing unit (ProcessingUnit.getStatus() among other things.

Defaults to 1 second.

Parameters:
interval - The interval to use.
timeUnit - The time unit the interval is at.

setAgentProcessessMonitorInterval

void setAgentProcessessMonitorInterval(long interval,
                                       TimeUnit timeUnit)
Sets the Grid Service Agent processes monitor (not statistics) interval. The monitor basically updates the list of processes the agent manages (GridServiceAgent.getProcessesDetails().

Defaults to 5 seconds.

Parameters:
interval - The interval to use.
timeUnit - The time unit the interval is at.

setSpaceMonitorInterval

void setSpaceMonitorInterval(long interval,
                             TimeUnit timeUnit)
Sets the Space monitor (not statistics) interval. The monitor checks each space instance and updates its different status (such as the replication status).

Defaults to 1 second.

Parameters:
interval - The interval to use.
timeUnit - The time unit the interval is at.

setSchedulerCorePoolSize

void setSchedulerCorePoolSize(int coreThreads)
The Admin API uses a shared scheduler thread pool to perform *all* scheduled operations (monitoring, statistics monitoring). The number of threads used can be set here.

Defaults to 10 threads.

Parameters:
coreThreads - The number of threads the shared scheduler thread pool will use,

setDefaultTimeout

void setDefaultTimeout(long timeout,
                       TimeUnit timeUnit)
The default timeout to be used for operations that have a wait for mechanism, i.e. operations with overloaded methods containing (..., long timeout, TimeUnit timeUnit). If not set, the default is Long.MAX_VALUE, TimeUnit.MILLISECONDS

Parameters:
timeout - The timeout value to be used as the default operation timeout if non was provided.
timeUnit - The time-unit corresponding to the timeout.

close

void close()
Closes the Admin, releasing any resource and stops listening for events from the lookup service.


getGridServiceAgents

GridServiceAgents getGridServiceAgents()
Returns the grid service agents discovered.


getLookupServices

LookupServices getLookupServices()
Returns the lookup services discovered.


getGridServiceManagers

GridServiceManagers getGridServiceManagers()
Returns the grid service managers discovered.


getElasticServiceManagers

ElasticServiceManagers getElasticServiceManagers()
Returns the elastic service managers discovered.


getGridServiceContainers

GridServiceContainers getGridServiceContainers()
Returns the grid service containers discovered.


getGateways

Gateways getGateways()
Returns the gateways discovered.

Since:
8.0.4

getGatewayProcessingUnits

GatewayProcessingUnits getGatewayProcessingUnits()
Returns the Gateway Processing Units discovered.

Since:
9.5

getGridComponentByUID

GridComponent getGridComponentByUID(String uid)
Returns the Grid Component represented by this UID; e.g. ESM, GSA, LUS, GSM, GSC

Parameters:
uid - The UID of the service returned by GridComponent.getUid(); null if no representation.
Returns:
The Grid Component represented by this UID.
See Also:
GridComponent.getUid()

getMachines

Machines getMachines()
Returns the machines discovered.


getZones

Zones getZones()
Returns the zones discovered.


getApplications

Applications getApplications()
Returns:
the discovered applications
Since:
8.0.3

getTransports

Transports getTransports()
Returns the transports discovered.


getVirtualMachines

VirtualMachines getVirtualMachines()
Returns the Virtual Machines discovered.


getOperatingSystems

OperatingSystems getOperatingSystems()
Returns the Operating Systems discovered.


getProcessingUnits

ProcessingUnits getProcessingUnits()
Returns the Processing Units discovered.


getSpaces

Spaces getSpaces()
Returns the spaces discovered.


getAlertManager

AlertManager getAlertManager()
Returns the alert manager through which alert strategies are managed, alerts are fired and alert events are registered for.


addEventListener

void addEventListener(AdminEventListener eventListener)
Smart addition of event listeners. Will automatically add to the correct place any interface that extends the AdminEventListener interface.

See Also:
removeEventListener(AdminEventListener)

addEventListener

void addEventListener(AdminEventListener eventListener,
                      boolean withStatisticsHistory)
Smart addition of event listeners. Will automatically add to the correct place any interface that extends the AdminEventListener interface.

Parameters:
withStatisticsHistory - if all statistics histories will be fired on registration statistics listener
See Also:
removeEventListener(AdminEventListener)

removeEventListener

void removeEventListener(AdminEventListener eventListener)
Smart removal of event listeners. Will automatically remove to the correct place any interface that extends the AdminEventListener interface.

See Also:
addEventListener(AdminEventListener)

getEventListenersCount

int getEventListenersCount()
Returns number of registered event listeners. See AdminEventListener. Only for calls issued by either addEventListener or removeEventListener

Since:
8.0.5
See Also:
addEventListener(AdminEventListener), removeEventListener(AdminEventListener)

generateDump

DumpResult generateDump(Set<DumpProvider> dumpProviders,
                        DumpGeneratedListener listener,
                        String cause,
                        Map<String,Object> context,
                        String... processor)
                        throws AdminException
Generates dump for an explicit set of dump providers.

Throws:
AdminException

GigaSpaces XAP 10.0.1 API

Copyright © GigaSpaces.