K8sGPT: Simplifying Kubernetes Diagnostics with Natural Language Processing

Kubernetes is a powerful tool that has revolutionized the way we build and deploy applications. However, managing Kubernetes clusters can be a daunting task, especially when it comes to diagnosing and triaging issues. With so many moving parts and complex interdependencies, it can be challenging to pinpoint the root cause of a problem. This is where K8sGPT comes in. K8sGPT is a tool that leverages natural language processing (NLP) to simplify the process of diagnosing and triaging issues in Kubernetes clusters. In this article, we’ll explore K8sGPT and how it works, and we’ll provide code snippets to demonstrate how to use it.

What is K8sGPT?

K8sGPT is a tool that uses NLP to analyze logs and other data from Kubernetes clusters to identify and diagnose issues. It has a set of built-in analyzers that are designed to identify common issues such as pod crashes, service failures, and ingress misconfigurations. K8sGPT is built on top of OpenAI’s GPT-3 language model, which allows it to understand natural language and provide explanations that are easy to understand.

K8sGPT is focused on triaging and diagnosing issues in your cluster. It is a tool for SRE, Platform, and DevOps engineers to help them understand what is going on in their cluster and find the root cause of an issue. It can help you cut through the noise of logs and multiple tools to find the root cause of an issue.

How K8sGPT Works

K8sGPT uses a set of analyzers that are designed to identify issues in Kubernetes clusters. These analyzers use NLP to analyze logs, metrics, and other data from your cluster to identify potential issues. When an issue is identified, K8sGPT provides an explanation in natural language that is easy to understand. This allows you to quickly understand the issue and take the necessary steps to resolve it.

K8sGPT is built on top of OpenAI’s GPT-3 language model, which allows it to understand natural language. This means that you can ask K8sGPT questions about your cluster in plain English, and it will provide a response that is easy to understand. For example, you can ask K8sGPT “Why is my pod crashing?” and it will provide an explanation of why the pod is crashing and what steps you can take to fix the issue.


K8sGPT can be installed on Linux, Mac, and Windows. The easiest way to install K8sGPT on Linux or Mac is via Homebrew. To install K8sGPT via Homebrew, run the following commands:


brew tap k8sgpt-ai/k8sgpt

brew install k8sgpt


If you encounter an error when installing K8sGPT on WSL or Linux, you may need to install the build-essential package. You can do this by running the following commands:


sudo apt-get update

sudo apt-get install build-essential


If you are running on Windows, you can download the latest Windows binaries from the Release tab on GitHub.

Once k8sgpt is installed, you can verify that it is working by running the version command:


k8sgpt version

Generating an API key

Before we can use k8sgpt, we need to generate an API key from OpenAI. To generate an API key, run below command , this will open a link in your default web browser where you can generate an API key. Once you have generated an API key, you can set it in k8sgpt

k8sgpt generate

K8sgpt auth

This will prompt you to enter your API key. Once you have entered your API key, k8sgpt will be able to use it to analyze your Kubernetes clusters.

Analyzing your Kubernetes clusters

Now that we have k8sgpt installed and authenticated, we can start analyzing our Kubernetes clusters. To analyze a Kubernetes cluster, run the following command:

k8sgpt analyze

This will scan your Kubernetes cluster and look for any issues. By default, k8sgpt will use all of its built-in analyzers to analyze your cluster.

If k8sgpt finds any issues, it will output a summary of the issues it found. For example:

Analyzer: podAnalyzer

  Namespace: default

  Name: nginx-66b6c48dd5-zk6jt

  Kind: Pod

  Reason: CrashLoopBackOff

  Message: Back-off 5m0s restarting failed container=nginx pod=nginx-66b6c48dd5-zk6jt_default(25f13c57-04eb-4a0a-a2f7-17b7564a7944)


Refer:   https://kubernetes.io/docs/tasks/debug-application-cluster/debug-running-pod/ 

This output tells us that there is an issue with the nginx pod in the default namespace. The pod is in a CrashLoopBackOff state, and the nginx container in the pod has failed and is being restarted every 5 minutes.

If you want to see more information about the issue, you can use the –explain flag:

k8sgpt analyze –explain

This will output a more detailed explanation of the issues that k8sgpt found.

Filtering resources

By default, k8sgpt will analyze all resources in your Kubernetes cluster. However, you can filter the resources that k8sgpt analyzes by using the –filter flag.

Filters are used to control which Kubernetes resources are analyzed. By default, all filters are enabled. You can manage filters using the filters subcommand.

To view the list of filters, run:

Add filter , remove , list and more

k8sgpt filters list

k8sgpt filters add [filter]

k8sgpt filters add Service,Pod

k8sgpt filters remove [filter]

k8sgpt filters remove Service

You can filter the resources by namespace using the –namespace flag:

k8sgpt analyze –namespace=default

Custom Analyzers

k8sgpt comes with a set of built-in analyzers that cover a variety of Kubernetes resources. However, you can also write your own custom analyzers to analyze your own resources.

To write a custom analyzer, you will need to create a new Go package that implements the Analyzer interface:

type Analyzer interface {

// Analyze analyzes the given Kubernetes resource and returns any issues found

Analyze(resource *unstructured.Unstructured) ([ ]*Issue, error)

// Name returns the name of the analyzer

Name() string

// Enabled returns whether the analyzer is enabled

Enabled() bool


The Analyze method takes a Kubernetes resource as input and returns an array of issues found. The Name method returns the name of the analyzer, and the Enabled method returns whether the analyzer is enabled.

Once you have written your custom analyzer, you can register it with k8sgpt by calling the RegisterAnalyzer function:

RegisterAnalyzer(name string, analyzer Analyzer)

k8sgpt.RegisterAnalyzer(“MyAnalyzer”, &MyAnalyzer{})

You can then use the –filter flag to filter by your custom analyzer:

k8sgpt analyze –filter=MyAnalyzer

You can also combine multiple filters together to create more complex filters. For example, the following command will only analyze Pod resources in the “default” namespace with a label of “app=myapp”:

k8sgpt analyze –filter=Pod –namespace=default –label-selector=app=myapp


K8sGPT is a powerful tool that can help you diagnose and triage issues in your Kubernetes clusters. Its ability to analyze logs and Kubernetes resources using natural language processing and AI makes it stand out from other monitoring tools.

By installing and configuring K8sGPT, you can easily scan your clusters, identify issues, and get recommendations on how to fix them. Additionally, its built-in analyzers and filters make it easy to customize the analysis to fit your specific needs.

Whether you’re an SRE, Platform or DevOps engineer, K8sGPT can help you gain insights into your Kubernetes clusters and make your job easier. Try it out today and see how it can help you improve your Kubernetes monitoring and troubleshooting workflows!