= SOP Add Zabbix monitoring to the RabbitMQ hosts
:page-description: This SOP documents step by step, of what was required to add Zabbix monitoring to the RabbitMQ hosts.

== Overview
This SOP documents step by step, of what was required to add Zabbix monitoring to the RabbitMQ hosts.

== Contact Information

Owner::
  Fedora Infrastructure Team
Contact::
  #fedora-admin, sysadmin-main, sysadmin-noc
Purpose::
  Provide basic orientation and introduction to the sysadmin group

== Access Level

To perform the configuration described in this SOP, one will likely need to have sysadmin-main, sysadmin-noc access.

== Requirements

- `root` access to the hosts in ansible group: `rabbitmq` and or `rabbitmq_stg`.

== Process

- Add the official Zabbix `RabbitMQ node by Zabbix agent` template to the `rabbitmq` and `rabbitmq_stg` hosts.
- Using the `rabbitmqctl` utility on the `rabbitmq` and `rabbitmq_stg` hosts, create the user `zbx_monitor`.
- Using the `rabbitmqctl` utility on the `rabbitmq` and `rabbitmq_stg` hosts, set the `monitoring` permissions on the `zbx_monitor` user.
- Configure the `RabbitMQ node by Zabbix agent` template within Zabbix, to update the password added in the previous step.
- Update the ansible private repo vars with the password for these users. Vars: `zbx_monitor` and `zbx_monitor_staging`



== Resources

- [1] Ansible Zabbix Template for RabbitMQ: https://www.zabbix.com/integrations/rabbitmq


=== Future Work
Replace these custom monitoring things with a Zabbix solution.

- https://pagure.io/firmitas-notifier

