k8sgpt-ai/k8sgpt
Giving Kubernetes Superpowers to everyone
k8sgpt란 무엇인가요?
k8sgpt는 Kubernetes 클러스터를 스캔하여 문제를 찾고 평이한 영어로 설명하는 명령줄 도구(및 선택적 클러스터 내 운영자)입니다. Kubernetes 객체(Pod, Service, Deployment 등)를 이해하는 내장 분석기 세트와 LLM(OpenAI, Azure, Cohere, Bedrock, Gemini, 로컬 모델 등)을 결합하여 원시 진단 데이터를 사람이 읽을 수 있는 설명과 수정 제안으로 변환합니다.
주요 기능
| 기능 | 설명 |
|---|---|
| 클러스터 스캔 | Kubernetes API를 탐색하고 수십 개의 분석기(예: Pod, PVC, HPA, Ingress)를 실행하여 상태, 이벤트 및 구성 세부 정보를 수집합니다. |
| AI 기반 설명 | 간결하고 익명화된 페이로드를 선택한 LLM에 보내고 문제와 해결 방법에 대한 자연어 설명을 받습니다(k8sgpt analyze --explain). |
| 다중 LLM 백엔드 | OpenAI, Azure OpenAI, Cohere, Amazon Bedrock, Google Gemini, Ollama, LiteLLM 프록시 및 일반 REST 인터페이스를 통한 자체 호스팅 모델을 지원합니다. |
| 익명화 | 민감한 이름은 클러스터를 떠나기 전에 마스킹된 후 최종 답변에서 마스킹이 해제되어 데이터 유출 위험을 줄입니다. |
| 운영자 모드 | 클러스터 내에 k8sgpt-operator를 배포하여 지속적인 모니터링과 Prometheus/Alertmanager 통합을 실현합니다. |
| MCP 서버 | Model Context Protocol (MCP) HTTP/gRPC 엔드포인트를 노출하여 다른 도구(예: Claude Desktop)가 분석 결과를 프로그래밍 방식으로 쿼리할 수 있게 합니다. |
| 확장 가능한 필터 및 사용자 정의 분석기 | 특정 분석기를 활성화/비활성화하고, 리소스 유형이나 네임스페이스로 필터링하고, 자체 플러그인을 작성할 수 있습니다. |
| 원격 캐시 | 분석 결과를 캐시하기 위한 선택적 S3 또는 Azure Blob 스토리지. |
| 간편한 설치 | Homebrew, RPM, DEB, APK 패키지 및 Windows용 사전 빌드 바이너리. |
누가 사용할까요?
- 사이트 신뢰성 엔지니어(SRE): 로그를 파헤치지 않고 클러스터 상태를 빠르고 읽기 쉬운 요약으로 확인해야 하는 분.
- 개발자: 실패한 배포를 문제 해결하고 AI가 생성한 제안을 원하는 분.
- 플랫폼 팀: 운영자를 통해 지속적인 검사를 실행하고 결과를 기존 모니터링 스택에 공급하려는 분.
- CLI에 익숙한 모든 분: Kubernetes용 LLM 기반 진단을 실험해 보고 싶은 분.
시작하기(빠른 시작)
- 설치 –
brew install k8sgpt(또는 RPM/DEB/Windows 바이너리 사용). - LLM 구성 –
k8sgpt generate를 실행하여 OpenAI 키 페이지를 열고k8sgpt auth add를 실행합니다(또는--backend로 다른 백엔드 추가). - 스캔 실행 –
k8sgpt analyze --explain. - 선택 사항 –
--with-doc를 추가하여 공식 Kubernetes 문서를 포함하거나--filter=Pod --namespace=default를 추가하여 범위를 좁힙니다.
자세히 알아보기
- 전체 문서: https://docs.k8sgpt.ai/
- 운영자 저장소: https://github.com/k8sgpt-ai/k8sgpt-operator
- 커뮤니티 및 기여는 GitHub 저장소를 통해 환영합니다.
관련
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트