# 메트릭 및 점수 참조

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

이 문서에서는 에서 사용하는 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" 아래의 \*\*\*\* 탭의 표준 결과 탭에서 볼 수 있습니다.

## 메트릭 정의

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

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

## 심각도 수준

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

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

## 점수 정의

이러한 점수는 전체 기본 브랜치를 CodeQL 검사하여 발견된 규칙 기반 결과의 심각도에 따라 리포지토리의 전반적인 신뢰성 및 유지보수성을 요약하는 데 사용됩니다:

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

## 코드 커버리지

Code Quality가 코드 커버리지를 측정하고 보고하는 방법에 대한 자세한 내용은 [코드 커버리지 참조](/ko/enterprise-cloud@latest/code-security/reference/code-quality/code-coverage)을 참조하세요.

## 추가 읽기

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