# pier monitor

> Monitor a resource or the whole environment: live snapshot, --range summary, --metric drill-down

URL: https://pier.run/docs/cli/reference/monitor

```bash
pier monitor [<ref>] [flags]
```

Monitor a resource or the whole environment: live snapshot, --range summary, --metric drill-down.

## Arguments

| Argument | Required | Description                                           |
| -------- | -------- | ----------------------------------------------------- |
| `<ref>`  | no       | Resource to show (name, or name/target); omit to pick |

## Flags

| Flag            | Value    | Default | Description                                                                                  |
| --------------- | -------- | ------- | -------------------------------------------------------------------------------------------- |
| `--type`        | `STRING` |         | Disambiguate a name shared by several kinds: app, site, pg, bucket or volume                 |
| `--all`         |          |         | Show every resource in the environment (the overview) without the picker                     |
| `--range`       | `24h`    |         | Summarise a window instead of the live snapshot (1h, 6h, 24h, 7d, 30d)                       |
| `--metric`      | `STRING` |         | Show one measure's series over the window (e.g. cpu\_pct, latency\_p95\_ms); implies --range |
| `--by-instance` |          |         | With --metric on an app: one column per instance for cpu\_pct/memory\_pct                    |

[Global flags](/docs/cli/reference#global-flags) apply to every command.