Cluster settings

Review or edit the settings of the onboarded cluster

Cluster Settings contains a variety of configurable parameters, including:

• General cluster settings

• Various customizations

• Cluster labels

• Status of the Agent connecting the cluster to PerfectScale

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.

Cluster settings

General settings

General cluster settings

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.

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 in building 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.

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.

Cluster labels

Adding labels via the UI

There are two seamless approaches to add cluster labels:

• From the cluster settings

• From the 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.

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.

Both the Key and the Value are limited to a maximum of 225 characters. Only alphanumeric characters and the following special symbols are allowed: . - _ /.

1. Click Save.

Add cluster label - cluster settings

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.

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.

Both the Key and the Value are limited to a maximum of 225 characters. Only alphanumeric characters and the following special symbols are allowed: . - _ /.

1. Click Save.

Add cluster label - global settings

How to edit/delete a label in the UI

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.

Label actions

Adding labels via CR

Labels defined in the CR take precedence over labels added via the UI. If both define the same key, the value from the CR will be used.

Example:

Label added via the UI: env: prod

Label defined in the CR: env: app

Result: env: app is applied (CR has higher priority).

To add labels, you need to define and apply a Custom Resource (CR) that specifies these labels (key: value). This approach allows you to manage labels directly through Kubernetes manifests.

Here is an example of the CR configuration:

apiVersion: perfectscale.io/v1
kind: ClusterSettings
metadata:
  name: cluster-settings
  namespace: perfectscale
spec:
  # Cluster classification labels
  clusterLabels:
    env: production
    team: platform
    cost-center: engineering

Both the Key and the Value are limited to a maximum of 225 characters. Only alphanumeric characters and the following special symbols are allowed: . - _ /.

Labels defined in the CR are displayed in the UI with a dedicated CRD flag. Such labels cannot be edited in the UI and can only be updated in the CR.

Cluster label via CR

Automation

PerfectScale provides a quick, UI-based automation setup, so there’s no need to configure automation CRs. Learn more about Automation via UI here.

Automation via UI

Agent

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

PerfectScale agents

In Cluster Settings (accessed by clicking the gear icon next to the cluster name), select Agents. Here you can seamlessly check the current version of the agents, explore recent release notes, and manage the agents. Clicking the Release Notes button takes you to GitHub, where you can explore comprehensive release details, including changes and assets.

Updating agents

In order to ensure you receive superior service and benefit from the latest features, it’s important to keep the agents up to date.

You may encounter two types of update statuses:

• Update Available - a newer version is available, including new features and fixes, and can be installed at your convenience.

• Update Required - updating to a newer version is mandatory to continue receiving service (for example, if your current version is no longer supported).

PerfectScale provides you with several options on how to upgrade the Agents and keep operations smooth:

• Install PerfectScale Operator (recommended)

• Update the agents manually.

Updating agents with PerfectScale Operator

The PerfectScale Operator is a Kubernetes operator that handles the installation and upgrades of PerfectScale components, including the Exporter, Automation Agent, and others. It helps reduce maintenance, minimize manual work, and speed up feature rollouts across your clusters.

To learn more about installing and using the PerfectScale Operator, go here.

Updating agents manually

When updating agents manually, go to Cluster Settings (accessed by clicking the gear icon next to the cluster name), select Agents. Once there, click Show Updates Instructions next to the agent, where newer version is available.

Updating agent manually

Proceed with the two steps:

1. Update the Helm repository

helm repo update perfectscale

1. Update the PerfectScale version (example for the exporter):

helm upgrade --install -n perfectscale \
--reset-then-reuse-values \
perfectscale perfectscale/exporter

Alternatively, you can install the PerfectScale Operator to automate deployment and ensure your agents stay up to date with the latest features and product updates. Learn how to migrate.

Managing agents

PerfectScale provides a comprehensive Agent Management view, allowing you to easily access agent-related information and manage or update your agents. There are two ways to access the Agent Management view:

1. From the Overview screen.

2. From the Account settings.

Manage agent

From this view, you can:

• See information about available agent updates.

• Access detailed Helm or CRD instructions, depending on the selected update mode.

• Monitor the progress of ongoing updates or see a Failed status if an update encounters an issue.

By hovering over the displayed status or listed version you can view detailed information about the update or the reason for any failure.

Update failed flag

If the Agent Operator is installed to the cluster(s) and the mode is set to webapp, you can trigger updates for all agents with a single click for these cluster(s).

Upgrade all agents

Agent version history

When updating agents manually by explicitly setting the agent version in the CRD, you can review the CRD history to track previous versions, see changes made over time, and verify update actions for auditing or troubleshooting purposes. To access it, click the CRD label next to the agent version, then select Show History.

Agent version history

Specifying an optimization policy or returning to the default

If you set an optimization policy or custom time window using helm upgrade, you won’t be able to change these settings in the UI until you revert them to the defaults.

When upgrading the Agent, you can seamlessly specify an optimization policy and set a custom time window.

To specify an optimization policy and/or a custom time window when installing the Agent, use the following command:

helm upgrade --install -n some-release-name --create-namespace some-namespace \
  --set secret.create=true \
  --set secret.clientId=CLIENT_ID \
  --set secret.clientSecret=CLIENT_SECRET \
  --set settings.clusterName=CLUSTER_NAME \
  --set settings.clusterOptimizationPolicy="MaxSavings" \ # specify a desired optimization policy
  --set settings.optimizationPolicyTimeWindow="21d" \ # set a desired custom time window
  perfectscale/exporter

To revert to the default optimization policy and time window, upgrade the Agent using the following command:

helm upgrade --install -n some-release-name --create-namespace some-namespace \
  --set secret.create=true \
  --set secret.clientId=CLIENT_ID \
  --set secret.clientSecret=CLIENT_SECRET \
  --set settings.clusterName=CLUSTER_NAME \
  perfectscale/exporter

To revert to the default optimization policy and time window, do not specify clusterOptimizationPolicy and optimizationPolicyTimeWindow.

Delete a cluster

The endpoint removes the cluster instance from PerfectScale.

There may be situations where you need to remove a cluster from PerfectScale. You can seamlessly delete a cluster using the Public API. Learn more here.