This package contains a set of nagios checks useful for monitoring a RabbitMQ server. They use the RabbitMQ management interface with is over HTTP and therefore have a very light profile on the nagios server.
See the documentation on the RabbitMQ management interface for more details on what it provides.
NOTE: RabbitMQ 2.x and RabbitMQ 3.x use different ports for the management
interface. master
is configured to use the RabbitMQ port by default (15672).
If you are running RabbitMQ 2.x, use the rabbitmq-2.x
branch.
Currently we have the following checks:
-
check_rabbitmq_aliveness
- Use the
/api/aliveness-test
API to send/receive a message.
- Use the
-
check_rabbitmq_connections
- Use the
/api/connections
API to gather details of connections used, their state and their throughput
- Use the
-
check_rabbitmq_objects
- Use a variety of APIs to count instances of various objects on the server. These include vhosts, exchanges, bindings, queues and channels.
-
check_rabbitmq_overview
- Use the
/api/overview
API to collect the number of pending, ready and unacknowledged messages on the server
- Use the
-
check_rabbitmq_partition
- Use the
/api/nodes
API to check for partitions in a RabbitMQ cluster.
- Use the
-
check_rabbitmq_queue
- Use the
/api/queue
API to collect the number of pending, ready and unacknowledged messages and the number of consumers on a given queue
- Use the
-
check_rabbitmq_server
- Use the
/api/nodes
API to gather resource usage of the rabbitmq server node
- Use the
-
check_rabbitmq_shovels
- Use the
/api/nodes
API check that all the shovels of the given RabbitMQ host are running
- Use the
-
check_rabbitmq_watermark
- Use the
/api/nodes
API to check to see if mem_alarm has been set to true
- Use the
See the relevant POD documentation/man pages for more information on usage.
This file is part of nagios-plugins-rabbitmq.
Copyright 2010, Platform 14.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
James Casey [email protected]