ビルドの分析

[ビルド] タブには、パイプライン実行の一部として実行されたビルドの詳細が表示されます。次のセクションでは、ビルドの失敗の分類を使用して、ビルドの失敗の原因を特定する方法について説明します。

このトピックの内容:

ビルドの詳細

左側のペインでパイプラインステップを選択すると、ビルドタブに、選択したステップとその子パイプラインステップのビルドの詳細が表示されます。ビルドごとに、ビルドのステータス、ビルド番号、継続時間、ビルド実行履歴 、このビルド内の失敗したテストのなかで現在対処されているテストの割合 などが表示されます。

外部に保存されたビルドレポートへのカスタムレポートリンクが設定されている場合は、それも利用できます。カスタムビルドレポートリンクの設定の詳細については、パイプラインのステップのラベル付けと設定を参照してください。

セクション失敗を調査する担当者の割り当ての説明に従って、担当者フィールドを設定して、失敗したビルドを調査する人を割り当てます。これは、ビルドに失敗した理由が特定のテストに関連していない場合に役立ちます。たとえば、環境に注意が必要な場合や、コンパイル時にビルドが失敗した可能性がある場合などです。詳細については、以下のビルドの失敗の分類を参照してください。

右上隅にある実行セレクターを使用して、実行間を移動して問題のトラブルシューティングに役立てることができます。概要タブには常に最新の実行が表示されることに注意してください。

トップに戻る

ビルドの失敗の分類

失敗したビルドには、失敗を分類するラベルが表示され、失敗の原因となった問題の種類を示します。これには、テストコードの問題、コードの問題、環境の問題などがあります。

ビルドの失敗の分類は、パイプライン実行の失敗に対処する必要がある担当者と、対処すべき問題を決定するために使用します。

ビルドを手動で分類して、調査結果を文書化することができます。Jenkinsのビルドの場合は、ビルドログに基づいてビルドを自動的に分類するルールを作成することもできます。詳細については、ログの分析を参照してください。

ビルドの失敗の分類は、パイプライン実行のレベルでも示されます。このパイプライン実行内の失敗したビルドの数は、失敗のタイプ別に表示できます。

特定のビルドの失敗の分類のビルド失敗のみを表示するには、CIビルドを使用してクロスフィルターを追加します。ビルドの失敗の分類フィールド:

ビルドが失敗する最も一般的な理由を時系列でを理解するには、パイプラインのビルドの失敗の分類の時間変化ウィジェットをパイプラインのダッシュボードに追加します。特定の実行にカーソルを置くと、その分類の詳細が表示されます。このウィジェットを使用して、ネットワークやデータベースが多くの問題の原因となっていないかどうか、テストの変更が頻繁すぎないかどうか、コードにエラーがないかなどを確認します。

トップに戻る

ビルドの失敗の手動による分類

ビルドの失敗を調査し、原因を特定できたら、[ビルドの失敗の分類] ボタンをクリックし、失敗したビルドにラベルを付けます。これにより、調査の結果を共有し、その後の分析のために調査結果を追跡できます。

分類ラベルを追加、交換、クリアするには、次の手順を実行します。

1. パイプライン実行で、[ビルド] タブを開きます。

2. 1つまたは複数の失敗したビルドを選択します。

3. [ビルドの失敗の分類] ツールバーボタンをクリックします。

   リストに新しい分類ラベルを追加します。

4. ドロップダウンリストで分類ラベルを選択します。

   ビルドがすでに自動的に分類されている場合、手動による分類が自動分類よりも優先されます。

トップに戻る

参照情報:

• パイプラインの概要
• ログの分析
• すべてのビルドの失敗の分類ルールの管理