Getting started 💪🏽

Welcome to Komodor, the dev-first Kubernetes operations platform 👋

Follow these instructions to quickly install our Agent on the clusters you want to manage, monitor, and track changes on.

To unlock Komodor's full potential take a deep dive into the feature docs, join our Slack Kommunity where you can meet fellow Komodor users, exchange knowledge, and get support from our team.

What is Komodor

Komodor is a Kubernetes operations platform for developers, complete with automated playbooks for every K8s resource, and static-prevention monitors that enrich live & historical data with contextual insights to help enforce best practices and stop incidents in their tracks.

By baking Kubernetes expertise directly into the product, Komodor is accelerating development cycles, reducing MTTR, and empowering dev teams to manage their applications efficiently and independently.

The Komodor Agent consists of two main components: 

1. Komodor-agent deployment - responsible for collecting data from the Kubernetes API and sending it to the Komodor platform. 
2. Komodor-agent-daemon daemonset - responsible for collecting metric data from nodes and pods and sending it to the Komodor platform.

Quick start TL;DR

To quickly deploy your first Komodor Agent, please follow the steps outlined below:

Prerequisites: 

1. A Kubernetes cluster
2. Helm, a package manager for Kubernetes

Step 1 - Sign up to Komodor

To create your account, sign up for Komodor with your work email address or by using SSO using your Google account.

Step 2 - Deploy the Komodor Agent on your cluster

1.  From the Clusters page, click the Connect new cluster button in the top right-hand corner.

2. Choose a name for your cluster:

3.  Copy the helm installation command:

Additional Documentation:
- How to install
- Required Permissions 

4. After copying the install command, click the Next button to bring up this page:

5. From your terminal, ensure you have switched to the relevant Kubernetes cluster context
6. Execute the Helm installation command copied from Step 3. You should see output similar to the following:

That's it! You can now click the View Resources button to start exploring all of your Kubernetes cluster's resources directly from Komodor's web UI: 

Step 3 - Start exploring the platform

After installing the Komodor Agent you will be able to view all the Kubernetess resources in your clusters on the Komodor platform web UI.
 

To unlock Komodor’s full potential, take a deep dive into the feature docs. Take a glance below at some of the key capabilities Komodor has to offer.

👁️ Observe: Cross-cluster Visibility 
- Uncover your resources with a robust K8s dashboard 
- Easily explore and navigate through your Kubernetes resources across clusters from a single pane of glass - View metrics, logs, K8s events and inspect resources in real-time

Learn how to set up your first monitors for each K8s resource

⚙️ Manage: Simplified Cluster Management 
- Easily run day-to-day operations like restarting a service, rollbacks, comparing resources, setting requests/limits, etc. 
- Control more complex configurations by editing resources, manifests and config files 
- Validate your K8s configurations with real-time feedback for best practices

Learn how to interact with your K8s cluster using Komodor

🛠️ Troubleshoot: Automated and Guided 
- View the entire history of changes and events to quickly correlate issues 
- Instantly know if an issue is infra or app-related 
- Run automatic playbooks for common K8s incidents 
- Get simple remediation instructions and take action with just one click

Learn how to use Komodor to troubleshoot issues in your K8s application

Adding additional clusters

Komodor is cloud agnostic and allows you to manage multiple clusters from a single pane of glass!
In order to add additional clusters to your account, you will need to repeat the installation process for each cluster. 

Additional clusters can be added via the Connect new cluster button on the Clusters page. 

Alternatively, new clusters can also be added via Organization Settings:

1. Navigate to the 'Organization Settings' page by clicking the Gear Icon in the upper right hand corner.
2. Click on 'Agents' under the Account section.

   

3. Click on the 'Add Cluster' button.

   

4. Follow the cluster installation wizard to onboard your new cluster.

   

Advanced configurations

To tailor the agent's functionality, go ahead and explore the Advanced Agent Configuration Guide.