Top-level commands
up0 commands that are not part of a command group.
Top-level commands
Commands invoked directly as up0 <command>, with no group prefix.
up0 tail
Short-poll and stream your organization's telemetry logs or traces.
Logs and traces are both selected with --type; the old up0 logs and
up0 traces commands are retired.
Usage: up0 tail [OPTIONS]| Name | Type | Default | Description |
|---|---|---|---|
--type | choice (logs, traces) | logs | Signal to stream: logs or traces |
--query / -q | string | - | Free-text filter, sent to the server as q |
--view | string | - | Resolve a named DataView (an org-scoped saved query) and apply its query/range as defaults; the presentation half is ignored and any other flag passed alongside --view overrides it |
--since | string | - | Initial lookback, e.g. 5m, 1h, 24h, 7d (default 5m) |
--service | string | - | Filter by service_name |
--status | string | - | Filter by severity (--type logs, case-insensitive) or status_code (--type traces) |
--json | boolean | false | Emit newline-delimited JSON, one record per line |
--follow / -f / --no-follow | boolean | - | Keep polling after the first batch. Defaults to on when writing to a terminal, off when piped, redirected, or --json |
--limit / -n | integer | - | Max records rendered per poll (default 20) |
--org-id | string | - | Organization ID (or set UP0_ORG_ID) (env: UP0_ORG_ID) |
up0 whoami
Show who you are, which profile is active, and what it points at.
Usage: up0 whoami [OPTIONS]| Name | Type | Default | Description |
|---|---|---|---|
--output | string | - | Set to 'json' for JSON output |
up0 import
Snapshot this org's current live state into up0/*.yaml manifests.
One-time, not scheduled — re-running it after manual dashboard changes
is a valid way to pull drift back into the repo, but that's a
deliberate choice each time, not automatic (GITOPS_ARCHITECTURE.md
§4.6). Existing files under the target up0/ tree are overwritten;
nothing outside the paths this command writes is touched.
Usage: up0 import [OPTIONS]| Name | Type | Default | Description |
|---|---|---|---|
--output-dir | string | . | Directory the up0/ manifest tree is written under (default: cwd) |
--org-id | string | - | Organization ID (or set UP0_ORG_ID) (env: UP0_ORG_ID) |
--json | boolean | false | Emit a JSON summary instead of the file list |
up0 stats
Organization statistics: current held totals per signal, the real
retention horizon, and -- once a range is given via --from/--to/--bucket
-- a bucketed series (#623's GET /me/statistics, in one call).
Usage: up0 stats [OPTIONS]| Name | Type | Default | Description |
|---|---|---|---|
--from | string | - | Range start, ISO 8601. With --to/--bucket, prints the bucketed series in addition to the totals; omitted entirely, up0 stats shows only current held totals and the retention horizon. |
--to | string | - | Range end, ISO 8601 (exclusive) |
--bucket | string | - | Bucket granularity for the series: hour or day (default: day) |
--group-by | string | - | Break totals/series down by service or token |
--output | string | table | Output format: table (default) or json |
--org-id | string | - | Organization ID (or set UP0_ORG_ID) (env: UP0_ORG_ID) |
up0 health
Check API health
Usage: up0 health [OPTIONS]