Skip to main content

A log viewing and tailing utility accessible via a Djangoadmin 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.

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

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

LOGTAIL_FILES = {
'apache': '/var/www/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.0 (2012-04-22)
------------------

- Initial release.

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

django_logtail-0.0.0.tar.gz (4.8 kB view details)

Uploaded Source

File details

Details for the file django_logtail-0.0.0.tar.gz.

File metadata

File hashes

Hashes for django_logtail-0.0.0.tar.gz
Algorithm Hash digest
SHA256 3ac423589ea9ded53486bff0cb022a2493785f6070e65d11053be8eb7329ccd3
MD5 fed60486d9d2fcc99c247894e05ff24e
BLAKE2b-256 410ecdbba7c7025dd302d7062c2e477356d012fd1eb42d3a788d9cfcf4af10cc

See more details on using hashes here.

Provenance

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