# Run page

On the Run page you can configure and run Procedures, dig into Procedure output, and review Procedure
history for a project.

![Run Project Page](/static/bas/run/run_page.png "Run Project page")

!!!Note
Windows support is available at this time and Mac support will be available at a later date.
!!!

## Running a project

Use the steps below to run a project.

1. Filter the list of agents displayed in the Agents field group and select the one you'd like to run.

   - From the first drop-down list, select the Platform: All Agents, Windows, or Linux.

     ![All agents](/static/bas/run/select_agent.png "All agents")

   - From the second drop-down list, select the agent connection status: All Agents or Active Agents.

     ![Active agents](/static/bas/run/active_agents.png "Active agents")

   !!!
   If you haven't yet set up an agent, see the [Agents](/bas/management/agents/) section of this guide for
   how to do so.
   !!!

2. Select an optional procedure or a playbook from the *Select Procedure* or *Select Playbook* drop-down lists on the
*Plan* tab.

   ![Plan Tab](/static/bas/run/plan_tab.png "Plan Tab")

   To view procedures grouped by tactics, playbooks, or tags, select the Tree View icon next to the
   *Select Procedure* field to display the *Add Procedures* dialog box -> select the filter to the right of the
   *All* filter and select *Tactics*, *Playbooks*, or *Tags*.

   ![Group Procedures](/static/bas/run/group_procedures_run.png "Group Procedures")

   As you add procedures and/or a playbook, all the procedures selected (or associated with the playbook)
   display in the Plan table below the *Select Procedure* drop-down list.

   ![Selected Procedures](/static/bas/run/selected_procedures_run.png "Selected Procedures")

3. Select any Procedure row to display its details in the right, lower section of the page.

   ![Procedure details from Plan](/static/bas/run/procedure_details_run.png "Procedure details from Plan")

   From here you can edit the information on the Run tab, view the procedure overview =and activity log, upload
   files, view related tags, and modify the settings. Each procedure will have different settings depending on its
   particular requirements.

4. Select the blue **Run** button. Once the project begins to run, focus moves to the Execute tab, where you can
see the status of your queued Procedures.

5. Once the Procedures have run, select the History tab to view the result.

6. Select a Procedure to see the results on the right side along with the Details and Settings.

   The results include:

   - The time it was run, how long it took to run, the Execution and project status.
   - The Detection Categories
   - Agent details
   - Verbose Output

## Using the Event Viewer for integration data

The Event Viewer displays your integration's data in JSON formatted results for items detected during a
project's run.

!!!danger Required
An integration must be configured on the [BAS Integrations page](/settings/bas_integrations/)
(Settings -> BAS Integrations) in order to use the Event Viewer.
!!!

Below are the high-level steps to view your integrations data in the Event Viewer.

1. Install a [BAS agent](/bas/management/agents/).

2. Navigate to [Run page](/bas/projects/run/) and select your agent.

3. [Run](#running-a-project) the project. Then:

   - **A.** Select the *History* tab.
   - **B.** Select a procedure for the historical run.
   - **C.** Then select its *Run* tab in the right, lower section of the page.
   - **D.** View the **Event Viewer** button.<br><br>

   ![The Run page and Event Viewer button](/static/bas/projects/run_page_event_viewer.png)

4. Select the **Event Viewer** button to display the Event Viewer screen and select your integration's tab to view
its output in JSON format.

   ![Even Viewer results](/static/bas/projects/event_viewer_results.png)

## Add or edit data sources

If you have not yet added data source information for your integration, you can add it in the *Complete Data Source*
field group and rerun the project to view results.

1. Select each desired integration tab to set the log viewing time, the detection name, and the data source.

   ![Even viewer new row](/static/bas/projects/event_viewer_add_row.png)

2. Add multiple data sources as desired (by selecting **Add Row**), and select **Review** and then **Save and Close**
when done adding or editing the data source.

3. Run the project, or follow the steps described above for a new integration and then run the project, to
view the integration data in the Event Viewer.

!!!info Note
You may need to wait a minimum of 15 to 30 minutes for integration detection results to display after a project's
run completes.
!!!