VersusControl/versus-incident

어떤 프로젝트인가요?

핵심 기능

• 01AI 에이전트가 정상 로그 패턴을 학습하고 새로운 이상 징후가 발생하면 인시던트를 생성합니다.
• 02Alertmanager, Grafana, Sentry, CloudWatch SNS, FluentBit의 웹훅을 받습니다.
• 03인시던트를 Slack, Microsoft Teams, Telegram, Viber, Email, Lark로 전달합니다.
• 04확인되지 않은 인시던트를 PagerDuty, Opsgenie, incident.io, ServiceNow, AWS Incident Manager로 에스컬레이션합니다.
• 05Go 템플릿으로 알림 메시지를 맞춤 설정할 수 있습니다.
• 06환경 변수를 지원하는 YAML 설정을 사용합니다.

활용 사례

• 여러 모니터링 도구의 알림을 하나의 알림 파이프라인으로 통합합니다.
• 알림 규칙을 관리하지 않고 애플리케이션 로그의 예상치 못한 오류를 탐지합니다.
• PagerDuty나 Opsgenie를 사용하는 팀의 온콜 에스컬레이션을 운영합니다.
• 하나의 대시보드에서 Kubernetes 클러스터를 모니터링하고 워크로드와 Helm 릴리스를 확인합니다.

빠른 시작

1. 1

   에이전트의 커서 저장용으로 Redis를 시작합니다

   docker run -d --name versus-redis -p 6379:6379 redis:7
2. 2

   AI 에이전트를 활성화한 상태로 Versus를 학습 모드에서 실행합니다

   docker run -p 3000:3000 -e GATEWAY_SECRET=change-me -e AGENT_ENABLE=true -e AGENT_MODE=training -e REDIS_HOST=host.docker.internal -e REDIS_PORT=6379 -v $(pwd)/config:/app/config -v $(pwd)/data:/app/data ghcr.io/versuscontrol/versus-incident
3. 3

   localhost:3000에서 관리자 대시보드를 열어 학습된 패턴을 검토합니다

사용 전 알아둘 점

• !실행하려면 로그를 가리키는 config.yaml과 agent_sources.yaml이 필요합니다.
• !현재 구현된 스토리지 백엔드는 파일 스토리지뿐이며, Redis와 데이터베이스는 스텁입니다.
• !AI 에이전트에는 소스 커서용 Redis 인스턴스도 실행 중이어야 합니다.

토픽

자주 묻는 질문

versus-incident은(는) 무엇인가요?

정상 로그 패턴을 학습하고 새로운 이상 징후가 발생하면 인시던트를 자동 생성해 알림을 전달하는 셀프 호스팅 AI SRE 에이전트입니다. Versus Incident는 운영팀을 위한 셀프 호스팅 인시던트 관리 서비스입니다. 인시던트를 생성하는 방법은 두 가지입니다. 하나는 Elasticsearch나 로컬 파일 같은 로그 소스를 읽고 정상 패턴을 학습한 뒤 새로운 오류가 나타나면 인시던트를 생성하는 AI SRE 에이전트입니다. 다른 하나는 Alertmanager, Grafana, Sentry, CloudWatch SNS, FluentBit 같은 도구에서 Go 템플릿으로 형식을 지정한 웹훅 알림을 받는 방식입니다.

versus-incident은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

versus-incident은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

versus-incident은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. versus-incident의 마지막 커밋은 2026년 10월 17일입니다.

versus-incident은(는) 어디에 사용할 수 있나요?

여러 모니터링 도구의 알림을 하나의 알림 파이프라인으로 통합합니다. 알림 규칙을 관리하지 않고 애플리케이션 로그의 예상치 못한 오류를 탐지합니다. PagerDuty나 Opsgenie를 사용하는 팀의 온콜 에스컬레이션을 운영합니다. 하나의 대시보드에서 Kubernetes 클러스터를 모니터링하고 워크로드와 Helm 릴리스를 확인합니다.

versus-incident는 어떻게 설치하나요?

에이전트의 커서 저장용으로 Redis를 시작합니다: docker run -d --name versus-redis -p 6379:6379 redis:7 AI 에이전트를 활성화한 상태로 Versus를 학습 모드에서 실행합니다: docker run -p 3000:3000 -e GATEWAY_SECRET=change-me -e AGENT_ENABLE=true -e AGENT_MODE=training -e REDIS_HOST=host.docker.internal -e REDIS_PORT=6379 -v $(pwd)/config:/app/config -v $(pwd)/data:/app/data ghcr.io/versuscontrol/versus-incident localhost:3000에서 관리자 대시보드를 열어 학습된 패턴을 검토합니다

versus-incident은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/VersusControl/versus-incident