Builds ページ

「Builds」ページではデプロイメント全体のビルド情報だけでなく、特定のビルドや Agent (イニシエーター) の実行に関する情報など IncrediBuild で行われたビルド*のさまざまな詳細をご覧になれます。このページに表示される値はフィルターを使って絞り込むことができます。

*この資料とダッシュボードでは「ビルド」とはコンパイルだけでなく、IncrediBuild で行われたすべての処理を指します。

メニュー:

フィルター
ビルド KPI サマリー
5 Longest Builds ディスプレイ
5 Top Distributed Builds ディスプレイ
ビルドグリッド

フィルター

「Builds」ページに表示するデータを絞り込むことができます。

注意: ビルドフィルターで設定した値のみが表示されます。

ページヘッダー

ページ左上の「Build Overview」下の [Valid For] でデータの最終更新日時を確認できます。ここに表示される日時がページ内でタイムフィルターを適用する際の現在時刻となります。データは 1 時間ごとに自動的に更新されます。タイムフィルターで設定されるタイムレンジは現在時刻に基づきます。

注意: ページを再読み込みすると現在時刻を手動で更新できます。この場合、設定済みのフィルターはリセットされます。

タイムフィルター

指定期間のデータのみを絞り込んで表示できます。

プリセットまたはカスタムのタイムレンジを作成して適用します。

プリセットのタイムレンジは下表の通りです。

注意: 以下の説明ではデータの最終更新日時を現在時刻としています。

項目	説明
12H	現在時刻から 12 時間前までに実行されたビルドのデータを表示します。
24H	現在時刻から 24 時間前までに実行されたビルドのデータを表示します。デフォルトで選択されています。
Today	当日 00:00 から現在時刻までに実行されたビルドのデータを表示します。

タイムレンジを自分で設定する方法

ページヘッダーで [Custom] をクリックします。

2.[Pick a Date Range] 画面が表示されます。

3.[From Date] をクリックします。

カレンダーが表示されます。
日付を選択します。
デフォルトで当日が選択されています。
前の月に移動するにはカレンダー上部の左向き矢印をクリックします。
[OK] をクリックします。

4. [To Date] フィールドも同様に選択します。

プロダクトフィルター

特定のプロダクトに関連するビルドを絞り込んで表示できます。フィルターを適用する前に「Configuration」ページの「Product 設定 」タブでプロダクトのプロフィールを作成する必要があります。
.

プロダクトフィルターの設定方法

[Products] フィールドをクリックします。

プロダクトが一覧表示されます。

表示したいプロダクトの横にあるチェックボックスをオンにします。

注意:

フィルターが適用されると [Product] フィールドに赤字でプロダクト名が表示されます。
デフォルトではビルドコマンドによる絞り込みなしで、すべてのビルドが表示されます。
プロダクトを未作成の場合は [Add Products] オプションがドロップダウンメニューに表示されます。

ビルドタイプフィルター

特定タイプのビルドを絞り込んで表示できます。ビルドタイプは複数選択できます。

注意: IDE または IncrediBuild BuildConsole コマンドラインで実行される Visual Studio ビルドのみがビルドタイプに登録されています。その他のビルドや処理は「Unknown」として表示されます

ビルドタイプは下表の通りです。

Category	Description
Build	Visual Studio ソリューションまたはプロジェクトのインクリメンタルビルド。
Clean	Visual Studio ソリューションまたはプロジェクトのクリーンビルド。
Rebuild	Visual Studio ソリューションまたはプロジェクトのリビルド (クリーンしてからビルド)。
Unknown	Visual Studio コンパイルを除く IncrediBuild の処理。

ビルドタイプの設定方法

ページヘッダーの [Build Type] フィールドをクリックします。
ビルドタイプが一覧表示されます。
表示したいビルドタイプの横にあるチェックボックスをオンにします。
選択したビルドタイプが表示されます。

