> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.itential.com/itential-gateway/5/iagctl/inspect-cluster/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.itential.com/_mcp/server.

# iagctl inspect cluster

Gateway 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](../monitor-cluster-health-activity).

## Syntax

```bash
iagctl inspect cluster [subcommand] [flags]
```

## Subcommands

| Subcommand | Description                                                                                                                             |
| ---------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| `health`   | Check the health of the gateway store and all registered runner nodes. See [iagctl inspect cluster health](./inspect-cluster-health).   |
| `activity` | Display running and recently completed work across all runner nodes. See [iagctl inspect cluster activity](./inspect-cluster-activity). |

## Examples

### Display health and activity together

```bash
iagctl inspect cluster
```

## Options

```bash
  -h, --help   help for cluster
```

## Options inherited from parent commands

```bash
      --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
```