Engines#

Engines list#

Opening page MANAGER>ENGINES will direct you to the Engines list. On this page you will find a table including all basic information on your engines. This includes

  • Name
  • Version
  • URL
  • IP
  • Core Configuration providing the status of the connection to RPS Core Admin Configuration environment (it is either empty, Connected or Disconnected)
  • Reporting providing the status of the connection with RPS Reporting environment (it is either empty, Connected or Disconnected)
  • RAM usage
  • CPU usage

The icon at the very beginning of the line gives the status of the engine: indicates an error in connection or in the link to the engine while indicates a successful connection to the engine. At the end of each line you can also find buttons to edit , delete or get more information on an engine.

Edit or delete an engine#

At the end of each row, you have the possibility to edit , delete or get more information on an engine.

  • Clicking on will prompt the window to edit an RPS Engine instance, it allows to change the name or the base URL of the engine,
  • The button gives you the possibility to delete an engine,
  • By clicking the button you will see options to be redirected to pages showing performances, reports or logs of the selected engine, this option only appears if the corresponding engine is Connected to Core configuration and Reporting.

Add a new engine#

By clicking on ADD NEW ENGINE below the table, you will be prompted for a name and a base URL. Both fields are needed to create an engine, and the name is limited to 200 characters.

Performances#

Selecting Performances from the button, you will be redirected to the performances of the engine. It consists of 6 tables with different information:

  • Cients Input Requests giving the n° of requests and the n° of transformation sequences as a function of the hour,
  • Processing of the Request/Response showing the average time of processing per request in ms as a function of the hour or of the n° of requests (scatter chart in the top right corner of the plot),
  • Core Configuration showing the average time of core configuration per request in ms as a function of the hour or of the n° of requests (scatter chart in the top right corner of the plot),
  • Transformation plotting the average time of transformation per request in ms as a function of the hour or of the n° of requests (scatter chart in the top right corner of the plot),
  • Stacked Chart showing the stacking of the three previous times giving the overall processing time per request in ms as a function of the hour or of the n° of requests (scatter chart in the top right corner of the plot),
  • Transformation Sequence giving the average time of transformation per sequence in ms as a function of the hour or of the n° of requests (scatter chart in the top right corner of the plot).

Reports#

If you click on Reports from the button, you will see a list containing the performances of sequences, providing the Sequence Name, the Max Elapsed Time, the Standard Deviation Time and the Average Elapsed Time (all in ms). You also have the possibility to filer the reports by date or by name.

Stress Tests#

The Stress Tests page allow you to create and run stress tests, to access it, click on the page name from the side menu. Templates are containers where you can store tests. On the page you will find the buttons NEW STRESS TEST and NEW TEMPLATE. You will also find a table with existing Templates/Stress tests providing information on their last run, duration and number of runs, as well as links to Show the runs results, run the test , rerun the test or stop it , get more information on the run , clone , edit or destroy the template/test. You also have the possibility to filter templates/tests by engine names or by template names.

When using the run the test with or rerun button, you will be prompted for an Engine (the field may be filled with the previously used engine) and API key and secret for the run.

Last run test information#

When clicking on Last run test information button on an already run test, you access a page with different bar charts providing further information on the chosen test. You will find charts on

  • Cients Input Requests giving the n° of requests per minute processed by RPS Engine,
  • Processing of the Request/Response showing the average time of processing per request in ms per requests (scatter chart available in the top right corner of the plot),
  • Core Configuration showing the average time of core configuration per request in ms per request (scatter chart in the top right corner of the plot),
  • Transformation plotting the average time of transformation per request in ms per request (scatter chart in the top right corner of the plot),
  • Stacked Chart showing the stacking of the three previous times giving the overall processing time per request in ms per request (scatter chart in the top right corner of the plot),
  • Transformation Sequence giving the average time of transformation per sequence in ms per request (scatter chart in the top right corner of the plot).

New Template#

The NEW TEMPLATE button allows you to create a template, a container for your stress tests defining the data to be used during the tests. While creating a new template, you need to provide

  • the name of the template,
  • the class and property names of the data instance to test,
  • an evidences set for Rights Context,
  • and an evidences set for both protection and deprotection.

Once saved, the template can be used while creating new stress tests. Templates can be deleted or edited only if no tests are associated to it and if there is no stress test running.

New Stress test#

To create a new stress test, click on NEW STRESS TEST, you will be redirected to the stress test creation page. Here you can choose a name for the test, a template to store it, and configure the test as you wish. You can choose

  • the type of the test, either exponential (increase the number of requests per minute) or linear (number of requests stays constant),
  • the mode of the test, where you select between "protect only" and "protect and deprotect",
  • the value length,
  • the number of values per request
  • the number of requests per minute in linear mode, or the increase in requests per minutes in exponential mode,
  • the total time of the test in minutes.

Once configured you can SAVE or SAVE AND RUN the test.

Stress test runs#

Clicking on "Show all runs" will get you to the list of all runs associated to a stress test. The list provides information on the runs'

  • start time,
  • duration,
  • engine used,
  • status,

You can also get more information on each run or destroy the results of the run.

Runs results#

Clicking on from the list of stress test runs will show the detailed performances of the chosen run. You will be redirected to a page with six charts showing:

  • Cients Input Requests giving the n° of requests and n° of transformation sequences per minute processed by RPS Engine,
  • Processing of the Request/Response showing the average time of processing per request in ms per requests (scatter chart available in the top right corner of the plot),
  • Core Configuration showing the average time of core configuration per request in ms per request (scatter chart in the top right corner of the plot),
  • Transformation plotting the average time of transformation per request in ms per request (scatter chart in the top right corner of the plot),
  • Stacked Chart showing the stacking of the three previous times giving the overall processing time per request in ms per request (scatter chart in the top right corner of the plot),
  • Transformation Sequence giving the average time of transformation per sequence in ms per request (scatter chart in the top right corner of the plot).