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. ページ「Agents」ページでは Agent マシンでの IncrediBuild の利用状況に関する情報が表示され、デプロイメントのプロセス全体にわたって IncrediBuild システムがどれほど効果的に使用されているかを確認できます。このページに表示される値はフィルターを使って絞り込むことができます。 ページ ヘッダー
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:注意: Agent フィルターで設定した値のみが表示されます。 |
タイムフィルター指定期間のデータのみを絞り込んで表示できます。 Image Added プリセットまたはカスタムのタイムレンジを作成して適用します。 プリセットのタイムレンジは下表の通りです。
Panel |
---|
borderColor | black |
---|
borderWidth | 1 |
---|
borderStyle | dashed |
---|
| Note注意: In the descriptions below, the Current time refers to the time that the data on the page was last refreshed.以下の説明ではデータの最終更新日時を現在時刻としています。 | Click on CustomPick a Date Range window is displayed:
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: プリセットのタイムレンジの選択方法 ヘッダーのフィルターから適用したいタイムレンジをクリックします。選択したタイムレンジが黄色でハイライト表示されます。 タイムレンジを自分で設定する方法 - [Custom] をクリックします
- [Pick a Date Range] 画面が表示されます。
3. Click on the From Date field. [From Date] をクリックします。
- 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.
- Click OK.カレンダーが表示されます。
- 日付を選択します。
- デフォルトで当日が選択されています。
- 前の月に移動するにはカレンダー上部の左向き矢印をクリックします。
- [OK] をクリックします。
4. Do the same for the end 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.[To Date] フィールドも同様に選択します。
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 注意: The default is set to display all Agents available in the IncrediBuild infrastructure. If no Agents Groups have been created an option to Add Agents Group is displayed in the Agents drop-down menu.- デフォルトでは IncrediBuild システムで使用可能なすべての Agent が表示されます。
- Agent グループを未作成の場合は [Add Agents Group] オプションがドロップダウン メニューに表示されます。
|
Anchor |
---|
| Agentskpisummary |
---|
| Agentskpisummary |
---|
|
Agents Key Performance Indicator SummaryThe 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 KPI サマリーには IncrediBuild システムで使用する Agent の KPI 値の統計が表示されます。
ページ内のすべてのデータ (KPI サマリーを含む) は Agent フィルターで絞り込んだ値に基づいているため、特定の Agent の統計となります。
KPI サマリーには次の情報が表示されます。
Anchor |
---|
| KPIUtiization |
---|
| KPIUtiization |
---|
|
Utilization Over Time
Graphic Displayグラフ
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 を表示)。表示される内容については KPI サマリーをご覧ください。データが最後に集計されてから指定した時間までのすべてのアクティビティに関するデータが表示されます。
Panel |
---|
borderColor | black |
---|
borderWidth | 1 |
---|
borderStyle | dashed |
---|
|
Note注意: The 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] ボタンをクリックします。
Anchor |
---|
| TopAgentUtilization |
---|
| TopAgentUtilization |
---|
|
Top Agent Utilization
Image 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).このセクションでは IncrediBuild タスクでの稼働時間を Agent ごとにご覧になれます。ローカル (イニシエーター) Agent とタスクを分散された (リモートまたはrヘルパー) 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. 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: