Skip to main content

GELF (Graylog Extended Log Format) for Zope

Project description

develop master

GELF (Graylog Extended Log Format) for Zope event logs

Contents

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.

Dependencies

  1. Graylog server

  2. graypy

  3. plone.recipe.zope2instance >= 4.2.17

Source code

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]

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

eea.graylogger-1.7.zip (26.9 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page