> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kinetica.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cluster

<a id="gadmin-cluster" />

The **Cluster** menu selection comprises several tabs that contain
information about all the machines in your cluster as well as configuration and
log file access. Summary data about your *Kinetica* cluster is pinned to the top
right of each tab within **Cluster**; it includes:

* The [status](/content/admin/services#statuses) of *Kinetica*
* How many users are connected to *Kinetica*
* How many requests per second are being made to *Kinetica*
* How many tables are present in this *Kinetica* cluster
* How many rows are present in this *Kinetica* cluster
* The uptime of this *Kinetica* cluster
* A refresh button to refresh the cluster information

<img src="https://mintcdn.com/kinetica/PHQlULcgtUSM8bYf/content/admin/images/cluster_summary_bar.png?fit=max&auto=format&n=PHQlULcgtUSM8bYf&q=85&s=b9d55a10a229ee6863be310c06d6c17b" alt="../../images/cluster_summary_bar.png" width="561" height="35" data-path="content/admin/images/cluster_summary_bar.png" />

<a id="gadmin-cluster-dashboard" />

## Dashboard

The **Dashboard** page is also the [GAdmin](/content/admin/gadmin) homepage. It
highlights the most important information about all the machines in your
cluster, including CPU, Memory, and Disk usage.

<img src="https://mintcdn.com/kinetica/PHQlULcgtUSM8bYf/content/admin/images/cluster_dashboard.png?fit=max&auto=format&n=PHQlULcgtUSM8bYf&q=85&s=194032dd71013d6a4112050f3d6327b2" alt="../../images/cluster_dashboard.png" width="1000" height="428" data-path="content/admin/images/cluster_dashboard.png" />

## Ranks

The **Ranks** page displays important information about all the GPU
ranks being used in your cluster.

<img src="https://mintcdn.com/kinetica/PHQlULcgtUSM8bYf/content/admin/images/cluster_ranks.png?fit=max&auto=format&n=PHQlULcgtUSM8bYf&q=85&s=0854d70bfe5094199077718ffc3f147f" alt="../../images/cluster_ranks.png" width="1000" height="350" data-path="content/admin/images/cluster_ranks.png" />

<a id="gadmin-db-rebuild" />

## Admin

<Note>
  The **Cluster --> Admin** section is only available to users
  with the *System Admin* permission.
</Note>

The **Admin** page allows you to stop or start the database, rebuild the
database, rebalance the database, or review operation history (add, remove, or
rebalance node operations) information.

Click **Rebuild DB** to rebuild the database should you experience
database errors or some *tables* and/or *schemas* are unable to be queried.
All tables can be rebuilt **or** just tables with disk optimized columns and/or
tables with text search columns can be rebuilt. For more information on
rebuilding individual *tables* or *schemas*, see
[Rebuilding](/content/admin/gadmin/data#gadmin-table-rebuild).

Click **Rebalance DB** to optionally shuffle around sharded and
unsharded data across your cluster so all nodes could have roughly the same
amount of sharded and unsharded data. If choosing to rebalance unsharded data,
optionally provide a whitelist **or** blacklist of unsharded tables' names.

<img src="https://mintcdn.com/kinetica/PHQlULcgtUSM8bYf/content/admin/images/cluster_admin.png?fit=max&auto=format&n=PHQlULcgtUSM8bYf&q=85&s=07daaf4b10a3425263f261782fbe2aeb" alt="../../images/cluster_admin.png" width="1000" height="358" data-path="content/admin/images/cluster_admin.png" />

## License

<Note>
  The **Cluster --> License** section is only available to users
  with the *System Admin* permission.
</Note>

The **License** page provides management capability for the *Kinetica*
license used by the cluster.  The page will list the type, status, and
expiration date of the active license.

<Info>
  The license can only be modified when *Kinetica* is not running.
</Info>

<img src="https://mintcdn.com/kinetica/PHQlULcgtUSM8bYf/content/admin/images/cluster_setup.png?fit=max&auto=format&n=PHQlULcgtUSM8bYf&q=85&s=17b433c1f1e402f682cc1160cfe7d651" alt="../../images/cluster_setup.png" width="1000" height="349" data-path="content/admin/images/cluster_setup.png" />

## Config

<Note>
  The **Cluster --> Config** section is only available to users
  with the *System Admin* permission.
</Note>

The **Config** page allows you to edit the core *Kinetica* configuration
file and save the changes directly in [GAdmin](/content/admin/gadmin); this file maps
to the <Badge color="gray">/opt/gpudb/core/etc/gpudb.conf</Badge> file. Detailed
information about configuration file settings can be found on
[Configuration Reference](/content/config).

<Info>
  This tab can only be edited when *Kinetica* is not running.
</Info>

<img src="https://mintcdn.com/kinetica/PHQlULcgtUSM8bYf/content/admin/images/cluster_config.png?fit=max&auto=format&n=PHQlULcgtUSM8bYf&q=85&s=828df8ce702fe6f5f46d2a5ca613241a" alt="../../images/cluster_config.png" width="1000" height="739" data-path="content/admin/images/cluster_config.png" />

<a id="cluster-alerts" />

## Alerts

The **Alerts** displays the most recent triggered alerts. Detailed
information about alerts and how to set them can be found on
[Alerting](/content/admin/alerting).

<img src="https://mintcdn.com/kinetica/PHQlULcgtUSM8bYf/content/admin/images/cluster_alerts.png?fit=max&auto=format&n=PHQlULcgtUSM8bYf&q=85&s=00110871f4a702976f18b270d21834a9" alt="../../images/cluster_alerts.png" width="1000" height="489" data-path="content/admin/images/cluster_alerts.png" />

<a id="cluster-logging" />

## Logging

The **Logging** page displays the running system log file, updating
every two seconds. This file is *Kinetica's* main diagnostic tool and it is
located at
<Badge color="gray">/opt/gpudb/core/logs/host-manager-\<hostname>-\<date-time>.log</Badge>.

<Info>
  If the cluster uses a shared persist directory, each nodes' database log will
  be located in this directory as well.
</Info>

Select the **Pause Log** checkbox to pause the file updates.  The number
of displayed lines can be selected from **Lines**, and the displayed
lines can be filtered using **Filter** (select the **Exclude**
checkbox to instead exclude the filtered word or phrase).

<img src="https://mintcdn.com/kinetica/PHQlULcgtUSM8bYf/content/admin/images/cluster_logging.png?fit=max&auto=format&n=PHQlULcgtUSM8bYf&q=85&s=ea29b339edfc1f97ffce6cb55eda3575" alt="../../images/cluster_logging.png" width="1000" height="375" data-path="content/admin/images/cluster_logging.png" />

### Setting Loggers

Click **Manage Logging Level** to open the
**Manage System Logging Level** window, where the per-rank logging level
for any system logger can be modified.

To view the active loggers and corresponding levels for each rank, select the
rank from the **Rank** drop-down menu above the
**Current Log Levels** list. Use the **Filter** below the list
to find a particular logger in the list.

To update a logger:

1. At the top of the window, select a rank or *ALL* from the **Rank**
   drop-down window.
2. Provide a logger name for the **Logger** field.
3. Select a logger level from the **Level** drop-down menu.
4. Click **Set Logger**.

<Tip>
  Instructions for manually changing the logging level via the
  `/opt/gpudb/core/etc/gpudb_logger.conf` file are located on the
  [Custom Logging](/content/admin/logging) documentation.
</Tip>

Any change will take effect immediately and be in effect until a subsequent
change is made to the same logger or the database is restarted. A database
restart will reset all loggers to their default levels, system-wide.

<img src="https://mintcdn.com/kinetica/PHQlULcgtUSM8bYf/content/admin/images/cluster_sys_logging_level.png?fit=max&auto=format&n=PHQlULcgtUSM8bYf&q=85&s=76ec7457059ec6cc1d244c99f461f510" alt="../../images/cluster_sys_logging_level.png" width="602" height="659" data-path="content/admin/images/cluster_sys_logging_level.png" />

## Debug

The **Debug** page displays debugging and metric information about your
cluster. Note that each section has nested information, so it's possible
to drill in for more details. From this page, you can also generate system
reports and access previous reports. A system report includes important logs
and files that can be sent to support ([support@kinetica.com](mailto:support@kinetica.com)) to help diagnose
any issues at hand.

<img src="https://mintcdn.com/kinetica/PHQlULcgtUSM8bYf/content/admin/images/cluster_debug.png?fit=max&auto=format&n=PHQlULcgtUSM8bYf&q=85&s=8ff5b07c1f1c238ae27c6f19130964b1" alt="../../images/cluster_debug.png" width="1000" height="557" data-path="content/admin/images/cluster_debug.png" />

<a id="cluster-demo" />

## Demo

<Note>
  The **Cluster --> Demo** section is only available to users
  with the *System Admin* permission.
</Note>

The **Demo** page contains various data that you can load into
*Kinetica*. This data will help get you started using *Kinetica* as well as
demonstrate some key capabilities of the system. Each demo dataset contains
500,000 records; after loading the data into *Kinetica*, you have the option of
loading the same data again. The datasets with a
[Reveal Dashboard](/content/bi/reveal) button have a corresponding
Reveal dashboard that will be automatically setup in Reveal after ingesting the
data.

<img src="https://mintcdn.com/kinetica/PHQlULcgtUSM8bYf/content/admin/images/cluster_demo.png?fit=max&auto=format&n=PHQlULcgtUSM8bYf&q=85&s=b873da5a6bbbb0e0a4b53b3b5067c300" alt="../../images/cluster_demo.png" width="1000" height="585" data-path="content/admin/images/cluster_demo.png" />

## Visualize

The **Visualize** page contains an overview of
[Reveal](/content/bi/reveal) as well as a quick link to Reveal.

<img src="https://mintcdn.com/kinetica/PHQlULcgtUSM8bYf/content/admin/images/cluster_visualize.png?fit=max&auto=format&n=PHQlULcgtUSM8bYf&q=85&s=0a1b5c170c366e030270bea70824dbad" alt="../../images/cluster_visualize.png" width="1000" height="479" data-path="content/admin/images/cluster_visualize.png" />
