EV Observe - Synthetic Monitoring Module - Console

Last modified on 2023/09/28 16:50

The Console is the tool for managing the local machine and all child machines. It allows you to:

  • Supervise and monitor the entire Synthetic Monitoring  infrastructure from the main Console, or from the local machine if running locally.
  • Get a screenshot of a Windows session, or components (Player, Recorder).
  • Modify machine properties, and add users.
  • View on going tasks and tasks on the local machine.
  • List scenarios on the local machine, execute and delete them, as well as send them over the WCF network.
  • Manage licenses.
  • Create and modify database access.

It is accessible from the Console menu of the Scripts Manager tool or directly via the Systray.

Description of sub-menus


The Explorer sub-menu displays all the machines that are part of the model. For each machine, you can access its properties and users. You can also display the remote machine screen in real-time.

          Explorer tab.png

List of machines

  • Icon displayed before the machine name:
    • A green icon indicates that the machine is present in the model and is connected and accessible for all of the actions.
    • A red icon indicates that the machine has disappeared from the model and is disconnected (off machine, cable disconnected, etc.).
  • Click on a machine in the tree to display the properties (central panel) and the screen in real-time (right panel) of the selected machine.
  • Open the tree for a machine to display the list of sessions.
  • Right-click on the name of a machine or a session for accessing actions via a contextual menu.

List of options for a machine
       Explorer tab - Machine contextual menu.png

  • The remote machine modules appear at the top of the contextual menu.

example  xSession, Console, Recorder, Player modules.

  • Open RDP Session: Open a session RDP/RDS on the remote machine. Then, you will be asked the name of the user and the resolution of the RDP/RDS session.
           Explorer tab - Machine contextual menu - Open RDP option.png
  • Stop Service: Stop the xService on the remote machine.
  • Reboot Machine: Restart the remote machine.
  • Ping Machine: Ping the IP address or NetBIOS name of the remote machine.
  • Modify Parent Machine: Access the configuration of the parent machine.
  • Refresh Model: Refresh the list of machines.
  • Send Message: Send a message to the remote machine.
  • Exec Dos Command: Send a DOS command to the remote machine.
  • Remote Process List: Display the process list on the remote machine.
  • License: Display licenses assigned to the remote machine. You can restore or assign a license to the machine.
  • Version: Display the Synthetic Monitoring module version.

List of options for a session
       Explorer tab - Session contextual menu.png

  • Load Script: Load a scenario on the remote machine. The list of the available scenarios appears.
  • Load Recorder: Load the Recorder on the remote machine.
  • Stop JobQ: Pause scheduled scenarios.
  • End Session(s): End ongoing sessions of the remote machine.
  • Open RDP: Launch a RDP/RDS session on the remote machine with the credentials and the graphic resolution used by the session.
  • Browse: Activate the interaction with the desktop of the remote machine. This is a nickname RDS.
  • Exec Dos Command: Send a DOS command to the remote machine.
  • Send Keystroke: Send keystroke to the remote machine.
  • Remote Process List: Display the process list on the remote machine.

Properties of the machine

          Explorer tab - Machine properties.png

The following information can be changed.

  • Location > City / Country / Office: Agent location. You can use this property for reports.
  • Machine:
    • MachineGroup: Group in which the machine is located. You can use this property for aggregates.
    • MachineName: NetBIOS name of the machine.
  • BatchCpuLimit: Property used to prevent a scenario from being launched if the machine's CPU utilization exceeds the specified value.
    • Value between 0 and 100 (by default, 0).
    • You can use this property to avoid saturating the Injectors.
  • PlayersLogPath: Directory for storing logs when metrics are saved with CSV mode option.
  • SnmpAlternativeAgentIP: IP address alternative for the SNMP service if a NPS customer is already active on the remote machine.


List of users with access to the machine.

You can add, delete and modify users.


The Jobs sub-menu displays the machine's task history: tasks linked to the selected machine, time of the next iteration, status of previous iterations, etc.

          Jobs tab.png


The Manage sub-menu displays scenarios available on the selected machine.

You can select scenarios and send them to the parent machine and/or child machines  - Open url.png See the procedure

          Manage tab.png

Description of the icon bar of the Machine(s) Scripts list

  • Reload the list of scenarios.
  • Display scenario properties. You can modify them and integrate them into the next iteration.
  • Remove the selected scenario.
  • Load the selected scenario.
  • Reset the locks of the Dataset file.


The License sub-menu allows to manage the Synthetic Monitoring module licenses. Demand and import licenses is done through the control panel.

          License tab.png

  • License Details: Display the license status for the machine (Permanent, Temporary) and the number of licenses available and/or used.
  • Features: Display the type of licenses activated for the machine (Player, Recorder).
  • Manage Licenses: Display the list of the licenses used by machines. You can delete a license from one machine and reassign it to another.
  • Action buttons:
    • Send License Request: Generate and send the license file (extension .itx) for asking a new license.
    • Import New License File: Import and activate the license file (extension .itx) receive from EasyVista Support.
    • Update License File: Import and active the license file (extension .itx). New licenses are added to the existing, active license file.
    • Clear License: Delete the license file (extension .itx).


