# ツールの状態ページについて

ツールの状態ページ は、使用中リポジトリ内にある code scanning ツールの正常性とパフォーマンスを可視化します。

## ツールの状態ページ とは

ツールの状態ページ には、使用している code scanning ツールすべての情報が表示されます。code scanning が期待どおりに動作しない場合、このページは問題のデバッグを開始するのに適したポイントとなります。

> \[!NOTE]
> ツールの状態ページ には、組織レベルではなく、既定のブランチのリポジトリ レベルでのみツールの状態が表示されます。

## ツールの状態インジケーター

ツールの状態ページ には、次の 3 つの状態のいずれかが表示されます。

* **すべての構成が機能しています**:すべてのツールが想定どおりに動作しています
* **一部の構成には注意が必要**です。一部のツールには警告や重大でない問題があります
* **一部の構成が機能しない**: 1 つ以上のツールに重大なエラーがある

## 利用可能な情報

### すべての code scanning ツールに対して

* 構成状態と健康状態
* スキャン のスケジュール設定
* 最初と最新のスキャン時間
* スキャンで使用されるルール

### CodeQL などの統合ツールの場合

上記の情報に加えて、統合ツールの ツールの状態ページ には、次の詳細が記載されています。

* プログラミング言語別のファイル カバレッジの割合
* 各セットアップの種類の構成の詳細
* 特定のエラー メッセージ
* 分析されたファイルのダウンロード可能な CSV レポート
* 使用されるルールとアラートの数のダウンロード可能なリスト

## スキャンされるファイルを CodeQL で定義する方法

CodeQL は、そのファイル内のコード行が処理された場合に、ファイルをスキャン済みとして報告します。

### 解釈された言語

* **既定のセットアップ**: スキャンされたファイルには、言語 CodeQL が分析できるすべてのソース コード ファイルが含まれます
* **詳細設定**: `paths` と `paths-ignore` を使用して、スキャンするファイルを定義できます。 「[CodeQL によるコード スキャンについて](/ja/code-security/code-scanning/introduction-to-code-scanning/about-code-scanning-with-codeql)」を参照してください。

### コンパイル済み言語

ツールの状態ページ は、自動ビルドまたは手動ビルドステップを実行する前に存在するファイルを報告します。 ビルド プロセス中に生成されたファイルは表示されません。 「[コンパイル済み言語の CodeQL コード スキャン](/ja/code-security/code-scanning/creating-an-advanced-setup-for-code-scanning/codeql-code-scanning-for-compiled-languages#about-autobuild-for-codeql)」を参照してください。

### カバレッジの計算

ファイル カバレッジの割合は、 `paths` および `paths-ignore` 構成プロパティによって除外されるすべてのファイルを考慮します。

## ファイル カバレッジ パーセンテージについて

ファイル カバレッジの割合を使用して、分析をデバッグして改善します。

* **\[High percentage (高い割合)]**: Code scanning は、その言語で期待どおりに動作しています
* **低い割合**: 診断出力を確認します。 「[CodeQL によってスキャンされた行が予想よりも少ない](/ja/code-security/code-scanning/troubleshooting-code-scanning/codeql-scanned-fewer-lines-than-expected)」を参照してください
* **ゼロパーセンテージ**: 現在分析されていない言語のコードがある可能性があります。 これらの言語を含むようにセットアップを更新します。 「[コード スキャンのワークフロー構成オプション](/ja/code-security/code-scanning/creating-an-advanced-setup-for-code-scanning/customizing-your-advanced-setup-for-code-scanning#changing-the-languages-that-are-analyzed)」を参照してください

> \[!NOTE]
> 詳細設定と既定のセットアップの両方を設定した場合、ツールの状態ページ には既定のセットアップのみが表示されます。

## トラブルシューティング機能

ツールの状態ページ は、次の方法で問題のトラブルシューティングを行うのに役立ちます。

* **エラー メッセージ**: 推奨されるアクションでツールが期待どおりに動作しない理由について説明します
* **ファイル カバレッジ データ**: 分析対象のファイルと言語を示します
* **構成の詳細**: 各分析実行に関する情報を表示します
* **ダウンロード可能なレポート**: CSV レポートに詳細なファイルとルールの情報を提供します

## 詳細については、次を参照してください。

* [コード スキャンにツールの状態ページを使用する](/ja/code-security/how-tos/scan-code-for-vulnerabilities/manage-your-configuration/use-the-tools-status-page-for-code-scanning)