fioctl waves status

Show status for a given Wave by name

Synopsis

Show status for a given Wave by name. When no Wave name is provided — show a status for a currently active Wave.

For an active Wave, this command shows an overview if it, followed by an overview of device groups participating in the Wave, and lastly, detailed information for each rollout group.

For finished Waves, detailed per group information is not shown as it is no longer relevant.

When counting the total number of devices participating in a Wave, each production device with a tag equal to a Wave tag counts. In particular, devices outside rollout groups also count if they satisfy this condition.

All other numbers are calculated relative to this total number. For example, online devices in each group are counted only among those production devices that belong to a given group and also have a tag equal to a group tag. This number can be lower than the total number of online devices in this group.

In a device group overview, all Wave rollout groups are shown first in the order of rollout time. Next is other groups that have devices with a matching tag — if they contain at least one such device. The last row is for devices not belonging to any group — if at least one such device matches a Wave tag.

A number of updated devices depends onto a Wave status: For active Waves, it is a number of devices in rollout groups with Target version >= Wave version. For finished Waves, it is a number of all devices with Target version >= Wave version.

Meaning of scheduled vs unscheduled (for updates) device number also depends on Wave status: For an active Wave, “scheduled for update” are devices in rollout groups with Target version < Wave version. For a completed Wave, “scheduled” are all devices (regardless of group) with Target version < Wave version. For a canceled Wave, all devices with Target version < Wave version are unscheduled (scheduled is always zero).

For finished Waves, all numbers are calculated for a current date (not a date of a Wave finishing). This can be used to monitor how an update progresses after a Wave completes.

fioctl waves status [<wave>] [flags]

Options

-h, --help                    help for status
    --offline-threshold int   Consider device 'OFFLINE' if not seen in the last X hours (default 4)

Options inherited from parent commands

-c, --config string    config file (default is $HOME/.config/fioctl.yaml)
-f, --factory string   Factory to list Targets for
-t, --token string     API token from https://app.foundries.io/settings/tokens/
-v, --verbose          Print verbose logging

SEE ALSO