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
  • Subcommands
  • Examples
  • Display health and activity together
  • Options
  • Options inherited from parent commands
Command referenceiagctl inspect cluster

iagctl inspect cluster

Was this page helpful?
Previous

iagctl inspect cluster activity

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