Home Applications Metrics example

Metrics example

This application is not supported by InterSystems Corporation. Please be notified that you use it at your own risk.
3.5
2 reviews
0
Awards
164
Views
0
IPM installs
0
0
Details
Releases
Reviews
Issues
Pull requests
Articles
Simple example of collating database and license metrics

What's new in this version

Including R Cemper's Docker updates

Intersystems Database Metrics example

This is a self contained class that can be run from the Intersystems Task Scheduler which records peak usage details for databases and licenses built up throughout the day and retaining 30 days history.

To schedule the task to run every hour:
d ##class(Metrics.Task).Schedule()

You can also specify your own start time, stop time, and run interval:
d ##class(Metrics.Task).Schedule(startTime, stopTime, intervalMins)

Metrics are stored in ^Metrics in the namespace that the class resides in/is run from.

^Metrics("SystemMetrics","Databases",{database},+$h,"usage",{metric})={value}  
   "Available"     = lowest peak space available in the database (KB).  
   "Used"          = peak space used in the database (KB).  
   "Size"          = peak size of the database (KB).  
   "Free"          = lowest peak percentage free space of the database (%).  
   "MaxSize"       = peak maximum size paramater of the database (KB).  
   "DiskFreeSpace" = peak space available on the disk/volume for the database (KB).  
   "DiskSize"      = peak total size of the disk/volume for the database (KB).  
   "MaxFree"       = lowest peak percentage free space for the database based on MaxSize or DiskFreeSpace if not set (%).  

^Metrics("SystemMetrics","License",+$h,{metric})
"Customer" = customer name on the license key.
"Expires" = expiry date on the license key.
"Total" = peak total units on the license key.
"Used" = peak license units in use.
"Available" = lowest peak license units available.

Docker

Prerequisites

Make sure you have git and Docker desktop installed.

Installation

Clone/git pull the repo into any local directory

$ git clone https://github.com/rcemper/PR_Database-Metrics.git   

to build and start the container run

$ docker compose up -d && docker compose logs -f

A deom Task is prepared. It’s named docker
http://localhost:42773/csp/sys/op/%25CSP.UI.Portal.TaskInfo.zen?$ID1=1000
It is ready for you to adjust it to your needs.

To open IRIS Terminal do:

$ docker-compose exec iris iris session iris 
USER>

or using WebTerminal
http://localhost:42773/terminal/

To access IRIS System Management Portal
http://localhost:42773/csp/sys/UtilHome.csp

Made with
Version
1.0.110 Jun, 2024
Category
Technology Example
Works with
CachéInterSystems IRIS
First published
09 Jul, 2019
Last checked by moderator
07 May, 2024Works