.. _doc_pages_events:

Events
======

An event in W4 Build is an action that triggers a matrix, which in turn starts a group of builds.
This page will help you debug and understand what has been triggered and built in your account.

An event can be triggered in three ways:

#. Receiving a webhook or GitHub integration
#. Cron execution
#. Manual execution

    .. image:: img/home.png
       :alt: W4 Build events overview


View Events
-----------

You can click on any event in the Events table to see which builds were triggered.
Selecting a row will open the event details page.

    .. image:: img/details.png
       :alt: Build event details

The event details page displays the following information:

#. **Event type:** The type of event that occurred
#. **Builds:** The number of builds started
#. **Triggered at:** The timestamp of when the event was triggered
#. **Used matrix:** The matrix that was executed for this event

The Events page contains two tabs: the **Build List** and the **Event Log**.


Build List
----------

The build list shows all builds that were started by the selected event.

    .. image:: img/build_list.png
       :alt: Build list for an event


Event Log
---------

The event log contains data related to the event.
For example, if an error occurred during triggering, the error will be displayed here.

    .. image:: img/details.png
       :alt: Event log details