조직에서 GitHub 코드 품질 결과 살펴보기

사전 요구 사항

• 조직이 엔터프라이즈에 속하는 경우, 엔터프라이즈 소유자는 Code Quality을(를) 조직에서 사용하도록 활성화해야 합니다. 엔터프라이즈에서 GitHub Code Quality 사용 허용을(를) 참조하세요.
• 조직에는 Code Quality가 활성화된 리포지토리가 있어야 합니다. GitHub Code Quality 사용을(를) 참조하세요.

조직에 대한 코드 품질 인사이트 보기

조직 수준 대시보드에는 다음 두 개의 탭이 있습니다.

• 상태 탭에는 조직의 현재 코드 상태에 대한 스냅샷이 표시됩니다.
• 추세 탭은 진행 상황을 추적하고 주의가 필요한 리포지토리를 식별할 수 있도록 선택한 기간 동안 열린 결과 변경 방법을 보여 줍니다.

1. GitHub에서 조직의 메인 페이지로 이동하십시오. 예를 들어, https://github.com/settings/organizations에서.
2. 조직 이름 아래에서 탭을 Security and quality 클릭합니다.
3. 사이드바의 "인사이트" 섹션에서 을 클릭합니다 코드 품질.

대시보드 데이터 필터링

대시보드 맨 위에 있는 필터 막대는 상태 및 추세 탭 모두에 적용됩니다. 다음을 기준으로 필터링할 수 있습니다.

• 안정성 점수
• 유지 관리 효율성 점수
• 표준 결과
• AI 결과
• 주제
• 팀
• 가시성
• 조직에 대해 정의된 모든 사용자 지정 속성

동일한 필터 막대에서 정렬 컨트롤을 사용하여 대시보드 데이터를 정렬할 수도 있습니다.

현재 코드 상태 보기

상태 탭에는 현재 조직의 코드 상태에 대한 스냅샷이 표시됩니다.

점수 분포 차트 해석

점수 분포 차트는 조직의 코드 상태에 대한 시각적 개요를 제공합니다. 각 거품은 유지 관리 가능성 및 안정성 점수가 동일한 리포지토리 컬렉션을 나타냅니다.

• 각 거품의 위치 는 해당 리포지토리의 전반적인 상태를 보여 줍니다. 거품이 높을수록 유지 관리 효율성 점수가 높고 오른쪽에 있는 거품은 높은 안정성 점수를 나타냅니다.
• 거품의 색 및 테두리 패턴 은 해당 리포지토리에 대한 낮은 점수의 심각도를 나타냅니다. 예를 들어, 두 범주 중 하나에서라도 "Poor" 점수를 받은 버블은 항상 빨간색 점선 테두리로 표시됩니다.
• 각 거품의 크기는 특정 점수 조합을 가진 리포지토리 수를 나타냅니다.

유지 관리 가능성 점수, 안정성 점수 및 특정 거품이 나타내는 리포지토리 수를 보려면 거품 위로 마우스를 가져다 니다.

리포지토리 테이블 탐색

거품형 차트 아래에는 조직의 모든 리포지토리를 나열하는 테이블이 있습니다. 여기에서 코드 품질 결과와 해당 결과에 대한 자세한 정보를 볼 수 있습니다.

열 머리글을 클릭하여 모든 열에 대한 오름차순 또는 내림차순으로 리포지토리 테이블을 정렬할 수 있습니다.

낮은 점수를 받은 리포지토리 조사

1. 성능이 가장 낮은 리포지토리에 대한 대시보드 데이터를 필터링하려면 점수 분포 차트에서 결합된 점수가 가장 낮은 거품을 클릭합니다.
2. 리포지토리 테이블까지 아래로 스크롤합니다. 기본적으로 테이블은 가장 최근의 리포지토리 검사에서부터 가장 오래된 검사 순으로 정렬되어 있으므로 현재 품질 문제의 우선 순위를 지정할 수 있습니다.
3. 필요에 따라 검색 결과 수가 가장 높은 리포지토리의 CodeQL 우선 순위를 지정하려면 두 번 클릭합니다 표준 결과 .
4. 특정 리포지토리에 대한 리포지토리 수준 대시보드를 보려면 리포지토리의 이름을 클릭합니다.

