{"meta":{"title":"ログの詳細が十分ではありません","intro":"ログの詳細度を高め、ログに診断の詳細がない場合はデバッグ成果物を生成します。","product":"セキュリティとコードの品質","breadcrumbs":[{"href":"/ja/code-security","title":"セキュリティとコードの品質"},{"href":"/ja/code-security/reference","title":"リファレンス"},{"href":"/ja/code-security/reference/code-scanning","title":"コード スキャン"},{"href":"/ja/code-security/reference/code-scanning/troubleshoot-analysis-errors","title":"分析エラーのトラブルシューティング"},{"href":"/ja/code-security/reference/code-scanning/troubleshoot-analysis-errors/logs-not-detailed-enough","title":"詳細が十分ではないログ"}],"documentType":"article"},"body":"# ログの詳細が十分ではありません\n\nログの詳細度を高め、ログに診断の詳細がない場合はデバッグ成果物を生成します。\n\n問題のトラブルシューティングに十分な詳細がログにない場合は、追加の情報を取得し、ログをより便利にするために実行できるいくつかの手順があります。\n\n## ステップのデバッグロギングの有効化\n\nステップ デバッグ ログを使用すると、実行中と実行後にジョブのログの詳細度が向上します。\n\nステップ デバッグ ログを有効にするには:\n\n1. ワークフローを含むリポジトリで、次のシークレットまたは変数を設定します。 `ACTIONS_STEP_DEBUG` を `true` に設定します。 シークレットと変数の両方が設定されている場合、シークレットの値が変数よりも優先されます。\n2. ワークフローを再実行するか、新しい実行をトリガーします。\n\nシークレットまたは変数を設定すると、ステップ ログにさらに多くのデバッグ イベントが表示されます。 「[ワークフロー実行ログの使用](/ja/actions/monitoring-and-troubleshooting-workflows/using-workflow-run-logs#viewing-logs-to-diagnose-failures)」を参照してください。\n\nまた、デバッグ ログが有効な場合にのみ、 `runner.debug` コンテキストを使用してステップを条件付きで実行することもできます。 「[コンテキスト リファレンス](/ja/actions/reference/workflows-and-actions/contexts#runner-context)」を参照してください。\n\n## CodeQL デバッグ成果物の作成\n\n> \\[!WARNING]\n> CodeQL デバッグ成果物は、CodeQL によって分析されるソース コードのコピーを保持しているため、これらのバンドルは、そのソース コードへのアクセスが許可されているユーザーとのみ共有することをお勧めします。\n\nCodeQL のデバッグに役立つ成果物を取得できます。\nデバッグ 成果物は、名前が `debug-artifacts` で始まる成果物としてワークフロー実行にアップロードされます。 CodeQL がワークフロー実行の一部として複数の言語を同時に分析する場合、言語ごとにこのような成果物が 1 つ存在します。 データには、CodeQL ログ、CodeQL データベース、抽出されたソース コード ファイル、およびワークフローによって生成されたすべての SARIF ファイルが含まれます。 CodeQL 成果物のダウンロードの詳細については、「[ワークフローの成果物をダウンロードする](/ja/actions/managing-workflow-runs/downloading-workflow-artifacts)」を参照してください。\n\nこれらの成果物は、CodeQL code scanningに関する問題をデバッグするのに役立ちます。 GitHub のサポート にお問い合わせの場合、このデータを要求される場合があります。\n\n### CodeQL の既定のセットアップに対応する、CodeQL デバッグ成果物の作成\n\nCodeQL デバッグ成果物を作成するには、ステップデバッグロギングを有効にして（[ステップデバッグロギングの有効化を参照](#enabling-step-debug-logging)）、新しい CodeQL 分析をトリガーします。たとえば、新しいコミットをプルリクエストブランチにプッシュします。\n\nこれらの手順に従ってください:\n\nプライベートレジストリにCodeQL アクセス権を付与した場合、名前が `proxy-log-file` で始まる追加の成果物が利用可能になります。 これには、CodeQL の既定のセットアップでプライベート レジストリへの要求を認証するために使用される認証プロキシのログが含まれており、プライベート レジストリ構成のトラブルシューティングに使用できます。 詳細については、「[セキュリティ機能にプライベート レジストリへのアクセスを許可する](/ja/code-security/how-tos/secure-at-scale/configure-organization-security/manage-usage-and-access/giving-org-access-private-registries)」を参照してください。\n\n### CodeQL の詳細セットアップに対応する、CodeQL デバッグ成果物の作成\n\nCodeQL の詳細セットアップに対応するデバッグ成果物は、数種類の方法で取得できます。\n\n#### デバッグ ログを有効にしてジョブを再実行する\n\nCodeQL の詳細設定のデバッグ成果物を作成する最も簡単なオプションは、デバッグ ログを有効にしてジョブを再実行することです。 GitHub Actions のワークフローとジョブの再実行について詳しくは、「[ワークフローとジョブの再実行](/ja/actions/managing-workflow-runs/re-running-workflows-and-jobs)」を参照してください。\n\n必ず **\\[デバッグ ログの有効化]** を選ぶ必要があります。 このオプションにより、実行でランナー診断ログとステップ デバッグ ログが有効になります。 次に、CodeQLのデバッグ用ファイルをダウンロードでき、そのファイルを使ってさらに調査を進めることができます。 ジョブを再実行して CodeQL デバッグ成果物を作成するときに、ワークフロー ファイルを変更する必要はありません。\n\n#### ワークフロー フラグの使用\n\nワークフローでフラグを使用して CodeQL デバッグ成果物を作成できます。 このためには、CodeQL 分析ワークフロー ファイルの `init` ステップを変更して `debug: true` を設定する必要があります。\n\n```yaml\n- name: Initialize CodeQL\n  uses: github/codeql-action/init@v4\n  with:\n    debug: true\n```\n\n#### GitHub Actions ステップ デバッグ ログを使用\n\nGitHub Actions ステップ デバッグ ログを有効にした場合、CodeQL はまたデバッグ成果物を生成し、それらをワークフロー実行の一部としてアップロードします。 手順については、「 [ステップ デバッグ ログの有効化」を](#enabling-step-debug-logging)参照してください。"}