# 도구 상태 페이지 정보

도구 상태 페이지는 리포지토리의 code scanning 도구 상태 및 성능에 대한 가시성을 제공합니다.

> \[!NOTE]
> 이 기능을 사용하려면 사이트 관리자가 먼저 code scanning을(를) 사용하도록 설정해야 합니다. 자세한 내용은 [어플라이언스에 대한 코드 검사 구성](/ko/enterprise-server@3.22/code-security/how-tos/secure-at-scale/configure-enterprise-security/configure-specific-tools/configuring-code-scanning-for-your-appliance)을(를) 참조하세요.
>
> 엔터프라이즈 소유자가 엔터프라이즈 수준에서 code scanning 정책을 설정한 경우 GitHub Code Security을(를) 활성화하거나 비활성화하지 못할 수 있습니다. 자세한 내용은 [엔터프라이즈에 대한 코드 보안 및 분석을 위한 정책 적용](/ko/enterprise-server@3.22/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-code-security-and-analysis-for-your-enterprise)을(를) 참조하세요.

## 도구 상태 페이지란 무엇입니까?

모든 도구 상태 페이지 도구에 대한 code scanning 정보를 표시하며 예상대로 작동하지 않을 때 code scanning 문제를 디버깅하기 위한 좋은 시작점입니다.

> \[!NOTE]
> 도구 상태 페이지는 조직 수준이 아니라 기본 분기에 대해서만 리포지토리 수준에서 도구 상태를 표시합니다.

## 도구 상태 표시기

세 도구 상태 페이지 가지 상태 중 하나가 표시됩니다.

* **모든 구성이 작동합니다.** 모든 도구가 예상대로 작동합니다.
* **일부 구성에는 주의가 필요합니다.** 일부 도구에는 경고 또는 중요하지 않은 문제가 있습니다.
* **일부 구성이 작동하지 않음**: 하나 이상의 도구에 심각한 오류가 있음

## 사용할 수 있는 정보

### 모든 code scanning 도구의 경우

* 구성 상태 및 상태 진단
* 스캔 일정
* 첫 번째 및 가장 최근 검사 시간
* 검사에 사용되는 규칙

### 다음과 같은 통합 도구의 경우 CodeQL

위에 나열된 정보 외에도 통합 도구는 도구 상태 페이지 다음 세부 정보를 제공합니다.

* 프로그래밍 언어별 파일 검사 백분율
* 각 설치 유형에 대한 구성 세부 정보
* 특정 오류 메시지
* 분석된 파일의 다운로드 가능한 CSV 보고서
* 사용된 규칙 및 경고 수의 다운로드 가능한 목록

## 스캔한 파일을 정의하는 방법 CodeQL

CodeQL 는 해당 파일의 일부 코드 줄이 처리되었는지 검사한 대로 파일을 보고합니다.

### 해석된 언어

* **기본 설정**: 검색된 파일에는 분석할 수 있는 언어에 대한 모든 소스 코드 파일이 포함됩니다.CodeQL
* **고급 설정**: `paths` 및 `paths-ignore`를 사용하여 스캔할 파일을 정의할 수 있습니다.
  [CodeQL을 사용하여 코드 검색](/ko/enterprise-server@3.22/code-security/concepts/code-scanning/codeql/codeql-code-scanning)을(를) 참조하세요.

### 컴파일된 언어

도구 상태 페이지 자동 빌드 또는 수동 빌드 단계를 실행하기 전에 표시되는 보고서 파일입니다. 빌드 프로세스 중에 생성된 파일은 표시되지 않습니다.
[컴파일된 언어에 CodeQL 코드 스캐닝](/ko/enterprise-server@3.22/code-security/how-tos/find-and-fix-code-vulnerabilities/manage-your-configuration/codeql-for-compiled-languages#use-autobuild-for-codeql)을(를) 참조하세요.

### 적용 범위 계산

파일 커버리지 비율은 `paths` 및 `paths-ignore` 구성 속성에 의해 제외된 파일을 고려합니다.

## 파일 커버리지 비율 이해

파일 검사 백분율을 사용하여 분석을 디버그하고 개선합니다.

* **높은 비율**: Code scanning 해당 언어에 대해 예상대로 작동합니다.
* **낮은 비율**: 진단 출력을 조사합니다.
  [CodeQL이 예상보다 적은 줄을 스캔했습니다.](/ko/enterprise-server@3.22/code-security/reference/code-scanning/troubleshoot-analysis-errors/fewer-lines-scanned-than-expected)을(를) 참조하세요.
* **백분율 0**: 현재 분석되지 않는 언어의 코드가 있을 수 있습니다. 이러한 언어를 포함하도록 설정을 업데이트합니다.
  [코드 검색을 위한 워크플로 구성 옵션](/ko/enterprise-server@3.22/code-security/reference/code-scanning/workflow-configuration-options)을(를) 참조하세요.

> \[!NOTE]
> 고급 설정과 기본 설정을 모두 설정한 경우 기본 설정 도구 상태 페이지 만 표시됩니다.

## 문제 해결 기능

도구 상태 페이지은(는) 다음을 통해 문제 해결에 도움이 됩니다.

* **오류 메시지**: 제안된 작업에서 도구가 예상대로 작동하지 않는 이유를 설명합니다.
* **파일 검사 데이터**: 분석 중인 파일 및 언어 표시
* **구성 세부 정보**: 각 분석 실행에 대한 정보를 표시합니다.
* **다운로드 가능한 보고서**: CSV 보고서에 자세한 파일 및 규칙 정보 제공

## 추가 읽기

* [코드 검색에 도구 상태 페이지 사용](/ko/enterprise-server@3.22/code-security/how-tos/find-and-fix-code-vulnerabilities/manage-your-configuration/use-the-tools-status-page-for-code-scanning)