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
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.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.
Source Distribution
File details
Details for the file eea.graylogger-1.4.zip.
File metadata
- Download URL: eea.graylogger-1.4.zip
- Upload date:
- Size: 24.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | a4198625099409a4f8140f0b29708f94d680c89f6f47090066420c5e7d31fe7a |
|
| MD5 | 01cfd061aab30273dc0f52dcd2f0225e |
|
| BLAKE2b-256 | d83acf6709a8f8fdff95c257b382c652246e027d7b3ff39e5f4c622f49e5a37d |
