> For the complete documentation index, see [llms.txt](https://mariadb.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mariadb.com/docs/tools/enterprise/control-center/gg9/dashboard/my-cluster.md). # My Cluster The My Cluster tab of the Control Center Dashboard shows numeric and tabular information for the currently selected GridGain 9 cluster. **My cluster** opens as the first tab of the **Dashboard** screen when you select **Dashboard** from the navigation menu. It displays numeric and tabular information for the "current" cluster (selected in the cluster selector tool on the main toolbar). ![](https://2850516351-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkuTXWg0NDbRx6XUeYpGD%2Fuploads%2Fgit-blob-7edc54f525b26349fee93f23d50f2c1aa8c658e0%2Fcc-gg9-my-cluster-gg9.png?alt=media) {% hint style="info" %} Depending on configuration, [secured clusters](/docs/tools/enterprise/control-center/gg9/authorization-permissions.md) might require a cluster-level authentication for some (or all) of the actions. {% endhint %} ## Viewing Cluster Information Use the widgets to view the relevant cluster information: | Widget | Description | | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Cluster Health |

The cluster status:
- Warnings - at least one of the alerts for the cluster has been triggered
- Errors - partition loss
- Healthy - neither warnings nor errors are observed

| | Connections | A set of chips for adding connections. | | Details | A table of the cluster details, including `Type`, `ID`, `Owner`, etc. | | Nodes | A list of cluster's nodes. | ### Viewing Cluster Health Details To view details of the cluster health (status), in the **Cluster Health** widget, click the **View Details** link. The **Cluster Health Details** dialog shows what specific problems, if any, are observed in the cluster. ![Cluster health details GridGain 9](https://2850516351-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkuTXWg0NDbRx6XUeYpGD%2Fuploads%2Fgit-blob-9ed8e848c8ee7f29abf8d64149300214c3bfc1b9%2Fcc-gg9-health-widget-details.png?alt=media) The following health checks are available: | Check | Condition | Description | | ------------------------------ | --------- | ------------------------------------------------------------------------------------------------------------------------------------- | | Alerts | WARNING | One or more configured alerts have been triggered. Each active alert appears as a separate entry showing the alert's own message. | | Metric monitoring | WARNING | Metric monitoring is not enabled for this cluster. Update the cluster configuration to enable the metric exporter. | | Cluster Management Group (CMG) | WARNING | One or more CMG nodes are offline. The message lists the affected node IDs. | | Metastorage Group (MG) | WARNING | One or more Metastorage nodes are offline. The message lists the affected node IDs. | | Partition loss | ERROR | One or more partitions are in a degraded, read-only, or unavailable state. The message lists the affected zones and partition counts. | You can also retrieve cluster health information via the [REST API](/docs/tools/enterprise/control-center/admin-guide/rest-api.md). ### Viewing Cluster Nodes The cluster nodes are shown in the **Nodes** widget at the bottom of the screen. To auto-size a specific column or all columns in the table, select the corresponding option from the column's context menu. To add columns to the table or remove them from the table, select the **Table Columns** option from the table's context menu, then select or clear check boxes for the columns on the list that opens. For GridGain 9 clusters, the **Nodes** widget displays the following columns: | Column | Description | | ----------------- | --------------------------------------------------------- | | Name | The node name. | | Node ID | The ID of the node. | | Host | The cluster host IP address. | | Port | The cluster host port. | | CMG | Whether the node is included in Cluster Management Group. | | MS | Whether the node is included in the Metastorage Group. | | HTTP, HTTPS ports | The ports the node exposes. | | Status | `Running` or `Validating` - see explanation. | ## Renaming the Cluster The cluster name is a human-readable label used in Control Center to identify the cluster. Changing it does not affect cluster operation in any way. To rename the cluster, select **Rename** from the context menu in the top right corner of the **My Cluster** screen. ## Adding Connections To [add](/docs/tools/enterprise/control-center/gg9/dashboard/connect.md) a connection to the cluster, in the **Connections** widget: 1. Click the required client/protocol chip. 2. Proceed to define the new connection. ## Initializing the Cluster {% hint style="info" %} You initialize GridGain 9 clusters. {% endhint %} To initialize the attached GridGain 9 cluster: 1. Click **Initialize** in the top right corner. The **Initialize cluster** dialog opens. ![Initialize cluster](https://2850516351-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkuTXWg0NDbRx6XUeYpGD%2Fuploads%2Fgit-blob-e5b8b04ec5ba5087e00dff03e43a98a857a25cb4%2Fcc-gg9-initialize-cluster.png?alt=media) 2. Add configuration and license file(s) using the **Browse** button or by dragging and dropping. 3. Optionally: 1. Expand the **Advanced settings** section. 2. Clear the **Cluster Management Group (CMG) nodes same as MS nodes** check box. 3. Manually assign MS and CMG nodes. 4. To reset the MS and CMG nodes to default configurations, click **Reset to default**. 4. Click **Initialize**. The dialog closes. Once the initialization process is completed, the cluster status in the **My Cluster** screen changes to `Active`. ## Cluster Configuration ### View Configuration To view cluster configuration, click the ⋮ in the right corner of **My Cluster** tab and then choose **View cluster configuration** option from the menu. ![](https://2850516351-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkuTXWg0NDbRx6XUeYpGD%2Fuploads%2Fgit-blob-415334101319254262f339ca01b230f6b6671620%2Fcc-gg9-my-cluster-menu.png?alt=media) ### Update Configuration To change cluster configuration, click the ⋮ in the right corner of **My Cluster** tab and then choose **Update cluster configuration** option from the menu. You can define configuration in the build-it editor or upload as a file. ![](https://2850516351-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkuTXWg0NDbRx6XUeYpGD%2Fuploads%2Fgit-blob-2cbaf31a0b15e912fa6f8cdd583dd4743e0e6dce%2Fcc-gg9-my-cluster-update-config.png?alt=media) ## Monitoring Configuration You can configure what Control Center tracks for an attached cluster via the cluster **Monitoring configuration** dialog. To update the monitoring configuration: 1. Click the ⋮ in the right corner of the **My Cluster** tab and choose **Monitoring configuration** from the menu. ![](https://2850516351-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkuTXWg0NDbRx6XUeYpGD%2Fuploads%2Fgit-blob-07770bfdd7b4199fc90269db54694f9558ab6acc%2Fcc-gg9-update_cluster_config.png?alt=media) 2. Switch on the features you want Control Center to monitor: | Option | Description | | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Metrics | Enables the metric exporter. Available for attached clusters only. | | Queries log | Enables [query logging](/docs/tools/enterprise/control-center/gg9/querying-gg9.md#queries-log). Click **Configure** to set the minimum duration of the queries to monitor. | | Events | Enables [event](/docs/tools/enterprise/control-center/gg9/events.md) monitoring. Click **Configure** to select the events to collect. | 3. Click **Save**. The dialog closes once the configuration is saved. While the save is in progress, the form is read-only. To discard your changes, click **Cancel**. The **Metrics** option corresponds to the following cluster configuration: ```bash cluster config update "ignite.metrics.exporters=[ { compression=none endpoint="{connector_address}/api" exporterName=otlp headers=[] name="cc_exporter" periodMillis=5000 protocol="http/protobuf" } ]" ``` * If you are using a custom connector for metrics, then in the `endpoint` field, enter the connector address that is reachable from the cluster nodes, followed by `/api`. The address must match `connector.base-url` as documented in the Cloud Connector [section](/docs/tools/enterprise/control-center/gg9/cloud-connector/connect-cloud-connector.md#configure-cloud-connector). * If you prefer to use the embedded connector, then set the `endpoint` to the Control Center portal address, followed by `/api`. ## Updating Cluster Connection Settings If you have [attached](/docs/tools/enterprise/control-center/getting-started/connect/connect-gridgain9-cluster.md) and initialized a GridGain 9 cluster when it was not secure (did not require cluster-level user authentication), AND this cluster became secure afterwards, you need to update the cluster connection settings to support authentication. To update the cluster connection settings: 1. From the context menu in the top right corner, select **Connection settings**. ![Connection settings](https://2850516351-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkuTXWg0NDbRx6XUeYpGD%2Fuploads%2Fgit-blob-d9072289a88ca7d1d5009b3308125e2ba8687f67%2Fcc-gg9-connection-settings.png?alt=media) 2. In the dialog that opens, enter **Username** and **Password**. 3. Click **Save**. ## Refreshing Cluster Metadata Control Center collects cluster metadata including dashboard state, metrics, events, query logs, and connection health. If the displayed cluster information appears stale or inconsistent, you can clear it using the **Force refresh cluster state** option. {% hint style="info" %} The cluster itself is not affected. Monitoring data repopulates automatically on the next monitoring cycle; charts and logs may briefly show gaps after the refresh. {% endhint %} To force-refresh the cluster state: 1. Click the ⋮ in the top right corner of the **My Cluster** tab. 2. Select **Force refresh cluster state**. 3. In the confirmation dialog, click **Confirm**. ## Sharing Clusters You can have access to a cluster as: * *User* - a regular user who can view the cluster that had been shared with them individually or via a team, as well as utilize the actions that appear in the cluster's context menu. * *Owner* - the user who had created or attached the cluster. Owners have extended cluster access rights, including sharing the cluster with teams or users, suspension, removal, etc. As a cluster owner, you can share that cluster with individual users and/or teams. {% hint style="info" %} To [create and manage teams](/docs/tools/enterprise/control-center/profile/teams.md) on the **Teams** screen, select **Team management** from the menu on the top toolbar. {% endhint %} ### Sharing with Users and Teams To share the current cluster, click **Share** above the **Details** widget. The **Share cluster** dialog opens. ![](https://2850516351-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkuTXWg0NDbRx6XUeYpGD%2Fuploads%2Fgit-blob-965ed6453c71520acf1dee4ecceeb3e1070618a9%2Fcc-gg8-share-cluster.png?alt=media) The dialog lists users and teams that already have access to the cluster. In the entry field across the top of the **Share cluster** dialog, start typing a GridGain Control Center user's email, an LDAP ID, or a team name. As you type, the incremental search mechanism displays suggestions in a drop-down list. Select one of the suggested users or teams. Alternatively, type the identifier to the end, then click \[Enter]. You can add multiple users and/or teams in a single operation. When done, click **Share**. The users and teams you have entered appear in the corresponding sections of the **Share cluster** dialog. The system notifies the users and team members that a cluster had been shared with them. To close the **Share cluster** dialog, click **Close**. {% hint style="info" %} Depending on configuration, [secured clusters](/docs/tools/enterprise/control-center/gg9/authorization-permissions.md) might require a cluster-level authentication for some (or all) of the actions even from those users with whom the cluster had been shared. {% endhint %} ### Stopping a Cluster Share As a cluster owner, you can stop sharing your cluster with a team or with an individual user (remove access to the cluster that had been previously granted to that team or user). To stop sharing a cluster with team(s) and/or user(s), click **Share** above the **Details** widget. In the **Share cluster** dialog that opens, select **Stop sharing** from the context menu by the required team or user name. In the confirmation dialog, click **Stop sharing**. ## Viewing Graphic Dashboards To view the default graphic [dashboard](/docs/tools/enterprise/control-center/gg9/dashboard/dashboard-overview-gg9.md) for the current cluster, click the **Default** next to the **My cluster** tab in the top left corner of the screen. ## Switching Between Clusters If multiple clusters are registered in GridGain Control Center, you can switch between clusters by using the **Select cluster** control on the top toolbar. {% hint style="info" %} To view a [list of available clusters](/docs/tools/enterprise/control-center/cluster-management.md) on the **Cluster management** screen, select **Cluster management** from the menu on the top toolbar. {% endhint %} ## Adding Clusters To add a cluster, click **+** on the top toolbar. From the menu that opens, select an option: * **Attach cluster** - proceed to [cluster attachment instructions](/docs/tools/enterprise/control-center/getting-started/connect/connect-gridgain9-cluster.md) ## Updating License You can update GridGain 9 license via **My Cluster** [tab](/docs/tools/enterprise/control-center/gg9/dashboard/my-cluster.md). Click the context menu and select **Update license** action. License can be updated either by uploading the file or by pasting it as a text. ![License](https://2850516351-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkuTXWg0NDbRx6XUeYpGD%2Fuploads%2Fgit-blob-5a1649b77a4a98c7340ca9db2ce867eeaa93e5fa%2Fcc-gg9-update-license.png?alt=media) ## Next Steps * [Monitoring](/docs/tools/enterprise/control-center/gg9/dashboard/dashboard-overview-gg9.md) * [Querying](/docs/tools/enterprise/control-center/gg9/querying-gg9.md)