{{ :blocks:logo-apl.png?nolink |}} ======Installation guide===== ======Zabbix Report===== ====Prerequisites==== To be able to operate the plugin for collecting Moodle indicators on Zabbix you will require: Zabbix version recommended : > 6.4 * A Zabbix server installed. Both zabbix server and zabbix client (or proxies) need to share the same version to operate correctly. * Have installed yhe Zabbix frontend, for displaying the data. * A Zabbix client installed on the moodle server, principally zabbix_sender utility must be here. * Having Moodle recollection templates installed in the Zabbix server * Have configured a remote administration user, without access to the frontend (for better security) ====Additional requirements==== To be able to issue automated reports from zabbix to designated users, * Install a C++ compiler * Install a **Go** environment in minimum version 1.3 (https://www.itzgeek.com/how-tos/linux/debian/how-to-install-go-lang-on-debian-11-debian-10.html) * Compile and install web_services zabbix * Install a chromium or version of chrome capable of working in "headless" * If the configuration file is not present in /etc/zabbix, create it (zabbix_webservice.conf) with reference to https://www.zabbix.com/documentation/current/en/manual/appendix/config/zabbix_web_service and start web services by the command: ''zabbix_web_service -c /etc/zabbix'' ====Installation of the Moodle plugin==== * Deploy the plugin archive in the /report directory of your Moodle installation * Navigate to admin notifications to complete the logical installation of the plugin =====Configuration==== Configuration is required to allow measurements to be sent to the correct Zabbix server host. Data is emitted using the "trapper" method, through the "zabbix_sender" utility, without using the locally installed zabbix agent configuration. The data necessary for the emission of a measure are: * The IP or zabbix host to contact (provided by configuration). * The measurement key (provided by the implementation of the indicator). * The original host of the measurement (implicitly provided by ''$CFG->wwwroot'', or overloaded by the configuration value ''report_zabbix|zabbixhostname''). The the plugin's configuration also allows you to connect the plugin to the remote administration APIs of the Zabbix server, so your moodle instance can be automatically registered in Zabbix optionally in aggregation groups. ====Registration of moodle in a zabbix host==== **Warning:** To be able to perform the automatic registration of moodle in zabbix, the zabbix administrator user setup in configuration must be a known user of zabbix, with **administrator** rights, thus allowed to create host configurations and add this configuration in the targetted groups. Registrating again an olderly registrated host WILL NOT destroy the old data. ====References==== * [[https://www.zabbix.com/documentation/6.0/en/manual/installation|Zabbix 6.0 installation]] * [[https://www.zabbix.com/documentation/6.0/fr/manual/appendix/install/web_service|Installation of additional web services]]] * [[https://go.dev/doc/install|Go installation]] ------------- [[:report:zabbix|Back to plugin's index]] - [[:Plugins|Back to general index]] - [[:start|Home]]