Repolode
k8sgpt-ai

k8sgpt-ai/k8sgpt

Uma ferramenta de CLI que verifica clusters Kubernetes em busca de problemas e usa LLMs para explicá-los em linguagem simples.

Estrelas
8,275
Forks
1,087
Issues abertas
88
Último commit
há 10 horas

O que é?

k8sgpt verifica um cluster Kubernetes, executa analisadores integrados que codificam verificações comuns de SRE e relata os problemas encontrados. Ele abrange recursos como Pods, Services, Deployments, Ingress, PVCs, Nodes e webhooks, além de poder verificar áreas opcionais, como HPA, políticas de rede, Gateway API e objetos de operadores OLM.

Para cada problema encontrado, a ferramenta pode enviar o contexto relevante a um backend de IA para gerar uma explicação em linguagem simples e sugerir uma correção. Os backends compatíveis incluem OpenAI, Azure OpenAI, Cohere, Amazon Bedrock, Google Gemini, Ollama e LiteLLM. Uma opção de anonimização oculta os nomes dos objetos antes que os dados sejam enviados ao backend, e a flag `--with-doc` adiciona links para a documentação oficial do Kubernetes.

Além da CLI, o projeto oferece um modo de serviço com endpoints gRPC e de métricas, um servidor Model Context Protocol para clientes como Claude Desktop e cache remoto de resultados no S3, Azure Blob ou Google Cloud Storage.

Recursos principais

  • 01Verifica recursos Kubernetes com analisadores integrados para Pods, Services, Deployments, Ingress, PVCs e outros.
  • 02Explica os problemas detectados em linguagem simples usando um backend LLM escolhido.
  • 03É compatível com OpenAI, Azure, Bedrock, Gemini, Ollama e LiteLLM, entre outros provedores.
  • 04Anonimiza os nomes dos objetos antes de enviar dados a um backend de IA.
  • 05Filtra resultados por tipo de recurso e namespace e permite saída em JSON.
  • 06Oferece um modo de serviço e um servidor MCP para integração com assistentes de IA.

Casos de uso

  • Investigar falhas em workloads de um cluster sem precisar analisar manualmente uma grande quantidade de saídas do kubectl.
  • Executar verificações periódicas em um cluster e coletar os resultados em JSON para outras ferramentas.
  • Dar a um assistente de IA, como o Claude Desktop, acesso a informações sobre a saúde do cluster por meio do MCP.
  • Executar análises com um modelo local quando os dados do cluster não puderem sair da rede.

Início rápido

  1. 1

    Instale o k8sgpt com o Homebrew

    brew install k8sgpt
  2. 2

    Gere uma chave de API da OpenAI (um link será aberto no navegador)

    k8sgpt generate
  3. 3

    Adicione a chave de API ao k8sgpt

    k8sgpt auth add
  4. 4

    Analise o cluster e confira a explicação dos problemas

    k8sgpt analyze --explain

Antes de usar

  • O backend de IA padrão é a OpenAI. Portanto, é necessária uma chave de API da OpenAI, a menos que você configure outro provedor.
  • A análise depende de um cluster Kubernetes acessível e de um backend de IA configurado para gerar explicações.

Em coleções

Tópicos

Perguntas frequentes

O que é k8sgpt?
Uma ferramenta de CLI que verifica clusters Kubernetes em busca de problemas e usa LLMs para explicá-los em linguagem simples. k8sgpt verifica um cluster Kubernetes, executa analisadores integrados que codificam verificações comuns de SRE e relata os problemas encontrados. Ele abrange recursos como Pods, Services, Deployments, Ingress, PVCs, Nodes e webhooks, além de poder verificar áreas opcionais, como HPA, políticas de rede, Gateway API e objetos de operadores OLM.
k8sgpt é gratuito? Qual é a licença?
k8sgpt é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
k8sgpt ainda é mantido?
Manutenção ativa. O último commit de k8sgpt foi em 24 de out. de 2026.
Para que posso usar k8sgpt?
Investigar falhas em workloads de um cluster sem precisar analisar manualmente uma grande quantidade de saídas do kubectl. Executar verificações periódicas em um cluster e coletar os resultados em JSON para outras ferramentas. Dar a um assistente de IA, como o Claude Desktop, acesso a informações sobre a saúde do cluster por meio do MCP. Executar análises com um modelo local quando os dados do cluster não puderem sair da rede.
Como instalar k8sgpt?
Instale o k8sgpt com o Homebrew: brew install k8sgpt Gere uma chave de API da OpenAI (um link será aberto no navegador): k8sgpt generate Adicione a chave de API ao k8sgpt: k8sgpt auth add Analise o cluster e confira a explicação dos problemas: k8sgpt analyze --explain
Onde consigo k8sgpt?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/k8sgpt-ai/k8sgpt

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados