# デバッグ ログを有効にする

ワークフロージョブあるいはステップが期待どおりに動作しない理由を診断する上で、十分な詳細がワークフローのログになかった場合、追加のデバッグロギングを有効化できます。

> \[!NOTE]
> GitHub Enterprise Server ホステッド ランナーは、現在 GitHub ではサポートされていません。

これらの追加ログは、ワークフローを含むリポジトリにシークレットまたは変数を設定することで有効になるため、同じアクセス許可の要件が適用されます。

* GitHub で組織リポジトリのシークレットまたは変数を作成するには、`write` のアクセス権が必要です。 個人アカウントのリポジトリについては、リポジトリコラボレーターである必要があります。
* 個人用アカウントのリポジトリ内の環境でシークレットか変数を作成するユーザーは、そのリポジトリのオーナーである必要があります。 組織用リポジトリ内の環境用にシークレットか変数を作成するユーザーには、`admin` のアクセス権が必要です。 環境の詳細については、「[デプロイメント用の環境管理](/ja/enterprise-server@3.22/actions/how-tos/deploy/configure-and-manage-deployments/manage-environments)」を参照してください。
* 組織の所有者 および "組織のアクション変数の管理" または "組織のアクション シークレットの管理" アクセス許可を持つユーザーは 組織レベルでシークレットまたは変数を作成できます。

詳細については、 [AUTOTITLE を](/ja/enterprise-server@3.22/organizations/managing-peoples-access-to-your-organization-with-roles/permissions-of-custom-organization-roles)参照してください。

シークレットと変数の設定の詳細については、「[GitHub Actions でのシークレットの使用](/ja/enterprise-server@3.22/actions/how-tos/write-workflows/choose-what-workflows-do/use-secrets)」および「[変数に情報を格納する](/ja/enterprise-server@3.22/actions/how-tos/write-workflows/choose-what-workflows-do/use-variables)」を参照してください。

さらに、ワークフローを実行するアクセス権を持つすべてのユーザーが、ランナー診断ログとステップ デバッグ ログを有効にして、ワークフローを再実行できます。 詳しくは、「[ワークフローとジョブの再実行](/ja/enterprise-server@3.22/actions/how-tos/manage-workflow-runs/re-run-workflows-and-jobs)」をご覧ください。

## ランナーの診断ロギングの有効化

ランナーの診断ログは、ランナーによるジョブの実行の様子に関する情報を含む追加のログファイルを提供します。 ログアーカイブには、2つのログファイルが追加されます。

* ランナープロセスログにはジョブの実行のためのランナーの調整とセットアップに関する情報が含まれます。
* ワーカープロセスログには、ジョブの実行が記録されます。

1. ランナー診断ログを有効にするには、ワークフローを含むリポジトリで、シークレットまたは変数 `ACTIONS_RUNNER_DEBUG` を `true` に設定します。 シークレットと変数の両方が設定されている場合、シークレットの値が変数よりも優先されます。
2. ランナーの診断ログをダウンロードするには、ワークフローの実行のログアーカイブをダウンロードしてください。 ランナーの診断ログは `runner-diagnostic-logs` フォルダーにあります。 ログのダウンロードについて詳しくは、「[ワークフロー実行ログの使用](/ja/enterprise-server@3.22/actions/how-tos/monitor-workflows/use-workflow-run-logs#downloading-logs)」を参照してください。

## ステップのデバッグロギングの有効化

ステップデバッグロギングは、ジョブの実行の間と実行後のジョブのログの詳細度を高めます。

1. ステップデバッグログを有効にするには、ワークフローを含むリポジトリで、シークレットまたは変数 `ACTIONS_STEP_DEBUG` を `true` に設定します。 シークレットと変数の両方が設定されている場合、シークレットの値が変数よりも優先されます。
2. シークレットまたは変数を設定すると、ステップ ログにさらに多くのデバッグ イベントが表示されます。 詳しくは、「[ワークフロー実行ログの使用](/ja/enterprise-server@3.22/actions/how-tos/monitor-workflows/use-workflow-run-logs#viewing-logs-to-diagnose-failures)」をご覧ください。

また、デバッグ ログが有効な場合にのみ、 `runner.debug` コンテキストを使用してステップを条件付きで実行することもできます。 詳しくは、「[コンテキスト リファレンス](/ja/enterprise-server@3.22/actions/reference/workflows-and-actions/contexts#runner-context)」をご覧ください。