feat(intake): agent identity and time-bucketed trace metrics [ASTD-424]

docs/cli/reference.mdx

@@ -7115,9 +7115,50 @@ nemo intake traces [OPTIONS] COMMAND [ARGS]...
 
 **Commands:**
 
+* `get-metrics`: Get Trace Metrics
 * `list`: List Traces
 * `get`: Get Trace
 
+##### nemo intake traces get-metrics
+
+Get Trace Metrics
+
+**Usage:**
+
+```shell
+nemo intake traces get-metrics [OPTIONS]
+```
+
+**Options:**
+
+* `--workspace`
+* `--bucket <CHOICE>`: Time bucket granularity. [possible values: total, hour, day, week, month]
+* `--timezone`: IANA timezone the buckets are aligned to, e.g. America/Los_Angeles.
+
+**Filter Options:**
+
+* `--filter FILTER_JSON`: Use --filter with JSON for complex/nested queries, or --filter. FIELD options for simple fields. Both can be combined, with field options taking precedence.
+JSON-only fields:
+  started_at: \{gte: str, lte: str}
+
+Filter the traces the metrics are computed over. Accepts the same fields as the traces list, so agent_name scopes the rollup to one agent. Without a started_at lower bound the rollup covers the last 7 days.
+* `--filter.id`
+* `--filter.agent-name`
+* `--filter.evaluation-id`
+* `--filter.evaluation-name`
+* `--filter.session-id`
+* `--filter.status`
+* `--filter.test-case-id`
+* `--filter.test-case-name`
+
+**Help:**
+
+* `--help, -h`: Show this message and exit.
+
+**Output Options:**
+
+* `--output-format, --output, -f <CHOICE>`: Output format for an entity. [possible values: json, yaml, raw, code]
+
 ##### nemo intake traces list
 
 List Traces
@@ -7143,8 +7184,9 @@ nemo intake traces list [OPTIONS]
 JSON-only fields:
   started_at: \{gte: str, lte: str}
 
-Filter root-span-backed traces by id, session_id, root status, root span started_at, evaluation_name, and test_case_name.
+Filter root-span-backed traces by id, session_id, root status, root span started_at, evaluation_name, test_case_name, and agent_name.
 * `--filter.id`
+* `--filter.agent-name`
 * `--filter.evaluation-id`
 * `--filter.evaluation-name`
 * `--filter.session-id`