# pier events

> Show or watch events for a resource, the environment, the project or the workspace

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

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

Show or watch events for a resource, the environment, the project or the workspace.

## Arguments

| Argument | Required | Description                                                  |
| -------- | -------- | ------------------------------------------------------------ |
| `<ref>`  | no       | Resource (name, or name/target for one 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-envs`      |                |         | Every environment of the project (skips the picker)                          |
| `--all-projects`  |                |         | The whole workspace (skips the picker)                                       |
| `--kind`          | `KIND,...`     |         | intent \| milestone \| activity (repeatable)                                 |
| `--action`        | `ACTION,...`   |         | Exact action match e.g. app.created (repeatable)                             |
| `--action-prefix` | `STRING`       |         | Action prefix e.g. app. matches every app.\* event                           |
| `--severity`      | `SEVERITY,...` |         | info \| warn \| error \| critical (repeatable)                               |
| `--actor`         | `STRING`       |         | Filter by actor user ID                                                      |
| `--intent`        | `STRING`       |         | All events for one intent ID                                                 |
| `--operation`     | `STRING`       |         | All events for one operation (op\_...)                                       |
| `--since`         | `STRING`       |         | Lower bound: a duration (30m, 6h, 7d) or an RFC3339 time                     |
| `--until`         | `STRING`       |         | Upper bound: a duration ago or an RFC3339 time                               |
| `--limit`         | `50`           | `50`    | Max events (server caps at 200)                                              |
| `--after`         | `STRING`       |         | Continue from a previous page's next\_cursor (--json)                        |
| `--payload`       |                |         | Include each event's payload (--json)                                        |
| `--watch`         |                |         | Keep printing new events until Ctrl-C                                        |
| `--utc`           |                |         | Absolute UTC timestamps instead of relative                                  |

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