📝 [Wiki] KubeRCA→ AI-Driven Kubernetes RCA and Automated Remediation

[Taeji_Kim]

[KubeRCA] Official Wiki

KR: 이 페이지는 KubeRCA의 비전, 기술적 방향성, 그리고 협업 방식을 정의하는 통합 문서입니다. 팀원과 외부 기여자들이 조화롭게 협업할 수 있도록 돕는 공식 가이드라인입니다.

EN: This page serves as the comprehensive documentation defining the vision, technical direction, and collaboration methods for 자 드가자. It is an official guideline to ensure seamless collaboration between the team and external contributors.

1. 프로젝트 개요 (Project Overview)

• Purpose: AI Agent를 활용하여 Kubernetes 환경에서 발생하는 Incident Alarm을 분석하고, 실제 클러스터 내 Application과 Node의 상태를 종합적으로 해석하여 표준화된 RCA 템플릿 기반의 분석 결과를 제공하는 것을 목표로 합니다.

• Background / Introduction (KR):

  • 완전 자동화된 장애 대응보다는 장애 대응 과정 중 발생하는 다양한 Alert를 AI Agent을 통해 분석하여 엔지니어가 장애의 근본 원인을 더 빠르고 명확하게 파악하고 사후 재발 방지 대책을 체계적으로 수립할 수 있도록 돕는 것을 목표로 합니다.
  • 장애 발생 시 Prometheus Alert, 로그, 메트릭 등 관측 데이터를 자동으로 수집하고, LLM과 Vector Database를 활용해 과거 유사 장애 사례 Top 3를 비교 분석함으로써 현재 상황에 가장 적합한 신속하고 일관된 대응 가이드를 제공합니다.
  • 이를 통해 개인의 경험에 의존하던 장애 대응 방식을 줄이고, 특히 주니어 엔지니어도 안정적인 판단을 내릴 수 있는 운영 환경을 만드는 것을 지향합니다.

• Background / Introduction (EN):

  • Rather than pursuing fully automated incident remediation, this project focuses on analyzing the diverse alerts generated during incident response through AI agent-based analysis, enabling engineers to identify root causes more quickly and clearly and to systematically establish post-incident prevention strategies.

  • When an incident occurs, the system automatically aggregates observability data, including Prometheus alerts, logs, and metrics. By leveraging LLMs and Vector Databases, it compares the Top 3 most similar historical incidents to provide a rapid, consistent, and context-aware response guide tailored to the current situation.

  • Through this approach, the project aims to reduce reliance on individual experience and to create an operational environment in which junior engineers can make stable and well-informed decisions.

• Core Values:

  • Open Source, Human-in-the-Loop by Design, AI-Forward Architecture

2. 팀 구성 (The Team)

Roles and responsibilities for the member team.

이름 (Name)	ID	역할 (Role)	SNS	주요 책임 (Responsibilities - KR/EN)
김태지	@Taeji_Kim	Team Leader	Link	로드맵 및 최종 의사결정 / Roadmap & Final decision-making
김회정	@user116	DevOps	Link	인프라 및 CI/CD 관리 / Infrastructure & CI/CD management
황우빈	@Binoo	BE/FE	Link	핵심 기능 구현 / Core logic & API implementation
최보현	@brilly	BE/FE	Link	핵심 기능 구현 / Core logic & API implementation

3. 기술 스택 (Tech Stack)

• Infra: Kubernetes, Terraform, AWS
• Language: Go, Python, React
• Database: PostgreSQL
• Chaos Engineering: K6, Istio, Chaos Mesh
• Observability: Loki, Grafana, Tempo, Mimir, Kiali
• Communication: Discord, Slack

4. 로드맵 (Roadmap)

• Phase 1: MVP 요구사항 정의 (MVP Requirement Definition)
• Phase 2: 핵심 모듈 개발 및 알파 테스트 (Core Module Dev & Alpha Test)
• Phase 3: 글로벌 커뮤니티 공개 (Global Community Launch)

5. 참여 방법 (How to Contribute)

• Issues: 버그나 기능 제안은 GitHub Issues를 활용하세요. (Please use GitHub Issues for bug reports or feature requests.)
• PRs: 모든 Pull Request는 Tech Lead의 검토 후 병합됩니다. (All PRs will be merged after review by the Tech Lead.)
• Guide: [CONTRIBUTING.md] 파일을 참고하세요. (Please refer to the [CONTRIBUTING.md] file.)
• Discord (Official): [자 드가자 Invite Link]
  • KR: 실시간 소통 및 기술 지원을 위한 채널입니다.
  • EN: Official channel for real-time communication and technical support.

6. 리소스 및 링크 (Resources & Links)

• GitHub Repository: [Link]
• Docs: [Architecture / API Specs]

| This is a space where knowledge is not merely consumed, but respected, sovereign, and connected—shared together with cloud industry professionals (Bros).|
| 지식이 소비되지 않고 존중·주권보장·연결되는 공간으로 클라우드 현업 전문가(Bro)와 함께 공유하고 있습니다. |