Lens Desktop Integration

Lens Desktop now offers smooth integrations with Lens AppIQ, so users can quickly set up our control plane and ease their application management.

📘

Requirements

To easily set up Lens AppIQ from Lens Desktop on any cluster, please sign up at apps.lenscloud.io first. Create your own organization, or join an existing one (by previous invite of its admin). Once done, please continue with the steps below.

Enable Lens AppIQ

Within Lens Desktop, open the cluster of your preference and visit the section "Applications"

In the upper banner, click "Sign In to Lens AppIQ" and complete the authentication process.

After signing in, we validate if your cluster already has our control plane installed. If it does, you can start interacting with your applications and seeing the supported features (events, alerts/webhooks, policy violations, etc). If it does not, you will see a banner with a button that reads "Enable Lens AppIQ". Click on it

Lens will open the Settings page of your cluster and will validate if our control plane can be installed in it, based on our requirements. Please consider the following limitations

Click "Enable Lens AppIQ" and confirm the process to initiate the installation of our control plane. You can oversee the progress of the installation on the screen. It can take a couple of minutes to complete.

When the process completes successfully, you should see a healthy status of the control plane and some metadata (this information is useful to match your cluster in the web application if needed).

📘

Installation issues

If the installation of the control plane fails, please review the details of the error and visit our Troubleshooting section for more insights on what the problem might be. Feel free to contact our team for further support

After the installation is completed, Lens AppIQ will start discovering the applications running in your cluster and will augment them with all our features (events, alerts/webhooks, etc). Augmentations will be visible in the Applications section when inspecting the details of particular apps.

Visualize your applications on the web by clicking "Open in Browser".

Visualize all events affecting your applications, alerts/webhooks configured, policy violations, and more.

Inspect the topology of your applications by clicking on each workload resource and scrolling down until the section "Map"

Consolidate the application management in a single place and abstract away the complexities of Kubernetes.

Disable Lens AppIQ

To disconnect your cluster from Lens AppIQ, visit the Settings page of your Cluster, navigate to the tab Lens AppIQ, and proceed to click the button "Disable", wait a few seconds until the control plane is removed from your cluster.

Remove all remaining bits of the control plane by accessing directly your cluster and running the following commands:

kubectl get clusterrolebindings.rbac.authorization.k8s.io -o name | grep shipa | xargs kubectl delete
kubectl get clusterrole -o name | grep shipa | xargs kubectl delete
kubectl delete ns shipa

That's all, at this point, Lens AppIQ has been fully removed from your cluster.