Get started
To get started with Kubernetes Intelligence, you first need to enable the Kubernetes core feature, and then onboard Kubernetes clusters.
Follow the step-by-step instructions below or check out the ▶️ interactive demo for a visual walkthrough.
Enable Kubernetes core
Enabling the Kubernetes core feature on your connected cloud accounts grants DoiT permissions to access relevant information in your environment.
- AWS account
- Google Cloud organization or project
You can enable Kubernetes core when linking a new account or editing a linked account.
See Link your AWS account for detailed instructions; see Kubernetes core for information about the required permissions.
You can enable Kubernetes core when connecting a Google Cloud organization or project, or when editing the connection.
See Connect Google Cloud resources for detailed instructions; see Kubernetes core for information about the required permissions.
Once permissions are granted:
-
DoiT performs a daily scan of the connected AWS accounts and Google Cloud organizations and projects (midnight UTC for AWS, 2 AM UTC for Google Cloud) to uncover Kubernetes clusters in your cloud environment.
-
DoiT synchronizes with PerfectScale for clusters that have onboarded the PerfectScale platform.
Onboard clusters
Kubernetes Intelligence relies on the Kubernetes Intelligence agent (PerfectScale Exporter) to collect cluster metrics. To onboard a Kubernetes cluster, you need to have the agent installed on the cluster.
-
In the DoiT console, select Integrate from the top navigation bar, and then select Assets.
-
Select Kubernetes from the left-hand menu. Here you'll find all the clusters uncovered via the daily scan by the DoiT platform.
-
If you've onboarded clusters with PerfectScale, proceed to Option 1: Map clusters. Otherwise, go to Option 2: Install agent via Helm chart.
Option 1: Map clusters
This option lets you avoid reinstalling the agent on clusters that already onboarded PerfectScale.
Select Map clusters to specify mappings between PerfectScale clusters and their corresponding DoiT entities.
Option 2: Install agent via Helm chart
-
Install Helm on your local system if you haven't done so.
-
Make sure the
kubectl
command-line tool is configured to communicate with your clusterThere are multiple ways to point
kubectl
to the correct cluster. The instructions below are for reference purposes.- Amazon Elastic Kubernetes Service
- Google Kubernetes Engine
-
Associate your IAM user with the AmazonEKSClusterAdminPolicy access policy for the target cluster.
-
Create a
kubeconfig
file to connectkubectl
to the EKS cluster, using the following command in the AWS CLI:aws eks update-kubeconfig --name <eks_cluster_name> --region <region>
-
Set your project property by running the
gcloud config set project <projectID>
command. -
Update the
kubeconfig
file to pointkubectl
at the GKE cluster, using the following command:gcloud container clusters get-credentials <gkeClusterName> --zone <zone> --project <projectID>
-
In the DoiT console, navigate to the Kubernetes assets list, locate the cluster of interest, and then select Install agent in the Action column.
If the DoiT platform identifies clusters that have installed the agent on PerfectScale but not mapped yet, you'll have the option to map the cluster and skip the following steps.
-
Copy and run the Helm command shown in the DoiT console to add the PerfectScale Helm chart repo.
-
Select Generate secret.
-
Note down the values of
secret.clientId
andsecret.clientSecret
in the Helm command displayed on the DoiT console. -
Copy and run the Helm command to deploy the chart.
-
-
Select Done when the Helm deployment is completed.
Verify agent status
If the installation or mapping is successful, the Agent status of the cluster on the assets list will show Waiting for data
. This status may last three minutes. After that, the status changes to Transmitting Data
.
To onboard multiple clusters, repeat the steps above for each one.
It can take up to three minutes for the status in the assets table to update, and up to 24 hours before the data is available in the Kubernetes Intelligence.
Offboard clusters
To offboard a cluster, run the following kubectl command. Deleting the namespace removes the agent from the cluster and stops all data transmission.
kubectl delete namespace perfectscale
You can also find the command in the instructions to Delete agent.
▶️ Interactive demo
Try out our interactive demo for a hands-on walk-through experience.
If the demo doesn't display properly, expand your browser window or open the demo in a new tab.