k8sgpt  by k8sgpt-ai

CLI tool for Kubernetes cluster analysis via AI

created 2 years ago
6,820 stars

Top 7.6% on sourcepulse

GitHubView on GitHub
Project Summary

k8sgpt is a command-line tool designed to simplify Kubernetes cluster diagnostics and issue triaging for SREs and developers. It leverages AI, integrating with various LLM providers, to analyze cluster states, identify problems, and provide explanations in plain English, enriching findings with codified SRE best practices.

How It Works

k8sgpt scans Kubernetes clusters using a suite of built-in analyzers that inspect various resources like Pods, Deployments, and Services. It then sends the collected data to a configured AI backend (e.g., OpenAI, Azure OpenAI, local models) for analysis. The AI provides plain-language explanations and potential solutions, with options for anonymizing sensitive data before transmission.

Quick Start & Requirements

  • Installation: Via package managers (brew, rpm, deb, apk) or direct binary download.
  • Prerequisites: Kubernetes cluster access, LLM API keys (e.g., OpenAI).
  • Setup: Configure AI backend via k8sgpt auth add.
  • Usage: k8sgpt analyze for scans, k8sgpt analyze --explain for AI-powered insights.
  • Documentation: Official Documentation

Highlighted Details

  • Supports multiple LLM backends including OpenAI, Azure, Cohere, Bedrock, Gemini, and local models.
  • Features data anonymization for sensitive information sent to AI backends.
  • Extensible with custom analyzers written in any language.
  • Operator installation available for continuous cluster monitoring.

Maintenance & Community

Licensing & Compatibility

  • License: MIT.
  • Compatible with commercial and closed-source applications.

Limitations & Caveats

  • Anonymization is not yet applied to all analyzers, notably "Events," with masking for event messages scheduled for future implementation.
  • Sensitive fields like "Event Message" are not currently masked.
  • The project recommends using local models in critical production environments due to potential data privacy concerns with public LLMs.
Health Check
Last commit

2 days ago

Responsiveness

1 week

Pull Requests (30d)
15
Issues (30d)
6
Star History
300 stars in the last 90 days

Explore Similar Projects

Starred by Eugene Yan Eugene Yan(AI Scientist at AWS), Jared Palmer Jared Palmer(Ex-VP of AI at Vercel; Founder of Turborepo; Author of Formik, TSDX), and
3 more.

seldon-core by SeldonIO

0.1%
5k
MLOps framework for production model deployment on Kubernetes
created 7 years ago
updated 1 day ago
Feedback? Help us improve.