본문으로 건너뛰기
JournalTORIS / FIELD NOTES

← 블로그개발 도구

OpenSRE(Tracer-Cloud/opensre) — 깨진 CI/CD 빌드 원인을 추적하고 PR 수정안까지 올리는 오픈소스 에이전트

CI/CD 빌드가 깨졌을 때 로그와 커밋·Grafana·Datadog 지표를 교차 분석해 원인을 분리하고 PR 수정안까지 생성하는 Apache-2.0 오픈소스 에이전트 OpenSRE 정리.

Read in English

OpenSRE(Tracer-Cloud/opensre) — 깨진 CI/CD 빌드 원인을 추적하고 PR 수정안까지 올리는 오픈소스 에이전트

Q. CI/CD 빌드가 깨졌을 때 로그 분석부터 PR 수정안 작성까지 오픈소스 에이전트에게 맡길 수 있나요? 네. **OpenSRE(Tracer-Cloud/opensre)**는 실패한 CI 실행 로그, 최근 커밋, Grafana·Datadog 관측 데이터를 함께 읽어 코드 문제인지 CI 환경 문제인지 가려낸 뒤 PR 수정안까지 생성하는 Apache-2.0 오픈소스 에이전트입니다.

⚠️ 정확도 가드레일: 이 글은 2026년 11월 21일 기준 공식 GitHub 저장소(Tracer-Cloud/opensre, 13,625 Stars · 1,926 Forks · 최신 릴리즈 v0.1.2026.11.21)와 README·릴리즈 메타데이터를 직접 확인해 작성했습니다. 프로젝트가 Public Alpha 단계여서 API·연동 스펙이 수시로 바뀔 수 있으며, 실서버 벤치마크나 유료 OpenSRE Cloud 요금제 상세는 저장소에 공개되지 않아 다루지 않았습니다.

30초 요약

  • CI/CD 전용 오픈소스 에이전트: 단순 재실행(re-run)이 아니라 실패한 빌드 로그와 커밋·메트릭을 교차 조회해 CI 환경 오류와 코드 오류를 분리하고 수정안을 PR 브랜치로 올립니다.
  • 60개 이상 연동 & 셀프 호스팅: GitHub·GitLab·Jenkins부터 Grafana·Datadog·Sentry·Kubernetes·Slack·Telegram까지 연결하며, Anthropic·OpenAI·Gemini·Ollama 등 원하는 모델 키로 내 인프라에서 직접 돌릴 수 있습니다.
  • 도입 전 체크할 점: Apache-2.0 라이선스지만 현재 Public Alpha 상태이며, 1차 제품 분석·Sentry 텔레메트리가 기본 활성화(opt-out)이므로 운영 환경에서는 export OPENSRE_NO_TELEMETRY=1 설정을 먼저 확인하는 편이 안전합니다.

토리스 스튜디오 유튜브에서도 11월 20일 GitHub 트렌딩 TOP 10 중 3위로 다룬 프로젝트입니다. AI 코딩 도구로 코드를 뽑아내는 속도는 빨라졌는데, 막상 PR을 올렸을 때 깨진 테스트와 불안정한 CI 파이프라인을 파헤치는 일은 여전히 사람 몫으로 남곤 합니다. OpenSRE가 왜 빠르게 별을 모으고 있는지, 실제 구조와 도입 기준을 짚어 봅니다.

Tracer-Cloud/opensre GitHub 저장소 화면

OpenSRE가 해결하려는 문제: 재실행이 아니라 원인 분리

CI가 빨간불을 띄웠을 때 가장 비싼 비용은 "다시 돌려보고 넘기는 습관"에서 나옵니다.

기존 CI 알림은 "무엇이 실패했다"만 알려줄 뿐, 러너 메모리 부족이나 외부 패키지 일시 장애 같은 인프라 이슈인지 실제 코드 회귀(regression)인지까지는 가려주지 않습니다. OpenSRE는 실패가 감지되거나 사용자가 질문을 던지는 순간 관련 로그·최근 커밋·배포 이력을 묶어 가설을 세우고 검증합니다.

구분 기존 CI + 수동 디버깅 OpenSRE 에이전트 워크플로우
실패 원인 파악 개발자가 로그·커밋·모니터링을 수동 대조 실패 체크·최근 커밋·관측 로그를 자동 교차 분석
오류 성격 분류 경험 많은 시니어 엔지니어에 의존 CI 환경 문제 vs 코드 문제를 도구 호출 루프로 분리
후속 조치 로컬에서 재현 후 직접 패치 커밋 수정안 생성 후 PR 브랜치 푸시(사람 리뷰 대기)
알림·보고 단순 실패 링크 알림 원인·근거·조치 내역을 Slack·PagerDuty·Telegram 요약

광고

6단계 작동 구조와 60+ 연동 생태계

OpenSRE의 핵심은 LangGraph 같은 무거운 체인 계층을 덜어내고, 도구 호출(tool-calling) 루프로 관측·코드·알림을 한 번에 잇는 데 있습니다.

OpenSRE 6단계 CI/CD 에이전트 아키텍처

