Dashboard IRIS History Monitor
Hi, everyone!
I want to share a personal project that started with a simple request at work:
Is it's possible to know how many Caché licenses we are using?
Reading other articles here in the community, I found this excellent article by David Loveluck
APM - Using the Caché History Monitor
https://community.intersystems.com/post/apm-using-cach%C3%A9-history-monitor
So, using David's article, I started using Caché History Monitor and to show all that information.
When facing the question: Which cool tech should I use?
My decision was CSP, simple and powerful, so the customer that I'm working for can realize that Caché it's more than just MUMPS/Terminal.
After creating the pages to show the history of Licensing, Database Growth, and CSP Sessions, I've decided to create a new design for the System Dashboard and Processes page.
Everything works great with my Caché instance.
However, how about IRIS?
Following the article by Evgeny Shvarov
Using Docker with your InterSystems IRIS development repository
https://community.intersystems.com/post/using-docker-your-intersystems-iris-development-repository
I dockerized and put the code on GitHub, so now, everyone can try with a few steps.
How to Run
To start coding with this repo, you do the following:
1. Clone/git pull the repo into any local directory$ git clone https://github.com/diashenrique/iris-history-monitor.git
2. Open the terminal in this directory and run:$ docker-compose build
3. Run the IRIS container with your project:$ docker-compose up -d
How to test
Open the browser and go
Ex.: http://localhost:52773/csp/irismonitor/dashboard.csp
The username _SYSTEM can run the dashboard and the other features.
System Dashboard
System Dashboard shows the following items:
- Licensing
- System Time
- Application Errors
- Cache Processes
- CSP Sessions
- Lock Table
- Journal Space
- Journal Status
- ECP AppServer
- ECP DataServer
- Write Daemon
- Cache Efficiency
- Serious Alerts
The line charts widgets plot a point every 5 seconds
System Menu
System Processes
Processes Filters
Use different filters to achieve the result that you need. You can also use Multiple Sorts, pressing Shift + clicking on the column header. And even export the data grid to Excel!
History Monitor
The History Monitor for CSP Sessions and Licensing shows the information between three sections:
- Every 5 Minutes
- Daily
- Hourly
Database Growth only shows Daily information.
The history pages share the features below:
Date Range Picker
The default value is "Last 7 Days."
Chart / Data Table
On the top right of every each section, there are two buttons (Chart/Data Table)
The Data Table shows the information that creates the chart, and you can also download in Excel format.
The excel shows the same format, content, and group defined in the CSP.
Zooming
All charts have the Zoom option to visualize the information with more details.
Average and Maximum
For the Sections Hourly and Daily, the charts show Average and Maximum values.
AVG
Max
Enjoy!