> 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-activity/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 activity

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

## Syntax

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

```bash
iagctl inspect cluster activity
```

### Check cluster activity using a specific config file

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

## Options

```bash
  -h, --help   help for activity
```

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