注意: デフォルトではすべてのビルドタイプが表示されます。

ビルド KPI サマリー

ヘッダー下のビルド KPI サマリーには IncrediBuild システムで行われたビルドの KPI 値の統計が表示されます。

注意:

ページ内のすべてのデータ (KPI サマリーを含む) はビルドフィルターで絞り込んだ値に基づいています。
選択した期間 / プロダクトタイプ / ビルドタイプで、選択した Agent グループによって開始されたビルドのみが表示されます。

KPI サマリーには次の情報が表示されます。

カテゴリー	説明
Builds Executed	IncrediBuild で実行されたビルドの合計数。
Build Status	Successful - IncrediBuild により実行され、正常に完了したビルド数。 Failed - IncrediBuild によって実行され、失敗したビルド数。システムやユーザーによって中止されたビルドが含まれます。
Avg. Build Duration	IncrediBuild で実行した各ビルドの平均所要時間。
Distributed [%]	合計時間に対するローカル Agent とリモート Agent で行われた処理の割合。この値はリモート Agent コアで実行したビルドの合計時間を、すべての Agent (ローカルとリモート) で実行したビルドの合計時間で割って計算します。たとえば、ローカル Agent と 9 台のリモート Agent でビルドを 1 時間行った場合、リモート Agent コアで行った処理の合計時間 (9 時間) をビルドの合計時間 (10 時間) で割って、分散処理されたタスクの割合 (90%) を計算します。注意: リモートコアを使用するとローカル Agent の負荷が軽減されます。そのため、分散処理の割合が大きいほど IncrediBuild を効果的に利用できていることを示しています。

Builds Execution Over Time ディスプレイ
このセクションでは時間の経過に伴うビルドの KPI の推移をグラフで確認できます。グラフは上下に分かれており、上のグラフでは時間の経過に伴う「成功したビルドと失敗したビルド (Success vs Fail)」または「ビルドタイプ (Build Type)」を選択できます。デフォルトでは「成功したビルドと失敗したビルド」のグラフが選択されています。下のグラフでは時間の経過に伴う分散処理の割合の推移を確認できます (表示項目の詳細は「ビルド KPI サマリー」を参照)。データが最後に集計されてから指定した時間までのすべてのビルドに関するデータが表示されます。

グラフには過去 2 週間 (毎時) とそれ以前 (毎日) の集計データが表示されます。
グラフの上部に表示項目と表示色の凡例が表示されます。

次の方法で表示を変更することができます。

表示 / 非表示 - 凡例のデータ項目をクリックするとグラフを表示 / 非表示できます。デフォルトではすべてが表示されているため、項目をクリックすると非表示になります。

注意: フィルターで除外されているビルドタイプのデータは凡例をクリックしても表示されません。

データ表示 - グラフの任意の場所にカーソルを合わせると、その地点の日時とデータがポップアップ表示されます。

注意: 上下のグラフはリンクしています。上のグラフで任意の時点にカーソルを合わせると、下のグラフにもデータがポップアップ表示されます。

ズーム - タイムライン上でドラッグした範囲を拡大表示して、すばやくデータの詳細を表示できます。タイムライン全体の表示に戻るには、グラフ右上の [Reset Zoom] ボタンをクリックします。

This section shows two bar charts representing either the top or bottom Agents for each of the two measures Time Spent Building and # Builds Executed. You can select the parameters for the data displayed in these charts using the Build Filters. Underneath the title of each chart there is a legend indicating the color of the display for each Agent.

このセクションでは 2 つの評価 (「ビルドの所要時間」と「処理したビルド数」) から上位または下位の Agent を棒グラフで確認できます。ビルドフィルターで設定したデータが表示されます。それぞれのグラフの上部に表示項目と表示色の凡例が表示されます。

Agent 表示数フィルター

ドロップダウンリストから表示する Agent の数を選択できます (5、10、20 のいずれか)。また、パフォーマンス上位 (Top Initiators) または下位 (Bottom Initiators) のどちらを表示するかを選択できます。

