Skip to main content

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

Project description

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.

Django 1.3+ compatible.

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/www/www.foo.com.log',
    'django': '/var/log/www.foo.com/project.log',
}

Add it via your installed apps:

INSTALLED_APPS = (
    ...
    'django_logtail',
)

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. Note that files will not appear if the django process cannot access them.

Other Settings

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

LOGTAIL_UPDATE_INTERVAL = 50000 # Default is 3000 (three second)

Developing

You can build a development environment using the following instructions:

virtualenv venv --distribute
source venv/bin/activate
python manage.py syncdb
python manage.py runserver

Changelog for django_logtail

0.1.1 (2013-05-26)

  • Add the static folder to the MANIFEST.in

0.1.0 (2013-05-26)

  • Adding django_logtail.urls to your project’s ROOT_URLCONF is no longer necessary. All log tailing functionality has been moved to the ModelAdmin class in the form of the URLs and views.

  • Now that the view is served from the ModelAdmin, use the Media class to define jquery dependency, and use django’s built-in jquery object rather than using a CDN.

  • Added example/ project for easier testing.

  • Update documentation.

0.0.6 (2013-03-20)

  • Use a CDN that does not serve gateway timeouts (mediatemple -> google)

0.0.5 (2013-03-20)

  • Load the jquery js over https where required using a protocol-relative url.

0.0.4 (2012-12-20)

  • Improved the quality of the javascript polling code

  • The default poll time is now three seconds, rather than every one

  • Now Django 1.3+ compatible (@victorgp)

0.0.3 (2012-08-16)

  • Add the ability to turn off polling (@scott-w)

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


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.1.1.zip (12.0 kB view details)

Uploaded Source

File details

Details for the file django_logtail-0.1.1.zip.

File metadata

  • Download URL: django_logtail-0.1.1.zip
  • Upload date:
  • Size: 12.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for django_logtail-0.1.1.zip
Algorithm Hash digest
SHA256 4abe6daa152a0f5441c767776be6be1502534725f23c927cc5f48d40c4a38deb
MD5 4269fb1052c168308a9c67e42d305776
BLAKE2b-256 3ea54766f5676674bad7a881d84b07efbac1666901e9770b6d5029fcff9541ed

See more details on using hashes here.

Supported by

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