GELF (Graylog Extended Log Format) for Zope
Project description
GELF (Graylog Extended Log Format) for Zope event logs
Contents
Main features
Sends Zope event logs to Graylog instead of a file.
Install
Add eea.graylogger to your eggs section in your buildout and re-run buildout. You can download a sample buildout from https://github.com/eea/eea.graylogger/tree/master/buildouts/plone4
[instance] eggs = ... eea.graylogger zope-conf-imports = eea.graylogger event-log-custom = <graylog> server 172.17.0.18:12201 </graylog>
Getting started
Install Graylog server or use Graylog2 Docker image
Restart Zope
Go to http://localhost:9000 to see your Zope logs
Configuration parameters
rabbit - True if you want to use GELFRabbitHandler instead of GELFHandler. See graypy documentation for more details.
GELFHandler
server - the host[:port] of the graylog server.
chunk_size - message chunk size. messages larger than this size will be sent to graylog in multiple chunks (default 1420).
debugging_fields - send debug fields if true (the default).
extra_fields - send extra fields on the log record to graylog if true (the default).
fqdn - use fully qualified domain name of localhost as source host (socket.getfqdn()).
localname - use specified hostname as source host.
facility - replace facility with specified value. if specified, record.name will be passed as logger parameter.
GELFRabbitHandler
server - RabbitMQ URL (ex: amqp://guest:guest@localhost:5672/%2F).
exchange - RabbitMQ exchange. Default ‘logging.gelf’. A queue binding must be defined on the server to prevent log messages from being dropped.
debugging_fields - send debug fields if true (the default).
extra_fields - send extra fields on the log record to graylog if true (the default).
fqdn - use fully qualified domain name of localhost as source host - socket.getfqdn().
exchange_type - RabbitMQ exchange type (default fanout).
localname - use specified hostname as source host.
facility - replace facility with specified value. if specified, record.name will be passed as logger parameter.
Dependencies
Graylog server
plone.recipe.zope2instance >= 4.2.17
Source code
Latest source code (Plone 4 compatible): https://github.com/eea/eea.graylogger
Copyright and license
The Initial Owner of the Original Code is European Environment Agency (EEA). All Rights Reserved.
The EEA Graylogger (the Original Code) is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
More details under docs/License.txt
Funding
EEA - European Environment Agency (EU)
Changelog
1.7 - (2019-01-28)
Jenkins: Add sonarqube step [avoinea refs #101552]
Change: updated URLs pointing to eea.europa.eu with https:// [alecghica refs #95849]
1.6 - (2017-12-12)
Change: Replace eeacms/zptlint with eeacms/plone-test:4 zptlint [avoinea refs #90415]
1.5 - (2017-06-15)
Bug fix: Fix to work with graypy 0.2.14+ (facility override) [avoinea refs #85963]
1.4 - (2017-05-15)
Change: fixed PyLint warnings and errors [eduard-fironda refs #84949]
1.3 - (2017-04-24)
Change: updated package information [eduard-fironda]
1.2 - (2015-10-05)
Bug fix: Instance name param added to graylog’s log entry [lucas, refs #28304]
1.1 - (2015-07-06)
Bug fix: Added hard dependency to amqplib in order to fix GELFRabbitHandler [voineali refs #21610]
1.0 - (2015-05-05)
Initial release [voineali]
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
