From 27e055f7906e48c8bca3e126484f4256c2a3c2c1 Mon Sep 17 00:00:00 2001
From: Georgios Konstantopoulos <me@gakonst.com>
Date: Sat, 17 Jan 2026 10:20:22 +0000
Subject: [PATCH] feat(engine): add time_between_new_payloads metric (#21158)

---
 crates/engine/tree/src/tree/metrics.rs | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/crates/engine/tree/src/tree/metrics.rs b/crates/engine/tree/src/tree/metrics.rs
index da78752025..40b57c54b4 100644
--- a/crates/engine/tree/src/tree/metrics.rs
+++ b/crates/engine/tree/src/tree/metrics.rs
@@ -298,6 +298,8 @@ pub(crate) struct NewPayloadStatusMetrics {
     pub(crate) new_payload_latency: Histogram,
     /// Latency for the last new payload call.
     pub(crate) new_payload_last: Gauge,
+    /// Time between consecutive new payload calls (payload-to-payload interval).
+    pub(crate) time_between_new_payloads: Histogram,
 }
 
 impl NewPayloadStatusMetrics {
@@ -311,6 +313,9 @@ impl NewPayloadStatusMetrics {
         let finish = Instant::now();
         let elapsed = finish - start;
 
+        if let Some(prev) = self.latest_at {
+            self.time_between_new_payloads.record(start - prev);
+        }
         self.latest_at = Some(finish);
         match result {
             Ok(outcome) => match outcome.outcome.status {