Caché Monitoring Guide - InterSystems Documentation

Monitoring Caché Using BMC PATROL
When Yes, the connection to PATROL starts automatically whenever Caché starts up. The default is No. When you
edit this setting, the Caché end of the PATROL interface immediately stops and starts.
3. Click Save.
PATROL Arguments — From the same [System] > [Configuration] > [Monitor Settings] page of the Management Portal, you
can also set the following PATROL settings:
• Patrol Top Processes to Monitor — Number of processes displayed in the Process Status window on the PATROL
console. This window shows the top processes as sorted by global or routine activity. The default number of processes
is 20. A value of 0 tells the PATROL utility to stop calculating the top processes, potentially saving significant work
on systems with many processes. The valid range is 1–10000 processes.
• Patrol Display Mode — Controls how the monitoring data is displayed in the PATROL console. The default option is
Total. Options are as follows:
– Total displays the total counts since the collection was started.
– Delta displays the count for the last collection period.
– Rate displays a calculated count per second.
• Patrol Collection Interval Seconds — Number of seconds between each time Caché collects data and makes it available
to PATROL. The default is 30 seconds; the valid range is 1–900 seconds.
By default, PATROL uses standard Caché system counters to generate metrics (for more information see Caché Metrics
Used with BMC PATROL in this appendix). However, you can activate the extended counters, which use more system
resources than the standard counters. To change the counters, use the following function before starting the ^PATROL
routine:
$$Light^PATROL(n)
where n is:
• 0 — PATROL uses extended counters
• 1 — PATROL uses standard counters (“light” version)
To see which version is currently specified, in the Caché Terminal, enter the following command:
%SYS>write $$Light^PATROL()
A.1.2 Caché PATROL Routine
Caché provides entry points to the ^PATROL routine to start and stop PATROL.
To start PATROL:
Do start^PATROL(display,process,timer)
The arguments are described in the following table:
102 Caché Monitoring Guide