cluster_control
The cluster_control tool retrieves information about the Wazuh manager cluster.
Use this tool to list cluster nodes, list registered agents, display the cluster health, and filter results by node name or agent status.
Options
Option |
Description |
|---|---|
-a, --list-agents |
Lists the registered agents in the cluster. |
-d, --debug |
Runs the tool in debug mode. |
-fn [<node> ...], --filter-node [<node> ...] |
Filters the results by one or more node names. |
-fs [<status> ...], --filter-agent-status [<status> ...] |
Filters the agent list by one or more agent statuses.
Valid only with |
-h, --help |
Displays the help message and exits. |
-i [health], --health [health] |
Displays information about the cluster health. |
-l, --list-nodes |
Lists the nodes in the cluster. |
-u, --usage |
Displays the command usage information. |
Examples
Get all connected nodes:
# /var/wazuh-manager/bin/cluster_control -l
The command output looks similar to this:
NAME TYPE VERSION ADDRESS
node01 master 5.0.0 127.0.0.1
Get agents in cluster
Get all agents:
# /var/wazuh-manager/bin/cluster_control -a
The command output looks similar to this:
ID NAME IP STATUS VERSION
003 CentOS 192.168.1.209 disconnected v5.0.0
005 MacOS 192.168.1.208 disconnected v4.14.5
007 agent1 192.168.1.185 disconnected v5.0.0
009 Windows 192.168.1.204 active v5.0.0
010 Ubuntu 192.168.1.252 disconnected v5.0.0
011 ubuntu2004 192.168.1.252 active v4.14.7