The Database sub-menu allows to configure the database which contains all information of the Synthetic Monitoring module.

   Supported bases: Microsoft SQL 2008 to 2016, including SQL Express 2008 to 2016, Standard and Enterprise.

          Database tab.png

  • Configure: Allows to configure the database by specifying the name and login information.
  • Clean: Allows to clean the database using criteria such as Agent, Script, Date.
  • Action buttons:
    • Connection Test: Test the connection to the database.
    • Mail Configure: Configure the mailbox in the database.
    • Data Links Utility: Display Microsoft utility to configure database access.
    • Create Tables: Once database access has been configured, you can create tables and SQL procedures.
    • Re-import Stored Procedures: Re-import stored procedures.
    • Re-index Tables: Re-index various tables.


The Monitoring sub-menu allows to configure the alerts related to Agents and scenarios to ensure that your infrastructure is running properly.


An alert can be sent if one of the machines is disconnected, such as a machine off or a disconnected Ethernet cable.

          Monitoring tab - Agents.png

  • A red icon is displayed for the machine on the Console when the error occurs.
  • When the machine reconnects, an alert is sent indicating a return to normal.
  • You can set the parameters of the alert in the Mail Configuration sub-menu.


An alert can be sent if the consistency of the number of database entries based on the schedule is not correct.

example  A scenario that runs every 5 minutes implies an entry in the database every five minutes. An alert is sent if there is only one entry in the database.

          Monitoring tab - Scenarios.png

  • MachineKey: Name of the machine.
  • MachineName: NetBIOS name of the machine.
  • ScriptName: Name of the monitored scenario.
  • NbMissedIterationsAlert: Number of missing entries in the database to send an alert.
  • NbMissedIterationsReboot: Number of missing entries in the database before forcing a machine reboot.
  • NbSucessivesErrorsReboot: Number of successive errors before forcing a machine reboot.


  • To active these features, you must active the Logs to Database option in the scenario properties.
  • To force a machine reboot, you must active the Auto Logon function for the machine.


The Graph sub-menu displays response time graphs for scenarios running on the selected machine over the last 24 hours.

          Graph tab.png

  • The histogram shows the response time for each iterations in green or in red in case of error.
  • Metrics are limited to the last 24 sliding hours. You can zoom in the graph using the mouse.
  • You can select a machine, a scenario and a transaction.
  • Holes may appear in the graph when a transaction has not been executed.
           Graph tab - Hole for transaction.png
  • Click on an error displayed in red to display a copy of the screen in error. You will also see the expected image as well as the date and time the scenario was executed.
           Graph tab - Error screen.png


   Only if Load Testing features are active.

The Appsload sub-menu allows to open automatically RDP/RDS sessions on the selected machine via the LaunchPad tool.

          Appsload tab.png

  • Configuration:
    • Nb of Sessions: Number of remote sessions to be opened.
    • Delay(s): Time between each session.
  • Interface used: Framework or MsTsc.
  • Resolution: Screen resolution for the remote session.
  • Smart Size: Check the box if you want remote sessions to be automatically resized to display their full size.
  • Authentication:
    • Selected customers: Select this option if you want to select credentials.
    • Manual: Select this option if you want credentials to be provided by the user when opening the session.
  • Action buttons:
    • Load Config File: Load a configuration file for opening remote sessions.
    • Save Config File: Save the configuration options in a file.
    • Connect: Connect to the remote sessions.
    • Open Launcher: Open the LaunchPad tool.
    • Allow Multiple User RDS: Check the box if you want to open multiple RDP/RDS sessions with the same credentials.
    • Charts: Display load graphs in real-time or over a limited period.


The Errors sub-menu allows to view the last five errors for each scenario linked to the machine.

          Errors tab.png

  • Error Screenshot: Display a copy of the screen in error. The options below the screen allow you to select the expected image and the image found with the accuracy rate.
  • Slide Desktops: Allows you to replay the scenario offline until the error occurs. You can check whether the various actions preceding the error have been played correctly.
  • Slide Objects: Allows you to replay the scenario offline until the error occurs. Only Windows objects are displayed.

   To active this feature, you must active the Tracking Object option in the Recorder.


The Properties sub-menu displays the machine configuration.

          Properties tab.png

  • User Logon:
    • Default Login / Password / Domain: Credentials used when the Auto Logon function for the machine is active.
  • Session in Startup: Check the box if you want to launch automatically the Synthetic Monitoring Session (xSession) when the Machine starts.
  • Sessions Password: Password to unlock the xSession (by default, seven).
  • Machine Key: Name of the machine key.
  • Parent Machine Name / IP: You can change the parent machine to associate the Agent with a new machine.
  • WCF connection: WCF connection with the parent machine.


The Report sub-menu displays logs of malfunctions. You can recover all of the logs of the machines for analysis.

          Report tab.png

  • Action buttons:
    • View Machine Log: Display the logs of the selected machine.
    • Get Manual Report: Recover logs of the selected machine as a zip file.
    • Get Full Report: Recover logs of all machines as a zip file.

Edit XML

The Edit XML sub-menu allows to read and modify XML configuration files, which can also be encrypted.

          Edit XML tab.png


How to start the Console from the Systray

1. Right-click on the Systray icon Systray icon - Synthetic Monitoring - xSession on.png.

          Systray icon bar.png

2. Select the Show Console option in the menu.

The Console window will appear.
         Console from Systray.png

Send scenarios between machines

1. Launch the Scripts Manager tool.

2. Go to the Console > Manage menu.

3. Select the machine on which scenarios are recorded.

  • The list of scenarios available on the selected machine will display in the Machine(s) Scripts list.
  • The parent machine and the list of child machines will display in the Send to list.

4. In the Machine(s) Scripts list, select the scenarios you want to transfer.

5. In the Send to list, select the recipient machines.

6. Click Send Selected Scripts.

Powered by XWiki © EasyVista 2024