「Agents」ページでは IncrediBuild インフラ内の様々なAgentマシン上でIncredibuildがどのように利用されているかに関する情報が表示されます。この情報により、全体処理の中で、IncrediBuild インフラがどれほど効果的に使用されているかを確認できるだけでなく、更に特定のAgentの情報も分析できます。このページに表示される値はフィルターを使って絞り込むことができます。
メニュー: Agents PageThe Agents page shows information about how IncrediBuild is being utilized on various Agent machines in your deployment This helps you gauge how effectively the IncrediBuild infrastructure is being used across your entire deployment process as well as information for specific Agents. You can set filters to specify the parameters for the data represented in the measures displayed on this page.  Image Removed
In the Page Header, below "Agent Utilization", the Valid For information is displayed. This shows the date and time of the data represented on this page since it was last refreshed. This is considered to be the current time with respect to the Time Filter set for the page. ページ ヘッダー
Image Added 本ページヘッダーでは、ページ左上の「Agent Utilization」下の [Valid For] には日時が表示されますが、これはページの最終更新時にデータが最後に更新された日時となります。ここに表示される日時がページ内で期間フィルターを適用した際の現在時刻となります。 | Panel |
|---|
| borderColor | black |
|---|
| borderWidth | 1 |
|---|
| borderStyle | dashed |
|---|
|
Note: You can update the current time manually by refreshing the page. However, refreshing the page will also reset any filters that you have set and return them to their default settings. |
FiltersFilters allow you to set the parameters for the data that is shown on the Agents page.注意: ページを再読み込みすると現在時刻を手動で更新できます。但し、更新した場合は、設定されたフィルターがリセットされ、全てのパラメーターがデフォルトの数値に戻されます。 |
フィルター「Agents」ページに表示するデータを絞り込むことができます。 | Panel |
|---|
| borderColor | black |
|---|
| borderWidth | 1 |
|---|
| borderStyle | dashed |
|---|
|
Note: All measures displayed on this page represent only the data within the parameters set from the Agent Filter |
Time FilterThe Time Filter enables you to filter the data represented on the Agents page to include only data for the specified time period.
 Image Removed
You can set the time filter using one of the preset time range buttons or you can create a custom time range.
The preset time ranges are described in the following table:To select one of the preset time ranges: From the filter pane in the Page Header, click the time range to be applied. Your selection is highlighted in yellow indicating that that time range filter is applied To set a custom time range: Click on CustomPick a Date Range window is displayed:注: このページに表示される全ての指標は、Agent フィルターで設定されたパラメータ内のデータのみを参照した値となります。 |
期間フィルター期間フィルターを使用すると、Agentsページに表示されるデータをフィルターし、指定した期間のデータのみ含まれるデータとして表示します。
Image Added
プリセットされた期間のボタンをクリックして期間を指定するか、カスタムで時間範囲を作成する事も可能です。
プリセットの時間範囲は下表の通りです。
| Panel |
|---|
| borderColor | black |
|---|
| borderWidth | 1 |
|---|
| borderStyle | dashed |
|---|
|
NoteIn the descriptions below, the Current time refers to the time that the data on the page was last refreshed.以下の説明ではデータの最終更新日時を現在時刻としています。 |
|
| Includes data from builds executed in the 12 hours prior to the current time. |
24H | Includes data from builds executed in the 24 hours prior to the current time. This is the default selection. |
Today | Includes data from builds executed from 00:00 of the current day up to the current time. |
プリセットの時間範囲の選択方法 ヘッダーのフィルターから適用したい時間範囲をクリックします。選択した時間範囲が黄色でハイライト表示されます。 カスタムの時間範囲を設定する方法 - [Custom] をクリックします
- [Pick a Date Range] 画面が表示されます。
 Image Modified 3. |
