pr-stats

액션 소개

pr-stats는 PR에 대한 유용한 통계를 산출하는 GitHub Actions입니다.

PR별 평균 머지까지 소요되는 시간, 리뷰어의 응답시간 등을 산출할 수 있습니다.

통계 결과는 커스터마이즈 할 수 있습니다.

해당 액션을 업무에 활용하는 방법은 활용 예시를 참고해 주세요.

사용 방법

GitHub 저장소에 아래 파일을 만드세요.

# .github/workflows/pr-stats.yml
name: PR Stats
on:
  workflow_dispatch: # 액션이 실행될 이벤트를 작성하세요.
  # https://docs.github.com/ko/actions/using-workflows/events-that-trigger-workflows
jobs:
  pr-stats:
    runs-on: ubuntu-latest
    steps:
      - name: PR Stats
        uses: "naver/pr-stats@v1.0.0"
        with:
          token: ${{ secrets.GITHUB_TOKEN }}
          # with 인자 설명을 반드시 참고하세요.

활용 예시) 결과물을 PR로 생성

다음과 같이 작성하면 ./stats/ 하위에 pr.csv, prList.csv, user.csv가 포함된 PR이 만들어집니다.

# .github/workflows/pr-stats.yml
    # ...
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4
      - name: PR Stats
        uses: "naver/pr-stats@v1.0.0"
        with:
          token: ${{ secrets.GITHUB_TOKEN }}
      - name: Create Pull Request
        uses: peter-evans/create-pull-request@v5

수집 데이터

PR

단일 PR에 대한 통계입니다. 이 데이터는 ./stats/pr.csv로 저장됩니다.

필드	설명
number	PR 번호
title	PR 제목
createdAt	PR 생성 시점의 timestamp
mergedAt	PR 머지 시점의 timestamp
addedLineCount	추가된 라인 수
removedLineCount	제거된 라인 수
changedLineCount	변경된 라인 수
fileCount	파일 개수
commitCount	커밋 개수
commentCount	코멘트 개수
conversationCount	대화 개수
reviewerCount	리뷰어 수
approvalCount	승인 수
participationCount	참여 수
participationRate	참여율
timeFromReviewToMerge	리뷰에서 병합까지의 시간 (ms)
averageResponseTime	평균 응답 시간 (ms)
averageTimeToApproval	평균 승인까지의 시간 (ms)
averageLinesChangedPerCommit	커밋당 평균 변경 라인 수

PR List

수집한 모든 PR에 대해서 산출한 통계입니다. 이 데이터는 ./stats/prList.csv로 저장됩니다.

필드	설명
averageAddedLineCount	평균 추가된 라인 수
averageRemovedLineCount	평균 제거된 라인 수
averageChangedLineCount	평균 변경된 라인 수
averageFileCount	평균 파일 개수
averageCommitCount	평균 커밋 개수
averageCommentCount	평균 코멘트 개수
averageConversationCount	평균 대화 개수
averageReviewerCount	평균 리뷰어 수
averageApprovalCount	평균 승인 수
averageParticipationCount	평균 참여 수
averageTimeFromReviewToMerge	리뷰에서 병합까지의 평균 시간 (ms)
averageResponseTime	평균 응답 시간 (ms)
averageTimeToApproval	평균 승인까지의 시간 (ms)
averageLinesChangedPerCommit	커밋당 평균 변경 라인 수
participationRate	참여율

User

수집된 데이터에서 각 유저들에 대해 산출한 통계입니다. 이 데이터는 ./stats/user.csv로 저장됩니다.

필드	설명
id	사용자 ID
requestedCount	요청 수
participationCount	참여 수
participationRate	참여율 (xx.xx)
averageCommentCount	평균 코멘트 개수
averageResponseTime	평균 응답 시간 (ms)
averageTimeToApproval	평균 승인까지의 시간 (ms)
averageLinesChangedPerCommit	커밋당 평균 변경 라인 수

커스터마이즈

액션을 실행하는 저장소 Root에 stats.config.js 을 추가하면, 출력할 통계 항목을 변경할 수 있습니다.

stats.config.js 파일은 필수로 생성하지 않아도 되며, 생성하지 않을 경우 기본동작을 실행합니다.

통계 항목 제어

