iagctl inspect cluster

IAG 5.4+

Display the health and activity of a gateway cluster.

The iagctl inspect cluster command runs both the health and activity checks together, displaying a combined view of cluster health and active execution in a single call. Run a subcommand to display only one section.

  • iagctl inspect cluster health — checks whether the gateway store and runner nodes are reachable
  • iagctl inspect cluster activity — displays running and recently completed work across all runner nodes

For guidance on using these commands as part of a maintenance workflow, see Monitor cluster health and activity.

Syntax

$iagctl inspect cluster [subcommand] [flags]

Subcommands

SubcommandDescription
healthCheck the health of the gateway store and all registered runner nodes. See iagctl inspect cluster health.
activityDisplay running and recently completed work across all runner nodes. See iagctl inspect cluster activity.

Examples

Display health and activity together

$iagctl inspect cluster

Options

$ -h, --help help for cluster

Options inherited from parent commands

$ --config string Specify the path to the configuration file
$ --profile string Specify the client profile to use (case-insensitive, defaults to [client] section)
$ --raw Displays the result of the command in its raw format
$ --verbose Enable verbose output