mpstat - Monitoring Extension

By:
Balakrishna.V , Version: 1.0.2
AppDynamics supported
Updated Jan. 23, 2019, 2:32 p.m.

This extension works only with the standalone machine agent.

Use Case

Use for monitoring performance statistics for all logical processors in the system.

This extension executes the mpstat command to retrieve the metrics and is currently supported for Linux and Solaris systems and requires to be deployed on the machine you want to monitor.

Note : By default, the Machine agent and AppServer agent can only send a fixed number of metrics to the controller. To change this limit, please follow the instructions mentioned here.

Prerequisites

Before the extension is installed, the prerequisites mentioned here need to be met. Please do not proceed with the extension installation if the specified prerequisites are not met.

Installation

Download and unzip MPStatMonitor.zip into <machine_agent_dir>/monitors/
The metricPrefix of the extension has to be configured as specified here. Please make sure that the right metricPrefix is chosen based on your machine agent deployment, otherwise this could lead to metrics not being visible in the controller.
Restart the Machine Agent.

Metrics

Metric path is typically: Application Infrastructure Performance|<Tier>|Custom Metrics|MPStat| followed by the individual metrics. The metric path can be changed by specifying in config.yml

Linux

Metric	Description
<CPU>\|%usr	CPU utilization that occurred while executing at the user level (application).
<CPU>\|%nice	CPU utilization that occurred while executing at the user level with nice priority.
<CPU>\|%sys	CPU utilization that occurred while executing at the system level (kernel)
<CPU>\|%iowait	Time that the CPU or CPUs were idle during which the system had an outstanding disk I/O request.
<CPU>\|%irq	Time spent by the CPU or CPUs to service interrupts.
<CPU>\|%soft	Time spent by the CPU or CPUs to service softirqs.
<CPU>\|%idle	Time that the CPU or CPUs were idle and the system did not have an outstanding disk I/O request.

Solaris

Metric	Description
<CPU>\|minf	minor faults
<CPU>\|mjf	major faults.
<CPU>\|xcal	inter-processor cross-calls
<CPU>\|intr	interrupts.
<CPU>\|ithr	interrupts as threads (not counting clock interrupt).
<CPU>\|csw	context switches.
<CPU>\|icsw	involuntary context switches.
<CPU>\|migr	thread migrations (to another processor)
<CPU>\|smtx	spins on mutexes (lock not acquired on first try).
<CPU>\|srw	spins on readers/writer locks (lock not acquired on first try)
<CPU>\|syscl	system calls.
<CPU>\|usr	percent user time.
<CPU>\|sys	percent system time
<CPU>\|wt	the I/O wait time is no longer calculated as a percentage of CPU time, and this statistic will always return zero.
<CPU>\|idl	percent idle time.

Platform Tested

Platform	Version
Ubuntu	14.04 LTS
SunOS	5.10

Agent Compatibility

Version
4.1.2+

Contributing

Always feel free to fork and contribute any changes directly via GitHub

Support

Please look at the troubleshooting document and make sure that everything is followed correctly.

For any questions or feature request, please contact AppDynamics Center of Excellence.

Attachments:

MPStatMonitor-1.0.2.zip