org.hawkular.alerts.engine.impl

Class PartitionManagerImpl

java.lang.Object

org.hawkular.alerts.engine.impl.PartitionManagerImpl

All Implemented Interfaces:

PartitionManager

public class PartitionManagerImpl
extends Object
implements PartitionManager

Implementation of PartitionManager services based on Infinispan cache. This implementation uses a consistent hashing strategy https://en.wikipedia.org/wiki/Consistent_hashing as a method to partition triggers across nodes. It needs three caches added into Wildfly/JBoss configuration files. standalone.xml: [...] [...] Wildfly standalone-ha.xml: [...] [...]

Author:

Jay Shaughnessy, Lucas Ponce

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	PartitionManagerImpl.NewDataListener
class	PartitionManagerImpl.NewTriggerListener
static class	PartitionManagerImpl.NotifyData Auxiliary class to store in the cache an operation for a Data/Event Used internally in the context of the PartitionManager services.
static class	PartitionManagerImpl.NotifyTrigger Auxiliary class to store in the cache an operation for a Trigger.
class	PartitionManagerImpl.PartitionChangeListener
static class	PartitionManagerImpl.PartitionEntry Auxiliary class to store in the cache a Trigger entry.
class	PartitionManagerImpl.TopologyChangeListener Auxiliary interface to add Infinispan listener to the caches

Nested classes/interfaces inherited from interface org.hawkular.alerts.engine.service.PartitionManager

PartitionManager.Operation

Field Summary

Fields

Modifier and Type	Field and Description
static String	BUCKETS
static String	CURRENT
static String	PARTITION_CHANGE
static String	PREVIOUS

Constructor Summary

Constructors

Constructor and Description
PartitionManagerImpl()

Method Summary

Modifier and Type	Method and Description
Integer	calculateNewEntry(PartitionManagerImpl.PartitionEntry newEntry, Map<Integer,Integer> buckets) Distribute a new entry across buckets using a consistent hashing strategy.
Map<PartitionManagerImpl.PartitionEntry,Integer>	calculatePartition(List<PartitionManagerImpl.PartitionEntry> entries, Map<Integer,Integer> buckets) Distribute triggers on nodes using a consistent hashing strategy.
protected Map<String,Map<String,List<String>>>	getAddedRemovedPartition(Map<PartitionManagerImpl.PartitionEntry,Integer> previous, Map<PartitionManagerImpl.PartitionEntry,Integer> current, Integer node)
Map<String,List<String>>	getNodePartition(Map<PartitionManagerImpl.PartitionEntry,Integer> partition, Integer node) Return the entries assigned for a node into a partition.
void	init()
boolean	isDistributed() Detects if PartitionManager is deployed on a distributed scenario.
void	notifyData(Collection<Data> data) Notify partition manager when a new collection of data has been received.
void	notifyData(Data data) Notify partition manager when a new data has been received.
void	notifyEvent(Event event) Notify partition manager when a new event has been received.
void	notifyEvents(Collection<Event> events) Notify partition manager when a new collection of events has been received.
void	notifyTrigger(PartitionManager.Operation operation, String tenantId, String triggerId) Notify partition manager when a trigger, dampening or condition has been added,updated or removed.
void	registerDataListener(PartitionDataListener dataListener) Register a listener to process patition events linked with data or events.
void	registerTriggerListener(PartitionTriggerListener triggerListener) Register a listener to process partition events linked with triggers.
Map<Integer,Integer>	updateBuckets(Map<Integer,Integer> oldBuckets, List<Integer> members) Update a nodes table.

Methods inherited from class java.lang.Object

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

Field Detail

BUCKETS

public static final String BUCKETS

See Also:

Constant Field Values

PREVIOUS

public static final String PREVIOUS

See Also:

Constant Field Values

CURRENT

public static final String CURRENT

See Also:

Constant Field Values

PARTITION_CHANGE

public static final String PARTITION_CHANGE

See Also:

Constant Field Values

Constructor Detail

PartitionManagerImpl

public PartitionManagerImpl()

Method Detail

isDistributed

public boolean isDistributed()

Description copied from interface: PartitionManager

Detects if PartitionManager is deployed on a distributed scenario. PartitionManager is always present to the engine, but only active on ha profile like defined on standalone-ha.xml PartitionTriggerListener and PartitionDataListener are ignored on non-distributed scenario. PartitionManager.notifyTrigger(org.hawkular.alerts.engine.service.PartitionManager.Operation, java.lang.String, java.lang.String), PartitionManager.notifyData(org.hawkular.alerts.api.model.data.Data) and PartitionManager.notifyEvent(org.hawkular.alerts.api.model.event.Event) are ignored on non-distributed scenario.

