Manage Health Check Dashboard

Health Check Dashboard provides a view of the health of selected Environments. Click an Environment to see the health of the Environment over the past 24 hours and any associated TECRs and TEBRs.

Set Up Health Check Dashboard

1. Environment Setup Customization

To enable Health Check Dashboard:

  1. Go to Settings  > Customization > Environments.
  2. Click Environment Setup.
  3. Click to select Enable Health Check checkbox.
  4. Click Submit.
    The yellow Your changes have been saved pop up opens and closes.
    If you click away from the Customization page without clicking Submit, your changes will not save.
    If Enable Health Check is disabled, all configured Environment scripts will have their schedule turned off so that they no longer run in the background.

2. Configure Environments

Each Environment must be configured separately in order to view the current Status and History on the Health Check Dashboard. See Add or Edit Environments for configuration instructions.

*NEW* Health Check Test Script Template

Use the template below for Health Check scripts.

 

Insert your test script inside the Promise between the following statements:

console.log('Beginning EnvironmentCheck test');

//Insert test script here

console.log('Completed EnvironmentCheck test');

IMPORTANT:

In order for your test result to be recorded in the Health Check Dashboard, you must resolve the Promise with a boolean True or False:

  • resolve(true) = your environment is ONLINE
  • resolve(false) = your environment is OFFLINE

If your script triggers the Reject path, either intentionally or through an uncaught throw, this will result in a status of “UNKNOWN” as the outcome of the test cannot be confirmed if the script fails to execute:

  • reject(true) = the status of your environment is UNKNOWN

*NEW* Sample Scripts

The following test scripts have been created to illustrate how to insert your test script into the template and return a test result successfully. 

Test Plutora SSO Login using Selenium

 

Test Plutora’s API using JS

 

*NEW* Chrome Driver

Health Check Dashboard uses NodeJS Selenium NPM. All scripts must reference, spin up, and exit Chrome Driver, which contains a subset of Selenium functions.

In order to execute Selenium javascript within your test script, we have pre-built the selenium webdriver to run on Chrome only. To enable the Selenium functionality within the script you must reference the prebuilt ‘chromeDriver’. For example:

  • let driver = chromeDriver.driver;

Only the following objects from the Selenium Webdriver have been whitelisted:

  • Driver
  • Until
  • By
  • Condition
  • Session
  • WebElement
  • WebElementCondition
  • WebElementPromise
  • Browser
  • Button
  • Key

 

Trigger Tests Remotely

If you have an existing suite of automated tests that you wish to use instead of developing new test scripts, you can modify the template to connect to the server where these tests are hosted and trigger them remotely, or trigger the execution of these test scripts through tools like Jenkins.

A sample script for triggering tests remotely is coming soon.

 

Update Environment Health Check Status via External APIs

If you wish to host and execute your test scripts outside of Plutora, you can modify your scripts to update the Health Check dashboard at the end of each execution using our external APIs. 

 

Manage Health Check Dashboard

To manage Health Check Dashboard:

  1. Go to Environment > Health Check Dashboard.
    If Health Check Dashboard does not appear under the Environment menu, enable it in Environment Setup.


    Health Check Dashboard displays nothing when first opened but remembers the previously selected filter from then on. 
  2. Click Select Filter. Available filters are:
    • Environments: Select the Environments to display one by one.
    • Environment Groups:
      • Display all the Environments in the selected Environment Groups.
      • Environment Groups are listed in the left-hand column and their Environments are visible in the same row.
    • Systems:
      • Display all the Environments in the selected Systems.
      • Systems are listed in the left-hand column and their Environments are visible in the same row.
  3. Type the search text.
  4. Press the Enter key on your keyboard.

    • The selected Environments display.
    • The colors mean:
      • Light gray: No data to display. The Environment has not been configured or the configured script has not yet run.
      • Dark gray: The script has run and failed. Check and rerun the script to get the status.
      • Green: The script has run and the Health Check has passed.
      • Red: The script has run and the Health Check has failed.
  5. Click an Environment to open the Environment health check details for the last 24 hours pop up.
  6. Click to open the blue-linked TECRs and TEBRs.
    If the Environment is down, the dates of on the TECRs and TEBRs may give a clue to what brought it down.

 

Back to the top arrow

Be the first to find out about new features. Subscribe to the Release Notes email. Subscribe Now

Was this article helpful?

0 found this helpful.