AppDynamics RabbitMQ Monitoring Extension

This extension works only with the standalone machine agent.

##Use Case RabbitMQ is open source message broker software that implements the Advanced Message Queuing Protocol (AMQP). It is written in the Erlang programming language. The RabbitMQ Monitoring extension collects metrics from an RabbitMQ messaging server and uploads them to the AppDynamics Controller.

##Prerequisite The RabbitMQ Management Plugin must be enabled. Please refer to http://www.rabbitmq.com/management.html for more details.

##Installation

1. Run "mvn clean install"
2. Download and unzip the file 'target/RabbitMQMonitor.zip' to <machineagent install dir>/monitors
3. Open monitor.xml and configure the RabbitMQ arguments.

```








```

##Metrics The following metrics are reported. The Metric Path is relative to the "metricPrefix" defined in the monitor.xml

Metric Path	Description
Nodes/{node}/Erlang Processes	The count of Erlang Processes running in the node
Nodes/{node}/File Descriptors	The count of open file descriptors in the node
Nodes/{node}/Memory(MB)	The memory in MB used by the node
Nodes/{node}/Sockets	The count of open sockets in the node
Nodes/{node}/Channels/Count	The count of channels in the node
Nodes/{node}/Channels/Blocked	The count of BLOCKED channels in the node
Nodes/{node}/Messages/Delivered	The count of messages 'deliver' in the node
Nodes/{node}/Messages/Acknowledged	The count of messages 'ack' in the node
Nodes/{node}/Messages/Got No-Ack	The count of messages with the status 'get_no_ack' in the node
Nodes/{node}/Messages/Delivered No-Ack	The count of messages with the status 'deliver_no_ack' in the node
Nodes/{node}/Messages/Redelivered	The count of messages with the status 'redeliver' in the node
Nodes/{node}/Messages/Published	The count of messages with the status 'publish' in the node
Nodes/{node}/Messages/Available	The count of messages with the status 'messages_ready' in the node
Nodes/{node}/Messages/Pending Acknowledgements	The count of messages with the status 'messages_unacknowledged' in the node
Nodes/{node}/Consumers/Count	The count of consumers for the node
Queues/{vHost}/{qName}/Consumers	The consumer count of a queue in a host
Queues/{vHost}/{qName}/Messages/Acknowledged	The count of messages with the status 'ack' in the host and the given queue
Queues/{vHost}/{qName}/Messages/Available	The count of messages with the status 'messages_ready' in the host and the given queue
Queues/{vHost}/{qName}/Messages/Delivered (Total)	The count of messages with the status 'deliver_get' in the host and the given queue
Queues/{vHost}/{qName}/Messages/Delivered	The count of messages with the status 'deliver' in the host and the given queue
Queues/{vHost}/{qName}/Messages/Delivered No-Ack	The count of messages with the status 'deliver_no_ack' in the host and the given queue
Queues/{vHost}/{qName}/Messages/Got	The count of messages with the status 'get' in the host and the given queue
Queues/{vHost}/{qName}/Messages/Got No-Ack	The count of messages with the status 'get_no_ack' in the host and the given queue
Queues/{vHost}/{qName}/Messages/Published	The count of messages with the status 'publish' in the host and the given queue
Queues/{vHost}/{qName}/Messages/Redelivered	The count of messages with the status 'redeliver' in the host and the given queue
Queues/{vHost}/{qName}/Messages/Pending Acknowledgements	The count of messages with the status 'messages_unacknowledged' in the host and the given queue
Summary/Channels	The total number of channels registered in the server
Summary/Consumers	The total number of Consumers registered in the server
Summary/Messages/Available	The total count of messages with the status 'messages_ready' in the RabbitMQ server
Summary/Messages/Delivered (Total)	The total count of messages with the status 'deliver_get' in the RabbitMQ server
Summary/Messages/Published	The total count of messages with the status 'publish' in the RabbitMQ server
Summary/Messages/Redelivered	The total count of messages with the status 'redeliver' in the RabbitMQ server
Summary/Messages/Pending Acknowledgements	The total count of messages with the status 'messages_unacknowledged' in the RabbitMQ server
Summary/Queues	The count of queues in the RabbitMQ Server

##Password Encryption Support

To avoid setting the clear text password in the monitor.xml. Please follow the process to encrypt the password and set the encrypted password and the key in the monitor.xml

1. Download the util jar to encrypt the password from here
2. Encrypt password from the commandline java -cp "appd-exts-commons-1.1.2.jar" com.appdynamics.extensions.crypto.Encryptor myKey myPassword
3. Add the properties in the monitor.xml. Substitute the default-value

#Custom Dashboard

##Contributing

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

##Community

Find out more in the AppSphere community.

##Support

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