공식 저장소 README에 공개된 동작 흐름은 여섯 단계입니다.

  1. 컨텍스트 수집(Fetch): 실패한 체크와 CI 로그, 최근 커밋·배포 내역, 연관된 로그·메트릭·트레이스를 끌어옵니다.
  2. 민감정보 마스킹(Mask): 외부 LLM 호출 전에 민감한 식별자를 선택적으로 가립니다.
  3. 추론 및 가설 검증(Reason): 연결된 시스템에 도구를 호출하며 가설을 검증하고 CI 원인과 코드 원인을 가릅니다.
  4. 근거 기반 답변(Answer): 확인된 로그·커밋 근거 링크와 함께 대화형으로 답합니다.
  5. 수정안 푸시(Fix): 원인을 고쳐 PR 브랜치에 올리거나, 승인된 복구 작업을 실행합니다.
  6. 채널 요약(Post): Slack, PagerDuty, Telegram으로 요약을 바로 전달합니다.

Q. 어떤 도구와 모델을 붙일 수 있나요? 공식 문서 기준 60개 이상의 연동을 지원합니다. LLM은 Anthropic·OpenAI·OpenAI Codex·Google Gemini·Ollama·Bedrock 등을 쓰고, 관측 도구는 Grafana(Loki·Mimir·Tempo)·Datadog·Sentry·CloudWatch, 인프라는 Kubernetes·AWS·ArgoCD·Helm, 코드 저장소는 GitHub·GitLab·Bitbucket·Jenkins를 연결합니다. Notion·Teams·Confluence·Linear는 로드맵에 올라가 있습니다.

설치와 3가지 실행 방식 (CLI · Headless · Python API)

설치 스크립트 한 줄로 로컬 CLI를 시작하거나, opensre ask로 기존 CI 파이프라인 안에 바로 끼워 넣을 수 있습니다.

macOS와 Linux에서는 아래 명령으로 최신 main 빌드를 내려받습니다(Windows는 PowerShell 스크립트 제공).

curl -fsSL https://install.opensre.com | bash -s -- -gh
opensre

실행 방식은 상황에 따라 세 가지로 나뉩니다.

  • 대화형 셸(opensre): 터미널 REPL에서 자연어로 장애를 묻고 /status, /cost, /sessions, /integrations verify 같은 슬래시 명령으로 세션을 제어합니다.
  • 헤드리스 CLI(opensre ask "..."): 비대화형으로 한 턴만 실행하므로 CI 잡이나 셸 스크립트 자동화에 끼워 넣기 좋습니다.
  • Python 임베디드 API(start_embedded_session): 소스 체크아웃 환경에서 팀 내부 자동화 스크립트 안으로 직접 불러다 쓸 수 있습니다.

밤 시간대 개발자 데스크의 터미널과 CI/CD 파이프라인 화면

배포 역시 Docker Dockerfile을 이용해 Railway·ECS·Vercel 등에 띄우거나, Telegram 게이트웨이 전용 AMI+systemd 이미지(make deploy-gateway)로 올릴 수 있고, 공유 Slack 상태가 필요할 때만 DATABASE_URL(Postgres)을 붙이는 구조입니다.

도입 전 꼭 확인할 Public Alpha 한계와 보안·텔레메트리

아파치 2.0 오픈소스라도 현재 Public Alpha 단계인 만큼, 자동 머지 대신 "PR 리뷰 보조"로 범위를 잡아야 합니다.

  • Public Alpha 변동성: 저장소 상단에도 핵심 워크플로는 탐색용으로 쓸 수 있지만 아직 완전한 안정판이 아니며, API와 연동 인터페이스가 바뀔 수 있다고 명시돼 있습니다.
  • 텔레메트리 opt-out: 제품 분석과 Sentry 오류 수집이 기본 켜짐(opt-out)입니다. 사내 환경이나 민감한 저장소에서 테스트한다면 실행 전 export OPENSRE_NO_TELEMETRY=1을 환경 변수에 넣어 두는 편이 깔끔합니다.
  • 사람의 최종 검토: 에이전트가 PR 브랜치에 수정안을 올릴 수는 있어도, 실제 머지와 프로덕션 배포 결정은 사람이 리뷰한 뒤 내리는 구조가 안전합니다. 에이전트의 계획과 코드 변경을 브라우저에서 직접 검수하려면 이전에 정리한 Plannotator 가이드나 에이전트용 CLI 래퍼인 CLI-Anything 가이드와 함께 보는 것도 좋습니다.

토리스의 판단

1인 개발자나 소규모 팀이라면: 당장 프로덕션 장애 자동 복구(auto-remediation)까지 맡기기보다, opensre ask나 GitHub 연동으로 깨진 CI 빌드 원인 요약과 초안 PR 생성만 먼저 붙여 보시길 권합니다. 주말이나 밤늦게 빌드가 깨졌을 때 로그를 처음부터 뒤지는 시간을 크게 줄여 줍니다.

중견 이상 팀이라면: 이미 Grafana·Datadog·Sentry와 Slack 알림을 쓰고 있다면 자체 컨테이너(Dockerfile)와 사내 LLM 키, 그리고 OPENSRE_NO_TELEMETRY=1 + 민감정보 마스킹 옵션을 켜고 스테이징 레포지토리에서 파일럿으로 검증해 볼 가치가 충분합니다.

출처

광고

YOUTUBE · TORIS STUDIO

토리스 영상 더 보기