Viewing workflow run history

You can view logs for each run of a workflow. Logs include the status for each job and step in a workflow.

Tool navigation

この記事の内容

これらのステップを実行するには、リポジトリへの読み取りアクセスが必要です。

  1. GitHub.com で、リポジトリのメイン ページへ移動します。

  2. リポジトリ名の下にある [アクション] をクリックします。

    "github/docs" リポジトリのタブのスクリーンショット。 [アクション] タブがオレンジ色の枠線で強調表示されています。

  3. 左サイドバーで、表示するワークフローをクリックします。

    [アクション] タブの左側のサイド バーのスクリーンショット。ワークフロー "CodeQL" が濃いオレンジ色の枠線で囲まれています。

  4. ワークフロー実行の一覧で実行の名前をクリックすると、ワークフロー実行の概要が表示されます。

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

Viewing recent workflow runs

To list the recent workflow runs, use the run list subcommand.

gh run list

To specify the maximum number of runs to return, you can use the -L or --limit flag . The default is 10.

gh run list --limit 5

To only return runs for the specified workflow, you can use the -w or --workflow flag. Replace workflow with either the workflow name, workflow ID, or workflow file name. For example, "Link Checker", 1234567, or "link-check-test.yml".

gh run list --workflow WORKFLOW

Viewing details for a specific workflow run

To display details for a specific workflow run, use the run view subcommand. Replace run-id with the ID of the run that you want to view. If you don't specify a run-id, GitHub CLI returns an interactive menu for you to choose a recent run.

gh run view RUN_ID

To include job steps in the output, use the -v or --verbose flag.

gh run view RUN_ID --verbose

To view details for a specific job in the run, use the -j or --job flag. Replace job-id with the ID of the job that you want to view.

gh run view --job JOB_ID

To view the full log for a job, use the --log flag.

gh run view --job JOB_ID --log

Use the --exit-status flag to exit with a non-zero status if the run failed. For example:

gh run view 0451 --exit-status && echo "run pending or passed"