org.gridgain.grid.spi.eventstorage
Interface GridEventStorageSpi

All Superinterfaces:

GridSpi, GridSpiJsonConfigurable

All Known Implementing Classes:

GridMemoryEventStorageSpi

public interface GridEventStorageSpi
extends GridSpi, GridSpiJsonConfigurable

This SPI provides local node events storage. SPI allows for recording local node events and querying recorded local events. Every node during its life-cycle goes through a serious of events such as task deployment, task execution, job execution, etc. For performance reasons GridGain is designed to store all locally produced events locally. These events can be later retrieved using either distributed query:

• GridProjection.remoteEvents(GridPredicate, long, org.gridgain.grid.lang.GridPredicate[])
• GridProjection.remoteEventsAsync(org.gridgain.grid.lang.GridPredicate , long, GridPredicate[])

or local only query:

• Grid.localEvents(org.gridgain.grid.lang.GridPredicate[])

NOTE: this SPI (i.e. methods in this interface) should never be used directly. SPIs provide internal view on the subsystem and is used internally by GridGain kernal. In rare use cases when access to a specific implementation of this SPI is required - an instance of this SPI can be obtained via Grid.configuration() method to check its configuration properties or call other non-SPI methods. Note again that calling methods from this interface on the obtained instance can lead to undefined behavior and explicitly not supported.

Wiki & Forum:

Wiki
Forum

See Also:

GridEvent

Method Summary

Collection<GridEvent>	localEvents(GridPredicate<? super GridEvent>... p) Queries locally-stored events only.
void	record(GridEvent evt) Records single event.

Methods inherited from interface org.gridgain.grid.spi.GridSpi

getName, getNodeAttributes, onContextDestroyed, onContextInitialized, spiStart, spiStop

Methods inherited from interface org.gridgain.grid.spi.GridSpiJsonConfigurable

setJson

Method Detail

localEvents

Collection<GridEvent> localEvents(GridPredicate<? super GridEvent>... p)

Queries locally-stored events only. Events could be filtered out by given predicate filters.

Parameters:

p - Event predicate filters. If no filters are provided - all local events will be returned.

Returns:

Collection of events.

record

void record(GridEvent evt)
            throws GridSpiException

Records single event.

Throws:

GridSpiException - If event recording failed for any reason.

Parameters:

evt - Event that should be recorded.