ワークフロー実行ログを使用する

GitHub Actions の支払いを管理する GitHubは、macOSランナーのホストにMacStadiumを使用しています。

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

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

GitHub Actionsは、Checks APIを使用してワークフローのステータス、結果、ログを出力します。 GitHub は、ワークフローの実行に対してそれぞれ新しいチェックスイートを作成します。 チェックスイートには、ワークフロー内の各ジョブに対するチェック実行が含まれ、各ジョブにはステップが含まれています。 GitHub Actionsは、ワークフローのステップとして実行されます。 For more information about the Checks API, see "Checks."

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

ワークフローの実行を失敗した場合には、どのステップが失敗の原因になったかを確認し、失敗したステップのビルドログを確かめてトラブルシューティングすることができます。 各ステップの実行にかかった時間もわかります。 ログファイルの特定の行のパーマリンクをコピーして、チームで共有することもできます。 Read access to the repository is required to perform these steps.

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

GitHubホストランナー上のジョブの実行では、"Set up job"はランナーの仮想環境の詳細を記録し、ランナーマシン上にあったプリインストールされたツールのリストへのリンクを含みます。

1. GitHubで、リポジトリのメインページにアクセスしてください。

2. リポジトリ名の下でActions（アクション）をクリックしてください。

   

3. 左のサイドバーで、表示させたいワークフローをクリックしてください。

   

4. From the list of workflow runs, click the name of the run you want to see.

   

5. Under Jobs or in the visualization graph, click the job you want to see.

   

6. Any failed steps are automatically expanded to display the results.

   

7. あるいはログの中の特定の行へのリンクを取得するには、そのステップの行番号をクリックします。 You can then copy the link from the address bar of your web browser.

   

ログを検索する

特定のステップのビルドログを検索できます。 ログを検索する際、展開されているステップのみが結果に含まれます。 Read access to the repository is required to perform these steps.

1. GitHubで、リポジトリのメインページにアクセスしてください。

2. リポジトリ名の下でActions（アクション）をクリックしてください。

   

3. 左のサイドバーで、表示させたいワークフローをクリックしてください。

   

4. From the list of workflow runs, click the name of the run you want to see.

   

5. Under Jobs or in the visualization graph, click the job you want to see.

   

6. ログ出力の右上隅にある [Search logs] 検索ボックスに、検索語句を入力します。

   

ログのダウンロード

ワークフローの実行からは、ログファイルをダウンロードできます。 また、ワークフローの成果物もダウンロードできます。 詳しい情報については「成果物を利用してワークフローのデータを永続化する」を参照してください。 Read access to the repository is required to perform these steps.

1. GitHubで、リポジトリのメインページにアクセスしてください。

2. リポジトリ名の下でActions（アクション）をクリックしてください。

   

3. 左のサイドバーで、表示させたいワークフローをクリックしてください。

   

4. From the list of workflow runs, click the name of the run you want to see.

   

5. Under Jobs or in the visualization graph, click the job you want to see.

   

6. 右上隅にある and select Download log archive.

   

ログの削除

ワークフローの実行からログファイルを削除できます。 Write access to the repository is required to perform these steps.

1. GitHubで、リポジトリのメインページにアクセスしてください。

2. リポジトリ名の下でActions（アクション）をクリックしてください。

   

3. 左のサイドバーで、表示させたいワークフローをクリックしてください。

   

4. From the list of workflow runs, click the name of the run you want to see.

   

5. 右上隅にある .

   

6. ログファイルを削除するには、Delete all logs（すべてのログを削除）ボタンをクリックして、確認の要求を見てください 。

   

After deleting logs, the Delete all logs button is removed to indicate that no log files remain in the workflow run.