This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description
============
django-fluentd
============

django-fluentd allows you to use django's logging framework to log directly to a fluentd server of your choice.

Please consider the package as unstable and don't use it for production, yet.

Installation
============

with pip::

pip install django-fluentd

**or**

with setup.py::

git clone https://github.com/jayfk/django-fluentd.git
cd django-fluentd
python setup.py install

Configuration
============

Add the following to your settings.py::

DJANGO_FLUENTD_SERVER = "10.10.10.10"
DJANGO_FLUENTD_PORT = 24224 #no string
DJANGO_FLUENTD_TAG = "your_fluentd_tag"

Add the fluentd handler to your LOGGING dict in your settings.py and add this handler to one of your loggers::

LOGGING = {

...

'handlers':{
'fluentd': {
'level': 'DEBUG',
'class': 'django_fluentd.handler.FluentdHandler',
},
}

...

'loggers': {
'django': {
'handlers': ['fluentd',],
'level': 'DEBUG',
'propagate': False,
},
},
}

If you want to capture all logging messages using fluentd, you can add a root handler::

LOGGING = {
...

'root': {
'level': 'DEBUG',
'handlers': ['fluentd'],
},

...
}

Further information on how to use django's logging framework can be found here: https://docs.djangoproject.com/en/dev/topics/logging/

Fluentd Server Setup
============

Your Fluentd Server should listen on the ip and the port you specified in ``DJANGO_FLUENTD_SERVER`` and ``DJANGO_FLUENTD_PORT``::

<source>
type forward
port 24224
bind 10.10.10.10
</source>

Please not that you currently can't use fluentd's secure_forward. If you want to send encrypted or authenticated messages
to another fluentd server on the net, you'll have to add a local fluentd server that accepts unencrypted messages and forwards
them using secure_forward::

<source>
type forward
port 24224
bind 10.10.10.10
</source>

<match **="">
type secure_forward
shared_key foobar
self_hostname example.org
send_timeout 60s
recover_wait 10s
heartbeat_interval 1s
phi_threshold 8
hard_timeout 60s

<server>
name remote_server_name
host 10.10.10.11
port 24224
username your_username
password your_password
</server>

</match>

Further information on how to use fluentd can be found here: http://fluentd.org/
Release History

Release History

0.1

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting