ログの分析

[ログ] タブには、パイプライン実行で選択したジョブのビルドログが表示されます。次のセクションでは、ビルドログ (コンソールログとも呼ばれます) を使用してビルドを分類し、ビルドの失敗の原因を特定する方法について説明します。

概要

左側のペインでジョブを選択すると、ログタブにビルドログのローカルコピーが表示されます。次に、ALM Octaneが特定のログメッセージをマップして障害分類をビルドし、ビルドログに基づいてビルドを自動的に分類できるようにするルールを作成できます。

[ビルド] タブで、失敗したビルドには、失敗を分類するラベルが表示され、失敗の原因となった問題の種類を示します。これには、テストコードの問題、コードの問題、環境の問題などがあります。ビルドの失敗の分類は、パイプライン実行の失敗に対処する必要がある担当者と、対処すべき問題を決定するために使用します。

トップに戻る

ビルドの失敗を自動的に分類するためのルールの作成

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

  2. ビルドログで、分類するログメッセージを選択します。

  3. [+] をクリックしてルールを追加します。

  4. ルールには、「illegal number」のような意味のある名前を付けます。

  5. [ルールパターン] には、選択したログ行のテキストが入力されます。

    [ルールパターン] を変更し、ビルドの失敗の分類にマップするログ行を指定します。

    テキストの一部をワイルドカード (*) で置き換え、特殊文字の前に\を追加します。

    例: *illegal number*

    パターンを編集すると、[選択されたログ行] 領域内で一致するテキストが強調表示されます。パターンによって行全体がハイライト表示された場合にのみ、ルールを保存できます。

  6. パターンに一致するログ行に割り当てる分類を選択します。

    例: 環境 - その他

    ヒント: 管理者は、手動の [ビルドの失敗の分類] ボタンをクリックすることで、分類ラベルをリストに追加できます。

  7. [OK] をクリックします。

    指定した分類は、次の項目に割り当てられます。

    • ビルドログファイル内で選択したログ行

    • これ以降、失敗したビルドのログ内でルールと一致するすべてのログ行

      1つの行が複数のルールと一致する場合は、最後に更新されたルールに基づいて分類されます。

    これ以降、失敗したビルドには、ログでマップされた最初の分類が自動的に適用されます。

トップに戻る

分類ルールの編集または削除

ALM OctaneでJenkinsビルドログを開くと、既存のルールが適用された分類ラベルが表示されます。ルールの作成者は、ルールを変更または削除できます。

ALM Octane設定領域にあるビルドの失敗の分類ルールを、すべて表示および変更できます。詳細については、すべてのビルドの失敗の分類ルールの管理を参照してください。

ビルドログファイルのルールを表示および変更するには、次の手順を実行します。

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

  2. ビルドログ内で特定の行の分類ラベルにカーソルを合わせると、そのラベルに割り当てられたルールの作成者が表示されます。

  3. ルールの作成者である場合は、[ルールの削除] または [ルールの編集] をクリックして、ルールを変更できます。ルールの作成者ではない場合は、表示された作成者をクリックすると、ルールの変更に関する電子メールが作成者に送信されます。

    ビルドの失敗を自動的に分類するためのルールの作成の説明に従って、ルールの詳細を編集します。

使用中のルールを変更するとどうなるか

ルールの分類を変更した場合、このルールによってすでに割り当てられているログ行に新しい分類のラベルが付きます。

これは前のビルドのログファイルに影響しますが、既存のビルドの分類には影響しません。ルールの変更は、将来のビルドの分類にのみ影響します。

使用中のルールを削除するとどうなるか

ビルドのログ行に分類を割り当て済みのルールを削除すると、その分類はすべてのログファイルから削除されますが、割り当てられたビルドには残ります。

トップに戻る

参照情報: