Caché Monitoring Guide - InterSystems Documentation

Using the Caché Monitor
3.2 Caché Application Monitor
The Caché Application Monitor (Application Monitor) monitors system- and user-defined metrics. It is an extendable Caché
utility that monitors the system for performance and system data, generates alerts, handles notifications, and generates and
maintains a persistent repository of all such data. It is a modular system that allows instances of the monitor to run in multiple
namespaces concurrently. Each instance of the Application Monitor lets you do the following in each namespace in
which it is activated:
1. Register system classes in the local namespace.
2. Activate the system- and user-defined classes you want to monitor. For user-defined classes, you can activate only
those classes that you have created in the local namespace; that is, if you created a user-defined class in the USER
namespace, you can only activate that user-defined class in the USER namespace.
3. Start an instance of the Application Monitor (%MONAPP) in the local namespace. When an Application Monitor is
started in a local namespace, it searches for all classes that have been activated and, for each activated class, it creates
sample data in local namespace globals. Monitor metadata is kept in globals ^ISCMonitor():
^ISCMonitor("Monitor","AppInterval")=300
^ISCMonitor("Monitor","Interval")=10
^ISCMonitor("Monitor","Metric","%Monitor.System.Dashboard","Active")=1
^ISCMonitor("Monitor","Recipients")=""
^ISCMonitor("Monitor","SmtpServer")=""
Sample data is kept as persistent data for the sample class. You may view this data by invoking class methods, or via
a browser; all sample classes are automatically CSP-enabled.
This section discusses the following topics:
• Application Monitor Manager – information about managing the Application Monitor
• Caché Metrics – information about system-defined metrics
• Writing User-defined Monitor Classes – information about writing user-defined monitor classes
3.2.1 Application Monitor Manager
The Application Monitor Manager (^%MONAPPMGR) is an interactive utility that lets you perform Application Monitor
management functions. Instances of the Application Monitor Manager can be executed in multiple namespaces concurrently
with different parameters for each namespace, which enables multiple Application Monitors, each with its own activated
classes and notification options, to run simultaneously; the name of the utility is case-sensitive.
1. To start the Application Monitor Manager, enter the following command in the Caché Terminal:
USER>do ^%MONAPPMGR
2. The main menu appears. Enter the number of your choice or press Enter to exit the Application Monitor Manager:
1) Manage Application Monitor
2) Manage Monitor Classes
3) Change Default Notification Method
4) Manage Email Options
5) Manage Alerts
6) Exit
Option
The options in the main menu let you manage the Application Monitor as described in the following table:
22 Caché Monitoring Guide