Variable DEFAULTSConst

Type Declaration

• ReadonlyATOMIC_EXTENSION_SAFETY_BUFFER: 2000

  Safety buffer for atomic extension (minimum TTL required)

• ReadonlyAUTO_EXTENSION_THRESHOLD_RATIO: 0.2

  Auto-extension threshold ratio (extend when 80% of TTL consumed)

• ReadonlyCIRCUIT_BREAKER_THRESHOLD: 5

  Circuit breaker failure threshold

• ReadonlyCIRCUIT_BREAKER_TIMEOUT: 60000

  Circuit breaker timeout in milliseconds (1 minute)

• ReadonlyCLOCK_DRIFT_FACTOR: 0.01

  Default clock drift factor for Redlock

• ReadonlyDISTRIBUTED_EXTENSION_BUFFER_RATIO: 0.05

  Extension buffer ratio for distributed locks (5%)

  This ratio determines how much TTL must remain before atomic extension. For distributed locks (RedLock), we use a smaller buffer (5%) because:

  • Multiple nodes require more coordination time
  • Smaller ratio ensures we extend before ANY node expires
  • Clock drift across nodes necessitates earlier extension
  • Quorum-based approach means we need tighter timing

  Example: For a 30-second TTL, extension triggers with 1.5 seconds remaining

• ReadonlyHEALTH_CHECK_INTERVAL: 30000

  Default health check interval in milliseconds (30 seconds)

• ReadonlyMIN_EXTENSION_INTERVAL: 1000

  Minimum extension interval in milliseconds

• ReadonlyMONITORING_INTERVAL: 60000

  Default monitoring interval in milliseconds (1 minute)

• ReadonlyREDIS_TIMEOUT: 5000

  Default Redis command timeout in milliseconds

• ReadonlyRETRY_ATTEMPTS: 3

  Default retry attempts

• ReadonlyRETRY_DELAY: 100

  Default retry delay in milliseconds

• ReadonlySINGLE_NODE_EXTENSION_BUFFER_RATIO: 0.1

  Extension buffer ratio for single-node locks (10%)

  This ratio determines how much TTL must remain before atomic extension. For single-node locks, we use a larger buffer (10%) because:

  • Lower coordination overhead allows larger safety margin
  • Single point of failure means we can be more conservative
  • Network latency to one node is more predictable

  Example: For a 30-second TTL, extension triggers with 3 seconds remaining

• ReadonlyTTL: 30000

  Default lock TTL in milliseconds (30 seconds)