Specified by:

isDistributed in interface PartitionManager

Returns:

true if PartitionManager is distributed. false otherwise

init

@PostConstruct
public void init()

notifyTrigger

public void notifyTrigger(PartitionManager.Operation operation,
                          String tenantId,
                          String triggerId)

Description copied from interface: PartitionManager

Notify partition manager when a trigger, dampening or condition has been added,updated or removed. PartitionManager will assign the trigger to a node a will notify all nodes with the change.

Specified by:

notifyTrigger in interface PartitionManager

Parameters:

operation - type of operation performed on the trigger

tenantId - Tenant where Trigger is stored

triggerId - Trigger id

registerTriggerListener

public void registerTriggerListener(PartitionTriggerListener triggerListener)

Description copied from interface: PartitionManager

Register a listener to process partition events linked with triggers.

Specified by:

registerTriggerListener in interface PartitionManager

Parameters:

triggerListener - the listener

notifyData

public void notifyData(Data data)

Description copied from interface: PartitionManager

Notify partition manager when a new data has been received.

Specified by:

notifyData in interface PartitionManager

Parameters:

data - the new data received by the engine

notifyData

public void notifyData(Collection<Data> data)

Description copied from interface: PartitionManager

Notify partition manager when a new collection of data has been received.

Specified by:

notifyData in interface PartitionManager

Parameters:

data - the new data received by the engine

notifyEvent

public void notifyEvent(Event event)

Description copied from interface: PartitionManager

Notify partition manager when a new event has been received.

Specified by:

notifyEvent in interface PartitionManager

Parameters:

event - the new event received by the engine

notifyEvents

public void notifyEvents(Collection<Event> events)

Description copied from interface: PartitionManager

Notify partition manager when a new collection of events has been received.

Specified by:

notifyEvents in interface PartitionManager

Parameters:

events - the new events received by the engine

registerDataListener

public void registerDataListener(PartitionDataListener dataListener)

Description copied from interface: PartitionManager

Register a listener to process patition events linked with data or events.

Specified by:

registerDataListener in interface PartitionManager

Parameters:

dataListener - the listener

updateBuckets

public Map<Integer,Integer> updateBuckets(Map<Integer,Integer> oldBuckets,
                                          List<Integer> members)

Update a nodes table. This table is represented as a Map where: - key is an index within [0, n-1] being n the number of nodes. - value is the code that represents a node, it is calculated from Address.hashCode This method re-calculate a new table from an old table and with a new list with new members. The algorithm minimizes the changes across topology changes.

Parameters:

oldBuckets - the old table used as input for the calculation

members - a new list of members

Returns:

a new table of nodes

calculatePartition

public Map<PartitionManagerImpl.PartitionEntry,Integer> calculatePartition(List<PartitionManagerImpl.PartitionEntry> entries,
                                                                           Map<Integer,Integer> buckets)

Distribute triggers on nodes using a consistent hashing strategy. This strategy allows to scale and minimize changes and re-distribution when cluster changes.

Parameters:

entries - a list of entries to distribute

buckets - a table of nodes

Returns:

a map of entries distributed across nodes

calculateNewEntry

public Integer calculateNewEntry(PartitionManagerImpl.PartitionEntry newEntry,
                                 Map<Integer,Integer> buckets)

Distribute a new entry across buckets using a consistent hashing strategy.

Parameters:

newEntry - the new entry to distribute

buckets - a table of nodes

Returns:

a code of the node which the new entry is placed

getNodePartition

public Map<String,List<String>> getNodePartition(Map<PartitionManagerImpl.PartitionEntry,Integer> partition,
                                                 Integer node)

Return the entries assigned for a node into a partition. The returned entries are represented by a Map> where: - key is a tenantId - value is a List of triggersId assigned to the tenant

Parameters:

partition - the partition used internally

node - the node to filter

Returns:

a map representing the entries for given node

getAddedRemovedPartition

protected Map<String,Map<String,List<String>>> getAddedRemovedPartition(Map<PartitionManagerImpl.PartitionEntry,Integer> previous,
                                                                        Map<PartitionManagerImpl.PartitionEntry,Integer> current,
                                                                        Integer node)