Caché Monitoring Guide - InterSystems Documentation

A
Monitoring Caché Using BMC PATROL
This appendix describes the interface between Caché and BMC PATROL.
BMC PATROL is a tool for monitoring and managing various software systems. Caché supplies PATROL extensions so
that you can monitor and collect information about Caché.
This interface allows users to monitor metrics of one or multiple Caché systems from the PATROL Console. The interface
requires that the PATROL daemon is running on the Caché system to collect and output the metric values and that the
Caché knowledge module files (*.km) are loaded into the PATROL Console to read and display these values.
This appendix provides information on the following topics:
• Running PATROL with Caché
• Caché PATROL Knowledge Modules
• Caché Metrics Used with BMC PATROL
A.1 Running PATROL with Caché
Run the ^PATROL Caché ObjectScript routine on each Caché installation that you want to monitor using the start and
stop entry points, or by setting it to automatically run at system startup.
The routine starts a background process that outputs metrics to a file, patrol.dat, located in the Caché manager’s directory
install-dir\Mgr (where install-dir is the Caché installation directory). The file is rewritten for each collection period, so the
file size is static. The file also includes an identifying header and a time stamp so that the PATROL Console can determine
that it is active and up-to-date.
There are two ways to run and configure PATROL in Caché:
• Configure PATROL Settings
• Caché PATROL Routine
A.1.1 Configure PATROL Settings
Automatic PATROL Startup — You can set an option to automatically start the PATROL daemon at Caché startup using
the Management Portal:
1. Navigate to the [System] > [Configuration] > [Monitor Settings] page of the Management Portal.
2. Click Yes in the Start Patrol at System Startup setting box.
Caché Monitoring Guide 101