Command Watcher Monitoring Extension

Command watcher monitoring extension


An AppDynamics extension to be used with a stand-alone Java machine agent to provide metrics from linux commands or script that generates a numeric output.


Metrics Provided


We provide metric related to output of the linux command or the script file that generates single numeric output.


For example: 


abhi.pandey@osxltapand:~$ps -ef | grep java | wc -l




  1. Download and unzip from AppSphere.
  2. Copy the CommandWatcher directory to `<MACHINE_AGENT_HOME>/monitors`.





Please make sure to not use tab (\t) while editing yaml files. You may want to validate the yaml file using a yaml validator


  1. Configure the file to be watched by editing the config.yaml file in `<MACHINE_AGENT_HOME>/monitors/ CommandWatcher /`. Below is the format


Important - displayName has to be unique for the command/script file


# List of commands

- displayName: "File descriptor"
command: "lsof | wc -l"
isScript: false

- displayName: "Java count script"
command: "/Users/abhi.pandey/Downloads/"
isScript: true

# Make sure the metric prefix ends with a |
metricPrefix: "Custom Metrics|Command Watcher|"



  1. Configure the path to the config.yaml file by editing the <task-arguments> in the monitor.xml file. Below is the sample


<!-- config file-->
<argument name="config-file" is-required="true" default-value="monitors/CommandWatcher/config.yml" />


Command Watcher Metrics


Screen Shot 2015-05-06 at 2.33.44 PM.png




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




Find out more in the [Community][].




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


Version: 1.0

Controller Compatibility: 3.7 or later




[AppDynamics Center of Excellence]:






 Last Update: