Caché Monitoring Guide - InterSystems Documentation

Examining Routine Performance Using ^%SYS.MONLBL
2.) Memory Requirements
Enter the number of your choice:
• Enter 1 to begin the dialog to provide the appropriate information to Start Monitoring.
• Enter 2 to calculate an estimate of how much memory a collection needs before actually starting the monitor. See the
Estimate Memory Requirements section for details.
7.1.1 Start Monitoring
You can select which routines and processes to monitor and which metrics to collect. These characteristics of the collection
remain until you stop the monitor. You provide monitoring collection information to the routine in the following order:
1. Routine Names – Enter a list of routine names to monitor. You can only select routines accessible from your current
namespace. Do not use the leading ^ when entering the routine name; the names are case-sensitive. You may use
asterisk (*) wild cards to select multiple routines. Press Enter twice after entering the last routine name to end the list.
2. Select Metrics to monitor – Enter the number of your choice of what type of metrics. The default is 1 for
minimal metrics.
Select Metrics to monitor
1) Monitor Minimal Metrics
2) Monitor Lines (Coverage)
3) Monitor Global Metrics
4) Monitor All Metrics
5) Customize Monitor Metrics
Enter the number of your choice:
A description of what metrics are included for each option follows:
• Minimal metrics — Monitors the metrics described in the following table.
Metric
Metric#: 34 - RtnLine
Metric#: 51 - Time
Metric#: 52 - TotalTime
Description
Number of times a routine line is executed
Clock time spent in executing that line
Total clock time for that line including time spent in subroutines
called by that line
Note:
Total Time for Recursive Code
When a routine contains recursive code, the TotalTime counter for the line which calls back into the
same subroutine only records the time of the outermost call, which should be, in most cases, the actual
time to run the recursive loop. Prior Caché releases accumulated the time for multiple iterations of the
same code reporting times that may have seemed too large.
• Lines — Monitors the number of times a routine line is executed (Metric#: 34 - RtnLine).
• Global metrics — Monitors several global metrics (Metric# 1-26,34-36,51,52).
• All metrics — Monitors all available metrics.
• Customize metrics — Allows you to create a customized list of metrics to monitor. You can select any of the
standard performance metrics supported by the %Monitor.System package classes. Enter a question mark () when
prompted for the metric item number to see a list of available metrics. For example:
58 Caché Monitoring Guide