Metadata

Distro Index Owner:
eea
Home Page:
eea.graylogger
License
GPL version 2
Version:
1.5
Last updated:
2017-06-15
Keywords:
EEA Add-ons Plone Zope

eea.graylogger

Files

Indexes

GELF (Graylog Extended Log Format) for Zope

EEA Graylogger

http://ci.eionet.europa.eu/job/eea.graylogger-www/badge/icon http://ci.eionet.europa.eu/job/eea.graylogger-plone4/badge/icon

GELF (Graylog Extended Log Format) for Zope event logs

Main features

  1. Sends Zope event logs to Graylog instead of a file.

Install

Getting started

  1. Install Graylog server or use Graylog2 Docker image
  2. Restart Zope
  3. 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.

Source code

Funding

EEA - European Environment Agency (EU)

Changelog

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]