Time Spent Building

このセクションでは任意の Agent が開始したすべてのビルドの総所要時間を確認できます。上位または下位いずれかの Agent を表示できます。

グラフには Agent の名前と時間が表示されます。
次の方法で表示を変更することができます。

表示 / 非表示 - 凡例の Agent 名をクリックするとグラフを表示 / 非表示できます。デフォルトではすべての Agent が表示されているため、項目をクリックすると非表示になります。
データ表示 - 各 Agent の棒グラフにカーソルを合わせると詳細データがポップアップで表示されます。Agent 名、Agent が Coordinator に接続されていた合計時間に対するビルド時間の割合、ビルドの総所要時間などが表示されます。

Number of Builds Executed

このセクションでは任意のイニシエーター Agent によって開始されたビルドの総数 (成功、失敗をともに含む) を確認できます。上位または下位の Agent を表示できます。グラフには Agent 名とビルド数が表示されます。

注意: グラフはビルド数のみを表し、ビルド時間は除外されているため、ここに表示される Agent のリストおよび順序は前述の「Time Spent Building」のグラフと必ずしも同じとは限りません。

次の方法で表示を変更することができます。

表示 / 非表示 - 凡例の Fail または Success をクリックするとグラフを表示 / 非表示できます。デフォルトでは成功したビルドと失敗したビルドの両方が表示されます。
データ表示 - 各 Agent の棒グラフにカーソルを合わせるとビルドの総数、成功 / 失敗したビルド数がポップアップで表示されます。

5 Longest Builds ディスプレイ

このセクションでは処理に時間のかかった上位 5 つのビルドを確認できます。棒グラフ下の矢印アイコンをクリックするとビルドの詳細情報が表示されます。

項目は次の通りです。

アイテム	説明
Agent Name	イニシエーター Agent の名前。
Status	ビルドのステータスは Success または Failed のいずれかになります。 Success - 正常に完了したビルド。 Failed - 失敗したビルド。システムやユーザーがビルドを中止したことで、システムが処理を継続できなくなったビルド。
Duration	ビルドの所要時間。
Distributed [%]	合計時間に対するローカル Agent とリモート Agent で行われた処理の割合。で割って、分散処理されたタスクの割合 (90%) を計算します。この値はリモート Agent コアで実行したビルドの合計時間を、すべての Agent (ローカルとリモート) で実行したビルドの合計時間で割って計算します。たとえば、ローカル Agent と 9 台のリモート Agent でビルドを 1 時間行った場合、リモート Agent コアで行った処理の合計時間 (9 時間) をビルドの合計時間 (10 時間) で割って、分散処理されたタスクの割合 (90%) を計算します。
Avg. Additional Cores Needed	ビルドで利用可能だった (実際には利用できなかった数) コアの平均数。ビルド処理中に、追加で必要とされるコア数が毎秒登録されます。1 秒ごとに追加で必要なコア数が集計され、その合計をビルドの処理時間 (秒) で割った値が表示されます。たとえば、値が「0」の場合は開発環境にコアを追加してもビルドの効率は向上しません。この値が大きいほど、コアを追加することによるパフォーマンスの向上を見込めます。
Peak Additional Cores Needed	ビルド中に追加で必要とされたコアの最大数。
Time Saved	すべてのビルドをイニシエーター Agent のみで実行した場合に余分にかかる時間。値はすべてのリモート (ヘルパー) Agent のコア稼働時間を集計して、イニシエーター Agent のコア数で割って算出します。リモート Agent は (I/O やネットワークの要因で) イニシエーター Agent よりも効率が悪いため 1/1.5 (0.6777...) 倍されます。たとえば、イニシエーター Agent が 4 コア、リモート Agent が 12 コアで 1 時間ビルドを実行した場合、「12 コア稼働時間－ 4 コア (イニシエーター Agent のコア数) = 3 時間」となります。これに 1/1.5 を掛けて、このビルドで短縮できた時間を計算します。この例では 2 時間となります。仮定と近似に基づいて計算を行うため、表示される値は実際に短縮した時間の概算値となります。コア稼働時間は各コアの利用時間です。たとえば、4 コアのマシンを 1 時間稼働させて、すべてのコアを完全に利用した場合は 4 コア稼働時間と考えます。
Avoid Local	ビルドを開始したユーザーが設定するブール型のフィールド。 True - リモートで実行可能なタスクはすべてリモート Agent で行い、ローカル Agent では実行しない。 False - IncrediBuild の判断により、分散可能なタスクをローカルまたはリモート Agent で実行する。
Start Time	ビルドを開始した日時。
End Time	ビルドが完了した日時。
Avg Used Cores	ビルド処理中の任意の時点で使用されたコアの平均数。使用コア数は毎秒登録されます。1 秒ごとに使用されているコア数が集計され、その合計をビルドの処理時間 (秒) で割った値が表示されます。
Product	ビルドコマンドに関連付けられた特定のプロダクト名 (該当する場合のみ)。
Command	ビルドの実行に使われたコマンドラインの全文。

