Skip to main content
ドキュメントには� �繁に更新が� えられ、その都度公開されています。本ページの翻訳はま� 未完成な部分があることをご了承く� さい。最新の情� �については、英語のドキュメンテーションをご参照く� さい。本ページの翻訳に問題がある� �合はこちらまでご連絡く� さい。

このバージョンの GitHub Enterprise はこの日付をもって終了となりました: 2022-06-03. 重大なセキュリティの問題に対してであっても、パッチリリースは作成されません。 パフォーマンスの向上、セキュリティの改善、新機能のためには、最新バージョンのGitHub Enterpriseにアップグレードしてく� さい。 アップグレードに関する支援については、GitHub Enterprise supportに連絡してく� さい。

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

ワークフロー実行の各ジョブのログを表示、検索、およびダウンロードできます。

ノート: GitHubホストランナーは、現在GitHub Enterprise Serverでサポートされていません。 GitHubパブリックロードマップで、計画されている将来のサポートに関する詳しい情� �を見ることができます。

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

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

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

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

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

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

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

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

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

  2. Under your repository name, click Actions. メインのリポジトリナビゲーション内のアクションタブ

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

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

    ワークフローの実行の名前

  5. [Jobs] または視覚化グラフで、表示するジョブをクリックします。

    Lint コードベースジョブ

  6. 失敗したステップは自動的に展開され、結果が表示されます。

    Super linterワークフローの結果

  7. あるいはログの中の特定の行へのリンクを取得するには、そのステップの行番号をクリックします。 このリンクは、Webブラウザのアドレスバーからコピーできます。

    リンクをコピーするボタン

ログを検索する

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

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

  2. Under your repository name, click Actions. メインのリポジトリナビゲーション内のアクションタブ

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

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

    ワークフローの実行の名前

  5. [Jobs] または視覚化グラフで、表示するジョブをクリックします。

    Lint コードベースジョブ

  6. ログ出力の右上隅にある [Search logs(ログの検索)] 検索ボックスに、検索クエリを入力します。 ログを検索するための検索ボックス

ログのダウンロード

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

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

  2. Under your repository name, click Actions. メインのリポジトリナビゲーション内のアクションタブ

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

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

    ワークフローの実行の名前

  5. [Jobs] または視覚化グラフで、表示するジョブをクリックします。

    Lint コードベースジョブ

  6. 右上隅にある をクリックし、[Download log archive] を選択します。

    [Download logs] ドロップダウンメニュー

ログの削除

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

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

  2. Under your repository name, click Actions. メインのリポジトリナビゲーション内のアクションタブ

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

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

    ワークフローの実行の名前

  5. In the upper right corner, click .

    水平ケバブアイコン

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

    すべてのログを削除

ログを削除すると、Delete all logs(すべてのログを削除)ボタンは消え、ワークフローの実行にログファイルが残っていないことを示します。

GitHub CLI でログを表示する

To learn more about GitHub CLI, see "About 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