Navigation:  Remote Monitoring and Management > Proactive Monitoring > Windows Server and Workstation Monitoring > 24x7 Checks >

Script Check

Previous pageReturn to chapter overviewNext page


The Script Check allows the user to upload, deploy and run your own scripts as a 24x7 Check. Script Checks can be added to all servers and workstations running Agent v8.2 or later and setup easily from the Dashboard.


Add a Script

To add a script to the Dashboard go to Settings, Script Manager, select New and in the Script Manager dialog enter the required Description, Usage, Default Timeout, Operating System, Script Type [Script Check or Automated Task (Windows or Mac)] then upload the Script. Further information on these steps is covered in the Script Manager section.


Check configuration

The check is configured via the Dashboard or Advanced Monitoring Agent:



Log on to the Dashboard, select the target device in the north pane of the Servers or Windows tab then choose the Checks tab.



From the Add Check drop-down go to Add 24x7 Check, Script Check.

Select the script.To make navigation through the Add Script Check dialog easier Scripts are grouped by function in expandable and contractable sections for both System (Application Control, Exchange, Security etc) and User Defined* Scripts: with the option to Search Script to display those Scripts meeting the search criteria. Click on a Script to view its Description (where available) then Next to configure.

Configure the Script Parameters settings, including the Command Line for custom scripts (where required)

Add the Script timeout period in seconds (1 - 150 seconds)



Select the required Script Check in the south panel then of the Checks tab then from the Checks drop-down Edit Check, configure as required.



Select the required Script Check in the south panel of the Checks tab then from the Checks drop-down Delete.

Enter the password of the user you have logged on to the Dashboard under to confirm deletion.

Link Check to On-Check Failure Automated Task

We have included the ability to run a Automated Tasks when a Check fails to, for example automatically dealing with cause of the failure, and with Dashboard 6.21 we have simplified its configuration process by incorporating the option to assign an On-Check Failure Automated Task when adding or editing a Check in the Checks tab for the Dashboard. Further information on this process is available in the section: Link Check to On-Check Failure Automated Task



Whichever management option is selected click OK to apply changes.


Dashboard: Add or Edit Check Behaviour

Pre-Agent 10

When a Check is added or edited from the Dashboard the new settings are downloaded to the Agent the next time it communicates back to the Dashboard and applied when all of the Checks of that frequency type next run.

From Agent 10

Any changes to the Check actioned from the Dashboard are applied immediately with the Check automatically re-run when the settings are received. This ensures that the users can almost instantaneously see the effects of any Check addition or modification; with the time this individual Check ran reflected in its Date/Time column.

Please note that there may be a delay when adding a new Check or where there was a change to the Script as this must first be downloaded to the device before the Check can run.

Please be aware that due to this improvement, the Date/Time may differ between Checks running at the same frequency.


Add Script Check

Choose Script



Configure Script





Windows Monitoring Agent - Test Check

Although the Script Check cannot be added or edited on the Agent, there is the option to immediately run the script. Once the check has synchronized, simply navigate to the Script Check tab under the 24x7 section, highlight the required script and select Test Check.  The Agent also contains information on the Script Check including the script Description, test parameter Arguments, the script’s Language and Time Out period.





Further information is available in Script Management with a list of the Default Script Checks in the following section.


Dashboard v5.38 introduced the facility to suppress Script Check Alerts until the Check failures exceed the specified number of consecutive failures.


To prevent the removal of the leading 0 in arguments, from Agent 9.5.4 any part of the command that begins with 0 is wrapped in \ so the full argument is preserved when executed or processed.


Script argument handling from Windows Monitoring Agent 9.12.2

Please be aware that Windows Monitoring Agent v9.12.2 introduced improvements to the handling of the script arguments entered in the Script Parameters, Command Line field of the custom Script Check dialog. From Agent 9.12.2 any specified arguments are passed to the script exactly as they would be if entered directly on the device itself.



Although we have provided the mechanism to run your own scripts on your servers and workstations. We are not responsible for custom scripts made or used in conjunction with this product. We are not liable for loss incurred from system, hardware or data loss. It is the customer/developers responsibility to verify the integrity, actions and impact of any custom scripts.