5 Top Distributed Builds ディスプレイ

このセクションでは、分散処理の割合が大きい上位 5 つのビルドを確認できます (分散処理の割合については前述の「ビルド KPI サマリー」を参照)。棒グラフ下の矢印アイコンをクリックするとビルドの詳細情報が表示されます。表示項目の詳細については「5 Longest Builds ディスプレイ」の項目リストをご覧ください。.

ビルドグリッド

このセクションではビルドの詳細な情報を確認できます。リストに表示されるビルドは最大 10 個です。各ビルドの詳細が右側の列に表示されます。セクションの一番下に表示された矢印アイコンをクリックすると次のリストを表示できます。各項目をクリックして昇順 / 降順に並べ替えることができます。分析モード (Analysis Mode) ではより詳細な分析を行うことができます。

ビルドグリッドフィルター

フィルターを使って表示項目を絞り込むことができます (各項目の詳細は後述の「表示項目の詳細」を参照)。「分析モード」を開いてより詳細な分析を行うことができます。

表示項目の変更方法

セクション上部の [COLUMNS] フィルターをクリックします。
表示項目がドロップダウンリストで表示されます。
表示したい項目のチェックボックスをオンにします。
選択済みの項目はチェックボックスをオフにすると非表示にできます (デフォルトではリストの上から 6 つの項目が選択済み)。
選択した項目がグリッドに表示されます。

注意:

IDE または IncrediBuild BuildConsole コマンドラインで実行される Visual Studio ビルドのみがビルドタイプに登録されています。その他のビルドは「Unknown」として表示されます。
選択した項目が画面に入りきらない場合はグリッドの下にスクロールバーが表示されます。

分析モードの利用方法

セクション上部の [Analysis Mode] をクリックします。

並び替え

グリッドに表示されているビルドは項目ごとに昇順 / 降順に並び替えることができます。

ビルドを並び替える

各項目の上向き矢印をクリックすると、降順 (上→下) に並び替えることができます。
各項目の下向き矢印をクリックすると、昇順 (下→上) に並び替えることができます。

注意: 選択した列だけでなくグリッド全体のビルドの表示順序が変わります。

表示項目の詳細

