ongridio/ongrid

An ops AI Agent that understands your infrastructure, finds the root cause, and fixes it — right from Slack, Telegram, Lark or DingTalk.

📌 Ongrid란 무엇인가?

Ongrid는 인프라 내에서 작동하는 오픈소스 AI 기반 운영 어시스턴트입니다. Slack, Telegram(및 기타 메신저)에 연결하여 질문하거나 알림에 대응할 수 있습니다. 내부적으로 코디네이터 및 전문 에이전트 집합이 대규모 언어 모델을 사용하여 다음을 수행합니다:

호스트, 컨테이너 및 네트워크 장치의 토폴로지 발견,
메트릭, 로그 및 추적을 상호 연관시켜 인시던트의 근본 원인 파악,
구체적인 복구 단계 제안,
승인 게이트 후 안전하고 감사된 명령(예: 역방향 터널 SSH 셸)을 선택적으로 실행.

플랫폼은 백엔드에 Go, UI에 TypeScript/React로 구축되었으며 전체 관찰 가능성 스택(Prometheus, Loki, Tempo, Grafana)을 제공합니다. Anthropic, OpenAI, Gemini, DeepSeek 등 API를 제공하는 모든 LLM을 연결할 수 있습니다.

🚀 핵심 기능(README에 나열된 대로)

기능	설명
코디네이터 + 전문 에이전트	중앙 디스패처가 요청을 도메인별 하위 에이전트(SRE, 네트워킹, 데이터베이스 등)로 라우팅합니다.
알림 시 자동 조사	알림이 발생하면 조사 에이전트가 자동으로 근본 원인 분석(RCA)을 시작하고 결과를 채팅에 게시합니다.
근본 원인 RCA	발견된 토폴로지를 탐색하고 메트릭/로그/추적을 상호 연관시켜 문제를 일으킨 정확한 코드 줄 또는 구성을 지적합니다.
인바운드 포트 없음	엣지 에이전트는 아웃바운드 연결만 시작합니다. 호스트에서 SSH/HTTP 포트를 열 필요가 없습니다.
브라우저 SSH	완전히 감사되고 웹 UI에서 액세스할 수 있는 역방향 터널, 키 없는 셸을 제공합니다.
원커맨드 자체 호스팅	`install.sh`가 전체 스택(백엔드, UI, 관찰 가능성)을 한 번에 프로비저닝합니다.
내장 관찰 가능성	Prometheus, Loki, Tempo 및 Grafana가 사전 연결되어 있으며 에이전트가 메트릭, 로그 및 추적에 대한 자체 쿼리를 작성합니다.
자체 모델 사용	Anthropic, OpenAI, GLM, DeepSeek, Gemini, Kimi를 지원하며 공급자 간 핫 라우팅이 가능합니다.
양방향 IM 채널	Slack, Telegram, Larksuite, DingTalk, WeCom 및 일반 웹훅을 통해 에이전트에 명령을 보내고 결과를 받을 수 있습니다.
읽기 전용 호스트 도구	26개 이상의 검사 유틸리티가 있는 샌드박스 Bash 환경. 모든 호출은 감사 가능하도록 기록됩니다.
Kubernetes 수명 주기	클러스터 등록, 워크로드/이벤트 검사, 업그레이드 관리, Kubernetes 리소스를 토폴로지 그래프에 매핑.
네트워크 장치 관리	엣지 호스트를 통해 인접 장치를 발견하고, SNMP로 검증하고, 인터페이스를 폴링하고, 호스트를 네트워크 장비에 연결합니다.

🛠️ 빠른 설치(README에서)

# 서버 CPU 아키텍처에 맞는 바이너리를 선택하세요
wget https://github.com/ongridio/ongrid/releases/download/v0.18.2/ongrid-v0.18.2-linux-amd64.tar.xz
# 또는 ARM64 변형
# wget https://github.com/ongridio/ongrid/releases/download/v0.18.2/ongrid-v0.18.2-linux-arm64.tar.xz

tar -xf ongrid-v0.18.2-linux-*.tar.xz && cd ongrid-v0.18.2-linux-*
sudo ./install.sh   # 전체 스택(백엔드, UI, 관찰 가능성) 실행

중국 본토 사용자를 위해 CDN 미러(https://ongrid.cloud/dl/...)가 제공됩니다.

🎯 일반적인 사용 사례

알림 기반 자동 조사 – Prometheus의 알림이 Incident Investigator를 트리거하여 토폴로지를 수집하고, 런북에 대해 RAG 검색을 실행하고, 간결한 RCA를 원래 Slack 채널에 게시합니다.
주문형 문제 해결 – 운영자가 봇에게 "서비스 X의 지연 시간이 왜 높습니까?"라고 묻습니다. 코디네이터가 쿼리를 SRE 전문가에게 라우팅하여 메트릭, 로그, 추적을 가져오고 단계별 설명을 반환합니다.
통제된 복구 – RCA 후 봇은 수정 사항(예: 포드 재시작)을 제안할 수 있습니다. 제안은 에이전트가 실행하기 전에 사람이 검토하고 승인하는 승인/쓰기 게이트 UI를 거칩니다.
Kubernetes 수명 주기 관리 – Edge 구성 요소를 통해 새 클러스터를 등록하고, 워크로드를 보고, 업그레이드를 예약하고, 클러스터를 전역 토폴로지 보기에 자동으로 매핑합니다.
네트워크 토폴로지 매핑 – Edge 에이전트가 네트워크 이웃을 발견하고, SNMP로 검증하고, 영향 분석을 위해 호스트-장치 링크를 시각화합니다.

📚 문서 및 커뮤니티

전체 문서: https://ongrid.cloud/docs
Telegram 또는 Slack에서 커뮤니티에 참여하세요(README의 배지).
기여는 환영합니다 – CONTRIBUTING.md를 참조하세요.

📄 라이선스

코드는 AGPL-3.0으로 릴리스됩니다. 브랜드 자산에는 별도의 상표 라이선스(TRADEMARK.md)가 있습니다.

TL;DR

Ongrid는 자체 호스팅, AI 기반 SRE 플랫폼으로, 대규모 언어 모델 기반 에이전트에게 인시던트 조사, 관찰 가능성 데이터 탐색, 안전한 복구 실행까지 요청할 수 있습니다—모두 익숙한 채팅 도구에서 가능합니다. 필요한 인프라(Go 백엔드, React UI, Prometheus/Loki/Tempo/Grafana)를 번들로 제공하며 선호하는 모든 LLM 공급자와 통합됩니다.