# 메트릭 및 등급 참조

리포지토리 코드의 품질을 평가하는 데 사용되는 GitHub 용어를 이해합니다.

> \[!NOTE]
> GitHub Code Quality은(는) 현재 공개 미리 보기에 있으며 변경될 수 있습니다.
> 공개 미리 보기에서 Code Quality은(는) 요금이 청구되지 않지만 Code Quality 스캔은 GitHub Actions 분을 소모합니다.

이 문서에서는 에서 사용하는 Code Quality메트릭 및 등급에 대한 정의를 제공합니다.

리포지토리의 규칙 기반 결과는 "<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-shield" aria-label="shield" role="img"><path d="M7.467.133a1.748 1.748 0 0 1 1.066 0l5.25 1.68A1.75 1.75 0 0 1 15 3.48V7c0 1.566-.32 3.182-1.303 4.682-.983 1.498-2.585 2.813-5.032 3.855a1.697 1.697 0 0 1-1.33 0c-2.447-1.042-4.049-2.357-5.032-3.855C1.32 10.182 1 8.566 1 7V3.48a1.75 1.75 0 0 1 1.217-1.667Zm.61 1.429a.25.25 0 0 0-.153 0l-5.25 1.68a.25.25 0 0 0-.174.238V7c0 1.358.275 2.666 1.057 3.86.784 1.194 2.121 2.34 4.366 3.297a.196.196 0 0 0 .154 0c2.245-.956 3.582-2.104 4.366-3.298C13.225 9.666 13.5 8.36 13.5 7V3.48a.251.251 0 0 0-.174-.237l-5.25-1.68ZM8.75 4.75v3a.75.75 0 0 1-1.5 0v-3a.75.75 0 0 1 1.5 0ZM9 10.5a1 1 0 1 1-2 0 1 1 0 0 1 2 0Z"></path></svg> Security and quality" 아래의 **표준 결과** 탭의 **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-code-review" aria-label="code review" role="img"><path d="M1.75 1h12.5c.966 0 1.75.784 1.75 1.75v8.5A1.75 1.75 0 0 1 14.25 13H8.061l-2.574 2.573A1.458 1.458 0 0 1 3 14.543V13H1.75A1.75 1.75 0 0 1 0 11.25v-8.5C0 1.784.784 1 1.75 1ZM1.5 2.75v8.5c0 .138.112.25.25.25h2a.75.75 0 0 1 .75.75v2.19l2.72-2.72a.749.749 0 0 1 .53-.22h6.5a.25.25 0 0 0 .25-.25v-8.5a.25.25 0 0 0-.25-.25H1.75a.25.25 0 0 0-.25.25Zm5.28 1.72a.75.75 0 0 1 0 1.06L5.31 7l1.47 1.47a.751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018l-2-2a.75.75 0 0 1 0-1.06l2-2a.75.75 0 0 1 1.06 0Zm2.44 0a.75.75 0 0 1 1.06 0l2 2a.75.75 0 0 1 0 1.06l-2 2a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042L10.69 7 9.22 5.53a.75.75 0 0 1 0-1.06Z"></path></svg> 코드 품질** 탭에서 볼 수 있습니다.

## 메트릭 정의

다음 표에서는 리포지토리에 대해 보고되는 각 메트릭에 대한 정의를 제공합니다.

| Metric          | Definition                                                                                                              | 예제 결과                                                                    |
| --------------- | ----------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| **Reliability** | 코드가 의도한 함수를 올바르게, 예측 가능하게, 일관되게 수행하는지 평가합니다. 신뢰할 수 있는 코드는 버그로부터 자유롭고, 오류를 안전하게 처리하며, 정상 및 에지 케이스 조건에서 예상대로 작동합니다.       | 성능, 동시성, 오류 처리, 정확성, API 디자인, 접근성, 국제화 또는 보안 관련 문제                       |
| **유지 관리**       | 시간이 지남에 따라 코드를 이해하고 수정하고 확장하는 것이 얼마나 쉬운지 평가합니다. 유지 관리 가능한 코드는 모범 사례를 따르고, 불필요한 복잡성을 방지하며, 향후 변경 및 공동 작업의 용이성을 위해 구성됩니다. | 모범 사례를 사용하지 않음, 사장된/사용되지 않는 코드, 중복 코드, 복잡성 문제, 논리적 중복성, 불충분한 문서화, 종속성 문제 |

## 심각도 수준

심각도 수준은 코드 품질 발견의 잠재적 영향 또는 긴급성을 나타내는 데 사용됩니다. 사용자가 수정 작업의 우선 순위를 지정하고 관련자에게 위험을 전달하는 데 도움이 됩니다. 심각도는 문제를 감지한 규칙에 따라, CodeQL 등의 관례와 업계 표준을 준수하여 결정됩니다.

\| 심각도
\| Definition         |
\|-----------|--------------------|
\| **Error** | 버그, 오류 또는 주요 유지 관리 위험의 원인이 될 가능성이 높은 심각도 문제를 나타냅니다. |
\| **경고** | 코드 품질 또는 안정성에 영향을 미칠 수 있지만 즉시 중요하지는 않은 보통 심각도 문제를 나타냅니다. |
\| **참고** | 심각도가 낮은 문제, 사소한 개선 또는 권장 사항을 나타냅니다. 이러한 결과는 지속적인 코드 상태 및 유지 관리에 유용합니다. |

## 등급 정의

이러한 등급은 기본 분기에서 CodeQL 검사가 검출한 규칙 기반 결과의 심각도에 따라 리포지토리의 전반적인 신뢰도 및 유지 관리 가능성을 요약하는 데 사용됩니다.

| Rating    | Definition                                        | 조건(결과 기반)             |
| --------- | ------------------------------------------------- | --------------------- |
| **우수**    | 코드베이스는 안정성 및 유지 관리에 대한 모범 사례를 보여 줍니다.             | 코드 품질 문제가 발견되지 않음     |
| **좋은**    | 코드베이스에 심각도가 낮은 문제가 있거나 사소한 개선 사항이 제안됩니다.          | ≥1 "Note" 수준의 결과      |
| **보통**    | 코드베이스에는 품질에 영향을 미칠 수 있지만 중요하지 않은 보통 심각도 문제가 있습니다. | ≥1 "경고" 수준 찾기         |
| **개선 필요** | 코드베이스에는 버그 또는 주요 유지 관리 위험 등 심각도가 높은 문제가 있습니다.     | "오류 수준의 결과가 1개 이상 있음" |

## 추가 읽기

* [GitHub 코드 품질 정보](/ko/code-security/code-quality/concepts/about-code-quality)
* [리포지토리에 대한 코드 품질 결과 해석](/ko/code-security/code-quality/how-tos/interpret-results)