iagctl inspect cluster activity

IAG 5.4+

Display active and recently completed work across a gateway cluster.

The iagctl inspect cluster activity command returns all currently running and recently completed work across every runner node in the cluster. The command fans out to all registered runners simultaneously and returns a combined view. Use this command to confirm no services are actively executing before taking a runner node offline or restarting the gateway.

You can also run iagctl inspect cluster without a subcommand to display health and activity output together.

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

Syntax

$ iagctl inspect cluster activity [flags]

Output

Column	Description
`NAME`	Execution identifier, assigned at runtime or derived from the service name depending on how the execution was triggered
`TYPE`	Normalized execution type: `runCode`, `httpRequest`, `ansible-playbook`, `python-script`, `opentofu-plan`, or `executable`
`NODE`	Address of the runner node that executed the work
`STARTED`	Time the work began on the runner
`COMPLETED`	Completion time, or `-` if the work is still running
`DURATION`	Elapsed time from start to completion, or from start to now if still running

Recently completed work is retained in the output for up to 15 minutes after completion. After that window, entries no longer appear.

Examples

Check cluster activity

$ iagctl inspect cluster activity

Check cluster activity using a specific config file

$ iagctl inspect cluster activity --config /path/to/gateway.conf

Options

$   -h, --help   help for activity

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