Skip to main content
Version:
2.0
Source:

http://github.com/fireantology/django-logtailer/

Allows the viewing of any log file entries in real time directly from the Django admin interface. It allows you to filter on logs with regex and offer also a log clipboard for save desired log lines to the django db.

Demos

LogTailer log reader in the Django admin

Requirements

  • Django >= 6.1.1

  • Python >= 3.12

  • Sessions enabled

Installation

  • Install the package with pip install django-logtailer

  • Add it to the INSTALLED_APPS in your SETTINGS

  • Set LOGTAILER_ALLOWED_ROOTS in your SETTINGS (see Settings below)

  • add to urls.py: url(r’^logs/’, include(‘logtailer.urls’)),

  • Run manage.py migrate for create the required tables

  • Run manage.py collectstatic

Settings

LOGTAILER_ALLOWED_ROOTS (mandatory): list of directories log files are allowed to live in. Paths are fully resolved (symlinks and .. included) before checking, preventing path traversal (CWE-22). If the setting is missing or empty, access to every log file is denied:

LOGTAILER_ALLOWED_ROOTS = ['/var/log/myapp']

Filters

Filters (saved in the admin or typed in the custom filter field) are Python regular expressions evaluated server-side with re.search() against each raw log line. Only matching lines are returned to the browser.

  • Write plain patterns, not JavaScript literals: use networkmanager, not /networkmanager/.

  • Flags are inline groups: case-insensitive matching is (?i)networkmanager, not /networkmanager/i.

  • An invalid regex falls back to a literal substring match.

Running tests

From the repository root:

python runtests.py

The suite uses a minimal standalone settings module (tests/settings.py) with an in-memory SQLite database, so no extra setup is needed.

Download files

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

Source Distribution

django_logtailer-2.0.0.tar.gz (15.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

django_logtailer-2.0.0-py3-none-any.whl (20.4 kB view details)

Uploaded Python 3

File details

Details for the file django_logtailer-2.0.0.tar.gz.

File metadata

  • Download URL: django_logtailer-2.0.0.tar.gz
  • Upload date:
  • Size: 15.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for django_logtailer-2.0.0.tar.gz
Algorithm Hash digest
SHA256 6ebd2e7ed1e3d04cf42394b2e07ba1998059e85b42ce0f4d31f0e47166e4c8e3
MD5 85003d5de06511433b8d1cb61b907bec
BLAKE2b-256 7a3bfa479170c74fedf41212a5ddde03929a3444f780bbb475f87e8584a195c9

See more details on using hashes here.

Provenance

The following attestation bundles were made for django_logtailer-2.0.0.tar.gz:

Publisher: publish.yml on fireantology/django-logtailer

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file django_logtailer-2.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for django_logtailer-2.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 bf2c7e516c012a83dc79239a8d83574383c59a524646ccc0c4d049ee7f6bbc65
MD5 1432bcde24ef572a745b8393eee82f9e
BLAKE2b-256 20fb4aea184d4172f71db9102a3ca1dafdb4cac092d41e19a2e7325155419eb2

See more details on using hashes here.

Provenance

The following attestation bundles were made for django_logtailer-2.0.0-py3-none-any.whl:

Publisher: publish.yml on fireantology/django-logtailer

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

2.0.0 This release

2 files

1.3.0

2 files

1.2.0

2 files

1.1.0

2 files

1.0.1

2 files

1.0.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page