アイテム	説明
Build Caption	特定のビルド処理を表す文字列。ユーザーによる定義、または自動で生成することもできます。ビルドの実行で使用したソリューション名を入れることができます。タイトルの引数を指定せずにコマンドラインからビルドを実行した場合は、Build Caption は適用されないため、このフィールドは空のままです。
Status	ビルドのステータスは Success または Failed のいずれかになります。 Success - 正常に完了したビルド。 Failed - 失敗したビルド。システムやユーザーがビルドを中止したことで、システムが処理を継続できなくなったビルド。
Start Time	ビルドを開始した時間。
Duration	ビルドの所要時間。
Initiator	イニシエーター Agent の名前。
Distributed	合計時間に対するローカル Agent とリモート Agent で行われた処理の割合。この値はリモート Agent コアで実行したビルドの合計時間を、すべての Agent (ローカルとリモート) で実行したビルドの合計時間で割って計算します。たとえば、ローカル Agent と 9 台のリモート Agent でビルドを 1 時間行った場合、リモート Agent コアで行った処理の合計時間 (9 時間) をビルドの合計時間 (10 時間) で割って、分散処理されたタスクの割合 (90%) を計算します。
Avg. Cores Used	ビルド処理中の任意の時点で使用されたコアの平均数。使用コア数は毎秒登録されます。1 秒ごとに使用されているコア数が集計され、その合計をビルドの処理時間 (秒) で割った値が表示されます。
Build Command	ビルドの実行に使われたコマンドライン。スペースの関係上グリッドには表示されませんが、ビルドの [Show] にカーソルを合わせるとビルドコマンドの全文がポップアップで表示されます。
Build Type	実行したビルドのタイプ。ビルドタイプは次の通りです。 Build - Visual Studio ソリューションまたはプロジェクトのインクリメンタルビルド。 Clean - Visual Studio ソリューションまたはプロジェクトのクリーンビルド。 Rebuild - Visual Studio ソリューションまたはプロジェクトのリビルド (クリーンしてからビルド)。 Unknown - Visual Studio コンパイルを除く IncrediBuild の処理。注意: IDE または IncrediBuild BuildConsole コマンドラインで実行される Visual Studio ビルドのみがビルドタイプに登録されています。その他のビルドや処理は「Unknown」として表示されます。
Estimated Time Saved	すべてのビルドをイニシエーター Agent のみで実行した場合に余分にかかる時間。値はすべてのリモート (ヘルパー) Agent のコア稼働時間を集計して、イニシエーター Agent のコア数で割って算出します。リモート Agent は (I/O やネットワークの要因で) イニシエーター Agent よりも効率が悪いため 1/1.5 (0.6777...) 倍されます。たとえば、イニシエーター Agent が 4 コア、リモート Agent が 12 コアで 1 時間ビルドを実行した場合、「12 コア稼働時間－ 4 コア (イニシエーター Agent のコア数) = 3 時間」となります。これに 1/1.5 を掛けて、このビルドで短縮できた時間を計算します。この例では 2 時間となります。仮定と近似に基づいて計算を行うため、表示される値は実際に短縮した時間の概算値となります。コア稼働時間は各コアの利用時間です。たとえば、4 コアのマシンを 1 時間稼働させて、すべてのコアを完全に利用した場合は 4 コア稼働時間と考えます。
End Time	ビルドが完了した時間。
Avg. Additional Cores Needed	ビルドで利用可能だった (実際には利用できなかった数) コアの平均数。システムにより 1 秒ごとに追加で必要なコア数が集計され、その合計をビルドの処理時間 (秒) で割った値が表示されます。たとえば、値が「0」の場合は開発環境にコアを追加してもビルドの効率は向上しません。この値が大きいほど、コアを追加することによるパフォーマンスの向上を見込めます。
Peak Cores Needed	ビルド中に追加で必要とされたコアの最大数。
Peak Cores Used	ビルド中に同時に使用されたコアの最大数。
Avoid Local	ビルドを開始したユーザーが設定するブール型のフィールド。 True - リモートで実行可能なタスクはすべてリモート Agent で行い、ローカル Agent では実行しない。 False - IncrediBuild の判断により、分散可能なタスクをローカルまたはリモート Agent で実行する。
Product	ビルドコマンドに関連付けられた特定のプロダクト名 (該当する場合のみ)。

ダッシュボードマニュアル:

Builds ページ