finding 상태 변경을 남기는 두 이벤트
GitHub는 10월 13일 Code Quality finding의 수동 해제와 재개를 감사 로그에서 검토할 수 있다고 발표했다. 새 이벤트는 repo.code_quality_findings_dismissed와 repo.code_quality_findings_reopened다. 각 이벤트는 요청한 주체, 발생 시각, 저장소와 규칙, 영향을 받은 finding 식별자와 개수를 담는다. 하나 이상의 항목을 처리한 행위를 표현하므로 로그 한 건이 언제나 finding 한 개와 같다고 계산해서는 안 된다. 이번 변화는 발견한 품질 문제에 대한 관리 동작을 기록하는 기능이며, 모든 항목이 자동으로 수정됐음을 인증하는 결과 기록과는 다르다.
정식 제공 범위와 조회 권한
이 기능은 GitHub Team과 Enterprise Cloud에 정식 제공되며 데이터 레지던시를 사용하는 엔터프라이즈도 포함한다. Enterprise Server에서는 이용할 수 없다고 공지는 명시한다. Code Quality가 켜진 저장소에서는 추가 설정이 필요하지 않지만, 조회자는 조직 또는 엔터프라이즈 감사 로그에 접근할 권한이 있어야 한다. Enterprise Cloud에서는 감사 로그 API로 이벤트를 가져올 수도 있다. 따라서 저장소에 코드를 쓸 수 있는 권한과 조직 전체의 감사 기록을 조회하는 권한을 같은 것으로 보면 안 된다. 공지는 기본 브랜치 backlog와 PR에서 나타나는 finding의 수동 처리 이력을 다루며 새 이벤트 이름으로 필터링하도록 안내한다.
검색 조건으로 좁히는 조사 절차
조직 감사 로그의 공식 문서는 소유자가 Settings의 Logs에서 Audit log로 이동하는 절차를 안내한다. 특정 사건은 action 한정자, 저장소는 소유자 이름까지 포함한 repo 한정자, 행위자는 actor 한정자로 좁힐 수 있다. 예를 들어 새 action 이름과 관련 저장소·담당자를 조합하면 한 규칙의 처리 이력을 찾는 데 쓸 수 있다. 일반 텍스트 검색으로 임의 문장을 찾는 방식은 아니다. 조직 로그는 최근 180일의 이벤트를 다루며 기본 화면에는 최근 세 달만 보이므로, 이전 기록을 조사할 때는 created 날짜 범위를 지정해야 한다. 조회 기간 차이를 사건 누락이나 새 기록 기능의 실패로 오인하지 않을 이유다.
수정과 해제의 운영상 의미
ARCH.B는 finding 수가 줄어든 이유를 구분할 수 있다는 점에 주목한다. 공식 backlog 문서는 관련 없거나 조치할 필요가 없는 항목을 Dismiss할 수 있으며, 유지보수하지 않는 코드·알려진 규칙 예외·오탐 등을 예로 든다. 반면 Copilot에 수정을 맡기는 경로에서는 생성된 초안 PR을 검토하고 CI를 통과한 뒤 병합하도록 안내한다. 따라서 해제 이력은 문제를 없앤 코드 변경과 별개인 판단 기록이다. 팀은 누가 어떤 규칙의 여러 항목을 처리했는지 확인한 뒤 필요한 맥락을 검토할 수 있다. 다만 이벤트 필드에 사유 설명이 항상 포함된다고 이번 공지가 보장한 것은 아니므로, 감사 로그만으로 모든 판단의 근거를 복원할 수 있다고 주장해서는 안 된다.
재개된 항목을 검토 흐름으로 연결
수동 재개 이벤트가 있으면 이전에 해제한 예외를 다시 다루는 시점을 추적할 수 있다. 운영팀은 이벤트의 항목 개수와 식별자를 보존하고, 같은 규칙에서 반복되는 해제·재개가 있는지 살펴 검토 지침이 불명확한 부분을 찾을 수 있다. 이것은 기록만으로 담당자의 판단을 평가하거나 품질 점수를 산출하는 방식과 다르다. Code Quality의 공식 설명에서 규칙 기반 분석과 최근 변경 파일의 AI 분석은 구분되며, AI findings 화면은 별도로 공개 프리뷰라고 표시된다. 이번 감사 이벤트의 정식 제공 상태를 모든 AI 분석 기능의 정식 출시로 확대하지 않는 것도 필요하다. 코드 품질 처리 이력과 보안 AI Scan의 집계 지표 역시 대상과 목적이 다른 운영 정보다.
출처
GitHub Changelog의 원출처와 본문에 표시한 참고자료를 바탕으로 한국어로 재구성했습니다. ‘ARCH.B 분석’은 자료를 읽고 덧붙인 편집 해석입니다.
Audit GitHub Code Quality finding dismissals and reopenings (새 창)