isc-perf-ui

Downloads4
Subscribe
1
Bookmark
2
This application is not supported by InterSystems Corporation. Please be notified that you use it at your own responsibility.
Details
Releases
Reviews
Issues

What's new in this version

Added:

  • Added support for React project build/deployment

Changed:

  • Refactored Angular-specific functionality into general-purpose/generic base class + toolset-specific implementations for Angular and React

isc.perf.ui

isc.perf.ui is a simple Angular UI and accompanying REST API for interacting with the line-by-line monitor (otherwise accessed via ^%SYS.MONLBL) and reviewing results.

Note that this is appropriate for use in development/testing environments, NOT production.

Beyond its intended use, this project also serves to demonstrate three other projects :

Getting Started

Note: a minimum platform version of InterSystems IRIS 2018.1 is required.

Installation: ZPM

If you already have the ObjectScript Package Manager, installation is as easy as:

zpm "install isc.perf.ui"

Notes on Security

If there is not public read permission on the namespace-default routine database for the namespace in which isc.perf.ui is installed, a role will be created that has read permission on that database and assigned as an application role to /csp/{namespace}/monlbl-viewer/, which provides unauthenticated access to the Angular UI. The REST API requires %Development:USE.

User Guide

After install isc.ipm.js, the package manager output will include a line like:

[isc.perf.ui]   Activate SUCCESS
You can view the Line-by-Line Monitor at: http://your.ip.address:52773/csp/USER/monlbl-viewer/

Navigate to that URL in a browser and log in with IRIS credentials.

Login

The monitor will (presumably) be stopped initially. To start the monitor, click the "Play" button.

Monitor Stopped

Select the routines and metrics to monitor. The wildcard syntax is the same as in ^%SYS.MONLBL. Once selections are made, click "Start Monitor."

Start Line-by-Line Monitor

Once running, the status will update. Clicking the "pause" button will pause the monitor (and "resume" will become an option). Selecting a routine will show its data. Clicking the "stop" button will stop the monitor and discard counts. Clicking the "refresh" button will refresh the currently-displayed metrics.

Monitor Running

When a routine is selected, clicking on a column header will sort by that column descending.

Routine Selected

Clicking on a line of code will highlight it and jump to it in line order. Click it again to remove the highlighting.

Line highlighting in context

Support

If you find a bug or would like to request an enhancement, report an issue. If you have a question, feel free to post it on the InterSystems Developer Community.

Contributing

Please read contributing for details on our code of conduct, and the process for submitting pull requests to us.

Versioning

We use SemVer for versioning. Declare your dependencies using the InterSystems package manager for the appropriate level of risk.

Authors

See also the list of contributors who participated in this project.

License

This project is licensed under the MIT License - see the LICENSE file for details.

ZPM installation
zpm "install isc.perf.ui"
Rating
0 (0)
Category
Developer Environment
Works with
InterSystems IRIS
Tags
Info
Version
1.1.0
Last updated
2022-08-08
Repository
Open
Documentation
Open
License
Link