From 565392738b424881672e7eea80b72192aa2d3961 Mon Sep 17 00:00:00 2001
From: John Mitsch <john@quicknode.com>
Date: Fri, 12 Jun 2026 15:04:51 -0400
Subject: [PATCH] docs(metrics): list known metric names in --metric help text
 (DX-5700)

The --metric flag help was uneven: 'qn endpoint metrics' showed only two
example names, and 'qn metrics account' / 'qn metrics endpoint' gave no
examples at all. List the known metric names (method_calls_over_time,
metered_endpoint_data_over_time, metered_endpoint_credits_over_time,
credits_over_time) on all three, keeping response_status_breakdown on
the endpoint-scoped commands. Help text only; no validation change.

223 tests pass.
---
 src/commands/endpoint/mod.rs | 3 ++-
 src/commands/metrics.rs      | 6 ++++--
 2 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/src/commands/endpoint/mod.rs b/src/commands/endpoint/mod.rs
index 1285a11..718cf72 100644
--- a/src/commands/endpoint/mod.rs
+++ b/src/commands/endpoint/mod.rs
@@ -200,7 +200,8 @@ pub struct MetricsArgs {
     /// Endpoint id.
     #[arg(value_name = "ENDPOINT_ID")]
     pub id: String,
-    /// Metric name (e.g. `method_calls_over_time`, `response_status_breakdown`).
+    /// Metric name (e.g. `method_calls_over_time`, `metered_endpoint_data_over_time`,
+    /// `metered_endpoint_credits_over_time`, `credits_over_time`, `response_status_breakdown`).
     #[arg(long)]
     pub metric: String,
     /// Period (`hour`, `day`, `week`, `month`).
diff --git a/src/commands/metrics.rs b/src/commands/metrics.rs
index 7076430..b989e88 100644
--- a/src/commands/metrics.rs
+++ b/src/commands/metrics.rs
@@ -28,7 +28,8 @@ pub struct AccountArgs {
     /// Period.
     #[arg(long, value_parser = ["hour", "day", "week", "month"])]
     pub period: String,
-    /// Metric name.
+    /// Metric name (e.g. `method_calls_over_time`, `metered_endpoint_data_over_time`,
+    /// `metered_endpoint_credits_over_time`, `credits_over_time`).
     #[arg(long)]
     pub metric: String,
     /// Percentile (for latency metrics).
@@ -44,7 +45,8 @@ pub struct EndpointArgs {
     /// Period.
     #[arg(long, value_parser = ["hour", "day", "week", "month"])]
     pub period: String,
-    /// Metric name.
+    /// Metric name (e.g. `method_calls_over_time`, `metered_endpoint_data_over_time`,
+    /// `metered_endpoint_credits_over_time`, `credits_over_time`, `response_status_breakdown`).
     #[arg(long)]
     pub metric: String,
 }