From c5704deb74d374ce657edf3886dc46db3597109e Mon Sep 17 00:00:00 2001 From: Claude Date: Fri, 17 Apr 2026 10:59:53 +0000 Subject: [PATCH 1/2] docs(merge-queue): document metrics drill-down PR list Adds a section to the Metrics and Monitoring page describing how to click into a chart data point to view the individual PRs that make up that metric, with filter options for date range, conclusion, and impacted targets. Source: trunk2 PR #3539 Co-Authored-By: Claude Opus 4.6 --- merge-queue/administration/metrics.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/merge-queue/administration/metrics.md b/merge-queue/administration/metrics.md index 04f80147..fc58d8e2 100644 --- a/merge-queue/administration/metrics.md +++ b/merge-queue/administration/metrics.md @@ -107,6 +107,24 @@ The time in queue can be displayed as different statistical measures. You can sh *** +### Drill into a metrics data point + +You can click any data point on the Conclusion Count or Time in Queue charts to open a detailed view listing the individual PRs that make up that point. + +The PR list shows each pull request that exited the queue during the selected time range, along with its conclusion (merged, failed, or canceled) and the time it spent in the queue. + +#### Filter the PR list + +Use the filters at the top of the PR list to narrow the results: + +* **Date range** - Select a start and end date to scope the list to a specific window. +* **Conclusion** - Filter by outcome: merged, failed, or canceled. +* **Impacted targets** - When running in Parallel Mode, filter PRs by the targets they affected. + +To return to the health charts, click **Back to Health** at the top of the page. + +*** + ### Prometheus metrics endpoint Trunk exposes merge queue metrics in [Prometheus text exposition format](https://prometheus.io/docs/instrumenting/exposition_formats/) via a scrapable API endpoint. Use this to build custom Grafana dashboards, set up alerts, or integrate merge queue health into your existing observability stack. From 252984efe46ff39f8abfcc4c3ab43501ab9edf52 Mon Sep 17 00:00:00 2001 From: Sam Gutentag <1404219+samgutentag@users.noreply.github.com> Date: Thu, 7 May 2026 01:03:18 -0700 Subject: [PATCH 2/2] docs(merge-queue): replace duplicate section with accurate page details The original PR added a "### Drill into a metrics data point" section that mostly duplicated the existing "### Drill down into metrics" section above and described filter UI that does not exist. Verified against trunk2: merge-metrics-pr-list.tsx (381 lines) has no filter widgets. The conclusion and impactedTargets URL params are set by the drill-down click flow on the Health charts, not by user-editable controls on the PR list page. Replaced the duplicate section with a sentence on the actual page features: Back to Health navigation (lines 324, 358) and the 2,500-row truncation behavior (constants: MAX_ITEMS = 2_500, FETCH_PAGE_SIZE = 250). Co-Authored-By: Claude Opus 4.7 (1M context) --- merge-queue/administration/metrics.md | 20 ++------------------ 1 file changed, 2 insertions(+), 18 deletions(-) diff --git a/merge-queue/administration/metrics.md b/merge-queue/administration/metrics.md index 2c033eba..bd462007 100644 --- a/merge-queue/administration/metrics.md +++ b/merge-queue/administration/metrics.md @@ -143,30 +143,14 @@ Both columns are sortable, so you can quickly surface the longest-running PRs in
PRs in Range table listing individual PRs with Conclusion (Merged or Failed), Reason, and Time in Queue columns, sorted by Time in Queue descending

The drill-down PR list, sortable by conclusion and time in queue.

+The PR list page shows the selected date range as a subtitle and a **Back to Health** link to return to the charts. If the selection contains more than 2,500 PRs, the list shows the first 2,500 with a notice indicating the total. Narrow the time bucket on the chart to drill into a smaller window. + {% hint style="info" %} Drill down and range selection are currently available on the Conclusion count and Time in queue charts. Additional Health charts will support the same interactions as they land in the UI. {% endhint %} *** -### Drill into a metrics data point - -You can click any data point on the Conclusion Count or Time in Queue charts to open a detailed view listing the individual PRs that make up that point. - -The PR list shows each pull request that exited the queue during the selected time range, along with its conclusion (merged, failed, or canceled) and the time it spent in the queue. - -#### Filter the PR list - -Use the filters at the top of the PR list to narrow the results: - -* **Date range** - Select a start and end date to scope the list to a specific window. -* **Conclusion** - Filter by outcome: merged, failed, or canceled. -* **Impacted targets** - When running in Parallel Mode, filter PRs by the targets they affected. - -To return to the health charts, click **Back to Health** at the top of the page. - -*** - ### Prometheus metrics endpoint Trunk exposes merge queue metrics in [Prometheus text exposition format](https://prometheus.io/docs/instrumenting/exposition_formats/) via a scrapable API endpoint. Use this to build custom Grafana dashboards, set up alerts, or integrate merge queue health into your existing observability stack.