Skip to main content

A log viewing and tailing utility accessible via a Django admin panel

Project description

==============
django_logtail
==============

Introduction
============

Logtail allows you to view logfiles for your django project via your django
admin, and will also provide you with a live tail of the logfiles using ajax
polling - and therefore without the need for a long-running django process.

See Also: https://pypi.python.org/pypi/django_logtail

Installation and Use
====================

Django logtail takes a dictionary from your settings.py as follows::

LOGTAIL_FILES = {
'apache': '/var/log/www.foo.com.log',
'django', '/var/log/www.foo.com/project.log',
}

Add it via your installed apps::

INSTALLED_APPS = (
...
'django_logtail',
)

If any of your django admin plugin apps already add a jquery header::

LOGTAIL_INCLUDE_JQUERY = False # Default is True

Next hook it into your root_urlconf, above the bog-standard admin urls::

urlpatterns = patterns('',
# First this
url(r'^admin/django_logtail/', include(logtail_urls)),

# Then this
url(r'^admin/', include(admin.site.urls)),
...
)

Then absolutely ensure that the user that your django process runs as (whether
it's via wsgi, fastcgi, django runserver for debugging, or something else) has
permission to read all of the files in your LOGTAIL_FILES list.

logtail should then appear in your admin, and provide access to these files -
including a live tail of the file.

Simples.

Other Settings
==============

You can set the default update interval for the log tailing::

LOGTAIL_UPDATE_INTERVAL = 50000 # Default is 1000 (one second)


============================
Changelog for django_logtail
============================

0.0.2 (2012-05-04)
------------------

- Escape log text to prevent html element lookalikes screwing up the formatting.


0.0.1 (2012-04-22)
------------------

- Update the package MANIFEST.in to ensure that the README and changelog are
included.


0.0.0 (2012-04-22)
------------------

- Initial release.

Project details


Release history Release notifications

History Node

0.3.0

History Node

0.2.0

History Node

0.1.1

History Node

0.0.6

History Node

0.0.5

History Node

0.0.4

History Node

0.0.3

This version
History Node

0.0.2

History Node

0.0.1

History Node

0.0.0

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
django_logtail-0.0.2.tar.gz (5.2 kB) Copy SHA256 hash SHA256 Source None May 4, 2012

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page