# Build Monitor

The Build Monitor screen provides an integration level view of all data for a reported build and associated test stages. Upon initial selection of a specific build i.e. selecting App, Branch, Build from the drop-down menus, a general build overview screen is shown with several tabs.

<figure><img src="https://4057366433-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAjqTCMRYvHhDgsdPLUnc%2Fuploads%2Fj4Ui5JiQsutRsSEjawCA%2FScreen%20Shot%202020-09-23%20at%203.12.56%20PM.png?alt=media&#x26;token=f2f0da2f-29f0-4e9a-9381-731e1eb51636" alt=""><figcaption></figcaption></figure>

## Build Session and Build Scan details <a href="#build-session-and-build-scan-details" id="build-session-and-build-scan-details"></a>

The landing page of the build selected will provide the details of the two first commands necessary to report a build to Sealights:

* config: generation of the Build Session ID (BSID)
* build Scan: agent’s scan analysis of the application bytecode

## Test Stage details <a href="#test-stage-details" id="test-stage-details"></a>

View Test Stage-specific data by selecting a Test Stage on the right-hand side of the screen.

<figure><img src="https://4057366433-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAjqTCMRYvHhDgsdPLUnc%2Fuploads%2F2zTjQqybsZErmMZdjxwO%2FScreen%20Shot%202020-09-23%20at%203.40.31%20PM.png?alt=media&#x26;token=adfb79c1-135c-412d-9b5d-87b032f78dcd" alt=""><figcaption></figcaption></figure>

### The “Executions” Tab <a href="#the-executions-tab" id="the-executions-tab"></a>

In this tab, you’ll find the details of all the test executions associated and aggregated with the current Test Stage: all these executions have contributed to the duration, coverage and tests counters shown in the Build Monitor or the main dashboard.

{% hint style="warning" %}
When you run the same tests against the same build, the test counters and duration will be aggregated.\
For example, if you execute two times 10 tests against the same build of your application and report them to Sealights, you’ll see a total number of 20 tests reported in the dashboard and the cockpit and it will appear with 2 executions in this tab.
{% endhint %}

Each execution will be summarized with the following parameters: status, start and end timestamps, lab ID used for the execution, and the ending cause.

<figure><img src="https://4057366433-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAjqTCMRYvHhDgsdPLUnc%2Fuploads%2FkX3lIJgIwfThgJ13kHes%2Fimage-20210819-075929.png?alt=media&#x26;token=37def47a-d087-41f7-977d-f1444d46ef1d" alt=""><figcaption></figcaption></figure>

There are 3 possible statuses for a Test stage Execution

<table data-header-hidden><thead><tr><th width="182.34765625">Status</th><th>Description</th></tr></thead><tbody><tr><td><code>Created</code></td><td>Execution was initiated and is still in progress.</td></tr><tr><td><code>Pending Delete</code></td><td>Execution was reported to Sealights as ended but entered in our Backend queue for processing.<br>The execution will not stay in this stage for more than 120 seconds.</td></tr><tr><td><code>ended</code></td><td>Execution was ended and processing completed. All metrics are calculated and made available in Selaights dashboard and Reports.</td></tr></tbody></table>

The ending cause column can have the following values

<table><thead><tr><th width="181.71875">Ending Cause</th><th>Description</th></tr></thead><tbody><tr><td><code>Agent</code></td><td>Execution was ended by a regular agent command.</td></tr><tr><td><code>API</code></td><td>Execution was ended by a regular API call.</td></tr><tr><td><code>Server - Conflict</code></td><td>Sealights' backend detected new executions opened with parameters conflicting with the current one(s) and closed the older one(s) automatically.<br>For example, when the same LabId is used by a different test stage.</td></tr><tr><td><code>Server - Timeout</code></td><td>When opening the execution via the API a timeout can be provided to end automatically the execution. By default the timeout is 4 hours.</td></tr><tr><td><code>Server - Daily</code></td><td>Every day at 3:00 AM GMT, Selaights backend automatically closes open executions left open for more than 24 hours.<br>Please contact Sealights Support if your tests executions durations are by default running for a longer time.</td></tr><tr><td><code>Sealights Support</code></td><td>Sealights Support department had forced the end of the execution manually (Typically for troubleshooting or ticket resolution purpose).</td></tr></tbody></table>

## Advanced  <a href="#advanced" id="advanced"></a>

### JSON details of agent’s command  <a href="#json-details-of-agents-command" id="json-details-of-agents-command"></a>

For Build scanner and Test Listener tabs, view JSON details of the session parameters mapped from the Agent commands.

<figure><img src="https://4057366433-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAjqTCMRYvHhDgsdPLUnc%2Fuploads%2FcC0maFUZbUghWasVlXkb%2FScreen%20Shot%202020-09-23%20at%203.26.06%20PM.png?alt=media&#x26;token=a2651c44-615d-4e36-896c-b1c3279dc4d2" alt=""><figcaption></figcaption></figure>

<figure><img src="https://4057366433-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAjqTCMRYvHhDgsdPLUnc%2Fuploads%2FQw5YA6d7DB5sEwDakP9E%2FScreen%20Shot%202020-09-24%20at%204.06.45%20PM.png?alt=media&#x26;token=54e8714a-3d18-43f4-8ef5-b6103bbb11c0" alt=""><figcaption></figcaption></figure>

### Validating Pull Request Integration using the Build Monitor <a href="#validating-pull-request-integration-using-the-build-monitor" id="validating-pull-request-integration-using-the-build-monitor"></a>

Pull Request jobs are not shown on the dashboard but they can be reviewed using the Build Monitor (by default PR branches are also hidden).

<figure><img src="https://4057366433-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAjqTCMRYvHhDgsdPLUnc%2Fuploads%2FTrBGBUMvo25w9t4dfpt5%2FScreen%20Shot%202020-09-25%20at%205.09.04%20PM.png?alt=media&#x26;token=505e78f6-32d2-4f67-92a0-bce038677a1c" alt=""><figcaption></figcaption></figure>

&#x20;