Skip to main content

監視とトラブルシューティングについて

GitHub Actions のツールを使って、ワークフローを監視およびデバッグすることができます。

ワークフローを監視する

組織または企業の現在のジョブを監視する

コンカレンシーまたはキューに関する制約を特定するには、組織や企業で GitHub ホステッド ランナーで現在処理されているジョブの数を確認できます。 詳しくは、「現在のジョブの監視」を参照してください。

視覚化グラフの利用

すべてのワークフローの実行は、実行の進行を示すリアルタイムのグラフを生成します。 このグラフを使って、ワークフローをモニタリング及びデバッグできます。 次に例を示します。

ワークフロー実行の視覚化グラフのスクリーンショット。

詳しくは、「視覚化グラフの利用」を参照してください。

ワークフロー状態バッジの追加

ステータスバッジは、ワークフローが現在失敗しているかパスしているかを示します。 ステータス バッジは、リポジトリの README.md ファイル内に追加するのが一般的ですが、どの Web ページにも追加することができます。 デフォルトでは、バッジはデフォルトブランチのステータスを示します。 また、特定のブランチやイベントのワークフロー実行のステータスを、URL 内の branch および event クエリ パラメーターを使用して表示することもできます。

ワークフローの状態バッジのスクリーンショット。 左側には、octocat のロゴと "GitHub Actions Demo" (ワークフローの名前) が含まれています。 右半分は緑色で、"passing" というテキストが表示されています。

詳しくは、「ワークフロー状態バッジの追加」を参照してください。

ジョブの実行時間を表示する

ジョブの実行にかかった時間を特定するために、ジョブの実行時間を表示できます。 詳しくは、「ジョブの実行時間を表示する」を参照してください。

ワークフロー実行の履歴を表示する

ワークフロー内の各ジョブとステップの状態を表示できます。 詳しくは、「ワークフロー実行の履歴を表示する」を参照してください。

ワークフローをトラブルシューティングする

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

各ワークフローの実行では、表示、検索、ダウンロードできるアクティビティ ログが生成されます。 詳しくは、「ワークフロー実行ログの使用」を参照してください。

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

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

ワークフローをキャンセルする

ワークフローをキャンセルしようとしても、キャンセルが成功しない場合は、always 式を使用していないことを確認してください。 always 式を使用すると、ワークフローがキャンセルされた場合でもワークフローのステップが実行され、その結果、キャンセルがハングします。 詳細については、「」を参照してください。

セルフホストランナーのモニタリングとトラブルシューティング

セルフホスト ランナーを使用する場合、そのアクティビティを見て、一般的な問題を診断できます。

詳しくは、「セルフホストランナーのモニタリングとトラブルシューティング」を参照してください。