diff options
Diffstat (limited to 'templates/app/rabbitmq_http/README.md')
| -rw-r--r-- | templates/app/rabbitmq_http/README.md | 73 |
1 files changed, 36 insertions, 37 deletions
diff --git a/templates/app/rabbitmq_http/README.md b/templates/app/rabbitmq_http/README.md index d2202fda60b..3d206d8c020 100644 --- a/templates/app/rabbitmq_http/README.md +++ b/templates/app/rabbitmq_http/README.md @@ -7,33 +7,34 @@ For Zabbix version: 6.2 and higher The template to monitor RabbitMQ by Zabbix that work without any external scripts. Most of the metrics are collected in one go, thanks to Zabbix bulk data collection. -Template `RabbitMQ Cluster` — collects metrics by polling [RabbitMQ management plugin](https://www.rabbitmq.com/management.html) with HTTP agent remotely. + Template `RabbitMQ Cluster` — collects metrics by polling [RabbitMQ management plugin](https://www.rabbitmq.com/management.html) with HTTP agent remotely. +_setup: | + Enable the RabbitMQ management plugin. See [RabbitMQ's documentation](https://www.rabbitmq.com/management.html) to enable it. + Create a user to monitor the service: -This template was tested on: - -- RabbitMQ, version 3.5.7, 3.7.17, 3.7.18, 3.7.7, 3.8.5, 3.8.12 - -## Setup + ```bash + rabbitmqctl add_user zbx_monitor <PASSWORD> + rabbitmqctl set_permissions -p / zbx_monitor "" "" ".*" + rabbitmqctl set_user_tags zbx_monitor monitoring + ``` -> See [Zabbix template operation](https://www.zabbix.com/documentation/6.2/manual/config/templates_out_of_the_box/http) for basic instructions. + Login and password are also set in macros: -Enable the RabbitMQ management plugin. See [RabbitMQ's documentation](https://www.rabbitmq.com/management.html) to enable it. + - {$RABBITMQ.API.USER} + - {$RABBITMQ.API.PASSWORD} +_zabbix_forum_url: https://www.zabbix.com/forum/zabbix-suggestions-and-feedback/387226-discussion-thread-for-official-zabbix-template-rabbitmq +_template_type: HTTP -Create a user to monitor the service: -```bash -rabbitmqctl add_user zbx_monitor <PASSWORD> -rabbitmqctl set_permissions -p / zbx_monitor "" "" ".*" -rabbitmqctl set_user_tags zbx_monitor monitoring -``` +This template was tested on: -Login and password are also set in macros: +- RabbitMQ, version 3.5.7, 3.7.17, 3.7.18, 3.7.7, 3.8.5, 3.8.12 -- {$RABBITMQ.API.USER} -- {$RABBITMQ.API.PASSWORD} +## Setup +Refer to the vendor documentation. ## Zabbix configuration @@ -120,8 +121,6 @@ There are no template links in this template. Please report any issues with the template at https://support.zabbix.com -You can also provide feedback, discuss the template or ask for help with it at [ZABBIX forums](https://www.zabbix.com/forum/zabbix-suggestions-and-feedback/387226-discussion-thread-for-official-zabbix-template-rabbitmq). - # RabbitMQ node by HTTP ## Overview @@ -130,31 +129,33 @@ For Zabbix version: 6.2 and higher The template to monitor RabbitMQ by Zabbix that work without any external scripts. Most of the metrics are collected in one go, thanks to Zabbix bulk data collection. -Template `RabbitMQ Node` — (Zabbix version >= 4.2) collects metrics by polling [RabbitMQ management plugin](https://www.rabbitmq.com/management.html) with HTTP agent remotely. + Template `RabbitMQ Node` — (Zabbix version >= 4.2) collects metrics by polling [RabbitMQ management plugin](https://www.rabbitmq.com/management.html) with HTTP agent remotely. +_setup: | + Enable the RabbitMQ management plugin. See [RabbitMQ's documentation](https://www.rabbitmq.com/management.html) to enable it. + Create a user to monitor the service: -This template was tested on: - -- RabbitMQ, version 3.5.7, 3.7.17, 3.7.18, 3.7.7, 3.8.5, 3.8.12 + ```bash + rabbitmqctl add_user zbx_monitor <PASSWORD> + rabbitmqctl set_permissions -p / zbx_monitor "" "" ".*" + rabbitmqctl set_user_tags zbx_monitor monitoring + ``` -## Setup + Login and password are also set in macros: -Enable the RabbitMQ management plugin. See [RabbitMQ's documentation](https://www.rabbitmq.com/management.html) to enable it. + - {$RABBITMQ.API.USER} + - {$RABBITMQ.API.PASSWORD} +_zabbix_forum_url: https://www.zabbix.com/forum/zabbix-suggestions-and-feedback/387226-discussion-thread-for-official-zabbix-template-rabbitmq -Create a user to monitor the service: -```bash -rabbitmqctl add_user zbx_monitor <PASSWORD> -rabbitmqctl set_permissions -p / zbx_monitor "" "" ".*" -rabbitmqctl set_user_tags zbx_monitor monitoring -``` +This template was tested on: -Login and password are also set in macros: +- RabbitMQ, version 3.5.7, 3.7.17, 3.7.18, 3.7.7, 3.8.5, 3.8.12 -- {$RABBITMQ.API.USER} -- {$RABBITMQ.API.PASSWORD} +## Setup +Refer to the vendor documentation. ## Zabbix configuration @@ -244,7 +245,7 @@ There are no template links in this template. |RabbitMQ: Node is not running |<p>RabbitMQ node is not running</p> |`max(/RabbitMQ node by HTTP/rabbitmq.node.running,5m)=0` |AVERAGE |<p>**Depends on**:</p><p>- RabbitMQ: Service is down</p> | |RabbitMQ: Memory alarm |<p>https://www.rabbitmq.com/memory.html</p> |`last(/RabbitMQ node by HTTP/rabbitmq.node.mem_alarm)=1` |AVERAGE | | |RabbitMQ: Free disk space alarm |<p>https://www.rabbitmq.com/disk-alarms.html</p> |`last(/RabbitMQ node by HTTP/rabbitmq.node.disk_free_alarm)=1` |AVERAGE | | -|RabbitMQ: has been restarted |<p>Uptime is less than 10 minutes</p> |`last(/RabbitMQ node by HTTP/rabbitmq.node.uptime)<10m` |INFO |<p>Manual close: YES</p> | +|RabbitMQ: has been restarted |<p>Uptime is less than 10 minutes.</p> |`last(/RabbitMQ node by HTTP/rabbitmq.node.uptime)<10m` |INFO |<p>Manual close: YES</p> | |RabbitMQ: Service is down |<p>-</p> |`last(/RabbitMQ node by HTTP/net.tcp.service["{$RABBITMQ.API.SCHEME}","{HOST.CONN}","{$RABBITMQ.API.PORT}"])=0` |AVERAGE |<p>Manual close: YES</p> | |RabbitMQ: Service response time is too high |<p>-</p> |`min(/RabbitMQ node by HTTP/net.tcp.service.perf["{$RABBITMQ.API.SCHEME}","{HOST.CONN}","{$RABBITMQ.API.PORT}"],5m)>{$RABBITMQ.RESPONSE_TIME.MAX.WARN}` |WARNING |<p>Manual close: YES</p><p>**Depends on**:</p><p>- RabbitMQ: Service is down</p> | |RabbitMQ: There are active alarms in the node |<p>http://{HOST.CONN}:{$RABBITMQ.API.PORT}/api/index.html</p> |`last(/RabbitMQ node by HTTP/rabbitmq.healthcheck.local_alarms[{#SINGLETON}])=0` |AVERAGE | | @@ -260,5 +261,3 @@ There are no template links in this template. Please report any issues with the template at https://support.zabbix.com -You can also provide feedback, discuss the template or ask for help with it at [ZABBIX forums](https://www.zabbix.com/forum/zabbix-suggestions-and-feedback/387226-discussion-thread-for-official-zabbix-template-rabbitmq). - |