ワークフロー実行ログの使用

注: GitHub ホステッドランナーは、現在 GitHub Enterprise Server でサポートされていません。 GitHub public roadmap で、今後の計画的なサポートの詳細を確認できます。

ワークフローの実行ページから、ワークフローの実行が進行中か完了しているかを確認できます。パブリックなリポジトリの分も含むワークフローの実行情報を見るには、GitHubのアカウントにログインしなければなりません。詳しくは、「GitHub 上のアクセス権限」を参照してください。

実行が完了している場合には、結果が成功か失敗か、キャンセルされたか、またはニュートラルかを確認できます。実行が失敗した場合には、ビルドログを表示して検索し、失敗の原因を診断してワークフローを再実行することもできます。また、課金対象のジョブ実行時間を表示したり、ログやビルドの成果物をダウンロードすることもできます。

GitHub Actionsは、Checks APIを使用してワークフローのステータス、結果、ログを出力します。 GitHub は、ワークフローの実行に対してそれぞれ新しいチェックスイートを作成します。チェックスイートには、ワークフロー内の各ジョブに対するチェック実行が含まれ、各ジョブにはステップが含まれています。 GitHub Actionsは、ワークフローのステップとして実行されます。 Checks API について詳しくは、「チェック」をご覧ください。

注: リポジトリには有効なワークフローファイルだけをコミットしてください。 .github/workflows に不正なワークフローファイルが含まれていると、GitHub Actions は新規のコミットのたびに失敗したワークフローの実行を生成します。

ログを表示してエラーを診断する

ワークフローの実行が失敗した場合には、どのステップが失敗の原因になったかを確認し、失敗したステップのビルドログを確かめてトラブルシューティングすることができます。各ステップの実行にかかった時間もわかります。ログファイルの特定の行のパーマリンクをコピーして、チームで共有することもできます。これらのステップを実行するには、リポジトリへの読み取りアクセスが必要です。

ワークフローファイルで設定されたステップに加えて、GitHub はジョブの実行をセットアップして完了するために、各ジョブに 2 つの追加ステップを追加します。これらのステップは、「Set up job」および「Complete job」として実行されるワークフローに記録されます。

GitHub ホステッドランナー上のジョブの実行の場合、"ジョブの設定" ではランナーイメージの詳細が記録され、ランナーマシン上にあったプレインストールされたツールのリストへのリンクが含まれます。

お使いの GitHub Enterprise Server インスタンスで、リポジトリのメインページへ移動します。
リポジトリ名の下にある [アクション] をクリックします。
左サイドバーで、表示するワークフローをクリックします。
ワークフロー実行の一覧で実行の名前をクリックすると、ワークフロー実行の概要が表示されます。
[ジョブ] の下、または視覚化グラフ内で、表示するジョブをクリックします。
失敗したステップは自動的に展開され、結果が表示されます。
あるいはログの中の特定の行へのリンクを取得するには、そのステップの行番号をクリックします。このリンクは、Webブラウザのアドレスバーからコピーできます。

ログを検索する

特定のステップのビルドログを検索できます。ログを検索する際、展開されているステップのみが結果に含まれます。これらのステップを実行するには、リポジトリへの読み取りアクセスが必要です。

お使いの GitHub Enterprise Server インスタンスで、リポジトリのメインページへ移動します。
リポジトリ名の下にある [アクション] をクリックします。
左サイドバーで、表示するワークフローをクリックします。
ワークフロー実行の一覧で実行の名前をクリックすると、ワークフロー実行の概要が表示されます。
[ジョブ] の下、または視覚化グラフ内で、表示するジョブをクリックします。
ログ出力の右上隅にある [ログの検索] 検索ボックスに、検索クエリを入力します。

ログのダウンロード

ワークフローの実行からは、ログファイルをダウンロードできます。また、ワークフローの成果物もダウンロードできます。詳しくは、「ワークフローデータを成果物として保存する」を参照してください。これらのステップを実行するには、リポジトリへの読み取りアクセスが必要です。

お使いの GitHub Enterprise Server インスタンスで、リポジトリのメインページへ移動します。
リポジトリ名の下にある [アクション] をクリックします。
左サイドバーで、表示するワークフローをクリックします。
ワークフロー実行の一覧で実行の名前をクリックすると、ワークフロー実行の概要が表示されます。
[ジョブ] の下、または視覚化グラフ内で、表示するジョブをクリックします。
ログの右上隅にあるドロップダウンメニューを選び、 [ログアーカイブのダウンロード] をクリックします。

注: 部分的に再実行されたワークフローのログアーカイブをダウンロードする場合、そのアーカイブに含まれるのは、再実行されたジョブのみです。ワークフローから実行されたジョブのログをすべて取得するには、他のジョブを前回実行しようとしたときのログアーカイブをダウンロードする必要があります。

ログの削除

ワークフローの実行からログファイルを削除できます。これらのステップを実行するには、リポジトリへの書き込みアクセスが必要です。

お使いの GitHub Enterprise Server インスタンスで、リポジトリのメインページへ移動します。
リポジトリ名の下にある [アクション] をクリックします。
左サイドバーで、表示するワークフローをクリックします。
ワークフロー実行の一覧で実行の名前をクリックすると、ワークフロー実行の概要が表示されます。
右上隅にあるドロップダウンメニューを選び、 [すべてのログの削除] をクリックします。
確認のプロンプトを確認します。

ログを削除すると、 [すべてのログを削除] ボタンが消えます。これは、ワークフローの実行にログファイルがこれ以上残っていないことを示しています。

GitHub CLI でログを表示する

GitHub CLI の詳細については、「GitHub CLI について」を参照してください。

特定のジョブのログを表示するには、run view サブコマンドを使います。 run-id を、ログを表示したい実行の ID に置き換えます。 GitHub CLI は、実行からジョブを選択するためのインタラクティブメニューを返します。 run-id を指定しない場合、GitHub CLI は、最近の実行を選ぶことができるインタラクティブメニューを返してから、その実行からジョブを選ぶことができる別のインタラクティブメニューを返します。

gh run view RUN_ID --log

また、--job フラグを使って、ジョブ ID を指定することもできます。 job-id を、ログを表示したいジョブの ID に置き換えます。

gh run view --job JOB_ID --log

grep を使うと、ログを検索できます。たとえば、このコマンドは、error という単語が含まれるすべてのログエントリを返します。

gh run view --job JOB_ID --log | grep error

失敗したステップのログをフィルター処理するには、--log の代わりに --log-failed を使います。

gh run view --job JOB_ID --log-failed