.. _controlcenter_userguide_clusters:

Clusters
========

The Clusters page provides a table summarizing all Kafka clusters for which interceptors are collecting
monitoring data:

.. figure:: images/c3clustermanagement.png
   :scale: 50%
   :align: center

There are four columns:

**Cluster name**
  A human friendly name for the cluster (by default, the cluster GUID). This name is specified using the
  :ref:`Cluster Edit <clustereditpage>` page in |c3-short| and is not exposed outside of |c3-short|.

**ZooKeeper servers**
  A list of ZooKeeper servers configured for the cluster. This information is only available if the cluster is the same
  as the one being used internally by |c3-short|. This column will be blank for other clusters.

**Bootstrap servers**
  A list of bootstrap servers configured for the cluster. This information is only available if the cluster is the same
  as the one being used internally by |c3-short|. This column will be blank for other clusters.

**GUID**
  A unique id associated with the Kafka cluster (provided by the cluster). This information is available for all
  clusters running Kafka version 0.10.1.0 or higher.


Setting a Cluster Name
----------------------

To set a human friendly name for a cluster, click the elipsis icon to the right of the *Cluster name* column on the
row associated with the cluster:

.. figure:: images/c3clusterstartedit.png
   :scale: 50%
   :align: center

Specify the *Cluster name* in the Edit cluster page, and press *Save cluster*. By default the Cluster name is the GUID
provided by the cluster.

.. _clustereditpage:

.. figure:: images/c3clusteredit.png
   :scale: 50%
   :align: center