%Monitor.Processabstract class %Monitor.Process
The methods here control the Process Monitor which allow a programmer to capture
metrics for the current process. The metrics are the same counters as
captured by the PERFMON utility, but they are only captured for the current
process and stored in the process local memory. This ensures that it has
minimal effect on the rest of the system.
Application programmers can embed the methods in their code, so that the Process Monitor can be enabled and metrics reported by user processes, allowing them to analyze trouble spots on live systems.
Note that all of the counters are either 32 or 64-bit counters, according to the word length of the platform, and follow the SNMP Counter32 and Counter64 semantics defined in RFC1442. Application code which subtracts a previous value from the current value must take into account the possible wrap around back to zero. All counters for a process may be initialized to zero using Clear().
Set all Process Monitor counters for the current process to zero. classmethod Disable() as %Status
Stop the Process Monitor for the current process. The current values for all metrics remain in memory until they are zeroed using the Clear() method or the Process Monitor is enabled again. classmethod Enable() as %Status
Start the Process Monitor for the current process. The counters from any previous collections are cleared when the Process Monitor is enabled. classmethod Metrics() as %String
Returns a comma-delimited list of all the Process Monitor metrics. These are in the same order as the metric counters returned by the Report() method. Although the list of metrics and the order of these metrics should be fairly static, it is possible that new metrics might be added or the order changed for some reason in future versions. Use this method to "name" the metrics when reporting them. classmethod Report() as %String
The metrics are the same as those reported by ^PERFMON, and the documentation for PERFMON gives a brief description of each metric.
Returns a comma-delimited list of all Process Monitor counters for the current process. The Metrics() method provides a list of the names for the metrics. classmethod Status() as %Integer
Note that only the current process can report its counters. To be viewed by other processes they must be written to a global or file.
Shows the current status of the Process Monitor for this process. Returns a '1' for enabled and a '0' for disabled.