Commands
up0 metrics
Metric catalog and range queries
up0 metrics
Metric catalog and range queries
up0 metrics ls
List metric names the organization has emitted in the range, with type and series count.
Usage: up0 metrics ls [OPTIONS]| Name | Type | Default | Description |
|---|---|---|---|
--since | string | - | Relative lookback, e.g. 15m, 1h, 24h, 7d — mutually exclusive with --start/--end (default: last 1h) |
--start | string | - | Range start, ISO 8601 — mutually exclusive with --since |
--end | string | - | Range end, ISO 8601 — mutually exclusive with --since |
--json | boolean | false | Emit the API response as JSON |
--org-id | string | - | Organization ID (or set UP0_ORG_ID) (env: UP0_ORG_ID) |
up0 metrics query
A bucketed, aggregated time series for one metric over a range.
Counters are reported as their raw cumulative value, not rate-corrected
-- metric_type in the output says which case you are in. An empty
bucket's value is null for every aggregation except sum/count, which
have a well-defined 0 for "nothing in this bucket". The CLI does not
compute quantiles itself; --aggregation quantile is passed straight to
the API, which does.
Usage: up0 metrics query [OPTIONS]| Name | Type | Default | Description |
|---|---|---|---|
--metric-name | string | required | Exact metric_name — required, one metric per request |
--since | string | - | Relative lookback, e.g. 15m, 1h, 24h, 7d — mutually exclusive with --start/--end (default: last 1h) |
--start | string | - | Range start, ISO 8601 — mutually exclusive with --since |
--end | string | - | Range end, ISO 8601 — mutually exclusive with --since |
--aggregation | choice (sum, avg, min, max, count, quantile) | avg | Aggregation applied per bucket |
--quantile | float | - | Fraction in [0, 1] — required iff --aggregation quantile, rejected otherwise (enforced by the API, not duplicated here) |
--group-by | string | - | Label key to split into its own series (repeatable, up to 10) |
--json | boolean | false | Emit the API response as JSON |
--org-id | string | - | Organization ID (or set UP0_ORG_ID) (env: UP0_ORG_ID) |