Caché Monitoring Guide - InterSystems Documentation

8
Monitoring Performance Using ^pButtons
This chapter describes the ^pButtons utility, a tool for collecting detailed performance data about a Caché instance and
the platform on which it is running. You can send the report it produces to the InterSystems Worldwide Response Center
(WRC) to help diagnose system problems. It is similar to Diagnostic Reports (see “Using the Caché Diagnostic Report”
in this guide), but focuses on performance data. ^pButtons works with all versions of Caché since release 5.0.
Note:
This utility may be updated between releases. Contact the InterSystems Worldwide Response Center (WRC) for
information about downloading pButtons_package.zip from ftp://ftp.intersys.com/pub/performance/.
You can run the profiles using the Caché Terminal (see Running the ^pButtons Utility in this chapter) or schedule runs
using the Task Manager in the System Management Portal (see Scheduling the ^pButtons Utility with Task Manger in this
chapter). In addition, you can add, modify, and delete profiles using the API that is included with the utility.
This chapter includes the following:
• Running the ^pButtons Utility
• Generating the ^pButtons Reports
• Scheduling the ^pButtons Utility with Task Manager
• Customizing the ^pButtons Utility
• Performance Reports Created by ^pButtons Utility
8.1 Running the ^pButtons Utility
The ^pButtons utility lets you select one or more profiles to run. Based on the selected profiles, it generates a set of log
files, which are placed in the output directory. By default, the output directory is the manager's directory of the Caché
instance, (install-dir\mgr); alternatively, you can specify the output directory as described in the Change Output Directory
section in this chapter.
By default, ^pButtons provides the following profiles:
• 30mins — a half hour detail run sampling every 5 seconds
• day — A full day long run, sampling every 60 seconds
• test — A 5 minute test run sampling every 30 seconds
• test30mins — A half hour run sampling every 30 seconds
Caché Monitoring Guide 67