feat: Better self-service commands for DHT providing

CHANGELOG.md

@@ -25,6 +25,13 @@ The following emojis are used to highlight certain changes:
 ### Security
 
 
+## [v0.27.3]
+
+### Added
+
+- `provider` Added LastRun and NextRun stats to the Reprovider. [#815](https://github.com/ipfs/boxo/pull/815)
+
+
 ## [v0.27.2]
 
 ### Fixed

provider/reprovider.go

@@ -62,6 +62,7 @@
 	statLk                                    sync.Mutex
 	totalProvides, lastReprovideBatchSize     uint64
 	avgProvideDuration, lastReprovideDuration time.Duration
+	lastRun                                   time.Time
 
 	throughputCallback ThroughputCallback
 	// throughputProvideCurrentCount counts how many provides has been done since the last call to throughputCallback
@@ -357,6 +358,7 @@
 			s.statLk.Lock()
 			s.avgProvideDuration = (totalProvideTime + dur) / (time.Duration(s.totalProvides) + time.Duration(len(keys)))
 			s.totalProvides += uint64(len(keys))
+			s.lastRun = time.Now()
 
 			log.Debugf("finished providing of %d keys. It took %v with an average of %v per provide", len(keys), dur, recentAvgProvideDuration)
 
@@ -539,6 +541,7 @@
 type ReproviderStats struct {
 	TotalProvides, LastReprovideBatchSize     uint64
 	AvgProvideDuration, LastReprovideDuration time.Duration
+	LastRun, NextRun                          time.Time
 }
 
 // Stat returns various stats about this provider system
@@ -550,6 +553,8 @@
 		LastReprovideBatchSize: s.lastReprovideBatchSize,
 		AvgProvideDuration:     s.avgProvideDuration,
 		LastReprovideDuration:  s.lastReprovideDuration,
+		LastRun:                s.lastRun,
+		NextRun:                s.lastRun.Add(DefaultReproviderInterval),
 	}, nil
 }