# Cluster settings

**Cluster Settings** contains a variety of configurable parameters.

To navigate to the **`Custer Settings`** , go to the  **`Overview`** tab and find the needed cluster from the list of onboarded clusters. Hover over the cluster and click on the **`Gear`** button. 

## General Settings

<figure><img src="https://3591580169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzCh9aABpk7yLeToPr6vk%2Fuploads%2F8KC5lRbmkC8rdgctCDqC%2Fimage.png?alt=media&#x26;token=24a54498-cbeb-43d5-992c-a4b149255845" alt=""><figcaption><p>General cluster settings</p></figcaption></figure>

1. **Cluster Name** - (editable field) displays the name of the cluster.
2. **Optimization Policy** - specifies how resources should be allocated to achieve the desired level of resiliency. This allows setting policies to support the individual needs of your workloads. Keep the default or select one of the following values:

   * MaxSavings - maximum cost savings, the best for non-production environments
   * Balanced (default) - optimally balances cost and resiliency
   * ExtraHeadroom - the best fit for latency-sensitive environments
   * MaxHeadroom - keeps the environment above the highest spikes

   Discover more about customizing the Optimization policy [here](https://app.gitbook.com/o/nm9j21i0V5wdxMTftXMN/s/ABMqnYtsOO44JmQTVSnn/~/edit/~/changes/470/customize-workflow/optimization-policy-customization).
3. **Region** - (autodetected editable field) displays the region where the cluster is running.
4. **Cloud Provider** - (autodetected non-editable field) displays the cloud provider name.
5. **Initialization Date** - (non-editable field) displays the date when the cluster was added.
6. **Disconnect Cluster** - click on the button to disconnect the cluster from PerfectScale.
7. **Kubernetes version** - shows the Kubernetes version currently used by the cluster.

Click **`Save Changes`** button to save the changes or  **`Cancel & Close`** to discard them.

## Customizations

PerfectScale offers a range of customizable features designed to empower you to build your own optimized K8s ecosystem. These enhancements boost observability throughout your environment while streamlining processes like alerting, ticketing, and pricing management.

Explore the available customizations [here](https://docs.perfectscale.io/2.0-self-hosted-or-perfectscale-documentation/customize-workflow/customization-overview).

## Cluster labels

PerfectScale allows you to leverage your cluster labels, enabling you to organize and manage your Kubernetes clusters in the usual way. This capability is particularly helpful when managing large-scale Kubernetes environments with numerous clusters. By defining and applying cluster labels, you can streamline navigation and filtering across PerfectScale dashboards, ensuring quick access to the data you need.

<figure><img src="https://3591580169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzCh9aABpk7yLeToPr6vk%2Fuploads%2FxcKkWiukOhygH3vhOuBr%2Fimage.png?alt=media&#x26;token=6f222ddd-5f20-48f0-a8cc-24dac72c4331" alt=""><figcaption><p>Cluster labels</p></figcaption></figure>

### How to add a label

There are two seamless approaches to add cluster labels:&#x20;

* [From the cluster settings](#add-cluster-labels-from-cluster-settings)
* [From the global settings](#add-cluster-labels-from-global-settings)

#### Add cluster labels from cluster settings

1. In the cluster list, click the **gear** icon next to the cluster name to open **Cluster Settings**.
2. Go to the **Labels** tab.
3. Click **+ New Label**.
4. Enter the **Label Key** and **Label Value**.

{% hint style="warning" %}
The label key must be unique per cluster. If you attempt to add a label using a key that already exists on that cluster, the label will not be applied.
{% endhint %}

{% hint style="info" %}
Both the Key and the Value are limited to a maximum of 225 characters. Only alphanumeric characters and the following special symbols are allowed: `. - _ /`.
{% endhint %}

5. Click **Save**.

<figure><img src="https://3591580169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzCh9aABpk7yLeToPr6vk%2Fuploads%2F217XSVyX0rC4nyVNkXNX%2Fimage.png?alt=media&#x26;token=3c961c39-0da0-4f6f-b6de-a051f7933cec" alt=""><figcaption><p>Add cluster label - cluster settings</p></figcaption></figure>

#### Add cluster labels from global settings

1. Navigate to **Global Settings** in the bottom-left corner of the screen.
2. Open **Cluster Labels**.
3. Under the desired cluster, click **+ New Label**.
4. Enter the **Label Key** and **Label Value**.

{% hint style="warning" %}
The label key must be unique per cluster. If you attempt to add a label using a key that already exists on that cluster, the label will not be applied.
{% endhint %}

{% hint style="info" %}
Both the Key and the Value are limited to a maximum of 225 characters. Only alphanumeric characters and the following special symbols are allowed: `. - _ /`.
{% endhint %}

5. Click **Save**.

<figure><img src="https://3591580169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzCh9aABpk7yLeToPr6vk%2Fuploads%2FhDFzcTJFn3CrAda97CJN%2Fglobal%20settings%20(1).gif?alt=media&#x26;token=09d9410a-7e9a-40fc-9e14-883e89976987" alt=""><figcaption><p>Add cluster label - global settings</p></figcaption></figure>

### How to edit/delete a label

You can seamlessly edit or delete labels. Simply hover over the label in either the cluster settings or the global settings, and select the desired action.

<figure><img src="https://3591580169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzCh9aABpk7yLeToPr6vk%2Fuploads%2FqK7lA9RUj9FGSy2MNA0b%2Fimage.png?alt=media&#x26;token=b644a181-0d2b-43cd-b2bf-3aba8505ace2" alt=""><figcaption><p>Label actions</p></figcaption></figure>

## Upgrade and maintenance

PerfectScale delivers its services through agents like the **PSC Exporter** and **PSC AutoScaler**. To continuously analyze your environment, provide recommendations, and execute automation on your clusters, it's essential to have the relevant agent installed.&#x20;

As part of regular upgrade and maintenance, we recommend rerunning the provisioner every three months. This guarantees that your deployment remains up to date with the latest version and configuration changes. If you're running an on-premise environment, please contact PerfectScale support through either [Slack](https://join.slack.com/t/perfectscalecommunity/shared_invite/zt-1tu9teu9e-Z9tGt4LpNI8tUC3j8obcmQ) or [email](mailto:support@perfectscale.io) so that we can provide you with the needed resources for the upgrade, including:

* The most recent version of the PerfectScale provisioner
* The most recent version of the PerfectScale provisioner configuration

You need to run the provisioner against the on-premises cluster configuration, selecting the same `kubeconfig` and `kubecontext` to connect to the original cluster in the provisioner configuration. The provisioner will upgrade needed components.

With the new version, you’ll also have access to download the SBOMs for all components associated with the release.