1. Help Center
  2. Getting started

Getting Started with AppsWatch


Evaluation can be done with all components on your PC or with robot on a different PC.


A brief overview of the product

AppsWatch uses robots called ScenarioStations to simulate users accessing your application from the front-end on a continuous basis from key locations.  These robots report back whenever your applications are not performing as they should. This allow you to be proactive as you will be alerted of issues before users are affected.

There is no coding necessary to set up your scripts.



ScenarioBuilder: Code-free engine for creating scenarios/scripts of business processes. 

Robots (ScenarioStations):  Each robot behaves as user executing the scripts continuously at set intervals. These are installed on PC’s or servers at key locations that you want to monitor your processes from.

The Base:  Where you manage and schedule monitors:

  1. Create and schedule application monitors
  2. Manage Alerts
  3. Create and view trend reports



Install the Base, ScenarioStation, and ScenarioBuilder on the same PC/server.

Choose "Complete install for all modules." option.

The installer also lets you select which modules to install on the PC/server..

Note: Make sure the PC/server has access to the application you need to test.


Install Sessions Controller. (allows you to remotely create a script on the environment where your robot will ultimately run)

Install where you want to script from.  



Before you start your scenario, know your application

Before you start recording and building the script, go through the process on your application manually and understand what steps you will need the robots to do. (Example: Log into an application, look up a record, and log out).


Set up ScenarioBuilder Sessions using Sessions Controller: 

  • Open Sessions Controller
  • Click on “Add ScenarioBuilder session”’
  • Enter username and password for the machine where ScenarioBuilder is installed, fill out the necessary settings (desktop resolution, color depth, font smoothing,...) and put the host name of the machine.
  • Click on Submit.
  • After “Connection created successfully” message appears, then click on “Start session”.
  • This will open the ScenarioBuilder session.

Build your Scenario:

  • Open ScenarioBuilder.
  • Enter a name for your project.
  • Build a scenario by clicking the “New” button on the top left to create your Scenario.   
  • Click on the "Start Recording" option

Now begin going through the process on your application. ScenarioBuilder will be listing the steps in a script as you go. (open app, login, run process, log out)

When you are done, click on "Stop" button, ScenarioBuilder will go back to the main window. You will see the recorded steps as individual actions.

Afterward, you can edit the script, break it into subscripts, update any actions or images, add transactions, etc.

(Later, you can divide and organize your scripts to make them more sophisticated and easier to edit, loop certain parts, etc.  To learn more, see this article.)


Play and Validate your Scenario

Once the scenario is built, run it by clicking on the “Play” button. Run multiple iterations to make sure that the scenario was finished correctly and everything is ready for the start of the next iteration.

If the scenario runs to the end without any errors and runs multiple times without errors, it is valid to use in monitoring.   If the scenario aborts on an error, debug the scenario with viewing the failure screenshot and run it through a simple test again.

Set the reference time and save your scenario.

Send your Scenario to the Base:

Send your scenario to the Base by clicking “Send Scenario”.   

(See the IP address/hostname of the Base that it is connected to at the status bar of ScenarioBuilder.)


Launch AppsWatch base

Open a browser to access Controller (by typing in IP address or hostname of the machine controller is on followed by and the port number, For example, localhost:8888 )

Log in to the Base (default is username: admin, password: admin)

Set up user account details, (it is only required for the first time logging in), submit and log in again.



Launch AppsWatch Base.

Click on "Applications" tab

You will see the registered ScenarioStations. 

Click "Application Manager” and click “New Application"

Select a group to set a frequency. (i.e. Check_5min)

Next, enter a name for your application.

Then, select your desired scenario and station.

Click on “Submit”.

*A service will be created automatically for your application.

Note: To learn more about Events and Reactions, see AppsWatch User Guide.

Important: Make sure the ScenarioStation is up and running.



Click on “Show Stations” section

This section displays the ScenarioStations in “Live” mode. This mirrors the Robots desktops and you can see the scenarios being executed by the ScenarioStations.

Here you can also view each Robot log with more details.

The application will start playing on the desired station based on the defined frequency. 



Click on “Backend Monitors” tab

In the “Metrics Tree” pane on the left side of the Base, click the “Monitors” part and expand the group;

Click the application monitor to open its Stats page in a new tab.

Here you can view and analyze the results, failures, reports, etc.

If there are script failures, go back to ScenarioBuilder and fix them as needed. Resend your scenarios and execute your monitors again.


Contact us anytime for assistance!  support@automai.com.