Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.

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

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

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

  • 個人用アカウント リポジトリのシークレットまたは変数を作成するには、リポジトリ所有者である必要があります。 Organization リポジトリのシークレットまたは変数を作成するには、admin アクセス権が必要です。
  • 個人用アカウント リポジトリ内の環境に対してシークレットまたは変数を作成するには、リポジトリ所有者である必要があります。 Organization リポジトリ内の環境に対してシークレットまたは変数を作成するには、admin アクセス権が必要です。
  • 組織レベルでシークレットまたは変数を作成するには、admin アクセス権が必要です。

シークレットと変数の設定について詳しくは、「暗号化されたシークレット」と「変数」を参照してください。

さらに、ワークフローを実行するアクセス権を持つすべてのユーザーが、ランナー診断ログとステップ デバッグ ログを有効にして、ワークフローを再実行できます。 詳しくは、「ワークフローとジョブの再実行」をご覧ください。

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

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

  • ランナープロセスログにはジョブの実行のためのランナーの調整とセットアップに関する情報が含まれます。
  • ワーカープロセスログには、ジョブの実行が記録されます。
  1. ランナー診断ログを有効にするには、ワークフローを含むリポジトリで、次のシークレットまたは変数を設定します: ACTIONS_RUNNER_DEBUGtrue に。シークレットと変数の両方が設定されている場合は、シークレットの値が変数よりも優先されます。
  2. ランナーの診断ログをダウンロードするには、ワークフローの実行のログアーカイブをダウンロードしてください。 ランナーの診断ログは runner-diagnostic-logs フォルダーにあります。 ログのダウンロードについて詳しくは、「ログのダウンロード」をご覧ください。

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

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

  1. ステップ デバッグ ログを有効にするには、ワークフローを含むリポジトリで、次のシークレットまたは変数を設定します: ACTIONS_STEP_DEBUGtrue に。シークレットと変数の両方が設定されている場合は、シークレットの値が変数よりも優先されます。
  2. シークレットまたは変数を設定すると、さらに多くのデバッグ イベントがステップ ログに表示されます。 詳しくは、「ログを表示してエラーを診断する」をご覧ください。