com.atlassian.jira.cluster.lock

Interface TimedClusterNodeHeartBeatDao

All Superinterfaces:

ClusterNodeHeartBeatDao

All Known Implementing Classes:

JiraClusterNodeHeartBeatDao, NullJiraClusterNodeHeartBeatDao

public interface TimedClusterNodeHeartBeatDao
extends ClusterNodeHeartBeatDao

Cluster node heartbeat DAO that adds operations to retrieve database timing information.

Since:

6.3

Method Summary

Modifier and Type	Method and Description
Map<String,Long>	getActiveNodesDatabaseTimeOffsets(long databaseActiveTime) Returns each active cluster node's clock offset from the database clock.

Methods inherited from interface com.atlassian.jira.cluster.heartbeat.ClusterNodeHeartBeatDao

findNodesWithHeartbeatsAfter, getLastHeartbeatTime, getNodeId, writeHeartBeat

Method Detail

getActiveNodesDatabaseTimeOffsets

@Nonnull
Map<String,Long> getActiveNodesDatabaseTimeOffsets(long databaseActiveTime)

Returns each active cluster node's clock offset from the database clock.

The returned map maps node IDs to their clock offset times in milliseconds. A clock offset time is the number of milliseconds difference between that node's system clock and the clock of the database. These values can be used to determine how synchronized the node's clocks are.

It is possible that a node's time offset value is returned as null if they have not registered a heartbeat yet after they have started up or if they are upgrading their version and have not written a database time value in the database yet.

Parameters:

databaseActiveTime - the minimum database time a node should have in the system to regard it as active. Nodes that registered their heartbeat with an associated database time less than this value will not be returned.

Returns:

a map mapping node IDs to offset times in milliseconds.