다음과 같이 작성하면, pr은 number, title, fileCount, prList는 미출력, user는 id만 출력됩니다.

// {targetRepo}/stats.config.js
module.exports = {
    pr: ["number", "title", "fileCount"],
    prList: [],
    user: ["id"],
};

통계 항목 추가

함수 형태로 export 하면 기본 통계 설정 정보(defaultStats)가 인자로 전달됩니다. 이를 통해 기본 통계 설정을 유지하며 특정 통계만 추가할 수 있습니다.

다음은 가장 빠른 응답 시간(ms)을 구하는 예시입니다.

// {targetRepo}/stats.config.js
const firstResponseTime = pr => {
    const {timeline} = pr;
    const firstResponse = timeline.comments.find(comment => timeline.firstRequestedAt < comment.createdAt);
    const value = Number(firstResponse.createdAt) - Number(timeline.firstRequestedAt);

    return {value, message: `First Response Time: ${value}`};
};

module.exports = defaultStats => {
    return {
        ...defaultStats,
        pr: [...defaultStats.pr, ["firstResponseTime", firstResponseTime]],
    };
};

with 인자 설명

이름	설명	기본 값	사용 예시
token	GitHub에서 제공하는 토큰입니다.	${{ secrets.GITHUB_TOKEN }}	token: "xoxb-798572638592-435243279588-9aCaWNnzVYelK9NzMMqa1yxz"
repository	GitHub Action이 진행될 저장소입니다. 입력하지 않을 시, pr-stats.yml 파일을 만든 저장소에서 통계를 추출합니다.	${{ github.repository }}	repository: "organization/repository"
ignoreUsers	PR 통계에 포함하지 않을 사용자 목록입니다. 쉼표(,)로 여러 사용자를 등록할 수 있습니다.	"" (빈 문자열)	ignoreUsers: "brown" ignoreUsers: "sonarqube[bot],lee-load"
configPath	통계 설정 파일 경로입니다.	"./stats.config.js"	configPath: "./settings/stats.config.js"
period	PR 통계 대상 기간을 지정합니다. 입력하지 않을 경우, count를 따릅니다.	"" (빈 문자열)	period: "2023-09-01~2023-10-01" period: "2023-09-01~"
count	조회할 PR의 개수를 설정합니다. 입력하지 않은 경우, period를 따릅니다.	100	count: 50
baseBranch	작업의 기준이 되는 branch를 지정합니다. 입력하지 않으면 모든 branch에 대해 조회합니다.	"" (빈 문자열)	baseBranch: "main"
output	데이터 출력 방식을 지정합니다. 쉼표(,)로 여러 방식을 함께 사용할 수 있습니다. (유효한 형식: console, csv)	"console,csv"	output: "csv"

⚠️ period의 우선순위가 count보다 높습니다. period가 있을 경우, count는 무시됩니다.

활용 예시

이 액션을 활용하면 팀의 코드 리뷰 현황을 명확하게 파악하고 개선점을 찾아낼 수 있습니다.

1. 상관관계 테이블을 통한 분석

예를 들어, 파이썬 코드나 생성형 AI를 활용하여 PR 통계를 바탕으로 아래와 같은 상관관계 테이블을 생성할 수 있습니다.

만약 머지까지 걸리는 시간을 단축하고 싶다면 timeFromReviewToMerge과 상관계수가 높은 지표를 찾고, 해당 지표를 개선하는 노력을 해 볼 수 있을 것입니다.

2. 산점도를 통한 분석

코드 리뷰 문화 개선 활동을 수행한 후, 수치 변화를 통해 얼마나 개선되었는지 파악할 수 있습니다.

예를 들어, 팀원들의 리뷰 반응 속도와 참여율이 얼마나 개선되었는지 알아보기 위해, 다음과 같은 산점도와 밀도 차트를 활용할 수 있습니다.

좌측의 산점도에서 각 점은 리뷰어의 평균 응답 시간과 참여율을 나타냅니다. 이 점들이 좌상단에 가까울수록 참여율이 높고 응답 시간이 짧아, 더 나은 리뷰 문화를 의미합니다.

만약 개선 활동 이후 아래와 같은 차트로 변화했다면, 이는 개선 활동이 상당히 성공적이었음을 보여줍니다.

배포 라이선스

Copyright (c) 2023-present NAVER Corp.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.