Logstore plugin for moodle to ship logs to graylog or other log backends which supports the GELF format. This plugin requires that you have a working Graylog node. Graylog can be downloaded for free from graylog2.org. Transport protocols TCP and UDP are supported.
Log timestamp in Graylog is directly taken from moodle log entry's timecreated. Useful when importing logs from moodle to graylog in a live moodle installation.
The array in other column in standard logstore is sent as a JSON string as of now. Users can use the "JSON Extractor" feature of Graylog in the other field to store them as separate fields in Graylog.
Please use Github Issues for bug reports, feature requests and send code contributions as Github Pull Requests.
- Create a new Input of type GELF UDP or GELF TCP in Graylog from the Graylog web interface at system/inputs.
- Unzip this plugin to directory
admin/tool/log/store/in your moodle installation. - Navigate to "System Administration -> Notifications" to install the plugin & configure Graylog input details.
This plugin can operate in two modes, just like the splunk logstore plugin.
- Realtime -> Logs are sent to graylog as soon as they happen.
- Background -> Logs are stored in standard logstore and new log entries are sent to graylog once every minute during cron run. Background mode can be used to import existing logs into graylog. Graylog Logstore ships the old logs in batches to Graylog every minute. Once the import is done (check reports->graylog), you can switch back to realtime.
Heavily inspired by the splunk logstore at https://github.com/unikent/moodle-logstore_splunk. Thanks Skylar Kelty!
This plugin uses composer to manage dependencies and is currently dependent on the composer package graylog2/gelf-php which is, in turn, dependent on psr/log. These dependencies are included with the release archive but not maintained in git.
- Implement other transports which GELF supports, such as, Kafka / AMQP, HTTP.
- Use LearningLocker/Moodle-Log-Expander or something similar to expand IDs. Better if logstore evolves automatically whenever the Moodle-Log-Expander project has new log types implemented.