For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Open sourceSupportFAQsDocs Home
DocumentationCommand referenceRelease notes
DocumentationCommand referenceRelease notes
  • Command reference
    • iagctl cert-gen
    • iagctl completion
      • inspect cluster
      • inspect cluster activity
      • inspect cluster health
    • iagctl login
    • iagctl runner
    • iagctl server
    • iagctl version
LogoLogo
Open sourceSupportFAQsDocs Home
On this page
  • Syntax
  • Output
  • Examples
  • Check cluster activity
  • Check cluster activity using a specific config file
  • Options
  • Options inherited from parent commands
Command referenceiagctl inspect cluster

iagctl inspect cluster activity

Was this page helpful?
Previous

iagctl inspect cluster health

Next
Built with
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

ColumnDescription
NAMEExecution identifier, assigned at runtime or derived from the service name depending on how the execution was triggered
TYPENormalized execution type: runCode, httpRequest, ansible-playbook, python-script, opentofu-plan, or executable
NODEAddress of the runner node that executed the work
STARTEDTime the work began on the runner
COMPLETEDCompletion time, or - if the work is still running
DURATIONElapsed 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