Click on the From Date field.Click OK. [From Date] をクリックします。  Image Modified
|
A calendar selection window is displayed.Select a date.The default is set for the current date.To select a date from a previous month, click the back arrow on the top of the calendar and then select a date.Agents FilterThe Agents filter enables you to filter the data represented on the Agents page to include only builds initiated by a specific group (or groups) of Agents. Agents groups must first be created in the Agents Configuration page before they can be applied to the Agents page (see Configuration Page).
To set the Agents filter:
- Click on the Agents field.
A multi-select list of the Agents Groups is displayed.- カレンダーが表示されます。
- 日付を選択します。
- デフォルトで現在日が選択されています。
- 前の月に移動するにはカレンダー上部の左向き矢印をクリックし、選択したい日をクリックします。
- [OK] をクリックします。
4. |
Do the same for the end date.[To Date] フィールドも同様に選択します。
Agent フィルター
Agentフィルターを使用すると、Agentの特定のグループ（または特定の複数グループ）によって開始されたビルドのみを集計対象として含むように、Agentページで表示されるデータをフィルタリングできます。フィルターを適用する前に「Configuration」ページの「Agent 設定」タブで Agent グループを作成する必要があります (「Configuration 」ページを参照)。 Agent フィルターの設定方法 - [Agent] フィールドをクリックします。
複数選択可能なAgent グループがリスト表示されます。 2. |
Click the checkbox next to each of the Agents Groups to be included.The filter is applied and the selected Agents Groups are now displayed.含めたい Agent グループの横にあるチェックボックスをオンにします。 フィルターが適用され、選択した Agent グループのデータが含まれた情報が表示されます。 | Panel |
|---|
| borderColor | black |
|---|
| borderWidth | 1 |
|---|
| borderStyle | dashed |
|---|
|
Note If no Agents Groups have been created an option to Add Agents Group is displayed in the Agents drop-down menu.The default is set to display all Agents available in the IncrediBuild infrastructure. - デフォルトでは IncrediBuild インフラで使用可能なすべての Agent が表示されます。
- Agent グループを未作成の場合は [Add Agents Group] オプションがドロップダウン メニューに表示されます。
|
| Anchor |
|---|
| Agentskpisummary |
|---|
| Agentskpisummary |
|---|
|
|
Agents Key Performance Indicator Summary
The Agents KPI Summary shows aggregated statistics for the KPI measures related to Agent usage in the IncrediBuild infrastructure.All data represented on the Agents page, including the KPI Summary are based on the parameters set in the Agent Filter. This means that the data presented here may show aggregated of only specific Agents.
The information displayed in the KPI display is explained in the following table:
Value | | These measures give a rough estimate of the value that you are getting from your IncrediBuild infrastructure in terms of savings in time and cost. | |
Time Saved | This is a rough estimate of how much longer it would have taken to run all of the build executions if they had been executed without using IncrediBuild (i.e. the builds were run entirely on the Initiator Agents) Note: This measure indicates the Time Saved for the Initiator Agents. This measure relates only to the data of the Initiator Agents, as IncrediBuild only saves time for builds that were initiated by Initiator Agents, this measure represents the time (and cost) saved for Initiator Agents. . Therefore, if the Agents group Group selected in your filter did not initiate any builds during the selected time range the value for this KPI is zero.
Note: If the duration of a build extended beyond the time range designated in the filter then the data from that build is represented proportionally to the percentage of the build that was run within the time range. For example, if the designated time range is from 10:00 AM to 11:00 AM and a build ran from 9:00 AM to 11:00 AM then half of the values for that build are represented in the data. This calculation is made by taking the aggregate of the core-hours (a core-hour is an hour of utilization of each core, e.g. a 4 core machine running for one hour and fully utilizing all of its cores iswouldFully utilizing all its cores would… be considered to have utilized four core-hours) of utilization of all remote (i.e. Helper) Agents and dividing that by the number of cores on the Initiator Agents. Since usage of the remote Agents is less efficient than usage of the Initiator Agents (because of I/O and Network factors etc.), the result is divided in halfby 1.5. For example, if the Initiator Agent has 4 cores and the build ran for an hour using an additional 12 cores on remote Agents. Then we take the 12 core-hours and divide that by the 4 cores on the Initiator Agent which yields the result of 3 hours. We then take that number and divide it in halfby 1.5 to reach the result that the Time Saved for that build was 1.52 hours.
Since this calculation is based on a series of assumptions and approximations, the result should be viewed as a rough estimate of the actual time saved. | | Cost Saved | This measure indicates the cost savings you gained by using IncrediBuild.
IncrediBuild cuts the downtime that users spend waiting for a build to be executed. This translates into cost savings for your company. This measure is based on the assumption that there is a fixed cost benefit for every hour of time that you free-up on the Initiator Agent by using IncrediBuild. The default value attributed to this savings is set as $40 per hour. As IncrediBuild saves developers waiting time, every minute that IncrediBuild saved translates to cost savings. The default value is set as a developer's cost of 40$ an hour.Therefore, this measure is calculated by multiplying the Time Saved by 40.
Note: You can adjust the value attributed to every hour of time saved on the Configuration page. (See Configuration Page) | | Processing Power | | These measures give an indication of the processing power available in your IncrediBuild infrastructure and to what extent it is being utilized.
Note: Like all other information on this page, these measures represent only data pertaining to the Agent Groups designated in the filter. | |
Total Licensed Cores | The total number of licensed cores. | | | Average Cores Utilized Per Agent | The average number of cores per Agent being utilized at a given time.
For every second during which an Agent is in use, IncrediBuild registers a value for how many cores are being used. This value is determined by taking the aggregate of the number of seconds of core usage and dividing it by the total number of seconds of Agent activity.
Note: Time during which an Agent was not being used by IncrediBuild is not taken into consideration. For example, if during the entire selected time range there were only 10 minutes of Agent activity and during the entire 10 minute duration 16 cores were in use then the value returned is 16. | |
Processing Time | | These measures indicate the total number of core-hours of execution on local cores (i.e. Initiator cores) and distributed (i.e. remote Helper cores) respectively. A core-hour is an hour of activity of an individual core. For example, if an Agent with 8 cores ran for one hour utilizing all of its cores, the processing time is 8 core-hours. | |
Local | The total number of core-hours of execution of IncrediBuild tasks on local Agents (i.e. Initiators). | | Distributed | The total number of core-hours of execution of IncrediBuild tasks that were distributed to remote Agents (i.e. Helpers). | | Agent Usage | | These measures indicate the average percentage of time per Agent that the Agent was in use and available respectively. | |
Usage Time | The average percentage of time that the Agents were in use either as an Initiator or as a Helper.
This is calculated by taking the number of seconds that each Agent was in use during the selected time range and dividing it by the total number of seconds. This yields the average usage time per Agent. An average is then taken of the usage time for all Agents. This yields the average percentage of Usage Time per Agent. | | | Available Time | The average percentage of time that the Agents were available for execution of IncrediBuild tasks. Agents are considered to be Available when they are subscribed and connected to the Coordinator (i.e. online).
This is calculated by taking the number of seconds that each Agent was available during the selected time range and dividing it by the total number of seconds. This yields the average Available time per Agent. An average is then taken of the Available time for all Agents. This yields the average percentage of Available time per Agent.Agent KPI サマリー
ページ ヘッダー(Agent Utilization)下の Agent KPI サマリーには IncrediBuild インフラ内でのAgent の利用状況に関する 集積されたデータによるKPI 値の統計が表示されます。
ページ内のすべてのデータ (KPI サマリーを含む) は Agent フィルターで絞り込んだ値に基づいているため、ここで表示されるデータは特定の Agent のみを集計した統計値となります。
KPI サマリーには次の情報が表示されます。 | Anchor |
|---|
| KPIUtiization |
|---|
| KPIUtiization |
|---|
|
Utilization Over Time |
Graphic Displayグラフ Image Modified
|
This area shows a graphic representation of the Agents KPIs over time. You can select to display the graph for Avg. Cores Utilized, Time Saved or Processing Time (Default: displays Processing Time). For explanation of these measures see Agents KPI Summary. The data displayed for a given point in time relates to all activity that occurred during the time period between the last aggregation of data and the specified time. このセクションでは時間の経過に伴う Agent の KPI の推移をグラフで確認できます。Avg. Core Utilized (コアの平均使用率)、Time Saved (削減時間)、Processing Time (処理時間) の表示を選択できます (デフォルトでは Processing Time を表示)。表示される内容については Agent KPI サマリーをご覧ください。特定の時点で表示されるデータは、データが最後に集計されてから指定した時間までに発生したすべてのアクティビティに関するデータです。 | Panel |
|---|
| borderColor | black |
|---|
| borderWidth | 1 |
|---|
| borderStyle | dashed |
|---|
|
NoteThe data shown in the graph is aggregated hourly for the last two weeks and daily for earlier dates. |
The legend indicating the color of the display for each element is shown at the top of the graph. You can interact with the display in the following manner:- Select/Deselect – Click on one of the data elements in the legend to show/hide that element in the display. The default is to display all elements. Therefore, the first time that you click on an element it will hide it.
- Display data – Hover over a point in the graph to create a pop-out display of the specified date and time and the data for that particular point in time.
- Zooming – Drag the cursor over a section of the timeline to zoom in on that time range and display a more granular breakdown of the data over a shorter period of time. To return to the display of the full timeline, click the Reset Zoom button in the top right corner of the graph.
Top Initiators Display
Image Removed
This section shows three bar charts representing either the top or bottom Agents for each of the three measures Agents Page (Copy), Agent Usage and Processing Power. You can select the parameters for the data displayed in these charts from the Page Header. Underneath the title of each chart there is a legend indicating the color of the display for each Agent.
For each chart, you can interact with the display in the following manner:
You can interact with the display in the following manner:
Agents Number Filter
Image Removed
From the Agents Number Filter you can select the number of Agents displayed from the dropdown list (options are: 5,10 or 20). You can also select whether to display the Agents with the top performance or the Agents with the bottom (lowest) performance.グラフには直近 2 週間は時間毎、 それ以前は日毎の集計データが表示されます。 |
グラフの上部に表示項目と表示色の凡例が表示されます。
次の方法で表示を変更することができます。
- 表示 / 非表示 - 凡例のデータ項目をクリックするとグラフを表示 / 非表示できます。デフォルトではすべての項目が表示されているため、項目をクリックすると非表示になります。
- データ表示 - グラフの任意の場所にカーソルを合わせると、その地点の日時とデータがポップアップ表示されます。
- ズーム - グラフのタイムライン上でのマウスドラッグにて、ドラッグした範囲を拡大表示し、すばやくデータの詳細を表示できます。タイムライン全体の表示に戻るには、グラフ右上の [Reset Zoom] ボタンをクリックします。
Top Agent UtilizationImage Added このセクションでは、Processing Time (処理時間)、Agent Usage (Agent 使用時間)、Processing Power (処理能力) の 3 項目で上位と下位の Agent を棒グラフで確認できます。ページ ヘッダーにて設定したフィルターに応じたデータが表示されます。 それぞれのグラフの上部のタイトルの下に表示項目と表示色の凡例が表示されます。
それぞれのグラフに対し、次の方法で表示を変更することができます。 Agent 表示数フィルターImage Added
ドロップダウン リストより、表示する Agent の数を選択できます (5、10、20 のいずれか)。また、パフォーマンス上位 (Top Agents) または下位 (Bottom Agents) のどちらを表示するかを選択できます。
| Anchor |
|---|
| Processing Time |
|---|
| Processing Time |
|---|
|
Processing Time |
This chart shows data about the amount of time that specific Agents were utilized for execution of IncrediBuild tasks. The bar graph shows the number of core-hours of utilization of the Agent as a Local (i.e. Initiator) Agent and for Distributed tasks (i.e. as a remote, Helper Agent).Agent Usage
This chart shows data about the amount of time that specific Agents were available and utilized for IncrediBuild. The bar graph shows the number of core-hours that a specific Agent was available (i.e. subscribed and connected to the Coordinator) and the number of core-hours that it was utilized by IncrediBuild.
- The display order of the Top and Bottom Agents is determined based on the values for Available Time.
- The data shown in the pop-out display (which is shown by hovering over an Agent bar) is the same as the data shown in the Processing Time pane.
Processing Power
This chart shows data about the processing power available for specific Agents and how it was utilized for IncrediBuild. The bar graph shows the number of Licensed cores for this Agent and the average number of cores being utilized at a given time.
- The display order of the Top and Bottom Agents is determined based on the values for Avg. Cores Utilized.
- Time during which no Agent is being used by IncrediBuild is not taken into consideration for the Avg. Cores Utilized measure
.
Example:
- if an Agent has 4 cores and during the entire selected time range, and there was only 10 minutes of Agent activity and during the entire 10 minute duration all 4 cores were in use, then the value returned is 4.,
The data shown in the pop-out display (which is shown by hovering over an Agent bar) is the same as the data shown in the Processing Time pane.Agents Grid
Image Removed
This pane displays detailed information about specific Agents. A list of up to 10 Agents is displayed at a time with a series of columns displaying detailed data about each Agent. Clicking "Expand" will open up a chart with more information regarding that Agent.You can scroll through the rest of the list by clicking the forward and backward arrows below the grid. You can customize the display by selecting which data columns are shown. The builds can be sorted in ascending or descending order in relation to each of the columns. You can view data for a specific Agent shown graphically over time, by clicking on the Agent in the grid.
The data can be accessed in a manner that enables more in-depth analyses by entering Analysis Mode.
From the Header Filter you can select which columns are displayed (for an explanation of the data displayed in each column see Column Definition Table). You can also enter Analysis Mode to enable more in-depth data analyses.
To select which columns are displayed:
1.Click on Columns in the Header Filter
2. A multi-select dropdown list of column categories is displayed. For an explanation of the columns selection, see Column Definition Table.
Image Removed
3.Select the check-box next to each of the columns to be displayed.
4.If a column is selected, you can click the check-box to deselect the column. (Default: the top 6 columns in the list are selected).
5.The selected columns are displayed in the grid.このグラフでは IncrediBuild タスクでの稼働時間を Agent 毎にご覧になれます。ローカル (イニシエーター) Agent とタスクを分散された (リモート/ヘルパー) Agent のコア稼働時間が棒グラフで表示されます。
| Panel |
|---|
| borderColor | black |
|---|
| borderWidth | 1 |
|---|
| borderStyle | dashed |
|---|
|
Note: The display order of the Top and Bottom Agents is determined based on values for the Overall Processing Time which represents the sum of the Local and Distributed processing times. |
The data shown in the pop-out display (which is shown by hovering over an Agent bar) is explained in the following table: