From 67c125e350df01c75d6ef59a1e45fe00edaf9d67 Mon Sep 17 00:00:00 2001 From: Julien Danjou Date: Mon, 27 Jul 2026 16:13:50 +0200 Subject: [PATCH] docs(datadog): document the batches_saved queue metric The metrics reference was missing `mergify.queue.skip_intermediate_results.batches_saved`, a count the engine's stats metrics pusher has been submitting alongside the rest of the `mergify.queue.*` family. It is what backs the "Batches Saved" chart on the merge queue Statistics page. Add the table row and a short paragraph explaining what it counts and that it only moves when `skip_intermediate_results` is enabled. The explanation goes in prose rather than the table cell because a metric name that long plus an inline link exceeds the 120-character line limit, and table rows cannot be wrapped. MRGFY-8213 Co-Authored-By: Claude Opus 5 (1M context) Change-Id: I4d81d0e0cc1ddea0fde7ca8a469bb99570a7db11 --- src/content/docs/integrations/datadog.mdx | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/src/content/docs/integrations/datadog.mdx b/src/content/docs/integrations/datadog.mdx index a0059794c1..b91adef9ad 100644 --- a/src/content/docs/integrations/datadog.mdx +++ b/src/content/docs/integrations/datadog.mdx @@ -93,6 +93,7 @@ any time range. Metrics submitted as **gauge** are peak values within the window | `mergify.queue.checks_retries.recovered` | count | Failed checks that passed on retry | | `mergify.queue.checks_retries.not_recovered` | count | Failed checks that failed again on retry | | `mergify.queue.bisection.started` | count | [Batch](/merge-queue/batches) bisections started | +| `mergify.queue.skip_intermediate_results.batches_saved` | count | Batches merged without their own checks | | `mergify.queue.total_queue_time.sum` | count | Total time queued, in seconds | | `mergify.queue.total_queue_time.count` | count | Queue sessions the sum covers | | `mergify.queue.ci_runtime.sum` | count | Total CI runtime, in seconds | @@ -111,6 +112,12 @@ queue or its checks were aborted, such as `checks_failed` or `pr_dequeued`. The [integration's README](https://github.com/DataDog/integrations-extras/blob/master/mergify_oauth/README.md) lists every value. +`skip_intermediate_results.batches_saved` counts the batches that merged because +a later batch containing their changes had already passed, so each one is a CI +run the queue avoided. It only moves when +[`skip_intermediate_results`](/merge-queue/batches#skip-intermediate-results-anti-flake-protection) +is enabled on the queue. + ## Querying the metrics ### Averages