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.

Pre-requisite

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.

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
3

Installation

1. Download and unzip CommandWatcher.zip from AppSphere.
2. Copy the CommandWatcher directory to `<MACHINE_AGENT_HOME>/monitors`.
3. Edit the file config.yml located at <MachineAgent_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.

Configuration

###Note

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

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
commandToProcess:

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

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

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

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

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

Troubleshooting

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

Command Watcher Metrics

Contributing

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

Community

Find out more in the Community.

Support

For any questions or feature request, please contact AppDynamics Support.