Package 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 Details

    • 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.