시간 경과에 따른 품질 추세 추적

추세 탭은 액세스 권한이 있고 현재 필터와 일치하는 리포지토리에서 열린 결과가 시간이 지남에 따라 어떻게 변경되었는지 보여 주므로 코드 품질 작업이 영향을 미치는지 여부와 다음에 주의해야 할 위치를 알 수 있습니다.

1. 조직 수준 대시보드에서 추세 탭을 클릭합니다.
2. 기간 드롭다운을 사용하여 지난 7일, 14일 또는 30일의 시간 범위를 선택합니다.
3. 선택한 기간 동안 적용 가능한 리포지토리에서 열려 있는 총 결과 수를 보여주는 "시간에 따른 결과 열기" 그래프를 검토합니다.
4. 필요에 따라 그래프 위의 단추를 사용하여 상태 점수 또는 심각도별로 데이터를 그룹 화합니다.
5. 그래프의 한 지점 위로 마우스를 가져가서 해당 날짜에 대한 열린 찾기 수를 확인합니다.

추세 데이터 이해

그래프를 해석할 때 다음 사항에 유의하세요.

• 그래프는 열린 결과의 일일 스냅샷을 기반으로 합니다. 지정된 날짜에 분석이 실행되지 않은 경우 해당 날짜에 대한 데이터 포인트가 없을 수 있습니다.

• 기록 데이터는 스냅샷을 만들기 시작한 시점 Code Quality 부터만 사용할 수 있으므로 사용 가능한 시간 범위는 처음에 제한될 수 있습니다.

• 그래프는 열려 있거나 수정되는 개별 결과가 아니라 열려 있는 결과의 총 수를 추적합니다. 개수의 변경이 반드시 개발자가 문제를 해결하거나 도입했음을 의미하지는 않습니다.

• 추가 리포지토리에서 Code Quality를 사용하도록 설정하면 그래프에 표시되는 탐지 건수가 증가할 수 있습니다. 새 리포지토리를 사용하도록 설정한 후 증가해도 반드시 코드 품질이 감소하는 것은 아닙니다.

• 그래프는 현재 필터링 중인 리포지토리에 대한 열려 있는 결과의 총 개수를 추적합니다. 총 개수에는 다음이 포함됩니다.

  • 새 리포지토리에서 코드 품질 분석을 사용하도록 설정하거나 코드 변경에 의해 도입된 새로운 결과
  • 코드에서 수정되었거나 사용자가 무시한 탐지 결과

주의가 필요한 리포지토리 식별

추세 그래프 아래에는 두 개의 테이블이 선택한 기간 동안 주의해야 하는 리포지토리를 식별하는 데 도움이 됩니다.

• 가장 개선된 리포지토리 는 선택한 기간 동안 열린 검색 결과가 가장 크게 감소한 리포지토리를 나열합니다.
• 개선이 필요한 리포지토리 는 선택한 기간 동안 열린 검색 결과가 가장 크게 증가한 리포지토리를 나열합니다.

두 테이블에는 다음 열이 포함됩니다.

• 리포지토리: 리포지토리의 이름입니다.
• 총 열기: 선택한 기간의 끝에 있는 리포지토리에 대한 열려 있는 결과 수입니다.
• 순변동: 선택한 기간 동안 리포지토리의 열린 발견 항목 수가 어떻게 변했는지를 나타냅니다.
• 해제됨: 선택한 기간 동안 리포지토리에 대해 해제된 결과 수입니다.

리포지토리에 대한 결과 수는 수정 및 해제되는 결과에 의해 영향을 받습니다. 리포지토리 수준 대시보드를 사용하여 변경된 내용을 확인할 수 있습니다.

리포지토리를 조사하려면 해당 이름을 클릭하여 리포지토리 수준 Code Quality 대시보드를 엽니다. 여기서 개별 결과를 검토하고 수정 작업을 수행할 수 있습니다.

다음 단계

리포지토리 수준 대시보드에서 사용할 수 있는 코드 상태 정보를 이해하려면 리포지토리에 대한 코드 품질 결과 해석을 참조하세요.

여러 리포지토리에서 사용하도록 설정 Code Quality 하려는 경우 대규모 GitHub Code Quality 롤아웃을 참조하세요.