Skip to content

dstack event

The dstack event command, an alias for dstack event list, allows you to view events.

For more details, see Events.

Usage

$ dstack event --help
Usage: dstack event [-h] [--project NAME] [-w] [--since SINCE]
                    [--target-fleet NAME | --target-run NAME | --target-volume NAME | --target-gateway NAME | --target-secret NAME]
                    [--within-fleet NAME | --within-run NAME]
                    [--include-target-type TYPE]
                    {list} ...

Positional Arguments:
  {list}
    list                List events within the selected project

Options:
  -h, --help            Show this help message and exit
  --project NAME        The name of the project. Defaults to $DSTACK_PROJECT
  -w, --watch           Watch events in realtime
  --since SINCE         Only show events newer than the specified date. Can be
                        a duration (e.g. 10s, 5m, 1d) or an RFC 3339 string
                        (e.g. 2023-09-24T15:30:00Z). If not specified, show
                        the last 100 events.
  --target-fleet NAME   Only show events that target the specified fleets
  --target-run NAME     Only show events that target the specified runs
  --target-volume NAME  Only show events that target the specified volumes
  --target-gateway NAME
                        Only show events that target the specified gateways
  --target-secret NAME  Only show events that target the specified secrets
  --within-fleet NAME   Only show events that target the specified fleets or
                        instances within those fleets
  --within-run NAME     Only show events that target the specified runs or
                        jobs within those runs
  --include-target-type TYPE
                        Only show events that target entities of the specified
                        types